Kudosity MCP server
{
"mcpServers": {
"kudosity": {
"command": "npx",
"args": [
"-y",
"kudosity-mcp@latest",
"kudosity-mcp"
],
"env": {
"KUDOSITY_API_KEY": "<kudosity_api_key>",
"KUDOSITY_API_SECRET": "<kudosity_api_secret>",
"KUDOSITY_API_BASE_URL": "https://...",
"KUDOSITY_V1_BASE_URL": "https://..."
}
}
}
}{
"mcpServers": {
"kudosity": {
"command": "npx",
"args": [
"-y",
"kudosity-mcp@latest",
"kudosity-mcp"
],
"env": {
"KUDOSITY_API_KEY": "<kudosity_api_key>",
"KUDOSITY_API_SECRET": "<kudosity_api_secret>",
"KUDOSITY_API_BASE_URL": "https://...",
"KUDOSITY_V1_BASE_URL": "https://..."
}
}
}
}{
"mcpServers": {
"kudosity": {
"command": "npx",
"args": [
"-y",
"kudosity-mcp@latest",
"kudosity-mcp"
],
"env": {
"KUDOSITY_API_KEY": "<kudosity_api_key>",
"KUDOSITY_API_SECRET": "<kudosity_api_secret>",
"KUDOSITY_API_BASE_URL": "https://...",
"KUDOSITY_V1_BASE_URL": "https://..."
}
}
}
}{
"servers": {
"kudosity": {
"command": "npx",
"args": [
"-y",
"kudosity-mcp@latest",
"kudosity-mcp"
],
"env": {
"KUDOSITY_API_KEY": "${input:kudosity_api_key}",
"KUDOSITY_API_SECRET": "${input:kudosity_api_secret}",
"KUDOSITY_API_BASE_URL": "${input:kudosity_api_base_url}",
"KUDOSITY_V1_BASE_URL": "${input:kudosity_v1_base_url}"
}
}
},
"inputs": [
{
"id": "kudosity_api_key",
"type": "promptString",
"description": "Kudosity api key",
"password": true
},
{
"id": "kudosity_api_secret",
"type": "promptString",
"description": "Kudosity api secret",
"password": true
},
{
"id": "kudosity_api_base_url",
"type": "promptString",
"description": "Kudosity api base url",
"password": true
},
{
"id": "kudosity_v1_base_url",
"type": "promptString",
"description": "Kudosity v1 base url",
"password": true
}
]
}{
"mcpServers": {
"kudosity": {
"command": "npx",
"args": [
"-y",
"kudosity-mcp@latest",
"kudosity-mcp"
],
"env": {
"KUDOSITY_API_KEY": "<kudosity_api_key>",
"KUDOSITY_API_SECRET": "<kudosity_api_secret>",
"KUDOSITY_API_BASE_URL": "https://...",
"KUDOSITY_V1_BASE_URL": "https://..."
}
}
}
}file .mcp.json (in your project root)file claude_desktop_config.jsonfile ~/.cursor/mcp.jsonfile .vscode/mcp.jsonfile ~/.codeium/windsurf/mcp_config.jsoninstall npx -y kudosity-mcpversion 0.5.0
What it does
Exposes tools for AI agents to send SMS, MMS, and WhatsApp messages, manage contact lists and webhooks, and query the Kudosity API. Designed for developers building messaging workflows into AI applications.
- Send transactional SMS or WhatsApp messages from an AI agent in response to user requests or events.
- Query message delivery status and retrieve inbound replies to track communication outcomes.
- Register webhooks to receive delivery status updates, inbound messages, and opt-outs from Kudosity.
Tools this server exposes
| Tool | Does |
|---|---|
| send_sms | Send an SMS to a recipient. |
| send_mms | Send an MMS with a media attachment. |
| send_whatsapp | Send a WhatsApp message as free-form text or an approved template. |
| get_message | Retrieve a sent message and its delivery status by channel and ID. |
| list_messages | List sent and received messages, optionally filtered by status, direction, recipient, or date range. |
| create_webhook | Register an HTTPS webhook for delivery status, inbound messages, link hits, or opt-outs. |
| list_webhooks | List all configured webhooks. |
| delete_webhook | Delete a webhook by ID. |
| create_list | Create a contact list. |
| get_lists | List all contact lists. |
| get_list | Get a contact list and optionally view its members. |
| add_contact_to_list | Add a contact to a list. |
| remove_contact_from_list | Remove a contact from a list. |
| delete_list | Delete a contact list. |
| get_balance | Get your account balance. |
| list_specs | List available Kudosity API specifications. |
| list_endpoints | List all endpoints for a given API specification. |
| search_endpoints | Search the Kudosity API by keyword. |
| get_endpoint | Get full details for a specific API endpoint. |
Before you enable it
An MCP server runs with whatever access you give it. Start with a development account rather than production, and check which tools the server exposes before you let an agent call them unattended.