Skip to main content
Glama
Kudosity MCP Server

Kudosity MCP Server

Official

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

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.

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

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.

Configuration

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

Local development

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)

License

MIT

Available Tools

19 tools
add_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 listA
Destructive

Delete a contact list by ID. Requires KUDOSITY_API_SECRET (v1 auth).

Inputs: list_id (required).

delete_webhookDelete webhookA
Destructive

Delete a webhook by its ID.

Inputs: id (required).

get_balanceGet account balanceA
Read-only

Get your Kudosity account balance. Requires KUDOSITY_API_SECRET (v1 Basic auth).

Inputs: no named parameters.

get_endpointGet endpoint detailsA
Read-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 listA
Read-only

Get a contact list, optionally including its members. Requires KUDOSITY_API_SECRET (v1 auth).

Inputs: list_id (required), members.

get_listsGet contact listsA
Read-only

List all contact lists on your account. Requires KUDOSITY_API_SECRET (v1 auth).

Inputs: no named parameters.

get_messageGet messageA
Read-only

Retrieve a previously sent message and its current status by channel and ID.

Inputs: id (required), channel (required).

list_endpointsList API endpointsA
Read-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 messagesA
Read-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 specsA
Read-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 webhooksA
Read-only

List all webhooks configured on your account.

Inputs: no named parameters.

remove_contact_from_listRemove contact from listA
Destructive

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 endpointsA
Read-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

    A3.9/5.0

    Scored across 19 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      An 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
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP 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 npm
      3
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that connects AI agents to WhatsApp using the multi-device API, enabling messaging, group management, and more as a regular user.
      6 npm
      1
      MIT