# AgentPhone

Gives AI assistants real phone lines for voice calls and text messaging. Handy when your agent needs to dial clients or process SMS.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 124
- Author: AgentPhone-AI
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/AgentPhone-AI/agentphone-mcp
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/agentphone

## What it does

The server links MCP clients with the AgentPhone telecom backend. With 28 provided tools, an assistant can purchase North American numbers, send text dispatches, trigger outbound voice conversations, and catch incoming calls with webhooks. Each virtual agent can have its own voice style, dedicated prompt, and call forwarding logic.

You can skip local installs via the hosted endpoint `https://mcp.agentphone.ai/mcp`. Another option runs locally through `npx` using an `AGENTPHONE_API_KEY`. The platform handles authentication through bearer tokens or OAuth with PKCE verification.

On self-hosted setups, `AGENTPHONE_ALLOW_ANONYMOUS=true` gives full account control to anyone who reaches the open port. You must have an active account and API key from `agentphone.ai` to handle calls.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.agentphone.ai/mcp`
- Environment variables: `AGENTPHONE_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI**
```bash
claude mcp add agentphone -e AGENTPHONE_API_KEY=<AGENTPHONE_API_KEY> -- npx -y agentphone-mcp
```
Replace <…> with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http agentphone https://mcp.agentphone.ai/mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add agentphone --url https://mcp.agentphone.ai/mcp
```

2. **Platform CLI**
```bash
codex mcp add agentphone --env AGENTPHONE_API_KEY=<AGENTPHONE_API_KEY> -- npx -y agentphone-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "agentphone": {
            "url": "https://mcp.agentphone.ai/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "agentphone": {
            "command": "npx",
            "args": [
                "-y",
                "agentphone-mcp"
            ],
            "env": {
                "AGENTPHONE_API_KEY": "<AGENTPHONE_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "agentphone": {
            "type": "http",
            "url": "https://mcp.agentphone.ai/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "agentphone": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "agentphone-mcp"
            ],
            "env": {
                "AGENTPHONE_API_KEY": "<AGENTPHONE_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http agentphone https://mcp.agentphone.ai/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e AGENTPHONE_API_KEY=<AGENTPHONE_API_KEY> agentphone npx -y agentphone-mcp
```
Replace <…> with your own values

## When to use it
- purchase telephone numbers in US and Canadian area codes
- dispatch outbound SMS messages and view reply threads
- run conversational voice calls with custom agent personas
- track monthly usage breakdowns across calls and texts

## Example prompts
- Buy a new phone number in the 415 area code for our support line
- Send an SMS to +14155551234 confirming our meeting tomorrow at 3 PM
- Call +14155551234 and handle the appointment scheduling discussion

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md