代理电话MCP服务器
通过以下方式为AI代理提供真实的电话号码、短信和语音通话 模型上下文协议.
代理 电话 让您的AI代理购买电话号码、发送/接收短信和拨打语音电话——所有这些都可以通过Cursor、Claude Desktop或任何兼容MCP的客户端中的自然语言完成。
代理 是核心概念——每个代理都有自己的电话号码、语音个性、系统提示和webhook。将代理想象成一个拥有自己电话线的虚拟团队成员。您可以为不同的目的（支持、销售、日程安排）创建代理，并配置它们在通话中的声音和行为。
快速开始
1.获取API密钥
注册地址： 代理电话.ai 并从创建API密钥 设置.
2.通过MCP连接
选项A：远程服务器（推荐）
将MCP客户端指向托管端点——无需安装：
{
"mcpServers": {
"agentphone": {
"type": "streamable-http",
"url": "https://mcp.agentphone.ai/mcp",
"headers": {
"Authorization": "Bearer your_api_key_here"
}
}
}
}适用于支持流式HTTP传输的任何MCP客户端（交换机、远程代理平台等）。
选项B：本地服务器（stdio）
通过以下方式在本地运行 npx --适用于Cursor、Claude Desktop、Windsurf和Claude Code：
光标： 设置>MCP或 ~/.cursor/mcp.json 克劳德桌面： ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）
{
"mcpServers": {
"agentphone": {
"command": "npx",
"args": ["-y", "agentphone-mcp"],
"env": {
"AGENTPHONE_API_KEY": "your_api_key_here"
}
}
}
}选项C：自托管HTTP服务器
运行您自己的HTTP MCP端点：
AGENTPHONE_API_KEY=your_api_key npx agentphone-mcp --http --port 3000然后连接到 http://localhost:3000/mcp.
它能做什么？
配置后，只需询问您的AI代理以下问题：
- *“给我买一个415区号的电话号码”*
- *“创建一个支持代理来问候来电者并帮助计费”*
- *“致电+14155551234，就安排牙医预约进行对话”*
- *“短信+14155551234，内容为'您的预约已确认为明天下午3点'”*
- *“显示我最近的通话和记录”*
- *“列出可用的声音并将我的代理切换到其他声音”*
- *“设置一个webhook，这样当有人给我打电话或发短信时，我会收到通知”*
- *“显示本月的使用情况明细”*
运输
| 传输 | 命令 | 用例 |
|---|---|---|
| 流式HTTP （远程） | https://mcp.agentphone.ai/mcp | 代理平台（交换机等）、远程客户端 |
| 流式HTTP （自托管） | npx agentphone-mcp --http --port 3000 | 您自己的基础设施 |
| 标准 （默认） | npx agentphone-mcp | 光标，克劳德桌面，风帆，克劳德代码 |
认证
- 标准 ： API密钥通过
AGENTPHONE_API_KEY环境变量 - HTTP（自托管）： API密钥通过env var或
Authorization: Bearer每个请求的标头 - HTTP（托管）： API密钥通过
Authorization: Bearer每个请求的标头
端点（HTTP模式）
| 方法 | 路径 | 描述 |
|---|---|---|
POST | /mcp | MCP流式HTTP端点（无状态——每个请求都是独立的） |
GET | /health | 健康检查 |
亮点
- 电话号码 --购买和管理任何美国/加利福尼亚区号中的号码
- 短信 --发送和接收短信，查看对话线程
- 语音通话 --使用内置AI对话进行出站呼叫（无需webhook）或携带自己的webhook
- 入境处理 --设置webhooks以实时接收和响应呼入电话和短信
- 代理 --使用自定义语音、系统提示、呼叫转移和语音邮件创建代理
- 使用和计费 --监控您的计划限额、消息/呼叫量以及每日/每月明细
所有工具（26）
账户
| 工具 | 说明 |
|---|---|
account_overview | 获取您帐户的完整快照——代理、号码、webhook和使用情况 |
get_usage | 获取使用统计数据、计划限制和配额。使用 breakdown 用于每日或每月的时间序列。 |
电话号码
| 工具 | 说明 |
|---|---|
list_numbers | 列出您帐户中的所有电话号码 |
buy_number | 购买带有可选功能的新电话号码 area_code 和 agent_id |
短信
| 工具 | 说明 |
|---|---|
send_message | 从您的代理号码之一发送短信 |
get_messages | 获取特定号码的消息 |
list_conversations | 列出短信对话。通过 agent_id 按代理过滤。 |
get_conversation | 获取包含完整消息历史记录的对话 |
update_conversation | 在对话中设置元数据 |
语音呼叫
| 工具 | 说明 |
|---|---|
list_calls | 列出通话记录。筛选依据 agent_id, number_id、状态、方向或关键字。 |
get_call | 获取通话详情和记录 |
make_call | 发出出站呼叫（webhook驱动） |
make_conversation_call | 使用内置AI对话拨打电话——无需webhook |
代理
| 工具 | 说明 |
|---|---|
list_agents | 列出所有代理及其号码和语音配置 |
create_agent | 使用语音、系统提示、呼叫转移和语音邮件创建新代理 |
update_agent | 更新代理的配置 |
delete_agent | 删除代理（保留数字但未分配） |
get_agent | 获取代理详细信息，包括电话号码和语音配置 |
attach_number | 为代理分配电话号码 |
detach_number | 从代理中删除电话号码 |
list_voices | 列出代理的可用声音 |
网络钩子
所有webhook工具都接受可选 agent_id --传递它以管理特定于代理的webhook，在项目级默认值中省略它。代理webhooks的优先级高于项目级别。
| 工具 | 说明 |
|---|---|
get_webhook | 获取webhook配置 |
set_webhook | 为入站消息和呼叫事件设置webhook URL |
delete_webhook | 删除webhook |
test_webhook | 发送测试事件以验证您的webhook是否正常工作 |
list_webhook_deliveries | 查看调试的交付历史记录 |
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
AGENTPHONE_API_KEY | stdio:yes，HTTP:no | 您的AgentPhone API密钥（HTTP模式可以使用授权头） |
AGENTPHONE_BASE_URL | 否 | 覆盖API基础URL（默认为 https://api.agentphone.ai) |
PORT | 否 | HTTP模式端口（默认为 3000，被覆盖 --port) |
发展
git clone https://github.com/AgentPhone-AI/agentphone-mcp.git
cd agentphone-mcp
npm install
npm run dev # Run with tsx (hot reload)
npm run build # Compile TypeScript
npm start # Run compiled JS (stdio)运作原理
此MCP服务器将您的AI助手连接到 代理电话API.您的助手与MCP服务器通话，后者调用AgentPhone API，后者与电话网络通话。
Your AI Assistant agentphone-mcp AgentPhone API Phone Network出站：您的助理通过AgentPhone的API拨打电话并发送短信。
入站：当有人打电话或发短信给你的号码时，AgentPhone会向你的服务器发送一个webhook事件——然后你可以以编程方式响应，或者让你的代理的内置AI处理它。
许可证
麻省理工学院