# ISP2Go — v2.1.12

> Agent-first ISP management. Run a full ISP/WISP — customers, billing, tickets,
> RADIUS/network, compliance — from the terminal or any MCP client. As easy as git.

Splynx charges ~$255/mo. ISP2Go starts at $39/mo flat. 9 AI experts, 20 MCP tools,
sandbox-first onboarding. RICA/POPIA compliant (South Africa).

## Quick Start

```bash
npm install -g isp2go
isp signup my-isp --sandbox
# Human opens payment URL, adds card (14-day trial, from $39/mo)
# API key (isk_...) auto-saved to config
```

Or if you already have a key:
```bash
isp login --key YOUR_KEY
```

## Sandbox → Live (the MOAT)

Every tenant starts in an isolated sandbox DB, pre-seeded with demo data. Try
everything risk-free, then promote to a clean live environment. Stripe-style toggle.

```bash
isp mode                        # show current mode (sandbox|live)
isp mode sandbox                # switch to test mode
isp mode live                   # go live to a clean environment
isp <command> --sandbox         # run one command against sandbox
```

## Session Start (DO THIS FIRST)

```bash
isp status                      # ISP overview: customers, services, MRR
isp notifications               # what changed recently
```

## MCP Server (Claude Code / Cursor / any MCP client)

20 tools returning structured JSON. Add to your agent:
```bash
claude mcp add isp2go -- isp mcp-serve
```
Or config:
```json
{ "mcpServers": { "isp2go": { "type": "stdio", "command": "isp", "args": ["mcp-serve"] } } }
```

Tools: isp2go_status, isp2go_dashboard, isp2go_list_customers, isp2go_get_customer,
isp2go_create_customer, isp2go_list_invoices, isp2go_generate_invoices,
isp2go_list_tickets, isp2go_create_ticket, isp2go_list_routers,
isp2go_list_services, isp2go_list_leads, isp2go_convert_lead, isp2go_list_tariffs,
and more.

## Core Commands

```bash
# Status
isp status                      # customers, services, MRR
isp dashboard                   # full dashboard JSON
isp me                          # tenant + plan info
isp config                      # active config

# Customers & services
isp customers --status active   # list/search customers
isp customer ID                 # detail + services
isp customer-create "Jane Doe" --email jane@x.com --phone 0821234567
isp services --customer ID      # list services
isp service-create CUSTOMER-ID TARIFF-ID --login jdoe

# Billing
isp invoices --status unpaid    # list invoices
isp invoice-create CUSTOMER-ID --amount 499 --desc "Fibre 100Mbps"
isp billing-run --preview       # dry-run the billing cycle
isp billing-stats               # MRR, ARPU, collection rate
isp dunning --preview           # overdue chase
isp payments                    # list payments

# Support
isp tickets --status open --priority high
isp ticket ID                   # detail + messages
isp ticket-create "Internet down" -c CUSTOMER-ID --priority high

# Network / monitoring
isp routers --status online     # list routers (MikroTik/Ubiquiti/…)
isp router ID                   # detail + interfaces
isp ips --router ROUTER-ID      # IP hosts
isp monitoring                  # stats + alerts
isp health-score                # network health 0–100
isp uptime                      # per-device uptime
isp sla                         # SLA compliance
isp ping router ROUTER-ID       # manual ping

# Sales
isp leads --status new          # list leads
isp lead-convert ID --tariff TARIFF-ID
isp proposals ; isp proposal-create --customer ID --title "Fibre quote"
isp contracts ; isp contract-activate ID ; isp contracts-expiring

# Tariffs & inventory
isp tariffs                     # plans
isp inventory                   # dashboard
isp inv-products ; isp inv-low-stock ; isp inv-transfer ID --to LOCATION-ID

# Messaging
isp msg-send --subject "..." --body "..." --customers ID1,ID2
isp announcement-create --title "..." --type maintenance
isp announcement-publish ID

# Scheduling / field ops
isp workflows ; isp sched-teams ; isp task-templates

# Voice (CDR)
isp cdrs ; isp cdr-stats ; isp cdr-revenue ; isp cdr-import --file calls.csv

# Towers / coverage (WISP)
isp towers ; isp coverage-check --lat -26.1 --lng 28.0 ; isp tower-map

# Hosting / domains
isp domains ; isp hosting-accounts ; isp ssl-certs ; isp mailboxes

# Compliance (South Africa)
isp rica                        # RICA compliance dashboard
isp popia --status open         # POPIA data-subject requests
isp dsars                       # list DSARs

# AI experts (h-conductor)
isp ask "why is MRR down this month?" --dept bizintel
```

## Discover the full schema

```bash
isp init --agent-schema         # JSON schema of every command + valid flags
```
This is the single source of truth. If a flag isn't in the schema, it doesn't exist.

## Pricing

14-day free trial, card required at signup. Starter from $39/mo flat (all modules,
cloud hosting, unlimited admins). Per-subscriber tiers for scale. Stripe Connect.

## Links

- Homepage: https://isp2go.com
- Sign up: https://isp2go.com/trial
- npm: https://www.npmjs.com/package/isp2go