JobXDubai Mcp Server

@bubblyphone/mcp-server

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

[](https://www.npmjs.com/package/@bubblyphone/mcp-server) [](https://opensource.org/licenses/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.

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

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: JobXDubai
• Source: JobXDubai/mcp-server
• License: MIT

Install and usage instructions live in the source repository linked above.