KaiCalls

KaiCalls MCP 服务

配有秘书的商务电话线路：获取一个号码、接听漏接来电、记录留言并查看通话。

获取一个内置 Kai 的商务号码（或保留现有号码）。你的电话会先响铃；Kai 会接听漏接来电和非工作时间的来电，记录详细信息并发短信给你。查看 当前套餐和价格。 此仓库是托管式 KaiCalls MCP 服务的公开连接器定义——它记录了端点、身份验证方式和工具目录，方便 MCP 客户端和目录发现并连接该服务。

KaiCalls 平台本身是托管式 SaaS，无需安装服务器。你只需使用 KaiCalls 账户连接下方的在线端点。

MCP 端点	https://www.kaicalls.com/api/mcp
传输方式	Streamable HTTP（通过 HTTP POST 传输 JSON-RPC）
身份验证	OAuth 2.1（PKCE S256 + DCR）或 kc_live_ API 密钥（作为 Bearer 传递）
设置端点	https://www.kaicalls.com/api/mcp/acquisition（仅用于首次购买者的设置子集）
工具	账户端点上有 87 个（46 个只读，41 个写入/设置）；设置端点上有 37 个
主页	KaiCalls
提供方	KaiCalls · [email protected]
许可证	MIT（连接器定义和文档）
状态	GA — 已在生产环境上线

---

快速解答

什么是 KaiCalls MCP 连接器？ 这是 KaiCalls 官方托管式 MCP 连接器。现有客户使用 https://www.kaicalls.com/api/mcp；首次购买者可以使用仅用于设置的端点 https://www.kaicalls.com/api/mcp/acquisition。

谁适合使用？ 当 Claude、ChatGPT、Cursor、MCP 网关或其他 AI 客户端需要安全地查看 KaiCalls Agent、通话、转录文本、潜在客户、分析数据和已批准的设置操作时，可以使用它。

需要自行托管服务器吗？ 不需要。KaiCalls 托管 MCP 服务。客户端使用 OAuth 或受限范围的 KaiCalls API 密钥连接生产端点。

这是 WordPress 插件吗？ 不是。已获批准的 KaiCalls AI Intake plugin 可从 WordPress 网站收集潜在客户信息。此代码库记录的是 Agent/MCP 连接器。

这是 n8n 集成吗？ 不是。n8n 工作流应使用 n8n-nodes-kaicalls。

---

快速连接

Claude（网页和桌面版）/ ChatGPT

添加自定义连接器，指向现有账户的 https://www.kaicalls.com/api/mcp，或指向用于设置的 acquisition 端点。使用 KaiCalls 账户登录，在授权界面选择企业，然后点击 Allow。截图和各客户端的操作步骤请参阅 docs/quickstart.md。

API 密钥客户端 / MCP 网关

直接传递 KaiCalls API 密钥，无需 OAuth 往返流程：

Authorization: Bearer kc_live_xxxxxxxxxxxxxxxxxxxx

（也接受 X-KaiCalls-API-Key: kc_live_...。）在 KaiCalls 控制面板的 Settings → API Keys 下生成密钥。请参阅 docs/authentication.md。

Cline / 远程 MCP 客户端

KaiCalls 是远程服务，无需克隆或安装任何内容。在 MCP 客户端配置中将其添加为 Streamable HTTP 服务，并使用 kc_live_ 密钥进行身份验证。 对于 Cline，请编辑 cline_mcp_settings.json（或使用 Remote Servers 标签页）并添加：

{
  "kaicalls": {
    "url": "https://www.kaicalls.com/api/mcp",
    "type": "streamableHttp",
    "headers": { "Authorization": "Bearer kc_live_YOUR_KEY" }
  }
}

将 kc_live_YOUR_KEY 替换为 KaiCalls 控制面板 Settings → API Keys 下的密钥。传输类型必须是驼峰式字符串 streamableHttp——使用 streamable-http 或省略此项会使 Cline 回退到 SSE，导致连接失败并返回 405。保存后，Cline 会列出 KaiCalls 工具，即可开始使用。完整的 Agent 引导设置步骤请参阅 llms-install.md。

