bubblyphone-agents
@bubblyphone/mcp-server
MCP server for BubblyPhone — make AI phone calls, manage voice agents, and track billing from any AI assistant.
What is BubblyPhone?
BubblyPhone is a telephony platform for AI voice agents. You get a real phone number, connect an AI model (Gemini, GPT), give it a system prompt, and it handles phone calls autonomously — booking reservations, answering support questions, qualifying leads, or anything you can describe in plain English.
This MCP server lets you control all of that from any AI assistant that supports the Model Context Protocol.
Related MCP server: TELNYX MCP Server
Quick Start
Claude Desktop
Add to your config (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"bubblyphone": {
"command": "npx",
"args": ["@bubblyphone/mcp-server"],
"env": {
"BUBBLYPHONE_API_KEY": "bp_live_sk_your_key_here"
}
}
}
}Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"bubblyphone": {
"command": "npx",
"args": ["@bubblyphone/mcp-server"],
"env": {
"BUBBLYPHONE_API_KEY": "bp_live_sk_your_key_here"
}
}
}
}ChatGPT
Connect to the remote MCP server at https://agents.bubblyphone.com/mcp — authentication is handled via OAuth.
Remote (Streamable HTTP)
Connect any MCP client to https://agents.bubblyphone.com/mcp with your API key as a Bearer token.
Available Tools
Calls
Tool | Description |
| Initiate an outbound AI phone call |
| List calls with filtering |
| Get call details |
| Terminate an active call |
| Transfer a call to another number |
| Send context to an AI agent mid-call |
| Get call transcript |
| Get call event log |
Phone Numbers
Tool | Description |
| Search available numbers in 30+ countries |
| List your numbers |
| Purchase a number |
| Get number details and AI config |
| Configure AI agent settings |
Billing
Tool | Description |
| Check credit balance |
| Usage statistics |
| Transaction history |
Models & Rates
Tool | Description |
| Available AI models and pricing |
| Rate for a phone number |
| Rates by country |
Account
Tool | Description |
| Account information |
Use Cases
"Call this restaurant and make a reservation for Friday at 7pm"
"Set up a 24/7 customer support line for my business"
"Call my doctor's office and reschedule my appointment"
"Create a phone agent that qualifies sales leads"
Get Your API Key
Sign up at agents.bubblyphone.com
Go to Dashboard > API Keys
Create a new API key
Development
# Install dependencies
npm install
# Build
npm run build
# Run locally (stdio)
BUBBLYPHONE_API_KEY=your_key node dist/bin/cli.js
# Run locally (HTTP)
node dist/index.js --http --port 3100License
MIT
Available Tools
20 toolsbuy_phone_numberADestructive
Purchase a phone number. This costs money from your balance (setup fee + monthly). Use search_phone_numbers first to find available numbers.
Inputs: phone_number (required), label, webhook_url, country_code, +1 more.
get_accountARead-onlyIdempotent
Get your BubblyPhone account information including name, email, company, and balance.
Inputs: no named parameters.
get_balanceARead-onlyIdempotent
Get your current BubblyPhone credit balance in USD.
Inputs: no named parameters.
get_callARead-onlyIdempotent
Get detailed information about a specific call including status, duration, cost, and transcript.
Inputs: call_id (required).
get_call_eventsARead-onlyIdempotent
Get the detailed event log for a call with millisecond-precision timestamps. Useful for debugging call flow issues.
Inputs: call_id (required).
get_call_transcriptARead-onlyIdempotent
Get the transcript for a completed call. Returns the full conversation text and summary.
Inputs: call_id (required).
get_country_ratesBRead-onlyIdempotent
Get all calling rate prefixes and prices for a specific country.
Inputs: country_code (required).
get_phone_numberBRead-onlyIdempotent
Get details and AI agent configuration for a phone number.
Inputs: phone_number_id (required).
get_usageARead-onlyIdempotent
Get usage statistics for a time period — inbound/outbound call counts, minutes, costs, and number costs.
Inputs: period.
hangup_callADestructiveIdempotent
Terminate an active call immediately.
Inputs: call_id (required).
inject_contextA
Send a message or context into an active streaming call's AI agent. Use this to give the AI agent new information mid-call (e.g. 'The customer's order #1234 has shipped').
Inputs: call_id (required), message (required).
list_callsBRead-onlyIdempotent
List your calls with optional filtering by direction, status, phone number, and date range.
Inputs: direction, status, phone_number_id, date_from, +1 more.
list_modelsBRead-onlyIdempotent
List available AI models for phone agents with their pricing per minute.
Inputs: no named parameters.
list_phone_numbersARead-onlyIdempotent
List your owned phone numbers with their status and configuration.
Inputs: no named parameters.
list_transactionsARead-onlyIdempotent
List billing transactions — top-ups, call charges, number rentals, refunds.
Inputs: no named parameters.
lookup_rateARead-onlyIdempotent
Look up the calling rate for a specific phone number. Returns the per-minute cost.
Inputs: phone_number (required).
make_callADestructive
Initiate an outbound call from a BubblyPhone number. Costs money from your balance. For streaming mode, provide model and system_prompt to have an AI agent handle the call.
Inputs: from (required), to (required), mode, webhook_url, +7 more.
search_phone_numbersARead-onlyIdempotent
Search for available phone numbers to purchase. Filter by country, area code, or locality. Returns numbers with pricing information.
Inputs: country_code, area_code, locality, number_type, +2 more.
transfer_callADestructive
Transfer an active call to another phone number.
Inputs: call_id (required), to (required).
update_phone_numberAIdempotent
Update phone number configuration. Use this to set up or modify the AI agent — change the model, system prompt, voice, tools, webhook, and other settings.
Inputs: phone_number_id (required), label, webhook_url, mode, +14 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 20 tools
Most tools have distinct purposes, but `get_call` and `get_call_transcript` overlap significantly—both retrieve call transcripts, creating ambiguity about which to use. `get_country_rates` vs `lookup_rate` are sufficiently differentiated by scope (country-wide vs specific number).
Excellent consistency with strict snake_case and verb_noun pattern throughout (e.g., `buy_phone_number`, `list_calls`, `inject_context`). All 20 tools follow the same grammatical structure without mixing conventions.
Twenty tools is well-scoped for a telephony platform with AI agents, covering number lifecycle (search/buy/manage), call operations (make/transfer/hangup), account management, and AI controls without bloat.
Strong coverage with minor gaps. Missing `delete_phone_number` or `release_phone_number` leaves the number lifecycle incomplete (no way to stop renting). Active call controls cover essential operations (hangup, transfer, inject) but lack hold/resume functionality.
Maintenance
Related MCP Connectors
Give AI agents a phone number. Voice calls, SMS, and phone number management for MCP clients.
Lets Claude, Cursor or any MCP client build voice agents and place real phone calls.
Phone call MCP server: AI agents place and answer real calls, text, email and WhatsApp via KaiCalls.
Give AI agents real phone numbers, messages, and voice calls via MCP.
Related MCP Servers
AlicenseNot gradedqualityDmaintenanceMCP server for Saperly that enables AI agents to provision phone numbers, place calls, send SMS, and manage credentials via 36 tools backed by the Saperly API.47 npm3MIT- AlicenseNot gradedqualityDmaintenanceA comprehensive MCP server for TELNYX integration, enabling AI assistants to send SMS messages, make voice calls, and handle incoming communications via webhooks.MIT
- AlicenseNot gradedqualityBmaintenanceAn MCP server enabling AI assistants to make voice calls, send SMS/MMS, and manage group conversations using Twilio and OpenAI.21 npmMIT
- AlicenseNot gradedqualityDmaintenanceA hosted MCP server that enables AI agents to place real phone calls from a verified caller ID, with async call management and built-in safety controls.73 npm2MIT