# Carrier — Claude Code plugin

Natural-language control of your MVNO/eSIM fleet, plus a white-labeled storefront — the Stripe of telecom, inside Claude Code.

## Install (recommended)

```bash
npx -y -p @carrierllc/mcp carrier-mcp
# or, after global install:
carrier
carrier init
```

The CLI opens a clear TUI: status (plugin / MCP / auth), sign-up & sign-in links, storefront scaffold, and “talk to fleet” examples.

```bash
carrier plugin install
```

### Zero credentials · OAuth on first use (Entry A)

The MCP server is registered as a plain HTTPS URL — **no API token in config**:

```text
https://mcp.carrier.llc/mcp
```

When Claude first calls a Carrier tool, your browser opens Clerk sign-in / sign-up
(Google, GitHub, or email). Authorize once; tokens stay in the client.

Headless / CI only: create an org API key (`ak_…`) in the console
(https://app.carrier.llc → Settings → API Keys) and pass it as a Bearer token
or `CARRIER_API_KEY` for `carrier ask "…"`.

…or wire Claude Code manually:

```bash
claude plugin marketplace add <path-to-bundled-plugin>
claude plugin install carrier@carrier
claude mcp add --transport http carrier https://mcp.carrier.llc/mcp
# stuck on auth?
claude mcp auth carrier
```

## Slash commands

Each ships as a skill (`skills/<name>/SKILL.md`), so it also fires on plain
natural language — `/carrier:fleet` and "how's the fleet doing?" reach the same
instructions.

| Command | Does |
|---|---|
| `/carrier:issue-esim` | Issue one eSIM via `connectivity.intent` (the vibe-coder path) |
| `/carrier:provision` | Operator path: inventory stock + a starter package |
| `/carrier:subscribers` | List / inspect / suspend / resume / terminate subscribers |
| `/carrier:packages` | Create, assign, optimize data packages |
| `/carrier:usage` | Usage, projections, depletion, anomalies |
| `/carrier:billing` | Balances, thresholds, Stripe Connect payouts |
| `/carrier:credits` | Platform credit, top-ups, credential health |
| `/carrier:wallet` | Managed prepaid wallet balance / bulk top-up / auto-top-up |
| `/carrier:sms` | Send an SMS to a subscriber |
| `/carrier:esim-status` | eSIM activation / SIM state / provider health |
| `/carrier:churn` | Churn risk + marketing intelligence |
| `/carrier:greenzone` | Fair-use whitelist + steering policy |
| `/carrier:fleet` | One-screen fleet health dashboard |
| `/carrier:status` | Fast control-plane + auth ping |
| `/carrier:storefront` | Scaffold / rebrand / deploy your storefront |
| `/carrier:onboard` | Zero-to-live: stand up a connectivity business |

## Agents

- **carrier-fleet-ops** — autonomous provisioning + lifecycle + remediation
- **carrier-billing-auditor** — read-only revenue/cost audit, proposes adjustments
- **carrier-storefront-builder** — scaffold, white-label, deploy the storefront

## Reference skill

- **carrier-operations** — the full MCP tool map + safety rules (no slash command; loaded when planning multi-step work)

All operations run through the Carrier MCP (`https://mcp.carrier.llc/mcp`, OAuth 2.1 + PKCE). Money- and service-affecting actions always confirm first.