{
  "markdown": "# Kudosity MCP Server\n\nAn installable [Model Context Protocol](https://modelcontextprotocol.io) 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](https://kudosity.com).\n\nRuns 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.\n\n## Tools\n\n**Messaging**\n\n| Tool | Type | Description |\n|---|---|---|\n| `send_sms` | write | Send an SMS to a recipient |\n| `send_mms` | write | Send an MMS with a media attachment |\n| `send_whatsapp` | write | Send a WhatsApp message (free-form text or approved template) |\n| `get_message` | read | Get a sent message and its status by channel + ID |\n| `list_messages` | read | List sent/received messages with delivery status; filter by status, direction (sent/replies), recipient, dates |\n\n**Webhooks**\n\n| Tool | Type | Description |\n|---|---|---|\n| `create_webhook` | write | Register an HTTPS webhook for delivery status, inbound messages, link hits, opt-outs |\n| `list_webhooks` | read | List configured webhooks |\n| `delete_webhook` | write | Delete a webhook by ID |\n\n**Contacts & lists** *(require `KUDOSITY_API_SECRET`)*\n\n| Tool | Type | Description |\n|---|---|---|\n| `create_list` | write | Create a contact list |\n| `get_lists` | read | List all contact lists |\n| `get_list` | read | Get a list and optionally its members |\n| `add_contact_to_list` | write | Add a contact to a list |\n| `remove_contact_from_list` | write | Remove a contact from a list |\n| `delete_list` | write | Delete a contact list |\n\n**Account** *(requires `KUDOSITY_API_SECRET`)*\n\n| Tool | Type | Description |\n|---|---|---|\n| `get_balance` | read | Get your account balance |\n\n**API discovery** — research the whole Kudosity API, always current\n\n| Tool | Type | Description |\n|---|---|---|\n| `list_specs` | read | List the Kudosity API specifications |\n| `list_endpoints` | read | List all endpoints for a spec |\n| `search_endpoints` | read | Search the API by keyword |\n| `get_endpoint` | read | Get full detail for one endpoint |\n\nThe discovery tools read the live specs from `developers.kudosity.com`, so they always reflect the latest published docs.\n\n## Requirements\n\n- Node.js 18+\n- A Kudosity account and API key — **Settings → API Settings** in the Kudosity platform\n- For contact and balance tools, also your API **secret** (same settings page)\n\n## Install & configure\n\nRuns via `npx` — no clone required.\n\n### Claude Desktop / Claude Code\n\n```json\n{\n  \"mcpServers\": {\n    \"kudosity\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"kudosity-mcp\"],\n      \"env\": {\n        \"KUDOSITY_API_KEY\": \"your_api_key\",\n        \"KUDOSITY_API_SECRET\": \"your_api_secret\"\n      }\n    }\n  }\n}\n```\n\n`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.\n\n### Cursor — `.cursor/mcp.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"kudosity\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"kudosity-mcp\"],\n      \"env\": { \"KUDOSITY_API_KEY\": \"your_api_key\", \"KUDOSITY_API_SECRET\": \"your_api_secret\" }\n    }\n  }\n}\n```\n\n### VS Code — `.vscode/mcp.json`\n\n```json\n{\n  \"servers\": {\n    \"kudosity\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"kudosity-mcp\"],\n      \"env\": { \"KUDOSITY_API_KEY\": \"your_api_key\", \"KUDOSITY_API_SECRET\": \"your_api_secret\" }\n    }\n  }\n}\n```\n\n## Usage examples\n\n- *\"Send an SMS to 61438333061 from KudosityDemo saying the order shipped.\"*\n- *\"Send the order_status_sample WhatsApp template to 61411122211.\"*\n- *\"List my delivered SMS from the last day.\"* / *\"Show me inbound SMS replies.\"*\n- *\"Create a contact list called VIPs and add 61438333061.\"*\n- *\"Register a webhook at https://example.com/hook for SMS delivery status.\"*\n- *\"What's my account balance?\"*\n- *\"Search the Kudosity API for anything about opt-outs.\"*\n\n## Authentication\n\nKudosity has two API surfaces, and this server uses each where it's authoritative:\n\n| Tools | Auth | Credentials |\n|---|---|---|\n| Messaging, webhooks, discovery | `x-api-key` header | `KUDOSITY_API_KEY` |\n| Contact lists, balance | HTTP Basic | `KUDOSITY_API_KEY` + `KUDOSITY_API_SECRET` |\n\nCredentials are read from environment variables and never written to disk. Treat them as secrets.\n\n## Configuration\n\n| Env var | Required | Default | Description |\n|---|---|---|---|\n| `KUDOSITY_API_KEY` | yes | — | Your Kudosity API key |\n| `KUDOSITY_API_SECRET` | for contacts/balance | — | Your Kudosity API secret |\n| `KUDOSITY_API_BASE_URL` | no | `https://api.transmitmessage.com` | Override the v2 API base URL |\n| `KUDOSITY_V1_BASE_URL` | no | `https://api.transmitsms.com` | Override the v1 API base URL |\n\n## Local development\n\n```bash\ngit clone https://github.com/kudosity/mcp\ncd mcp\nnpm install\nnpm run build\nKUDOSITY_API_KEY=your_api_key npm start\n```\n\nTest tool listing with the MCP Inspector, or run the checks:\n\n```bash\nnpm test              # mock integration tests (no credentials)\nnode test/discovery-test.mjs   # live spec-discovery test (no credentials)\n```\n\n## License\n\n[MIT](./LICENSE)\n",
  "bytes": 5214,
  "sha": "3bd6ee9b097d45b061beb75fe4277b1ed4ba336912f2be0ca67ce1766ad43e55",
  "repo_slug": "kudosity/mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_kudosity_mcp_43a72feb/readme"
}