Skip to content
Markets open
Sign in
A developer typing at a laptop beside a large monitor in a lamp-lit studio in the evening
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. 33 tools, scoped to your API key.

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. 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. 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. 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.

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

Set PACKETEXCHANGE_API_KEY (or PX_AUTH_HEADER) to your key. It is sent as an Authorization header on the connection and never passes through the chat. Endpoint: https://packetexchange.io/mcp/http (Streamable HTTP). Clients that only speak SSE use https://packetexchange.io/mcp/sse through mcp-remote --transport sse-only.

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 page

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.

wmmn_list_routes

Search marketplace routes by destination, traffic type, price ceiling and ASR floor.

country · type · max_price · min_asr · cli_type · route_type · search · sort · limit

wmmn_route_details

Full details for one route: price, billing increment, the quality its seller states and its Exchange Score.

route_id

wmmn_market_summary

Marketplace totals - route counts, price ranges and activity by traffic type.

no parameters

wmmn_resolve_route

Preview which route Smart Routing would pick for a destination, with ranked alternatives - free, no traffic.

to · type · strategy

wmmn_purchase_route

Connect a route to your account - no upfront cost, SIP credentials issued in the response.

route_id

wmmn_list_purchases

List the routes you have connected, with status and SIP credentials. Needs a full-access key.

no parameters

wmmn_send_sms

Send a real SMS over your routes, Smart-Routed or pinned, with segment count and cost returned.

to · from · message · route_id · strategy

wmmn_make_call

Place a real outbound call that can speak text, play an MP3 and collect keypad digits. Returns the outcome and exact cost, or the call id while it is still running.

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

wmmn_get_call

Read one call: live status, duration, exact cost, the hangup reason in plain words and any digits the callee pressed.

call_id

wmmn_send_voice_otp

Call a number and read a one-time passcode digit by digit, repeated, then hang up. Billed like any API call, no speech surcharge.

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

wmmn_verify_start

Send a verification code by SMS or voice call. Only a hash of the code is kept; returns a verification id.

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

wmmn_verify_check

Check the code a user entered: approved, denied, expired or max_attempts. Single use, five attempts.

verification_id · code

wmmn_get_balance

Read your prepaid balance and test credit.

no parameters

wmmn_list_transactions

Recent billing transactions - charges, credits and top-ups for your account.

no parameters

wmmn_topup_x402

Fund your balance with USDC over the x402 protocol - the agent signs a payment and the balance is credited.

amount_usd · payment_header

See the REST API behind every tool
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 & 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 dialed number - matched rule, block verdict and ordered failover chain.

switch_set_route_plan_entries

Replace a route group with an ordered supplier list - 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 & AR

3 tools
switch_create_invoice

Generate an itemized AR invoice for a customer from settled CDR usage and emit invoice.created.

switch_list_invoices

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

switch_ar_aging

AR aging summary - total outstanding and current / 1-30 / 31-60 / 61-90 / 90+ buckets.

Settlement & AP

2 tools
switch_create_payable

Generate a supplier AP payable from CDR seller-credit cost - what the operator owes a vendor.

switch_run_netting

Net a counterparty AR against AP for a period, returning net amount and direction.

Reporting & Fraud

4 tools
switch_analytics_overview

Unified P&L and quality KPIs - revenue, cost, margin, ASR, ACD, minutes and PDD across all CDR.

switch_analytics_breakdown

Top-100 metric breakdown by customer, supplier or destination prefix to find 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 scopes How x402 top-ups work Developer 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 key Read the API docs