---
name: carrier-operations
description: Reference map of the Carrier MCP tool surface — domains, key tools, and safety rules for operating an MVNO/eSIM fleet. Load when planning multi-step fleet, billing, or storefront operations.
---

# Carrier Operations — MCP Tool Map

Carrier is a programmable connectivity control plane (the "Stripe of telecom") exposed as an MCP server at `https://mcp.carrier.llc/mcp` (OAuth 2.1 + PKCE). Tools span these domains:

## Provisioning & SIM lifecycle
`assign_package` with `account_for_subs` (issue free eSIM from inventory — Console `issue-from-inventory` parity) · `provision_esim_wizard` (Pro+ UI on existing subscribers) · `change_sim_status` · `esim_status_per_account` · `get_sim_provider_status` · `audit_network_coverage` · `hlr_get_bitrate` / `hlr_set_bitrate`

## Subscribers
`list_subscribers` · `get_subscriber` · `diagnose_subscriber` · `modify_subscriber_status` · `modify_subscriber_contact_info` · `modify_subscriber_mobile_plan` · `modify_subscriber_voip_plan` · `affect_subscriber_phone_number` · `move_subscriber_range_to_account` · `get_subscriber_location[_by_cell_id]`

## Packages & pricing
`list_package_templates` · `create_package_template` · `modify_template_core|recurring|throttling` · `assign_package` · `assign_recurring_package` · `stop_resume_recurring_package` · `list_subscriber_packages` · `modify_package_limits|expiry|status` · `modify_subscriber_package_active_period` · `optimize_package` · `delete_subscriber_package` · `clean_all_packages` · `pricing_plans` · `service_catalog` · `get_tariff`

## Usage & intelligence
`subscriber_usage` · `usage_projection` · `subscriber_depletion_events` · `subscriber_network_events` · `subscriber_country_history` · `detect_usage_anomalies` · `churn_risk` · `marketing_intelligence` · `high_cost_subscribers`

## Billing, credit & wallet (three money domains)
- Platform credit: `credit_balance` · `balance_topup_form` · `billing_events` · `configure_billing` · `modify_subscriber_balance` · `modify_account_balance`
- Stripe Connect: `stripe_connect_status|balance|payouts|dispute_list` (Radar / `stripe_proxy_call` are Pro/ops-gated)
- Managed prepaid wallet: `wallet_balance` · `wallet_topup_checkout` · `wallet_auto_topup` (slash: `/carrier:wallet`)

## Green zone / steering
`greenzone_whitelist_list|add|remove` · `reset_subscriber_gz_counter` · `list_steering_lists` · `list_destination_lists` · `list_destination_prefixes` · `modify_subscriber_steering_list` · `push_steering_to_subscriber` · `set_subscriber_traffic_restrictions`

## Fleet & platform
`fleet_health` · `fleet_health_app` · `list_recent_ocs_events` · `rate_limit_status` · `carrier_ocs_calls_per_min` · `environment_info` · `credential_status` · `rotate_credentials` · `list_reseller_accounts` · `get_reseller_info` · `send_sms`

## Storefront
`generate_storefront_logo` (any authenticated MCP user) · CLI `carrier site create` writes `public/brand/logo.svg` · `carrier site logo` regenerates. Optional PNG if Carrier/worker has `OPENAI_API_KEY`.

## Gated surfaces (not free-tier defaults)
- **Steel ui_agent_*** — requires `STEEL_API_KEY` / ops config; UI-only OCS ops.
- **`stripe_proxy_call`** — Pro/Enterprise Stripe Agent Toolkit multiplexer.
- **`provision_esim_wizard`** — Pro+ MCP App; free tier uses `assign_package` inventory path.

## Safety rules (always)
1. **Read before write.** Establish current state before any mutation.
2. **Confirm money & live-service changes** — status changes, balance/package mutations, wallet top-ups, `clean_all_packages`, `rotate_credentials`, outbound `send_sms`.
3. **Right quantity only** — never over-provision; check `credit_balance` and (managed mode) `wallet_balance` first.
4. **Diagnose, don't guess** — use `diagnose_subscriber` + event tools for faults.
5. Storefront: `carrier site create` / `carrier site logo`, or MCP `generate_storefront_logo`. SVG mark is generated for every operator — no local image-API key required. Keep plans synced with `pricing_plans`.