---

Gemini CLI 和 Antigravity

gemini extensions install https://github.com/KaiCalls/kaicalls-mcp
agy plugin install https://github.com/KaiCalls/kaicalls-mcp

两者都会连接到托管服务 https://www.kaicalls.com/api/mcp，并在首次运行工具时通过 OAuth 登录。

通过 stdio 在本地运行（Docker）

大多数客户端应连接到托管服务 https://www.kaicalls.com/api/mcp。对于仅支持 stdio 的客户端，此仓库提供了一个无需依赖项的小型桥接程序：

docker build -t kaicalls-mcp .
docker run -i --rm -e KAICALLS_API_KEY=kc_live_... kaicalls-mcp
# or without Docker: KAICALLS_API_KEY=kc_live_... node stdio-proxy.mjs

无需密钥即可使用 initialize 和 tools/list。tools/call 需要 KAICALLS_API_KEY，你可以在 https://www.kaicalls.com/dashboard/settings/api-keys 创建该密钥。

工具

账户端点提供 87 个工具：46 个只读工具和 41 个写入／设置工具。每个工具都带有 MCP 安全注释（readOnlyHint、destructiveHint、idempotentHint、openWorldHint）。 设置端点（/api/mcp/acquisition）提供了 设置界面 列中标记为 Yes 的 37 个工具，这些工具可帮助新业务从注册到拥有可用号码。包含完整说明、作用域和注释的机器可读清单位于 mcp.json 和 server-card.json 中。核心工具的深入说明见 docs/tools.md。实时的 tools/list 响应会返回每个工具的输入架构。

只读工具（46）

