Skip to content

MCP server

Wholesale telecom, one tool call away

Connect Claude, Cursor or any MCP client to one hosted endpoint and your agent can price destinations, buy routes, verify phone numbers by SMS or voice, send messages, place calls and keep its own balance topped up.

Get your API keySee the tools

33

tools on one endpoint

15

for the marketplace and account

18

to run a Switch

0

to install

Connect in minutes

One hosted endpoint, nothing to build

MCP is the open standard AI clients use to call outside tools. Ours gives your agent the same marketplace, routes, numbers and billing your dashboard uses, as tools it calls by name.

  1. Step 1

    Create an API key

    Open a free account and make a key in the dashboard. Give it only the scopes the agent needs; a test key simulates every send.

  2. Step 2

    Add the endpoint and your key

    Paste the config for Claude Code, Claude Desktop, Cursor or any MCP client, with your key in an environment variable. There is no SDK to wire up and no server to run.

  3. Step 3

    Ask in plain English

    Your agent picks the tools: it can price a destination, connect a route, verify a phone number or place a test call.

Also listed on Smithery and in the official MCP Registry as io.packetexchange/mcp.

.mcp.json
{
  "mcpServers": {
    "packetexchange": {
      "type": "http",
      "url": "https://packetexchange.io/mcp/http",
      "headers": {
        "Authorization": "Bearer ${PACKETEXCHANGE_API_KEY}"
      }
    }
  }
}

Claude Code expands ${PACKETEXCHANGE_API_KEY} from your shell, so the key never sits in the file.

Streamable HTTP

https://packetexchange.io/mcp/http

Primary. Stateless, so every request stands alone. The key is the connection's Authorization header and never passes through the chat.

SSE, for older clients

https://packetexchange.io/mcp/sse

For clients that only speak SSE, through mcp-remote with --transport sse-only and the same header.

What your agent can do

Real telecom work, done by asking

Each job below is one or two tool calls. The agent pays wholesale rates from your prepaid balance, plus the same capped platform fee as the API, and every charge is on your ledger.

A developer at a lamp-lit desk building an agent, her laptop open at the PacketExchange MCP tools
  1. 1Asked in plain EnglishThe agent picks the tools: price a number, connect a route, send.
  2. 2Priced before it is sentEvery result carries the exact cost, from the prepaid balance.
  3. 3On your ledgerEach charge is a line in your transactions, by key.

Find and buy routes

Search the marketplace by destination, price and stated quality, preview what Smart Routing would pick, then connect a route.

wmmn_list_routes · wmmn_resolve_route · wmmn_purchase_route

Verify a phone number

Send a one-time code by SMS or by a call that reads it aloud, then check what the user typed. Only a hash of the code is kept.

wmmn_verify_start · wmmn_verify_check

Speak a passcode

Call a number and read a code digit by digit in English, Spanish, French, German, Portuguese or Hindi, then hang up.

wmmn_send_voice_otp

Send SMS and place calls

Real messages and calls over your routes, with the segment count, call outcome and cost returned to the agent.

wmmn_send_sms · wmmn_make_call

Watch and fund the balance

Read the balance and recent charges, and top up with one signed USDC payment on Base when it runs low.

wmmn_get_balance · wmmn_topup_x402

Run a Switch

Onboard customers and suppliers, load rate decks, set failover, invoice and net off, on an active Switch plan.

18 switch_* tools

Marketplace and account tools

15 tools to find, buy, send and verify

Route search and market figures are public. Everything else takes your API key, and each tool wraps a documented REST endpoint.

The REST API behind every tool

Discover

  • wmmn_list_routes

    Search marketplace routes per network, proven first, with measured connect and caller-ID results.

    country · type · max_price · min_asr · cli_type · route_type · search · sort · per_network · network · tested · verified_cli · limit

    FreeNo key needed

  • wmmn_route_details

    One route in full: price, billing increment, stated quality and Exchange Score.

    route_id

    FreeNo key needed

  • wmmn_market_summary

    Route and destination counts right now; averages too when a key is present.

    no parameters

    FreeNo key needed

  • wmmn_resolve_route

    Preview which route Smart Routing would pick for a number, with alternatives.

    to · type · strategy

    FreeNeeds a key

Connect

  • wmmn_purchase_route

    Connect a route to the account: no upfront charge, traffic then bills per use. Live key only.

    route_id

    Connects a routeNeeds a key

  • wmmn_list_purchases

    The routes you have connected, with SIP credentials. Full-access key only.

    no parameters

    FreeNeeds a key

