Kudosity

Kudosity MCP サーバー

AI エージェントが SMS、MMS、WhatsApp メッセージの送信、連絡先や Webhook の管理、Kudosity API の調査に使えるネイティブツールを提供する、インストール可能な Model Context Protocol サーバーです。Kudosity が提供します。

ローカル（または独自のインフラストラクチャ）で動作し、Kudosity API キーで認証して、アクションごとにシンプルなツールを 1 つ公開します。そのため、エージェントは HTTP リクエストを手作業で組み立てる代わりに、send_sms を呼び出せます。

ツール

メッセージング

ツール	種類	説明
send_sms	書き込み	受信者に SMS を送信します
send_mms	書き込み	メディア添付ファイル付きの MMS を送信します
send_whatsapp	書き込み	WhatsApp メッセージを送信します（自由形式のテキストまたは承認済みテンプレート）
get_message	読み取り	チャネルと ID を指定して、送信済みメッセージとそのステータスを取得します
list_messages	読み取り	配信ステータスとともに送受信メッセージを一覧表示します。ステータス、方向（送信／返信）、受信者、日付で絞り込めます

Webhook

ツール	種類	説明
create_webhook	書き込み	配信ステータス、受信メッセージ、リンクのクリック、オプトアウトを通知する HTTPS Webhook を登録します
list_webhooks	読み取り	設定済みの Webhook を一覧表示します
delete_webhook	書き込み	ID を指定して Webhook を削除します

連絡先とリスト（KUDOSITY_API_SECRET が必要です）

ツール	種類	説明
create_list	書き込み	連絡先リストを作成します
get_lists	読み取り	すべての連絡先リストを一覧表示します
get_list	読み取り	リストと、必要に応じてそのメンバーを取得します
add_contact_to_list	書き込み	連絡先をリストに追加します
remove_contact_from_list	書き込み	連絡先をリストから削除します
delete_list	書き込み	連絡先リストを削除します

アカウント（KUDOSITY_API_SECRET が必要です）

ツール	種類	説明
get_balance	読み取り	アカウント残高を取得します

API の検索 — Kudosity API 全体を常に最新の状態で調査できます

ツール	種類	説明
list_specs	読み取り	Kudosity API の仕様を一覧表示します
list_endpoints	読み取り	仕様に含まれるすべてのエンドポイントを一覧表示します
search_endpoints	読み取り	キーワードで API を検索します
get_endpoint	読み取り	1 つのエンドポイントの詳細をすべて取得します

検索ツールは 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 を送信して。」
• 「order_status_sample WhatsApp テンプレートを 61411122211 に送信して。」
• 「過去 1 日間に配信された SMS を一覧表示して。」 / 「受信した SMS の返信を表示して。」
• 「VIPs という連絡先リストを作成して、61438333061 を追加して。」
• 「SMS の配信ステータスを通知する Webhook を https://example.com/hook に登録して。」
• 「アカウント残高はいくら？」
• 「オプトアウトに関する情報がないか、Kudosity API を検索して。」

認証

Kudosity には 2 つの 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