工具	范围	设置界面	功能说明
get_extra_number_status	numbers:read	是	读取经所有者授权的额外号码申请。
get_setup_recovery_status	numbers:read	是	根据所属企业和幂等键，读取经所有者授权的设置恢复申请。
check_call_status	calls:read		根据通话 ID 检查通话状态
list_recent_calls	calls:read		列出已认证企业的近期通话
get_transcript	calls:read		获取已完成通话的转录文本和摘要
get_call_recording	calls:read		获取通话的真实录音 URL，方便审核人员收听语音／音频，而非仅依赖转录文本。
list_agents	agents:read	是	列出已认证账户中的 KaiCalls Agent。
get_business_info	agents:read	是	读取企业已有信息：资料详情、已配置的 Agent 数量和近期通话量。
get_operational_settings	agents:read	是	审核更改线上账户前所需的企业级运营设置：员工提醒接收人、短信／电子邮件提醒开关、升级规则、可发送短信的发送链接条目，以及已分配 Agent 的语音／模型／问候语元数据。
get_activation_status	agents:read	是	读取一个可访问企业已持久化的证明优先激活状态。
list_leads	calls:read		列出已认证企业的潜在客户，可选按状态／来源／Agent 筛选。
get_lead	calls:read		根据 ID 获取单个潜在客户的完整详情，包括最新的 AI 潜在客户评分和说明。
list_voicemails	calls:read		列出已认证企业的近期语音留言，包括转录文本和录音 URL。
list_sms_messages	calls:read		列出已认证企业的近期短信。
list_campaigns	calls:read		列出已认证企业的外呼活动。
list_workflow_templates	calls:read		列出 KaiCalls 可运行的跟进／活动工作流模板（标准、积极、培育、自定义），包括每个模板的重试间隔、默认设置（通话时段、日期、尝试次数）以及可直接使用的 cadence_config 示例。
get_analytics	calls:read		获取近期时间段内的仪表板摘要（按状态划分的潜在客户数量、转化率、通话量和时长、排名靠前的 Agent，以及按类型划分的企业成效）。
get_usage	events:read	是	列出调用方账户近期的 API 使用事件（端点、方法、状态码、费用）。
list_plans	billing:read	是	读取 KaiCalls 官方公开套餐目录、每月 USD 价格和额度。
get_checkout_status	billing:read	是	读取 Stripe 已验证的、由您拥有的企业的订阅结账收据。
get_balance	billing:read		获取可访问企业的套餐条款和用量。
list_numbers	numbers:read	是	列出分配给可访问企业的电话号码及其功能和合规标记。
get_phone_flow	numbers:read	是	读取企业托管电话系统的来电响铃方式：哪些手机和桌面电话会响铃、响铃秒数，以及非工作时间来电是否会直接转接至 AI 接待员。
get_phone_system_status	numbers:read	是	读取企业托管电话系统的设置状态：Kai 的分机、团队响铃组和拨号计划 ID（绝不包含密钥）、电话系统线路，以及 next_step——转达给所有者的一句话。
list_conversations	sms:read		列出已认证企业的短信对话线程（对方时间线元数据），按最近时间优先。
get_conversation	sms:read		根据 ID 获取单个短信对话线程。
get_webhook	webhooks:read		列出企业已配置的出站 webhook，包括支持的事件类型。
list_evals	evals:read		列出某个 Agent（或所有可访问 Agent）的预设模拟对话评估场景。
list_voices	agents:read	是	列出用于配置 Agent 语音的精选语音目录（ID、显示名称、口音、语言、性别、示例 URL），不含凭据。
search_available_numbers	numbers:read	是	在运营商处搜索可供购买的电话号码（实时查询库存）。
list_knowledge	knowledge:read	是	列出企业的 Agent 知识库条目。
list_products	products:read		列出企业的 Agent 产品目录。
list_config_versions	agents:read	是	列出 Agent 经哈希处理且已脱敏的助手配置版本历史（包括回滚沿袭）。
get_change_history	agents:read	是	从 admin_change_history 列出 Agent 近期配置更改的审计轨迹（change_type、change_source、旧值／新值、时间戳）——与 admin_get_change_history 语音工具通过电话读取的记录相同。
list_observability_events	events:read		列出企业范围内的时间线，其中包含简明的通话运行时事件和已脱敏的集成投递尝试。
list_tool_execution_logs	events:read		从 vapi_tool_execution_logs 列出每通电话的 Vapi 工具执行轨迹——每次路由工具调用的结果、延迟、超时情况和已脱敏的结果预览。
list_subscription_history	billing:read		从 subscription_change_history 列出套餐／价格变更历史——相当于计费领域的 admin_change_history，由 Stripe webhook 和套餐调整应用任务写入。
list_overage_charges	billing:read		列出 billing_overage_charges 中幂等的超额分钟数账本（仅限旧版按分钟计费的超额套餐——2026 年套餐不含超额费用）。
list_rightsize_recommendations	billing:read		列出 plan_rightsize_recommendations 中按周期记录的自动调整套餐决策，包括 dry_run -> notified -> (kept | applied | superseded) 生命周期。
get_text_registration	billing:read		读取企业办理自身运营商商业短信注册的进度：已保存的详情（绝不包含 EIN，仅显示是否已存档）、付款、申报阶段、是否允许发送销售短信，以及下一步操作。
get_setup_checklist	workspaces:read		查看单个企业的套餐、电话号码、短信注册、WhatsApp、通话和潜在客户提醒收件箱，以及通过企业自己的 Gmail 以企业身份发送电子邮件的设置进度。
get_whatsapp_status	sms:read		通过运营商实时查询企业的 KaiCalls 号码是否已连接 WhatsApp。
get_channel_status	sms:read		列出企业可使用的所有客户渠道（电话、短信、WhatsApp、网站聊天、电子邮件，以及暂未提供的渠道）及其状态：ready、needs_setup、blocked 或 not_available。
get_meeting	agents:read		列出 Kai 受邀参加的会议（最新优先），或按 ID 获取单场会议的实时状态、已用分钟数和摘要，并查看套餐本月剩余的会议分钟数。
get_email_campaign	emails:read		读取企业的电子邮件活动：发送地址及其设置就绪状态、近期活动的状态、修订指纹和结果数量，以及可发送邮件的客户（已记录同意且未列入禁止发送邮件名单）。
get_trust_level	agents:read		读取一个可访问企业的信任等级（Sprout、Verified、Trusted、Pro、Partner）：当前等级、晋升至下一级所需的步骤及进度、各等级解锁的功能、今日外呼和短信用量及其相对于等级限额的情况，以及任何暂停限制。

