# AgentPhone

Give AI agents phone numbers with messaging and voice calling capabilities.

## Quick Start

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

# Browse available tools
npx -y @smithery/cli@latest tool list meet/agentphone

# Get full schema for a tool
npx -y @smithery/cli@latest tool get meet/agentphone account_overview

# Call a tool
npx -y @smithery/cli@latest tool call meet/agentphone account_overview '{}'
```

## Direct MCP Connection

Endpoint: `https://agentphone.run.tools`

**Required config:**
- `AgentPhone_API_Key` (query) — Your API Key from the AgentPhone Dashboard

## Tools (26)

- `account_overview` — Get a complete snapshot of your AgentPhone account: agents, phone numbers, webhook status, and usage limits. Call this …
- `list_numbers` — List all phone numbers in your account. Each number has an ID needed by other tools (get_messages, attach_number, list_…
- `buy_number` — Purchase a new phone number. Use area_code to request a specific region (e.g. '415' for San Francisco). Tip: pass agent…
- `send_message` — Send an SMS or iMessage from one of your agent's phone numbers.
- `get_messages` — Get SMS messages for a specific phone number. Use list_numbers to find the number ID. For threaded conversations, use l…
- `list_calls` — List recent calls. Scope by agent_id or number_id, or use status/direction/search to filter globally.
- `get_call` — Get details and transcript for a specific call. Use list_calls to find call IDs. Pass wait=true to block until an in-pr…
- `make_call` — Initiate an outbound phone call.
- `make_conversation_call` — Place a phone call where the AI has an autonomous conversation about a given topic.
- `list_agents` — List all agents with their phone numbers and voice configuration. An agent is required before you can make calls — it o…
- `create_agent` — Create a new agent. An agent owns phone numbers and handles calls/SMS.
- `update_agent` — Update an agent's configuration — name, description, voice settings, system prompt, greeting, call transfer, or voicema…
- `delete_agent` — Delete an agent permanently. Phone numbers attached to it will be kept but unassigned.
- `get_agent` — Get details for a specific agent including its phone numbers, voice configuration, and system prompt.
- `attach_number` — Attach a phone number to an agent so the agent handles calls/SMS on that number. Use list_numbers to find unassigned nu…
- `detach_number` — Detach a phone number from an agent. The number is kept in your account but becomes unassigned. Use list_agents or get_…
- `list_voices` — List available voices for agents. Use the voice_id value when calling create_agent or update_agent.
- `list_conversations` — List SMS conversations. Optionally filter by agent_id to see conversations for a specific agent.
- `get_conversation` — Get a specific SMS conversation with message history. Use list_conversations to find IDs.
- `update_conversation` — Set metadata on a conversation. Use this to store custom state, tags, or context that persists between messages. Pass n…
- `get_usage` — Get account usage statistics. By default returns a summary with plan limits, quotas, and message/call volume. Use break…
- `get_webhook` — Get the webhook configuration. Pass agent_id to get an agent-specific webhook, or omit for the project-level default.
- `set_webhook` — Set a webhook URL to receive inbound messages and call events.
- `delete_webhook` — Remove a webhook. Pass agent_id to remove an agent's webhook (falls back to project default). Omit agent_id to remove t…
- `test_webhook` — Send a test event to verify a webhook is working. Returns the HTTP status code and response time.
- `list_webhook_deliveries` — View recent webhook delivery history. Shows which events were delivered, HTTP status codes, and timing.

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