Connect Your AI

Coding Agents

Add phone calls and SMS to your coding agent. One config block — your agent can buy numbers, make calls, read texts, and manage voice AI, all through natural language.

Works with any MCP-compatible client: Claude Code, Cursor, Windsurf, Claude Desktop, and more.

Claude Code

Option A: MCP Server

$claude mcp add agentphone -- npx -y agentphone-mcp

Then set your API key:

$export AGENTPHONE_API_KEY=your_api_key_here

Option B: Skill (slash command)

$npx skills add AgentPhone-AI/skills
$export AGENTPHONE_API_KEY=your_api_key_here

Then use /agentphone in any conversation:

/agentphone buy a 415 number and create a support agent
/agentphone call +14155551234 and ask about their hours
/agentphone show me my recent SMS conversations

The MCP server gives you 26 tools that Claude Code can call autonomously. The skill wraps the same tools behind a /agentphone command. Pick whichever style you prefer.

Cursor

Add to your Cursor MCP settings (Settings > MCP or ~/.cursor/mcp.json):

~/.cursor/mcp.json
1{
2  "mcpServers": {
3    "agentphone": {
4      "command": "npx",
5      "args": ["-y", "agentphone-mcp"],
6      "env": {
7        "AGENTPHONE_API_KEY": "your_api_key_here"
8      }
9    }
10  }
11}

Restart Cursor. In Composer or Chat, try:

“Create an agent and buy it a phone number, then call me at +14155551234 to test it.”

Windsurf

Add to your Windsurf MCP configuration:

MCP config
1{
2  "mcpServers": {
3    "agentphone": {
4      "command": "npx",
5      "args": ["-y", "agentphone-mcp"],
6      "env": {
7        "AGENTPHONE_API_KEY": "your_api_key_here"
8      }
9    }
10  }
11}

Claude Desktop

Add to your Claude Desktop config:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

claude_desktop_config.json
1{
2  "mcpServers": {
3    "agentphone": {
4      "command": "npx",
5      "args": ["-y", "agentphone-mcp"],
6      "env": {
7        "AGENTPHONE_API_KEY": "your_api_key_here"
8      }
9    }
10  }
11}

What your agent can do

Once configured, your coding agent has 26 phone tools:

CategoryToolsExample prompt
Phone numbersBuy, list, release”Buy a US number with area code 212”
Voice callsMake calls, list calls, get transcripts”Call +1234567890 and ask about their return policy”
SMSRead messages, list conversations”Show me texts from the 415 number”
AgentsCreate, update, configure voice”Create a support agent with a friendly greeting”
WebhooksSet up, manage per-agent routing”Set my webhook to https://my-server.com/hook”
AccountOverview, usage stats”How many minutes have I used this month?”

Real-world examples

Customer research from your IDE

> Create an agent, buy it a number, then call these 5 restaurants
  and ask if they have availability for 8 people this Saturday:
  +14155551111, +14155552222, +14155553333, +14155554444, +14155555555
  Summarize what you find.

Test your app’s phone integration

> I just deployed a new IVR. Call +14155559999 and navigate through
  the menu — press 1 for sales, then ask about enterprise pricing.
  Tell me if anything sounds broken.

Quick SMS check while coding

> Show me any SMS messages that came in today on my agent's number.

Set up a phone agent for your project

> Read my project's README and create a voice agent that can answer
  questions about this codebase. Give it a phone number and set the
  greeting to "Hi, I'm the docs bot for [project name]."

Get your API key

Sign up at agentphone.to and grab your key from Settings.

No Twilio account, no server, no ngrok needed. Your coding agent handles everything through the API.