Skip to main content
Glama

@bubblyphone/mcp-server

MCP server for BubblyPhone — make AI phone calls, manage voice agents, and track billing from any AI assistant.

npm version License: MIT

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

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

  1. Sign up at agents.bubblyphone.com

  2. Go to Dashboard > API Keys

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

Available Tools

20 tools
buy_phone_numberA
Destructive

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_accountA
Read-onlyIdempotent

Get your BubblyPhone account information including name, email, company, and balance.

Inputs: no named parameters.

get_balanceA
Read-onlyIdempotent

Get your current BubblyPhone credit balance in USD.

Inputs: no named parameters.

get_callA
Read-onlyIdempotent

Get detailed information about a specific call including status, duration, cost, and transcript.

Inputs: call_id (required).

get_call_eventsA
Read-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_transcriptA
Read-onlyIdempotent

Get the transcript for a completed call. Returns the full conversation text and summary.

Inputs: call_id (required).

get_country_ratesB
Read-onlyIdempotent

Get all calling rate prefixes and prices for a specific country.

Inputs: country_code (required).

get_phone_numberB
Read-onlyIdempotent

Get details and AI agent configuration for a phone number.

Inputs: phone_number_id (required).

get_usageA
Read-onlyIdempotent

Get usage statistics for a time period — inbound/outbound call counts, minutes, costs, and number costs.

Inputs: period.

hangup_callA
DestructiveIdempotent

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_callsB
Read-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_modelsB
Read-onlyIdempotent

List available AI models for phone agents with their pricing per minute.

Inputs: no named parameters.

list_phone_numbersA
Read-onlyIdempotent

List your owned phone numbers with their status and configuration.

Inputs: no named parameters.

list_transactionsA
Read-onlyIdempotent

List billing transactions — top-ups, call charges, number rentals, refunds.

Inputs: no named parameters.

lookup_rateA
Read-onlyIdempotent

Look up the calling rate for a specific phone number. Returns the per-minute cost.

Inputs: phone_number (required).

make_callA
Destructive

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_numbersA
Read-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_callA
Destructive

Transfer an active call to another phone number.

Inputs: call_id (required), to (required).

update_phone_numberA
Idempotent

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

    A3.9/5.0

    Scored across 20 tools

    Disambiguation4/5

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

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP 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 npm
      3
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A comprehensive MCP server for TELNYX integration, enabling AI assistants to send SMS messages, make voice calls, and handle incoming communications via webhooks.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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 npm
      2
      MIT