Send SMS, MMS and WhatsApp, manage contacts and webhooks, from AI agents.
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.
Messaging
| Tool | Type | Description |
|---|---|---|
send_sms | write | Send an SMS to a recipient |
send_mms | write | Send an MMS with a media attachment |
send_whatsapp | write | Send a WhatsApp message (free-form text or approved template) |
get_message | read | Get a sent message and its status by channel + ID |
list_messages | read | List sent/received messages with delivery status; filter by status, direction (sent/replies), recipient, dates |
Webhooks
| Tool | Type | Description |
|---|---|---|
create_webhook | write | Register an HTTPS webhook for delivery status, inbound messages, link hits, opt-outs |
list_webhooks | read | List configured webhooks |
delete_webhook | write | Delete a webhook by ID |
Contacts & lists (require KUDOSITY_API_SECRET)
| Tool | Type | Description |
|---|---|---|
create_list | write | Create a contact list |
get_lists | read | List all contact lists |
get_list | read | Get a list and optionally its members |
add_contact_to_list | write | Add a contact to a list |
remove_contact_from_list | write | Remove a contact from a list |
delete_list | write | Delete a contact list |
Account (requires KUDOSITY_API_SECRET)
| Tool | Type | Description |
|---|---|---|
get_balance | read | Get your account balance |
API discovery — research the whole Kudosity API, always current
| Tool | Type | Description |
|---|---|---|
list_specs | read | List the Kudosity API specifications |
list_endpoints | read | List all endpoints for a spec |
search_endpoints | read | Search the API by keyword |
get_endpoint | read | Get full detail for one endpoint |
The discovery tools read the live specs from developers.kudosity.com, so they always reflect the latest published docs.
Runs via npx — no clone required.
{
"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/mcp.json{
"mcpServers": {
"kudosity": {
"command": "npx",
"args": ["-y", "kudosity-mcp"],
"env": { "KUDOSITY_API_KEY": "your_api_key", "KUDOSITY_API_SECRET": "your_api_secret" }
}
}
}
.vscode/mcp.json{
"servers": {
"kudosity": {
"command": "npx",
"args": ["-y", "kudosity-mcp"],
"env": { "KUDOSITY_API_KEY": "your_api_key", "KUDOSITY_API_SECRET": "your_api_secret" }
}
}
}
Kudosity has two API surfaces, and this server uses each where it's authoritative:
| Tools | Auth | Credentials |
|---|---|---|
| Messaging, webhooks, discovery | x-api-key header | KUDOSITY_API_KEY |
| Contact lists, balance | HTTP Basic | KUDOSITY_API_KEY + KUDOSITY_API_SECRET |
Credentials are read from environment variables and never written to disk. Treat them as secrets.
| Env var | Required | Default | Description |
|---|---|---|---|
KUDOSITY_API_KEY | yes | — | Your Kudosity API key |
KUDOSITY_API_SECRET | for contacts/balance | — | Your Kudosity API secret |
KUDOSITY_API_BASE_URL | no | https://api.transmitmessage.com | Override the v2 API base URL |
KUDOSITY_V1_BASE_URL | no | https://api.transmitsms.com | Override the v1 API base URL |
git clone https://github.com/kudosity/mcp
cd mcp
npm install
npm run build
KUDOSITY_API_KEY=your_api_key npm start
Test tool listing with the MCP Inspector, or run the checks:
npm test # mock integration tests (no credentials)
node test/discovery-test.mjs # live spec-discovery test (no credentials)
Source-derived launch command. Check the maintainer’s required arguments and credentials before running:
npx -y kudosity-mcpMerge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.
{
"mcpServers": {
"com-kudosity-mcp": {
"command": "npx",
"args": [
"-y",
"kudosity-mcp"
]
}
}
}Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.
Claude Desktop setup referenceKudosity works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.
~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.~/.cursor/mcp.jsonRestart Cursor for changes to take effect..vscode/mcp.jsonReload VS Code window for changes to take effect.~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect..mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.