Kudosity

com.kudosityPublished by kudosity.comv0.5.0Updated Oct 24, 2026

Send SMS, MMS and WhatsApp, manage contacts and webhooks, from AI agents.

VerifiedSTDIODesktop onlyProductivity & WorkflowCommunication & Collaboration

Overview

AI-generated overview

Kudosity lets an assistant send SMS, MMS and WhatsApp messages, manage contacts and webhooks, and look up the Kudosity API.

What you can do
Send SMS, MMS and WhatsApp messages, and read sent or received messages with delivery status and filters by status, direction, recipient and dates. Create, list and delete webhooks for delivery status, inbound messages, link hits and opt-outs. Create, list, inspect and delete contact lists, and add or remove contacts. Check the account balance. Search the live Kudosity API specs by keyword and read endpoint details.
When to use it
Use it when an assistant should send customer messages or WhatsApp templates, review delivery status and replies, or maintain contact lists and webhooks through Kudosity. Also useful for looking up current Kudosity API endpoints while building an integration.
Requirements
Node.js 18 or later; runs locally via npx. A Kudosity account with an API key in KUDOSITY_API_KEY. Contact-list and balance tools also need KUDOSITY_API_SECRET. Network access to Kudosity's API and to the developer docs site for API discovery.
Before you install
Sending messages, creating or deleting webhooks, and changing contact lists all act on a live account and may incur messaging costs. KUDOSITY_API_KEY and KUDOSITY_API_SECRET are secrets; keep them out of shared config files. Message content, recipients and contact data are sent to Kudosity, and the discovery tools fetch data from Kudosity's developer site.

Installation

In SourceWeft

  1. Open Kudosity in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

ToolTypeDescription
send_smswriteSend an SMS to a recipient
send_mmswriteSend an MMS with a media attachment
send_whatsappwriteSend a WhatsApp message (free-form text or approved template)
get_messagereadGet a sent message and its status by channel + ID
list_messagesreadList sent/received messages with delivery status; filter by status, direction (sent/replies), recipient, dates

Webhooks

ToolTypeDescription
create_webhookwriteRegister an HTTPS webhook for delivery status, inbound messages, link hits, opt-outs
list_webhooksreadList configured webhooks
delete_webhookwriteDelete a webhook by ID

Contacts & lists (require KUDOSITY_API_SECRET)

ToolTypeDescription
create_listwriteCreate a contact list
get_listsreadList all contact lists
get_listreadGet a list and optionally its members
add_contact_to_listwriteAdd a contact to a list
remove_contact_from_listwriteRemove a contact from a list
delete_listwriteDelete a contact list

Account (requires KUDOSITY_API_SECRET)

ToolTypeDescription
get_balancereadGet your account balance

API discovery — research the whole Kudosity API, always current

ToolTypeDescription
list_specsreadList the Kudosity API specifications
list_endpointsreadList all endpoints for a spec
search_endpointsreadSearch the API by keyword
get_endpointreadGet full detail for one endpoint

The discovery tools read the live specs from developers.kudosity.com, so they always reflect the latest published docs.

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

json
{  "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

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

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:

ToolsAuthCredentials
Messaging, webhooks, discoveryx-api-key headerKUDOSITY_API_KEY
Contact lists, balanceHTTP BasicKUDOSITY_API_KEY + KUDOSITY_API_SECRET

Credentials are read from environment variables and never written to disk. Treat them as secrets.

Configuration

Env varRequiredDefaultDescription
KUDOSITY_API_KEYyes—Your Kudosity API key
KUDOSITY_API_SECRETfor contacts/balance—Your Kudosity API secret
KUDOSITY_API_BASE_URLnohttps://api.transmitmessage.comOverride the v2 API base URL
KUDOSITY_V1_BASE_URLnohttps://api.transmitsms.comOverride the v1 API base URL

Local development

bash
git clone https://github.com/kudosity/mcpcd mcpnpm installnpm run buildKUDOSITY_API_KEY=your_api_key npm start

Test tool listing with the MCP Inspector, or run the checks:

bash
npm test              # mock integration tests (no credentials)node test/discovery-test.mjs   # live spec-discovery test (no credentials)

License

MIT

Source: README.md at commit bac8bfc

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.5.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts