Agentphone

What is Agentphone?

Agentphone is an MCP server that gives AI agents real phone numbers, SMS, and voice calls. It integrates your AI assistant with the AgentPhone API so that agents can buy numbers, send/receive texts, place calls, and manage inbound communication—all through natural language in Cursor, Claude Desktop, or any MCP-compatible client.

How to use Agentphone?

Configure your MCP client with an API key from agentphone.to. Use the remote Streamable HTTP endpoint (https://mcp.agentphone.to/mcp) with an Authorization: Bearer <key> header, or run the local stdio server via npx -y agentphone-mcp with the AGENTPHONE_API_KEY environment variable. A self-hosted HTTP server is also available with npx agentphone-mcp --http --port 3000. After setup, simply ask your AI agent to perform phone tasks.

Key features of Agentphone

• Buy and manage phone numbers in any US/CA area code
• Send and receive SMS with full conversation history
• Place outbound voice calls with built-in AI conversation
• Handle inbound calls and texts via customizable webhooks
• Create agents with custom voices, system prompts, and voicemail
• Monitor usage, plan limits, and billing breakdowns

Use cases of Agentphone

• Create a support agent that greets callers and handles billing inquiries
• Schedule appointments by placing AI‑driven outbound calls
• Send automated SMS confirmations (e.g., “Your appointment is confirmed for 3pm tomorrow”)
• Set up real‑time webhook notifications for inbound calls and messages
• Track monthly usage and call/SMS volume across different agents

FAQ from Agentphone

What transports does Agentphone support?

Streamable HTTP (remote or self‑hosted) and stdio (local). Stdio works with Cursor, Claude Desktop, Windsurf, and Claude Code. Streamable HTTP is recommended for remote agent platforms.

How do I authenticate with Agentphone?

Provide your API key via the AGENTPHONE_API_KEY environment variable (stdio or self‑hosted HTTP) or via the Authorization: Bearer <key> header (HTTP modes).

What tools does Agentphone provide?

26 tools covering account overview, usage stats, phone number management, SMS (send, get, list conversations), voice calls (place, get details, transcripts), agent management, and webhook configuration.

Can I run Agentphone locally without hosting a server?

Yes. Use the remote hosted endpoint (https://mcp.agentphone.to/mcp) with no installation needed—just configure your MCP client with the URL and API key.

What are the runtime requirements for Agentphone?

For local stdio/HTTP modes, you need Node.js (to run npx). The remote hosted option has no local dependencies.