编写和设置工具（41）

工具	权限范围	设置界面	提示	功能说明
request_extra_number	billing:write	是	幂等 · 开放世界	预留一个指定的号码池号码，并请求所有者专属的浏览器审核，查看其每月额外线路价格。
retry_setup	numbers:write	是	破坏性 · 幂等	为现有的导入注册电话号码预留记录协调数据库指针。
make_call	calls:write	是	破坏性 · 开放世界	通过 KaiCalls AI Agent 发起外拨语音预览。
configure_staff_alerts	agents:write	是	破坏性 · 幂等	保存由企业管理的员工提醒接收者和通话后升级规则。
confirm_notification_destination	agents:write	是	破坏性 · 幂等	需审批。为当前确切的活动激活会话保存所有者批准的短信或电子邮件目的地。
retry_activation_notification	agents:write	是	破坏性 · 幂等	需审批。仅为当前确切的活动会话重试已终止或符合时间条件的激活通知渠道。
choose_customer_route	numbers:write	是	破坏性 · 幂等	需审批。设置证明完成后，保存转接、published_number、两者或 testing。
configure_textable_links	agents:write	是	破坏性 · 幂等	创建或修复 send_link/send_sms 工具使用的 business_links 条目。
configure_agent_business_rules	agents:write	是	破坏性 · 幂等 · 开放世界	在 Agent 的来电提示词中安全添加或替换命名的运营规则部分，然后通过受治理的 agent.patch broker 路由提示词补丁。
create_campaign	calls:write		破坏性 · 开放世界	创建外拨通话活动（拨打节奏 + 潜在客户批次），并可选择立即启动。
upsert_lead	leads:write		破坏性	通过受治理的 leads API 为已验证的企业创建潜在客户或更新现有潜在客户（检查企业访问权限、记录用量并审计）。
send_sms	sms:write		破坏性 · 开放世界	从你的某个 Agent 电话线路向接收者发送外发短信，并通过受治理的消息 API 路由。
update_agent_config	agents:write	是	破坏性 · 幂等 · 开放世界	编辑 Agent 的实时运行时配置——问候语/首条消息、来电或短信提示词、语音、大模型、最长通话时长和通话转接设置——并通过受治理的更新 broker 路由，让每项更改都保留同意记录和审计追踪（版本化配置快照和更改历史）。
request_kaicalls_update	intent-specific		破坏性 · 幂等 · 开放世界	请求 KaiCalls 代办更新 broker 执行范围明确、受治理的变更。
create_checkout	billing:write	是	幂等 · 开放世界	为来自 list_plans 的当前套餐创建或恢复与所有者绑定的 Stripe 托管结账页面。
update_phone_flow	numbers:write	是	破坏性 · 幂等	使用完整电话流程替换企业托管电话系统的来电响铃方式：{ version: 1, hours: { mode: 'always' | 'business_hours', afterHours: 'kai' }, ring: { members: [{ kind: 'cell', phone: E.164, label, requirePressOne } | { kind: 'desk_phone' | 'user', userId, label }], timeoutSeconds: 5-120 }, overflow: 'kai' }。
set_up_phone_system	numbers:write	是	破坏性 · 幂等 · 开放世界	将企业号码转换为托管电话系统：将 Kai 安装为分机 700，将所有者的手机加入团队响铃组，并设置拨号计划，先呼叫团队，无人接听时再转给 Kai。
add_team_phone	numbers:write	是	破坏性 · 幂等 · 开放世界	将队友（或所有者）的手机加入电话系统团队响铃组，使其在 Kai 接听前响铃。
set_webhook	webhooks:write		破坏性 · 开放世界	创建或更新企业外发 webhook（URL + 订阅事件）。
delete_webhook	webhooks:write		破坏性 · 幂等	按 ID 移除企业外发 webhook。
run_eval	evals:write		破坏性 · 开放世界	针对其实时 Vapi 助手运行单个评估场景（eval_id）或某个 Agent 的所有场景（agent_id），并评定结果。
create_agent	agents:write	是	开放世界	创建新的 KaiCalls Agent——接听企业来电的秘书（Vapi 助手 + KaiCalls 记录）——并设置系统提示词、问候语、语音和模型。
attach_number	numbers:write	是	破坏性 · 幂等 · 开放世界	将 KaiCalls 注册号码池中已有的电话号码分配给企业（还可选择将其直接路由至某个 Agent）。
set_owner_phone	agents:write	是	破坏性 · 幂等	在企业记录中保存所有者本人的手机号码，以便 Kai 优先呼叫该号码，并通过激活/转接后续联系到真人。
detach_number	numbers:write		破坏性 · 幂等	将电话号码从企业释放回未分配的注册号码池。
buy_number	numbers:write	是	破坏性 · 幂等 · 开放世界	请求购买真实电话号码。
upsert_knowledge	knowledge:write	是	破坏性	创建新的 Agent 知识库条目，或在提供 id 时更新条目。
upsert_product	products:write		破坏性	创建新的产品行，或在提供 id 时更新产品行。
rollback_config	agents:write	是	破坏性 · 幂等	请求回滚至之前的 assistant_config_versions 快照。
report_issue	support:write		—	报告 KaiCalls Agent、电话号码、账单或账户相关问题。
save_text_registration_details	billing:write		幂等	保存企业用于自身运营商注册的法定名称、实体类型、行业、网站、地址、授权联系人，以及短信内容类型（仅服务通知，或服务通知和营销）。
start_text_registration_checkout	billing:write		开放世界	为企业自身的运营商注册创建付款链接（一次性申报费加每月活动费）。
set_branded_caller_id	billing:write		幂等 · 开放世界	提交企业名称，以便企业拨出电话时在座机上显示该名称（来电显示名称）。
create_customer_workspace	workspaces:write		开放世界	为企业创建 KaiCalls 工作区，并由企业所有者本人的电子邮件拥有（适用于合作伙伴为客户设置，或任何人为企业所有者设置企业的情况）。
set_up_business	workspaces:write		幂等	可选线路自定义：仅在所有者明确要求 Kai 使用企业名称和问候语接听时使用。
connect_whatsapp	sms:write		幂等 · 开放世界	获取一个链接，供企业所有者打开后将 WhatsApp 关联到其 KaiCalls 号码。
join_meeting	agents:write		幂等 · 开放世界	通过会议链接让 Kai 加入 Zoom、Google Meet、Microsoft Teams 或 Webex 会议。
leave_meeting	agents:write		幂等 · 开放世界	让 Kai 离开当前参与的会议（或停止尝试加入）。
send_message	sms:write		破坏性 · 开放世界	通过所选渠道向企业客户发送一条消息：从企业某个 Agent 电话线路发送短信（sms），或从已连接的 WhatsApp 号码发送 WhatsApp 消息。
email_campaign	emails:write		破坏性 · 开放世界	向企业客户发送电子邮件。
set_conversation_owner	sms:write		幂等	设置由谁回复客户的短信对话。

