ClawdCall

ClawdCall MCP 服务

通过 Model Context Protocol，让 AI Agent 使用 ClawdCall 面向 Agent 的电话执行 API。

clawdcall-mcp 提供 ClawdCall 已确认的工作流：

• 发送注册 OTP
• 验证注册 OTP
• 拨打预期的呼出电话
• 获取通话转录文本

托管远程服务

将兼容的远程 MCP 客户端连接到 Streamable HTTP 端点：

https://gateway.clawdcall.com/mcp/

该端点会公布 OAuth 受保护资源元数据。现有 ClawdCall 集成也可以根据Agent 文档使用 API 密钥。

本地 Stdio 软件包

将已发布的 npm 软件包添加到本地 MCP 客户端：

{
  "mcpServers": {
    "clawdcall": {
      "command": "npx",
      "args": ["-y", "clawdcall-mcp"],
      "env": {
        "CLAWDCALL_API_KEY": "your_clawdcall_api_key"
      }
    }
  }
}

呼出电话和获取转录文本需要 CLAWDCALL_API_KEY。注册 OTP 工具无需现有密钥。

用于 staging 或可自托管 API 路由：

{
  "mcpServers": {
    "clawdcall": {
      "command": "npx",
      "args": ["-y", "clawdcall-mcp"],
      "env": {
        "CLAWDCALL_API_KEY": "your_clawdcall_api_key",
        "CLAWDCALL_BASE_URL": "https://api.clawdcall.com"
      }
    }
  }
}

安全的首次测试

1. 打开 ClawdCall Agent 设置。
2. 通过兼容的 Agent 客户端连接托管端点或本地软件包。
3. 让 Agent 给你或预期的内部接收者打电话，并布置范围明确的任务。
4. 允许通话前，确认目标号码和任务。
5. 检查返回的状态、转录证据、摘要或结构化结果。

ClawdCall 不适用于陌生电话营销、自动拨号、批量外联、紧急用途、政治外联或敏感建议工作流。

可复制粘贴的示例

examples 目录包含范围明确的首次通话工作流：

• MCP 自呼叫
• OpenAI Agents SDK
• 基于 LangGraph 的 Agent
• 签名 Webhook 转电话提醒
• 航班变更决策交接

代码示例将接收者信息保存在由操作人员控制的环境变量中。Agent 生成的输入无法更改电话号码，且产生实际副作用的操作需要明确批准或选择加入。

工具

工具	已确认的端点	描述
send_signup_otp	POST /cc/signup/send-otp	发送用于注册的电话验证 OTP。
verify_signup_otp	POST /cc/signup/verify-otp	验证 OTP 并获取账户／API 密钥详情。
place_outbound_call	POST /external/v1/agent/outbound?conversionFlag=1	拨打预期的呼出语音 Agent 电话。
get_call_transcript	GET /cc/v1/calls/{id}/transcript	按通话 ID 或营销活动 ID 获取转录文本。

环境变量

变量	必需	默认值	描述
CLAWDCALL_API_KEY	通话／转录工具需要		ClawdCall API 密钥。
CLAWDCALL_BASE_URL	否	https://api.clawdcall.com	API 基础 URL。

开发

git clone https://github.com/dialgoodian/clawdcall-mcp.git
cd clawdcall-mcp
npm install
npm run dev

构建：

npm run build

运行构建好的服务：

CLAWDCALL_API_KEY=your_clawdcall_api_key npm start

发现元数据

• server.json 包含 Official MCP Registry 元数据。
• 服务卡片
• 供 Agent 阅读的文档
• OpenAPI 描述

API 契约

此服务跟踪以下面向 Agent 的 ClawdCall 端点：

• POST /cc/signup/send-otp
• POST /cc/signup/verify-otp
• POST /external/v1/agent/outbound?conversionFlag=1
• GET /cc/v1/calls/{id}/transcript

在 ClawdCall 的 API 契约中存在相应路由之前，请勿为 Agent、号码购买、SMS、对话、语音或通用 Webhook 添加 MCP 工具。

许可证

MIT