Check prices and balance
Ask what a call or SMS to any country costs, and how much balance is left.
Connect Claude Code, Cursor, VS Code or another MCP client to your account. Your agent can check prices and balance, send SMS, place calls with your caller ID, run text-to-speech calls and look up numbers, using your API key.
Ask in plain words. The agent picks the right tool.
Ask what a call or SMS to any country costs, and how much balance is left.
Send an SMS with your sender ID, on the cheapest route or one you pick.
Place a call that shows the caller ID you choose, set how long it rings and check whether it was answered.
Call a number and read out a message in the voice and language you pick.
Get a free quote, then run a live HLR lookup to see which numbers are active.
Claude Code, Cursor, VS Code, Claude Desktop or any MCP client that supports custom headers.
Thirteen tools. Nine are free, four cost money.
get_account The account behind the key: username, balance and status.get_balance Your current balance in euros.get_prices Per-minute call prices and per-part SMS prices, for one country or all.list_sms_routes The SMS routes you can send on, with their prices for a country.list_tts_voices The voices available for text-to-speech calls.get_tts_call Status, duration and cost of a text-to-speech call.hlr_quote Checks a list of numbers and says what an HLR lookup would cost, without looking them up.get_call Status of one call (dialing, ringing, answered, completed, busy, no answer or failed) with its duration, billed time and cost.list_calls Your calls, newest first, with status, duration and cost.send_sms Sends one SMS with your sender ID, at the route price per message part.make_spoof_call Places a call that shows the caller ID you choose. Only answered calls are billed, at the destination's per-minute price.tts_call Calls a number and speaks your text with a synthetic voice, billed per minute.hlr_lookup Checks if numbers are live, which network they are on and whether they were ported, €0.01 per number with a result.Endpoint https://app.spoofcallerid.com/mcp, streamable HTTP, with your API key in the Authorization header. No OAuth.
Run this in your terminal, with your own key in place of <api_key>:<api_secret>.
claude mcp add --transport http spoofcallerid https://app.spoofcallerid.com/mcp --header "Authorization: Bearer <api_key>:<api_secret>"The button opens Cursor with the server ready to install. Replace <api_key>:<api_secret> with your key after installing, or add this to ~/.cursor/mcp.json:
{
"mcpServers": {
"spoofcallerid": {
"url": "https://app.spoofcallerid.com/mcp",
"headers": {
"Authorization": "Bearer <api_key>:<api_secret>"
}
}
}
}The button opens VS Code with the server ready to install. Replace <api_key>:<api_secret> with your key, or add this to .vscode/mcp.json; VS Code then asks for the key once and stores it safely:
{
"servers": {
"spoofcallerid": {
"type": "http",
"url": "https://app.spoofcallerid.com/mcp",
"headers": {
"Authorization": "Bearer ${input:spoofcallerid-key}"
}
}
},
"inputs": [
{
"type": "promptString",
"id": "spoofcallerid-key",
"description": "Spoof Caller ID API key as <api_key>:<api_secret>",
"password": true
}
]
}Claude Desktop connects through mcp-remote, which needs Node.js 18 or newer. Add this to claude_desktop_config.json and restart Claude Desktop:
{
"mcpServers": {
"spoofcallerid": {
"command": "npx",
"args": [
"mcp-remote",
"https://app.spoofcallerid.com/mcp",
"--header",
"Authorization:${AUTH_HEADER}"
],
"env": {
"AUTH_HEADER": "Bearer <api_key>:<api_secret>"
}
}
}
}Use these settings in any MCP client that supports remote servers with a custom header:
URL: https://app.spoofcallerid.com/mcp
Type: streamable HTTP
Header: Authorization: Bearer <api_key>:<api_secret>The server is listed in the official MCP Registry as com.spoofcallerid/spoofcallerid.
Get your key in the app under Account → API & keys. API documentation
What you can ask, and what happens.
What does a 5-minute call to Germany cost?
The agent calls get_prices for Germany and works out the cost from the per-minute price. Free.
How much balance do I have left?
The agent calls get_balance. Free.
Send an SMS to +44 7700 900123 from 'MyShop' saying 'Your order has shipped'.
The agent can check routes with list_sms_routes, then calls send_sms. This costs the route price per message part. The sender name shows where the route allows it. The number is only an example.
Check which of these numbers are live: …
The agent calls hlr_quote to show the cost first (free), then hlr_lookup, which costs €0.01 per number with a result, up to 100 numbers per call.
Call +44 7700 900123 with my caller ID, let it ring 10 seconds, and tell me if they answered.
The agent calls make_spoof_call with ring_timeout 10, then get_call to read the status. If nobody answers, the call costs nothing. The number is only an example.
Call this number and say 'Your appointment is tomorrow at 10' in a German voice.
The agent picks a voice with list_tts_voices, starts tts_call (billed per minute) and can follow it with get_tts_call.
A local version for Node.js 18 or newer is also available: spoofcallerid-mcp.mjs. It has six core tools.
Any MCP client that can connect to a remote server over streamable HTTP and send a custom Authorization header, such as Claude Code, Cursor and VS Code. Claude Desktop connects through mcp-remote.
No. The server uses your API key: send Authorization: Bearer <api_key>:<api_secret> with each request. Listing the tools needs no key; every tool call does.
Only the four paid tools cost money, and the server asks the assistant to confirm with you first, but whether it does depends on your client. To rule out spending, give the agent a key with only the read scope.
There is no separate fee for the MCP server. Paid tools are charged at the same prices as the dashboard, and the free tools cost nothing.
Yes. A one-file local server for Node.js 18 or newer is available. It has six core tools: get_account, get_balance, get_prices, send_sms, make_spoof_call and get_call.
Create an account, top up from €50 with crypto and create an API key for your agent.
Create accountChanging the caller ID is legal in many countries for legitimate uses such as privacy or calling on behalf of a business, and illegal when used to defraud or harass. You are responsible for following the law where you and the people you call are.
Related: API · Call cost calculator · Phone number checker · HLR lookup
Copy
Copied