Kudosity

com.kudosity由 kudosity.com 發布v0.5.0更新於 Oct 24, 2026

Send SMS, MMS and WhatsApp, manage contacts and webhooks, from AI agents.

已驗證STDIO僅桌面效率與工作流溝通與協作

概覽

AI 產生的概覽

Kudosity 讓助理傳送簡訊、MMS 和 WhatsApp 訊息，管理聯絡人與 Webhook，並查詢 Kudosity API。

可以做什麼
傳送簡訊、MMS 和 WhatsApp 訊息，並讀取已傳送或已接收訊息及其送達狀態，可依狀態、方向、收件者和日期篩選。建立、列出和刪除用於送達狀態、 inbound 訊息、連結點擊和退訂的 Webhook。建立、列出、檢視和刪除聯絡人清單，並新增或移除聯絡人。查詢帳戶餘額。依關鍵字搜尋 Kudosity 即時 API 規格並查看端點詳細資料。
適用情境
當助理需要透過 Kudosity 傳送客戶訊息或 WhatsApp 範本、查看送達狀態與回覆，或維護聯絡人清單和 Webhook 時使用。開發整合時查詢最新的 Kudosity API 端點也很有用。
執行需求
需要 Node.js 18 或更新版本，透過 npx 在本機執行。需要 Kudosity 帳戶，並在 KUDOSITY_API_KEY 中提供 API 金鑰。聯絡人清單和餘額工具還需要 KUDOSITY_API_SECRET。需要連線至 Kudosity API，以及用於 API 探索的開發者文件網站。
安裝前請注意
傳送訊息、建立或刪除 Webhook、修改聯絡人清單都會作用於真實帳戶，並可能產生簡訊費用。KUDOSITY_API_KEY 和 KUDOSITY_API_SECRET 屬於機密，請勿放入共用設定檔。訊息內容、收件者和聯絡人資料會傳送給 Kudosity，API 探索工具會從 Kudosity 開發者網站取得資料。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Kudosity，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Kudosity MCP Server

An installable Model Context Protocol server that gives AI agents native tools to send SMS, MMS and WhatsApp messages, manage contacts and webhooks, and research the Kudosity API — powered by Kudosity.

Runs locally (or in your own infrastructure), authenticates with your Kudosity API key, and exposes one clean tool per action — so an agent calls send_sms instead of hand-building HTTP requests.

Tools

Messaging

ToolTypeDescription
send_smswriteSend an SMS to a recipient
send_mmswriteSend an MMS with a media attachment
send_whatsappwriteSend a WhatsApp message (free-form text or approved template)
get_messagereadGet a sent message and its status by channel + ID
list_messagesreadList sent/received messages with delivery status; filter by status, direction (sent/replies), recipient, dates

Webhooks

ToolTypeDescription
create_webhookwriteRegister an HTTPS webhook for delivery status, inbound messages, link hits, opt-outs
list_webhooksreadList configured webhooks
delete_webhookwriteDelete a webhook by ID

Contacts & lists (require KUDOSITY_API_SECRET)

ToolTypeDescription
create_listwriteCreate a contact list
get_listsreadList all contact lists
get_listreadGet a list and optionally its members
add_contact_to_listwriteAdd a contact to a list
remove_contact_from_listwriteRemove a contact from a list
delete_listwriteDelete a contact list

Account (requires KUDOSITY_API_SECRET)

ToolTypeDescription
get_balancereadGet your account balance

API discovery — research the whole Kudosity API, always current

ToolTypeDescription
list_specsreadList the Kudosity API specifications
list_endpointsreadList all endpoints for a spec
search_endpointsreadSearch the API by keyword
get_endpointreadGet full detail for one endpoint

The discovery tools read the live specs from developers.kudosity.com, so they always reflect the latest published docs.

Requirements

  • Node.js 18+
  • A Kudosity account and API key — Settings → API Settings in the Kudosity platform
  • For contact and balance tools, also your API secret (same settings page)

Install & configure

Runs via npx — no clone required.

Claude Desktop / Claude Code

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

KUDOSITY_API_SECRET is optional — omit it if you only need messaging, webhooks, and discovery. It's required for the contact-list and balance tools.

Cursor — .cursor/mcp.json

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

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

Usage examples

  • "Send an SMS to 61438333061 from KudosityDemo saying the order shipped."
  • "Send the order_status_sample WhatsApp template to 61411122211."
  • "List my delivered SMS from the last day." / "Show me inbound SMS replies."
  • "Create a contact list called VIPs and add 61438333061."
  • "Register a webhook at https://example.com/hook for SMS delivery status."
  • "What's my account balance?"
  • "Search the Kudosity API for anything about opt-outs."

Authentication

Kudosity has two API surfaces, and this server uses each where it's authoritative:

ToolsAuthCredentials
Messaging, webhooks, discoveryx-api-key headerKUDOSITY_API_KEY
Contact lists, balanceHTTP BasicKUDOSITY_API_KEY + KUDOSITY_API_SECRET

Credentials are read from environment variables and never written to disk. Treat them as secrets.

Configuration

Env varRequiredDefaultDescription
KUDOSITY_API_KEYyes—Your Kudosity API key
KUDOSITY_API_SECRETfor contacts/balance—Your Kudosity API secret
KUDOSITY_API_BASE_URLnohttps://api.transmitmessage.comOverride the v2 API base URL
KUDOSITY_V1_BASE_URLnohttps://api.transmitsms.comOverride the v1 API base URL

Local development

bash
git clone https://github.com/kudosity/mcpcd mcpnpm installnpm run buildKUDOSITY_API_KEY=your_api_key npm start

Test tool listing with the MCP Inspector, or run the checks:

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

License

MIT

來源：README.md，提交 bac8bfc

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.5.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分