@carrierllc/mcp

Natural language control of your MVNO/eSIM fleet. 43 OCS tools + 8 intelligence composites + 5 prompts. Direct stdio mode — no OAuth required.

Quick start

ESIMVAULT_API_TOKEN=your_key npx -y @carrierllc/mcp

Get a key at mcp.carrier.llc.

Install in Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "carrier": {
      "command": "npx",
      "args": ["-y", "@carrierllc/mcp"],
      "env": {
        "ESIMVAULT_API_TOKEN": "YOUR_KEY"
      }
    }
  }
}

Install in Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "carrier": {
      "command": "npx",
      "args": ["-y", "@carrierllc/mcp"],
      "env": {
        "ESIMVAULT_API_TOKEN": "YOUR_KEY"
      }
    }
  }
}

Install in Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "carrier": {
      "command": "npx",
      "args": ["-y", "@carrierllc/mcp"],
      "env": {
        "ESIMVAULT_API_TOKEN": "YOUR_KEY"
      }
    }
  }
}

Remote HTTP (OAuth 2.1)

For multi-user deployments with OAuth 2.1 + PKCE, use the remote endpoint:

{
  "mcpServers": {
    "carrier": {
      "type": "http",
      "url": "https://mcp.carrier.llc/mcp"
    }
  }
}

Environment variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | ESIMVAULT_API_TOKEN | Yes | — | Your eSIMVault OCS API token | | CARRIER_OCS_API_TOKEN | Alternative | — | Alias for ESIMVAULT_API_TOKEN | | CARRIER_OCS_BASE_URL | No | https://ocs.esimvault.cloud | OCS base URL (no trailing slash) |

Tools (51 total)

Reseller (6)

| Tool | Scope | Description | |------|-------|-------------| | list_reseller_accounts | read | List all accounts across all resellers | | get_reseller_info | read | Retrieve reseller details | | esim_status_per_account | read | eSIM status breakdown per account | | list_sponsors | read | List all sponsor networks | | list_steering_lists | read | List all network steering lists | | modify_account_balance | write | Adjust or set reseller account balance |

Subscriber (13)

| Tool | Scope | Description | |------|-------|-------------| | get_subscriber | read | Get full subscriber details by ICCID or MSISDN | | list_subscribers | read | List subscribers with optional filters | | get_sim_provider_status | read | Check SIM provider-level status | | get_subscriber_location | read | Get last known subscriber location | | hlr_get_bitrate | read | Get HLR bitrate for a subscriber | | modify_subscriber_balance | write | Adjust or set subscriber balance | | modify_subscriber_status | write | Change subscriber OCS status | | change_sim_status | write | Change SIM status at provider level | | modify_subscriber_contact_info | write | Update subscriber contact info | | set_subscriber_traffic_restrictions | write | Configure traffic restrictions | | modify_subscriber_steering_list | write | Change network steering list for a subscriber | | hlr_set_bitrate | write | Set HLR bitrate for a subscriber | | move_subscriber_range_to_account | write | Move subscriber range to another account |

Packages (9)

| Tool | Scope | Description | |------|-------|-------------| | list_subscriber_packages | read | List all prepaid packages for a subscriber | | list_package_templates | read | List all prepaid package templates | | assign_package | write | Assign package template to subscriber | | assign_recurring_package | write | Assign recurring package to subscriber | | modify_package_limits | write | Change data/voice/SMS limits on active package | | modify_package_expiry | write | Change expiration date of active package | | modify_package_status | write | Activate or deactivate a subscriber package | | stop_resume_recurring_package | write | Stop or resume recurring package auto-renewal | | delete_subscriber_package | write | Remove a package from a subscriber |

Templates & Zones (7)

| Tool | Scope | Description | |------|-------|-------------| | clean_all_packages | write | Remove ALL packages from a subscriber | | create_package_template | write | Create a new prepaid package template | | modify_template_core | write | Modify core settings of a package template | | modify_template_recurring | write | Modify recurring settings of a package template | | modify_template_throttling | write | Modify throttling settings of a package template | | list_location_zones | read | List countries/networks in a location zone | | list_detailed_location_zones | read | Get detailed location zone definitions |

Statistics & Misc (8)

| Tool | Scope | Description | |------|-------|-------------| | subscriber_usage | read | Get daily usage for a subscriber (max 7 days) | | subscriber_network_events | read | Get network events for a subscriber (max 7 days) | | subscriber_active_period | read | Get subscriber active period | | get_tariff | read | Retrieve customer tariff/pricing table | | list_destination_prefixes | read | List phone number prefixes in destination lists | | list_network_profiles | read | List all available network profiles | | create_location_zone | write | Create a new location zone | | send_sms | write | Send MT SMS to a subscriber |

Intelligence (8)

AI composites that chain multiple OCS calls to produce structured insights:

| Tool | Description | |------|-------------| | diagnose_subscriber | Chains 5+ OCS calls to diagnose connectivity issues | | fleet_health | Single-call fleet overview: accounts, eSIM counts, low-balance alerts | | detect_usage_anomalies | Detect abnormal usage patterns and burn-rate risks | | optimize_package | Match subscriber usage to the best available package | | churn_risk | Score churn risk (0-100) with retention recommendations | | audit_network_coverage | Audit network coverage and steering effectiveness | | marketing_intelligence | Market segmentation and upsell opportunities | | high_cost_subscribers | Identify highest-cost subscribers for margin optimization |

Prompts (5)

| Prompt | Args | Description | |--------|------|-------------| | fleet_health_report | — | Full fleet health overview | | subscriber_deep_dive | iccid | Deep diagnostic for a single subscriber | | revenue_optimization | — | Revenue analysis and upsell opportunities | | coverage_analysis | — | Network coverage audit and steering recommendations | | bulk_operations_planner | operation | Plan and dry-run a bulk fleet operation |

Destructive tools and dry_run

All write/admin tools accept an optional dry_run: true argument. When set, the tool returns the would-be request without calling OCS — safe for previewing operations.

"Suspend ICCID 8988... but check what it would do first (dry_run)"

Links

• Product page: mcp.carrier.llc
• Source: github.com/Lifecycle-Innovations-Limited/carrier.llc
• OCS docs: docs.esimvault.cloud/ocs-api

MIT License. Copyright 2025 Lifecycle Innovations Limited.