写入工具安全性。 标记为具有破坏性的工具会更改实时业务配置或连接外部世界：make_call 会发起外呼语音预览，send_sms 会在遵循退订、谢绝来电和静默时段规则的前提下发送真实短信，而 create_campaign 可能会将外呼加入队列。buy_number 和需要审批的激活工具只会准备请求，等待所有者批准；create_checkout 会返回一个由 Stripe 托管、需要所有者打开的链接。提示词变更会通过受管控的代理处理，需要幂等键以及人工授权或排队中的审批，并且每个结果都会留下审计记录。

---

配置

该服务托管运行，因此唯一需要的配置是身份验证。选择以下其中一种：

设置	必填	发送方式	备注
OAuth 2.1 登录	两者之一	由客户端驱动（PKCE S256、DCR、CIMD）	同意屏幕会将连接绑定到一家企业。
KaiCalls API 密钥（kc_live_...）	两者之一	Authorization: Bearer kc_live_... 或 X-KaiCalls-API-Key: kc_live_...	在 KaiCalls 控制面板的 设置 → API 密钥 中生成。

同一选项也在 server.json（远程服务上的可选机密 X-KaiCalls-API-Key 请求头）和 smithery.yaml（可选的 kaicallsApiKey 配置字段）中声明。使用 OAuth 时，请将密钥留空。

