prepaid.ai docs
StatusOpen the console

API reference / MCP

MCP server

Connect an AI assistant to your workspace, read-only.

prepaid.ai speaks the Model Context Protocol, so an AI assistant that supports MCP — Claude, Cursor and others — can read your workspace directly.

POST/api/mcp

Streamable HTTP transport, protocol revision 2025-06-18.

Connecting#

Authenticate with the same API key you would use for REST, as a bearer token.

Client configurationjson
{
  "mcpServers": {
    "prepaid-ai": {
      "url": "https://app.prepaid.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer pk_live_your_key_here"
      }
    }
  }
}

Tools#

  • get_balance — spendable credits, in credit-hundredths.
  • list_agents — every agent, with id, name and status.
  • list_numbers — every number, with lifecycle status and the agent answering it.
  • list_calls — recent calls; takes an optional integer limit between 1 and 200.
Calling a tooljson
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_calls",
    "arguments": { "limit": 10 }
  }
}

What it deliberately cannot do#

Worth knowingEvery tool is read-only, by decision rather than omission. Nothing reachable from inside an AI session can spend credits, publish an agent, or delete anything — changes to what a real phone number says belong on a screen where a person confirms them.
NoteJSON-RPC batching is not supported: it was removed in the 2025-06-18 revision of the protocol. Send one request per POST.