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

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
`make_call`	Initiate an outbound AI phone call
`list_calls`	List calls with filtering
`get_call`	Get call details
`hangup_call`	Terminate an active call
`transfer_call`	Transfer a call to another number
`inject_context`	Send context to an AI agent mid-call
`get_call_transcript`	Get call transcript
`get_call_events`	Get call event log

Phone Numbers

Tool	Description
`search_phone_numbers`	Search available numbers in 30+ countries
`list_phone_numbers`	List your numbers
`buy_phone_number`	Purchase a number
`get_phone_number`	Get number details and AI config
`update_phone_number`	Configure AI agent settings

Billing

Tool	Description
`get_balance`	Check credit balance
`get_usage`	Usage statistics
`list_transactions`	Transaction history

Models & Rates

Tool	Description
`list_models`	Available AI models and pricing
`lookup_rate`	Rate for a phone number
`get_country_rates`	Rates by country

Account

Tool	Description
`get_account`	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 3100

License

MIT

bubblyphone-agents