# BubblyPhone Agents

Make AI phone calls from any AI assistant. BubblyPhone's MCP server lets you manage AI-powered phone agents — book reservations, schedule appointments, set up customer support lines, or have your AI …

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add bubblyphone/mcp-server

# Browse available tools
npx -y @smithery/cli@latest tool list bubblyphone/mcp-server

# Get full schema for a tool
npx -y @smithery/cli@latest tool get bubblyphone/mcp-server make_call

# Call a tool
npx -y @smithery/cli@latest tool call bubblyphone/mcp-server make_call '{}'
```

## Direct MCP Connection

Endpoint: `https://mcp-server--bubblyphone.run.tools`

## Tools (20)

- `make_call` — Initiate an outbound call from a BubblyPhone number. Costs money from your balance. For streaming mode, provide model a…
- `list_calls` — List your calls with optional filtering by direction, status, phone number, and date range.
- `get_call` — Get detailed information about a specific call including status, duration, cost, and transcript.
- `hangup_call` — Terminate an active call immediately.
- `transfer_call` — Transfer an active call to another phone number.
- `inject_context` — Send a message or context into an active streaming call's AI agent. Use this to give the AI agent new information mid-c…
- `get_call_transcript` — Get the transcript for a completed call. Returns the full conversation text and summary.
- `get_call_events` — Get the detailed event log for a call with millisecond-precision timestamps. Useful for debugging call flow issues.
- `search_phone_numbers` — Search for available phone numbers to purchase. Filter by country, area code, or locality. Returns numbers with pricing…
- `list_phone_numbers` — List your owned phone numbers with their status and configuration.
- `buy_phone_number` — Purchase a phone number. This costs money from your balance (setup fee + monthly). Use search_phone_numbers first to fi…
- `get_phone_number` — Get details and AI agent configuration for a phone number.
- `update_phone_number` — Update phone number configuration. Use this to set up or modify the AI agent — change the model, system prompt, voice, …
- `get_balance` — Get your current BubblyPhone credit balance in USD.
- `get_usage` — Get usage statistics for a time period — inbound/outbound call counts, minutes, costs, and number costs.
- `list_transactions` — List billing transactions — top-ups, call charges, number rentals, refunds.
- `list_models` — List available AI models for phone agents with their pricing per minute.
- `lookup_rate` — Look up the calling rate for a specific phone number. Returns the per-minute cost.
- `get_country_rates` — Get all calling rate prefixes and prices for a specific country.
- `get_account` — Get your BubblyPhone account information including name, email, company, and balance.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get bubblyphone/mcp-server <tool-name>
```

## Resources

- `bubblyphone://models` — Available AI models for BubblyPhone phone agents with pricing

## Prompts (2)

- `setup-agent` (country, use_case) — Guided flow to set up an AI phone agent on BubblyPhone. Walks through checking balance, searching numbers, purchasing, …
- `debug-call` (call_id) — Diagnose issues with a BubblyPhone call. Fetches call details, events, and transcript to produce a diagnostic summary.