Kudosity MCP Server
OfficialEnables sending WhatsApp messages (free-form text or approved templates) and tracking their delivery status through the Kudosity API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Kudosity MCP Server Send an SMS to 61438333061 saying my order shipped."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Kudosity MCP Server
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.
Tools
Messaging
Tool | Type | Description |
| write | Send an SMS to a recipient |
| write | Send an MMS with a media attachment |
| write | Send a WhatsApp message (free-form text or approved template) |
| read | Get a sent message and its status by channel + ID |
| read | List sent/received messages with delivery status; filter by status, direction (sent/replies), recipient, dates |
Webhooks
Tool | Type | Description |
| write | Register an HTTPS webhook for delivery status, inbound messages, link hits, opt-outs |
| read | List configured webhooks |
| write | Delete a webhook by ID |
Contacts & lists (require KUDOSITY_API_SECRET)
Tool | Type | Description |
| write | Create a contact list |
| read | List all contact lists |
| read | Get a list and optionally its members |
| write | Add a contact to a list |
| write | Remove a contact from a list |
| write | Delete a contact list |
Account (requires KUDOSITY_API_SECRET)
Tool | Type | Description |
| read | Get your account balance |
API discovery — research the whole Kudosity API, always current
Tool | Type | Description |
| read | List the Kudosity API specifications |
| read | List all endpoints for a spec |
| read | Search the API by keyword |
| 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.
Related MCP server: Telnyx MCP Server
Requirements
Node.js 18+
A Kudosity account and API key — Settings → API Settings in the Kudosity platform
For contact and balance tools, also your API secret (same settings page)
Install & configure
Runs via npx — no clone required.
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 is optional — omit it if you only need messaging, webhooks, and discovery. It's required for the contact-list and balance tools.
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" }
}
}
}Usage examples
"Send an SMS to 61438333061 from KudosityDemo saying the order shipped."
"Send the order_status_sample WhatsApp template to 61411122211."
"List my delivered SMS from the last day." / "Show me inbound SMS replies."
"Create a contact list called VIPs and add 61438333061."
"Register a webhook at https://example.com/hook for SMS delivery status."
"What's my account balance?"
"Search the Kudosity API for anything about opt-outs."
Authentication
Kudosity has two API surfaces, and this server uses each where it's authoritative:
Tools | Auth | Credentials |
Messaging, webhooks, discovery |
|
|
Contact lists, balance | HTTP Basic |
|
Credentials are read from environment variables and never written to disk. Treat them as secrets.
Configuration
Env var | Required | Default | Description |
| yes | — | Your Kudosity API key |
| for contacts/balance | — | Your Kudosity API secret |
| no |
| Override the v2 API base URL |
| no |
| Override the v1 API base URL |
Local development
git clone https://github.com/kudosity/mcp
cd mcp
npm install
npm run build
KUDOSITY_API_KEY=your_api_key npm startTest 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)License
Available Tools
19 toolsadd_contact_to_listAdd contact to listA
Add a contact (mobile number) to a list. Requires KUDOSITY_API_SECRET (v1 auth).
Inputs: number (required), list_id (required), last_name, first_name, +1 more.
create_listCreate contact listA
Create a new contact list. Requires KUDOSITY_API_SECRET (v1 auth).
Inputs: name (required).
create_webhookCreate webhookA
Register a webhook (HTTPS URL) to receive event callbacks — delivery status, inbound messages, link hits, opt-outs.
Inputs: url (required), name (required), senders, statuses, +2 more.
delete_listDelete contact listADestructive
Delete a contact list by ID. Requires KUDOSITY_API_SECRET (v1 auth).
Inputs: list_id (required).
delete_webhookDelete webhookADestructive
Delete a webhook by its ID.
Inputs: id (required).
get_balanceGet account balanceARead-only
Get your Kudosity account balance. Requires KUDOSITY_API_SECRET (v1 Basic auth).
Inputs: no named parameters.
get_endpointGet endpoint detailsARead-only
Get the full details of one Kudosity API endpoint — description, parameters, request body schema, and auth. Use search_endpoints or list_endpoints first.
Inputs: path (required), spec (required), method (required).
get_listGet contact listARead-only
Get a contact list, optionally including its members. Requires KUDOSITY_API_SECRET (v1 auth).
Inputs: list_id (required), members.
get_listsGet contact listsARead-only
List all contact lists on your account. Requires KUDOSITY_API_SECRET (v1 auth).
Inputs: no named parameters.
get_messageGet messageARead-only
Retrieve a previously sent message and its current status by channel and ID.
Inputs: id (required), channel (required).
list_endpointsList API endpointsARead-only
List all endpoints (path + method + summary) for a given Kudosity API spec. Use list_specs first to get spec titles.
Inputs: spec (required).
list_messagesList messagesARead-only
List sent or received messages with their delivery status. Filter by status, recipient, direction (OUT = sent, IN = inbound replies), and date range. This is the delivery-report and reply view.
Inputs: channel (required), limit, sender, status, +4 more.
list_specsList API specsARead-only
List the available Kudosity API specifications and how many endpoints each has. Use this to see what the Kudosity platform can do beyond the built-in tools.
Inputs: no named parameters.
list_webhooksList webhooksARead-only
List all webhooks configured on your account.
Inputs: no named parameters.
remove_contact_from_listRemove contact from listADestructive
Remove a contact from a list (list_id 0 = remove from all lists). Requires KUDOSITY_API_SECRET (v1 auth).
Inputs: number (required), list_id, country_code.
search_endpointsSearch API endpointsARead-only
Search the Kudosity API for endpoints matching a keyword — across paths, summaries, descriptions, tags and parameters. Use this to discover what the API can do.
Inputs: query (required), spec.
send_mmsSend MMSB
Send an MMS (media) message to a recipient via Kudosity.
Inputs: sender (required), recipient (required), content_urls (required), message, +3 more.
send_smsSend SMSA
Send an SMS text message to a single recipient via Kudosity.
Inputs: sender (required), message (required), recipient (required), message_ref, +1 more.
send_whatsappSend WhatsApp messageA
Send a WhatsApp message via Kudosity — either free-form text (only within an open 24h customer-service window) or a pre-approved template (sendable anytime).
Inputs: recipient (required), content_type (required), text, sender, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 19 tools
Each tool targets a distinct resource and action. Sending tools are separated by channel (SMS, MMS, WhatsApp), list management has clear CRUD operations, and API discovery tools are clearly differentiated between listing, searching, and retrieving endpoint details. No two tools appear to perform the same function.
All tool names follow a consistent lowercase snake_case verb_noun pattern. Verbs like list, get, create, delete, send, add, remove, and search are used uniformly, and there are no mixed conventions or camelCase deviations. The few longer names like remove_contact_from_list still fit the pattern.
At 19 tools, the count is slightly above the typical 3-15 range, but the server covers a broad domain: multi-channel messaging, contact lists, webhooks, balance, and API discovery. Each tool serves a distinct purpose and contributes to the overall functionality, so the count feels justified and not bloated.
The tool surface provides solid coverage for messaging (send and retrieve), contact list management (CRUD plus add/remove contacts), and webhooks (create, list, delete). Minor gaps exist, such as no direct update for lists or webhooks, but these can be worked around via delete+create. API discovery tools are a bonus that makes the surface quite comprehensive.
Maintenance
Related MCP Connectors
The Mobile Text Alerts SMS MCP server enables your AI to send SMS messages & manage contacts
Phone, SMS and email for AI agents. One remote MCP endpoint, OAuth login, zero install.
Give AI agents real phone numbers, messages, and voice calls via MCP.
MCP server for building and testing AI agents with multi-model experimentation and insights.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAn MCP (Multi-Agent Conversation Protocol) Server that enables interaction with the WhatsApp Business API, allowing agents to send messages, manage media, and perform other WhatsApp business operations through natural language.1-
- FlicenseCqualityDmaintenanceMCP server enabling interaction with Telnyx telephony, messaging, and AI assistant APIs through natural language.46-

@saperly/mcpofficial
AlicenseNot gradedqualityDmaintenanceMCP server for Saperly that enables AI agents to provision phone numbers, place calls, send SMS, and manage credentials via 36 tools backed by the Saperly API.56 npm3MIT- AlicenseNot gradedqualityDmaintenanceMCP server that connects AI agents to WhatsApp using the multi-device API, enabling messaging, group management, and more as a regular user.6 npm1MIT