How do I install the agentphone mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `AGENTPHONE_API_KEY`, `MCP_OAUTH_CLIENT_ID`, `MCP_OAUTH_CLIENT_SECRET`, `AGENTPHONE_BASE_URL` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

AgentPhone MCP Server

Give AI agents real phone numbers, messages, and voice calls via MCP.

Remote serverstreamable-httpTypeScript

What is the AgentPhone MCP Server?

Give AI agents real phone numbers, messages, and voice calls via MCP.

What it actually does

Phone numbers — — buy and manage numbers in any US/CA area code
SMS — — send and receive text messages, view conversation threads
Voice calls — — place outbound calls with built-in AI conversation (no webhook needed) or bring your own webhook
Inbound handling — — set up webhooks to receive and respond to inbound calls and texts in real time
Agents — — create agents with custom voices, system prompts, call transfer, and voicemail
Usage & billing — — monitor your plan limits, message/call volume, and daily/monthly breakdowns

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the AgentPhone MCP Server

{
  "mcpServers": {
    "agentphone": {
      "type": "streamable-http",
      "url": "https://mcp.agentphone.ai/mcp",
      "headers": {
        "Authorization": "Bearer your_api_key_here"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

Variable	Description	Required
AGENTPHONE_API_KEY	Credential the server authenticates with.	Yes
MCP_OAUTH_CLIENT_ID	Configuration value read at startup.	Optional
MCP_OAUTH_CLIENT_SECRET	Credential the server authenticates with.	Yes
AGENTPHONE_BASE_URL	Endpoint or connection string the server talks to.	Yes

Example prompts to try

“Use AgentPhone to Authentication.”
“Use AgentPhone to Environment.”
“Use AgentPhone to Account.”

Frequently asked questions

Give AI agents real phone numbers, messages, and voice calls via MCP. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.