SendKuy

SendKuy MCP 服务

让 AI 助手和 Agent 能够联系他人：通过你的 SendKuy 账户发送 WhatsApp 消息、SMS 和电子邮件，验证 OTP 代码并运行营销活动。

你可以在构建集成时使用它（“向我的号码发送测试 OTP”“我的 webhook 为什么失败了？”），也可以将它用作自主运行的 Agent 的通知步骤：发送值班告警、每日收入摘要，或向每位客户发送订单更新。

包含应用场景的完整指南：docs.sendkuy.com/mcp

获取密钥

在 app.sendkuy.com/user/api 创建 API 密钥。为它授予 account:read 以及所需工具的作用域，仅授予这些权限。服务只会列出该密钥可使用的工具，因此，只有读取作用域的密钥不会看到任何会发送消息的工具。

安装

Claude Code：

claude mcp add --transport stdio --env SENDKUY_API_KEY=sk_live_YOUR_API_KEY sendkuy -- npx -y @sendkuy/mcp

Cursor（.cursor/mcp.json）、Windsurf 和 Claude Desktop：

{
  "mcpServers": {
    "sendkuy": {
      "command": "npx",
      "args": ["-y", "@sendkuy/mcp"],
      "env": { "SENDKUY_API_KEY": "sk_live_YOUR_API_KEY" }
    }
  }
}

VS Code（.vscode/mcp.json）：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "sendkuy-key",
      "description": "SendKuy API key",
      "password": true
    }
  ],
  "servers": {
    "sendkuy": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@sendkuy/mcp"],
      "env": { "SENDKUY_API_KEY": "${input:sendkuy-key}" }
    }
  }
}

Claude Desktop 也可以通过点击一次，从最新版本安装 sendkuy-mcp.mcpb。

工具

工具	功能说明	权限范围
sendkuy_get_account	套餐、各渠道的积分、本期用量及密钥的权限范围	account:read
sendkuy_send_message	在一个渠道向 1–100 个接收者（联系人或群组）发送相同内容	messages:write
sendkuy_send_batch	发送最多 500 条不同内容的消息，并逐行返回结果	messages:write
sendkuy_get_messages	按 ID 查询最多 20 条消息的状态	messages:read
sendkuy_list_messages	按渠道、状态和时间查看近期消息	messages:read
sendkuy_cancel_message	取消尚未发送的消息	messages:write
sendkuy_send_verification	发送 OTP 验证码	verifications:write
sendkuy_check_verification	验证用户输入的代码	verifications:write
sendkuy_check_whatsapp_numbers	检查哪些号码已开通 WhatsApp	numbers:read
sendkuy_find_contacts	按电话号码或 external_id 查找联系人	contacts:read
sendkuy_list_templates	已保存的消息模板	templates:read
sendkuy_list_groups	联系人群组及其人数	groups:read
sendkuy_list_campaigns	在控制面板中准备的营销活动	campaigns:read
sendkuy_start_campaign	启动营销活动	campaigns:write
sendkuy_get_campaign	进度和送达统计	campaigns:read
sendkuy_control_campaign	暂停、恢复或取消	campaigns:write
sendkuy_list_webhook_deliveries	Webhook 及其最近的投递尝试	webhooks:read

发送类工具会实际发送消息并消耗积分。它们支持可选的 dedupe_key：Agent 使用相同密钥重复执行步骤时，会返回首次操作的结果，而不会重复发送。

示例

• 值班告警。 “健康检查失败时，通过 WhatsApp 向值班群组发送服务名称和错误信息。” Agent 使用群组的 grp_ ID 发送消息，并将事件 ID 设为 dedupe_key。
• 每日营收汇总。 “每天晚上向各分店经理发送各自的数据。” 调用一次 sendkuy_send_batch，为每位经理设置不同的消息正文。
• 集成调试。 “过去一小时内哪些 WhatsApp 消息发送失败了？原因是什么？” 先调用 sendkuy_list_messages，再调用 sendkuy_list_webhook_deliveries。

配置

变量
SENDKUY_API_KEY	你的 API 密钥。如果未提供密钥、密钥无效，或启动时无法连接到 SendKuy，服务仍会启动并列出其工具，且每次调用都会说明原因，直到你修复问题并重启客户端。
SENDKUY_BASE_URL	仅用于代理或测试中的模拟服务。默认为 https://app.sendkuy.com/api/v1。

许可证

MIT