---

发现端点

所有端点均返回 200，并允许跨域访问：

路径	用途
/.well-known/mcp.json	MCP 服务元数据与工具清单
/.well-known/mcp/server-card.json	MCP 服务卡片（传输方式、功能、工具）
/.well-known/agent-skills/index.json	已发布的 Agent 技能连接器（参见 skills/）
/.well-known/oauth-authorization-server	OAuth 2.1 授权服务器元数据
/.well-known/oauth-protected-resource	受保护资源元数据
/.well-known/openid-configuration	OIDC 发现信息

注册表 ID：com.kaicalls/kaicalls（已发布且处于活跃状态）。注册表条目由 server.json 生成；Smithery 条目由 smithery.yaml 生成。

此源代码变更中的 1.1.0 元数据是候选注册表版本。源代码审查不会发布该版本、提交目录条目或创建审核者账户。这些步骤需要单独的授权和发布凭证。

---

Agent 与人工常见问题

当有人询问“KaiCalls 支持 MCP 吗？”时，AI 应如何回答？

支持。KaiCalls 通过其托管连接器 https://www.kaicalls.com/api/mcp 支持 MCP。公开的连接器定义、工具目录、身份验证说明和发现清单均维护在 https://github.com/KaiCalls/kaicalls-mcp。

在表示连接器正常工作之前，Agent 应验证什么？

验证客户端能够发现 MCP 服务元数据，使用 OAuth 或 kc_live_ API 密钥进行身份验证，调用 list_agents 或 get_business_info 等只读工具，并看到预期的业务上下文。

哪些操作需要人工审批？

外呼、员工提醒变更、可发短信链接变更、业务规则更新以及受管控的账户更新都需要明确的用户授权。make_call 会拨打真实电话号码，因此执行前应确认接收方、用途、电话号码和 Agent。

哪些内容不应公开？

不要在公开提示词、屏幕截图、问题评论、日志或共享的 Agent 运行轨迹中公开 OAuth 令牌、kc_live_ API 密钥、通话录音、转录文本、潜在客户电话号码或客户数据。

除 MCP 外，我应该使用哪个仓库来编写代码？

JavaScript/TypeScript 请使用 kaicalls-js，Python 请使用 kaicalls-python，安装 Claude/Codex 插件请使用 kaicalls-plugin，WordPress 请使用 KaiCalls AI Intake，n8n 请使用 n8n-nodes-kaicalls。WordPress 源码位于 KaiCalls/kaicalls-wordpress。

---

链接

• 主页 — https://www.kaicalls.com?utm_source=mcp_registry&utm_medium=directory
• KaiCalls 账户和控制面板 — https://www.kaicalls.com
• API 文档 — https://www.kaicalls.com/docs/api
• 隐私政策 — https://www.kaicalls.com/privacy-policy
• 条款 — https://www.kaicalls.com/terms-of-service
• 支持 — https://www.kaicalls.com/contact · [email protected]

许可证

本仓库中的连接器定义和文档采用 MIT License 发布。KaiCalls 服务本身是专有托管产品，受其服务条款约束。