Kudosity

Kudosity MCP 服务

一个可安装的 Model Context Protocol 服务，为 AI Agent 提供原生工具，用于发送 SMS、MMS 和 WhatsApp 消息、管理联系人和 Webhook，以及查询 Kudosity API，由 Kudosity 提供支持。

可在本地（或你自己的基础设施中）运行，使用你的 Kudosity API 密钥进行身份验证，并为每项操作提供一个简洁的工具，因此 Agent 可以调用 send_sms，而不必手动构建 HTTP 请求。

工具

消息

工具	类型	描述
send_sms	write	向收件人发送 SMS
send_mms	write	发送带有媒体附件的 MMS
send_whatsapp	write	发送 WhatsApp 消息（自由文本或已批准的模板）
get_message	read	按渠道和 ID 获取已发送的消息及其状态
list_messages	read	列出已发送/收到的消息及其投递状态；可按状态、方向（已发送/回复）、收件人和日期筛选

Webhook

工具	类型	描述
create_webhook	write	注册用于投递状态、入站消息、链接点击和退订的 HTTPS Webhook
list_webhooks	read	列出已配置的 Webhook
delete_webhook	write	按 ID 删除 Webhook

联系人和列表 （需要 KUDOSITY_API_SECRET）

工具	类型	描述
create_list	write	创建联系人列表
get_lists	read	列出所有联系人列表
get_list	read	获取列表及其成员（可选）
add_contact_to_list	write	将联系人添加到列表
remove_contact_from_list	write	从列表中移除联系人
delete_list	write	删除联系人列表

账户 （需要 KUDOSITY_API_SECRET）

工具	类型	描述
get_balance	read	获取账户余额

API 探索 — 查询整个 Kudosity API，内容始终保持最新

工具	类型	描述
list_specs	read	列出 Kudosity API 规范
list_endpoints	read	列出某个规范的所有端点
search_endpoints	read	按关键词搜索 API
get_endpoint	read	获取某个端点的完整详情

探索工具会读取 developers.kudosity.com 上的实时规范，因此始终反映最新发布的文档。

要求

• Node.js 18+
• Kudosity 账户和 API 密钥 — 可在 Kudosity 平台的 Settings → API Settings 中获取
• 对于联系人和余额工具，还需要 API 密钥（同一设置页面）

安装和配置

通过 npx 运行 — 无需克隆。

Claude Desktop / Claude Code

{
  "mcpServers": {
    "kudosity": {
      "command": "npx",
      "args": ["-y", "kudosity-mcp"],
      "env": {
        "KUDOSITY_API_KEY": "your_api_key",
        "KUDOSITY_API_SECRET": "your_api_secret"
      }
    }
  }
}

KUDOSITY_API_SECRET 是可选的 — 如果只需要消息、Webhook 和探索功能，可以省略。联系人列表和余额工具需要此项。

Cursor — .cursor/mcp.json

{
  "mcpServers": {
    "kudosity": {
      "command": "npx",
      "args": ["-y", "kudosity-mcp"],
      "env": { "KUDOSITY_API_KEY": "your_api_key", "KUDOSITY_API_SECRET": "your_api_secret" }
    }
  }
}

VS Code — .vscode/mcp.json

{
  "servers": {
    "kudosity": {
      "command": "npx",
      "args": ["-y", "kudosity-mcp"],
      "env": { "KUDOSITY_API_KEY": "your_api_key", "KUDOSITY_API_SECRET": "your_api_secret" }
    }
  }
}

使用示例

• “通过 KudosityDemo 向 61438333061 发送一条 SMS，告知订单已发货。”
• “向 61411122211 发送 order_status_sample WhatsApp 模板。”
• “列出我过去一天内投递成功的 SMS。” / “显示收到的 SMS 回复。”
• “创建一个名为 VIPs 的联系人列表，并添加 61438333061。”
• “在 https://example.com/hook 注册一个用于 SMS 投递状态的 Webhook。”
• “我的账户余额是多少？”
• “在 Kudosity API 中搜索与退订相关的内容。”

身份验证

Kudosity 有两种 API 接口，本服务会在适用时使用相应接口：

工具	身份验证	凭据
消息、Webhook、探索	x-api-key 标头	KUDOSITY_API_KEY
联系人列表、余额	HTTP Basic	KUDOSITY_API_KEY + KUDOSITY_API_SECRET

凭据从环境变量读取，绝不会写入磁盘。请将其视为机密信息。

配置

环境变量	必需	默认值	描述
KUDOSITY_API_KEY	是	—	你的 Kudosity API 密钥
KUDOSITY_API_SECRET	用于联系人/余额	—	你的 Kudosity API 密钥
KUDOSITY_API_BASE_URL	否	https://api.transmitmessage.com	覆盖 v2 API 基础 URL
KUDOSITY_V1_BASE_URL	否	https://api.transmitsms.com	覆盖 v1 API 基础 URL

本地开发

git clone https://github.com/kudosity/mcp
cd mcp
npm install
npm run build
KUDOSITY_API_KEY=your_api_key npm start

使用 MCP Inspector 测试工具列表，或运行检查：

npm test              # mock integration tests (no credentials)
node test/discovery-test.mjs   # live spec-discovery test (no credentials)

许可证

MIT