clawcall

@clawcall/mcp

重要

旧版本地传输方式。 新集成应使用 ClawCall 托管的 OAuth MCP 连接器：https://api.clawcall.dev/mcp。此 stdio 包仍可用于现有的本地/API 密钥安装，但它不是提交给官方 xAI 市场的连接器。

用于 AI 驱动的美国电话呼叫的 ClawCall REST API MCP 服务。

ClawCall 会在美国拨打真实的外呼电话（仅限 +1）。此包是一个 stdio MCP 服务，将 ClawCall REST 接口封装为工具，供任何 MCP 宿主（Claude Code、Claude Desktop、Cursor、Windsurf）调用。它是基于 https://api.clawcall.dev 公共 API 的无状态客户端，不会导入 ClawCall 服务中的任何内容。

安装 / 注册

将服务添加到 MCP 客户端配置中：

{ "mcpServers": { "clawcall": { "command": "npx", "args": ["-y", "@clawcall/mcp"], "env": { "CLAWCALL_API_KEY": "optional", "CLAWCALL_BASE_URL": "https://api.clawcall.dev" } } } }

或者，在 Claude Code 中使用这条命令：

claude mcp add clawcall -- npx -y @clawcall/mcp

env 块是可选的。ClawCall 服务会在首次调用时自动配置 API 密钥：匿名调用 place_call 时会自动签发一个 proto-key，并由此服务捕获并持久化。你无需设置 CLAWCALL_API_KEY 即可开始使用。

身份共享

此 MCP 服务会读取和写入与 ClawCall Agent 技能使用的同一个 ~/.config/clawcall/key.json 文件（{ "api_key": "...", "user_phone_number": "..." }）。同时运行该技能和此 MCP 服务不会拆分你的身份：它们共用一个密钥、一份试用额度、一份通话记录和一个余额。

如果环境中设置了 CLAWCALL_API_KEY，它会覆盖文件中的密钥（供运维人员 / CI 使用）。除此之外，保存的文件是唯一可信来源；首次通话时签发的 proto-key 会自动持久化到该文件中（并保留已保存的 user_phone_number）。

工作流

一次通话会持续几分钟。关键流程如下：

1. place_call — 立即返回 call_id，不会阻塞。
2. 每隔 3 秒轮询一次 get_call，直到 lifecycle === "finalized"。
3. outcome 表示电话网络结果（answered / no_answer / busy / …），而不是任务是否成功。即使电话已接通，任务仍可能失败。
4. 使用 get_call_transcript 读取转录文本，并根据你设定的任务进行判断。

选择工具

• place_call_and_wait 是用于单个前台通话的快捷方式：它会发起通话，并在内部轮询，直到通话结束或达到硬性时限（约 180 秒，上限 240 秒）。达到时限后，它会退化为非阻塞模式——返回 { still_running: true, call_id, … }，你可以继续调用 get_call。如果你想一次性获取单个通话的结果，请使用此工具。
• Campaigns — 对于 3–4 个并行且可互换、仅用于收集信息的通话（报价、可用情况、库存、政策比较），请使用 place_call + get_call 扇出。切勿在 Campaign 中使用阻塞工具。切勿并行拨打会进行预订 / 购买 / 取消 / 承诺的电话。

注意事项

• greeting 不会设置 Agent 首句说的话。 它仅用于提供外呼开场背景。Agent 实际的开场白是服务端硬编码的录音提示。
• 402 错误表示永久性限制，不能重试。 trial_exhausted、plan_required 和 reserved_number_required 表示必须由人工处理。请原样转发返回的 action.url / sign_in_url（它们是个性化链接，且包含你的 proto-key）。不要重试。

试用限制从错误封套中的实时 quota 对象读取，不会在此包中硬编码，因此显示的数值始终与服务端一致。

环境变量

变量	默认值	用途
CLAWCALL_BASE_URL	https://api.clawcall.dev	ClawCall REST API 基础 URL。
CLAWCALL_FRONTEND_URL	https://clawcall.dev	用于构建登录／账户关联 URL 的前端基础 URL。
CLAWCALL_API_KEY	(unset)	可选的运维人员覆盖值。优先于已保存的密钥文件。
CLAWCALL_WAIT_DEFAULT	180	place_call_and_wait 的默认上限（秒）。
CLAWCALL_WAIT_CEILING	240	place_call_and_wait 允许的最长上限（秒）。

更多信息

• skill-companion/MCP-COMPANION.md — ClawCall 技能的配套说明， 描述两者如何共享身份和工作流。
• ../skill/SKILL.md — ClawCall Agent 技能（程序化层；此 MCP 服务是基于相同 REST API 的连接层）。