Send

  • wmmn_send_sms

    Send an SMS; returns segments and the exact cost.

    to · from · message · route_id · strategy

    Bills the balanceNeeds a key

  • wmmn_make_call

    Place a call that can speak, play audio and collect keypad digits; returns the outcome and cost, or a call id while it runs.

    to · from · route_id · strategy · max_duration · actions · language · wait_seconds

    Bills the balanceNeeds a key

  • wmmn_get_call

    Live status of a call: answered, duration, cost, hangup reason and gathered digits.

    call_id

    FreeNeeds a key

Verify

  • wmmn_verify_start

    Send a one-time code by SMS or a voice call. Only a hash of the code is kept.

    to · channel · length · language · brand · expiry_seconds · from · strategy

    Bills the balanceNeeds a key

  • wmmn_verify_check

    Check a code: approved, denied, expired or max_attempts.

    verification_id · code

    FreeNeeds a key

  • wmmn_send_voice_otp

    Read your own code aloud on a call in en, es, fr, de, pt or hi.

    to · code · length · language · repeat · from · brand · return_code · strategy

    Bills the balanceNeeds a key

Account

  • wmmn_get_balance

    Prepaid balance and test credit.

    no parameters

    FreeNeeds a key

  • wmmn_list_transactions

    Recent charges, credits and top-ups.

    no parameters

    FreeNeeds a key

  • wmmn_topup_x402

    Fund the balance with USDC on Base over x402, $5 to $50,000.

    amount_usd · payment_header

    Moves USDCNeeds a key

Switch tools

Run your Switch from any agent

Eighteen tools for the daily work of a NOC and a billing team: onboarding customers and suppliers, loading A-Z decks, setting failover, invoicing, netting and fraud screening. They use your operator key and need an active Switch plan.

Customers and suppliers

4 tools
  • switch_list_customers

    List every sell-side customer with balance, credit limit, markup, spend caps and status.

  • switch_create_customer

    Provision a customer and mint its first API key and SIP password; the buyer onboarding entry point.

  • switch_list_suppliers

    List buy-side vendor trunks with SIP egress config, default rate, capacity, CPS and settlement mode.

  • switch_create_supplier

    Provision a termination vendor trunk: SIP host, auth, codecs, rate, capacity and settlement mode.

Rating

2 tools
  • switch_bulk_upsert_supplier_rates

    Bulk-load a supplier's A-Z cost deck, de-duped last-wins, up to 50,000 rows.

  • switch_bulk_upsert_sell_rates

    Bulk-load the operator retail sell deck and fire the sell_rate.changed webhook.

Routing

3 tools
  • switch_preview_routing

    Read-only routing preview for a dialled number: matched rule, block verdict and ordered failover chain.

  • switch_set_route_plan_entries

    Replace a route group with an ordered supplier list, with per-prefix failover, weight and ASR/PDD gates.

  • switch_assign_customer_routing

    Point a customer at the right dialplan, route group and LCR strategy override.

Billing and receivables

3 tools
  • switch_create_invoice

    Generate an itemised invoice for a customer from settled call records and emit invoice.created.

  • switch_list_invoices

    Survey receivables with customer and status filters, pagination and a computed overdue flag.

  • switch_ar_aging

    Receivables aging: total outstanding and current, 1-30, 31-60, 61-90 and 90+ day buckets.

Settlement and payables

2 tools
  • switch_create_payable

    Generate a supplier payable from call-record cost: what the operator owes a vendor.

  • switch_run_netting

    Net a counterparty receivable against payables for a period, returning the net amount and direction.

Reporting and fraud

4 tools
  • switch_analytics_overview

    Unified P&L and quality figures: revenue, cost, margin, ASR, ACD, minutes and PDD across all call records.

  • switch_analytics_breakdown

    Top-100 breakdown by customer, supplier or destination prefix to find the best and worst.

  • switch_fraud_events

    List recent fraud events with score, action, destination, reasons and customer label.

  • switch_update_fraud_settings

    Tune fraud screening: enable, block and alert score thresholds and high-risk destination prefixes.

The Switch API reference

Guardrails

An agent with a key, not a blank cheque

  • Scoped to your key

    Every tool call carries your API key and is checked on our side against its scopes. Nothing runs without one.

  • Test keys first

    A test key runs the real request through routing and pricing without delivering it or touching your live balance.

  • Spending tools say so

    Tools that move money are described to the agent as spending money, so it knows before it calls them.

Keys and scopesHow x402 top-ups workDeveloper pricing

Give your agent a carrier account

Open a free account, create a key and add one URL to your client. Your agent can price, connect and test its first route in the same session.

Get your API keyRead the API docs