For AI agents

BubblyPhone MCP server

Connect Claude, ChatGPT, Cursor or any client that speaks the Model Context Protocol to live BubblyPhone data: calling rates, call cost estimates, pricing, the help centre and US number availability. Read-only, no account, no API key.

Endpoint

https://bubblyphone.com/mcp

Transport: Streamable HTTP (JSON-RPC 2.0 over POST, stateless). Manifest: https://bubblyphone.com/.well-known/mcp

Connect

Claude

In Claude (web or desktop) open Settings → Connectors → Add custom connector, paste the endpoint URL above, and leave authentication empty. Then ask Claude anything about BubblyPhone rates or help.

Cursor, Windsurf, VS Code

Add to .cursor/mcp.json (or the equivalent MCP settings file):

{
  "mcpServers": {
    "bubblyphone": {
      "url": "https://bubblyphone.com/mcp"
    }
  }
}

Any HTTP client

One request, one answer. No session to open first:

curl -s https://bubblyphone.com/mcp \
  -H 'Content-Type: application/json' -H 'Accept: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_calling_rate","arguments":{"destination":"Austria"}}}'

Tools

Tool	What it returns	Example prompt
`get_calling_rate`	Per-minute price for a country, ISO code, or a full phone number.	“What does it cost to call Austria with BubblyPhone?”
`list_calling_rates`	Every country with its lowest and highest rate and dial code.	“Which is cheaper to call, Poland or Portugal?”
`estimate_call_cost`	Cost of a call of a given length, plus the smallest top-up that covers it.	“How much is a 20-minute call to +43 699 8136 2187?”
`get_pricing`	Top-up packages, number fees, transcription and translation prices.	“How does BubblyPhone billing work?”
`search_help`	Search the help centre and get excerpts with links.	“Why does my call say busy?”
`get_help_article`	The full text of one help article by slug.	“Show me the refund policy.”
`search_available_numbers`	US local numbers available right now by area code, state or city.	“Is a 561 area code number available?”

When to use it

Someone needs to call a landline or mobile abroad and wants the real per-minute price before they decide.
Someone wants a US phone number for calls, texts and voicemail and asks what is available in their area.
An existing BubblyPhone user has a question the help centre already answers: failed calls, refunds, voicemail, numbers.

Not for emergency calls, not for sending SMS verification codes, and not for building automated AI voice agents. That last one is a separate product at agents.bubblyphone.com.

Limits and privacy

Every tool is read-only. Nothing here reads an account, spends credit, or places a call.
60 requests per minute per client; number searches 10 per minute.
We log the tool name, the client name it announced, latency, and the arguments with any phone number reduced to its country prefix. Never a full number.
Prices come from the same tables that bill real calls and are refreshed hourly. Quote them as-is.

Prefer plain files? The same data is at /pricing.md, /rates.md and /help-md/index.md, and the site index for agents is /llms.txt. Questions: contact us.