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