Kudosity MCP Server

The Kudosity Model Context Protocol (MCP) server gives AI assistants and agents native tools for messaging — send SMS, MMS, and WhatsApp, manage contacts and webhooks, and check your balance — plus live discovery of the Kudosity API specs.

There are two ways to use it:

	Best for	Install
Installable server (`kudosity-mcp` on npm)	Day-to-day use: 19 native tools your agent calls directly, with your API key	`npx -y kudosity-mcp`
Hosted server (`developers.kudosity.com/mcp`)	Zero-install API exploration: search specs, generate code snippets, run ad-hoc requests	Point your client at the URL

What is MCP?

Model Context Protocol is an open standard that lets AI applications securely access external tools and data. One MCP integration works across Claude Desktop, Claude Code, Cursor, Windsurf, and any other MCP-compatible client — no per-platform implementation.

Installable server (recommended)

The open-source kudosity-mcp package is published on npm and listed on the official MCP registry as com.kudosity/mcp with DNS-verified domain ownership. It runs locally, with your credentials staying on your machine.

Tools

Area	Tools
Messaging (5)	`send_sms`, `send_mms`, `send_whatsapp`, `get_message`, `list_messages`
Contacts & lists (6)	`create_list`, `get_lists`, `get_list`, `add_contact_to_list`, `remove_contact_from_list`, `delete_list`
Webhooks (3)	`create_webhook`, `list_webhooks`, `delete_webhook`
Account (1)	`get_balance`
API discovery (4)	`list_specs`, `list_endpoints`, `search_endpoints`, `get_endpoint`

The discovery tools read the live Kudosity OpenAPI specs at runtime, so the tools never drift from the documentation.

Setup

Add to your MCP client configuration (claude_desktop_config.json, ~/.cursor/mcp.json, or equivalent):

{
  "mcpServers": {
    "kudosity": {
      "command": "npx",
      "args": ["-y", "kudosity-mcp"],
      "env": {
        "KUDOSITY_API_KEY": "your-api-key",
        "KUDOSITY_API_SECRET": "your-api-secret"
      }
    }
  }
}

Or with Claude Code:

claude mcp add kudosity -e KUDOSITY_API_KEY=your-api-key -- npx -y kudosity-mcp

KUDOSITY_API_KEY covers messaging, webhooks, and discovery. Add KUDOSITY_API_SECRET for the contact-list and balance tools, which use the V1 API. Both are in the dashboard under Developers > API Settings.

📘
Pair it with Agent Skills
The MCP server gives your agent tools it can call; Agent Skills give it knowledge of how the API behaves. Together, your agent calls the right tool with the right arguments the first time.

Hosted server

Kudosity also hosts a remote MCP server at https://developers.kudosity.com/mcp for zero-install API exploration:

API discovery — list-specs, list-endpoints, get-endpoint, search-specs
Schema & documentation — get-request-body, get-response-schema, list-security-schemes, search-documentation
Code generation — get-code-snippet in curl, JavaScript, Python, and more
Live execution — execute-request runs real API calls

Authentication for live execution

api.transmitmessage.com (V2 endpoints) — your API key in the x-api-key header
api.transmitsms.com (V1 endpoints) — HTTP Basic with Base64-encoded API_KEY:API_SECRET (echo -n "API_KEY:API_SECRET" | base64)

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "kudosity-docs": {
      "url": "https://developers.kudosity.com/mcp"
    }
  }
}

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "kudosity-docs": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://developers.kudosity.com/mcp",
        "--header",
        "x-api-key: ${KUDOSITY_API_KEY}"
      ],
      "env": {
        "KUDOSITY_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "kudosity-docs": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://developers.kudosity.com/mcp",
        "--header",
        "Authorization: Basic ${KUDOSITY_AUTH_HEADER}"
      ],
      "env": {
        "KUDOSITY_AUTH_HEADER": "YOUR_BASE64_ENCODED_CREDENTIALS"
      }
    }
  }
}

Important: Restart your AI tool after saving the configuration file.

Test your setup

Restart your AI tool (Claude Desktop, Cursor, etc.)
Start a new chat with the AI assistant
Try it — for the installable server: "Check my Kudosity balance" or "Send a test SMS to my number". For the hosted server: "What APIs does Kudosity offer?" or "Create a curl command to send my first SMS through Kudosity"

Next steps

Agent Skills — API knowledge for coding agents, pairs with these tools
LangChain tools — the same capability for LangChain.js agents
Send messages from AI agents — runnable examples for every channel