Kudosity SMS Plugin for Claude Code

Send SMS, MMS, manage contact lists, and configure webhooks using the Kudosity messaging platform — directly from Claude Code.

Overview

This plugin integrates Claude Code with the Kudosity messaging APIs, enabling you to send SMS and MMS messages, create and manage contact lists, and configure webhooks through natural language commands.

All API operations are executed locally on your machine by Claude Code using curl with your own API credentials. The plugin connects to a remote MCP server for API documentation lookup only — no message data or credentials are sent through it.

Features

Skill	Description
/kudosity-sms:send-sms	Send SMS to individuals or contact lists (V1 + V2 API)
/kudosity-sms:send-mms	Send multimedia messages with images, GIFs, video, or audio (V2 API)
/kudosity-sms:create-list	Create contact lists and add recipients (V1 API)
/kudosity-sms:setup-webhook	Configure delivery status notifications, inbound messages, and more (V2 API)

The plugin also includes:

• /kudosity-sms:setup — interactive credential configuration and verification command
• kudosity-assistant — a specialized agent for coordinating multi-step messaging operations

Prerequisites

1. Kudosity account — Sign up for your free account
2. API credentials — Found in your account under Developers → API Settings
3. Claude Code v1.0.33+ — Run claude --version to check

Installation

From the official Anthropic marketplace

If approved on the official marketplace:

/plugin install kudosity-sms@claude-plugins-official

From the Kudosity marketplace (GitHub)

Add the Kudosity plugin marketplace and install:

/plugin marketplace add https://github.com/kudosity/kudosity-claude-sms-plugin
/reload-plugins
/plugin install kudosity-sms

Note: Run Claude Code from a directory where you have full read/write permissions (e.g., your project folder). On Windows, avoid running from restricted system directories.

For local development

git clone https://github.com/kudosity/kudosity-claude-sms-plugin.git
cd kudosity-claude-sms-plugin
claude

Claude Code will automatically detect the plugin files (.mcp.json, skills, commands, and agents) from the current directory.

Setup

1. Set your environment variables

Add these to your shell profile (~/.zshrc or ~/.bashrc):

export KUDOSITY_API_KEY="your_api_key"
export KUDOSITY_API_SECRET="your_api_secret"

Then reload your shell:

source ~/.zshrc

2. Verify your credentials

Run the setup command in Claude Code:

/kudosity-sms:setup

This will verify both your V1 and V2 API credentials and show your account balance.

Usage Examples

Create a contact list

"Create a contact list called 'March Campaign' with fields for email and postcode, then add John Doe (0491570156) and Jane Smith (0435795809)"

Send an SMS

"Send an SMS to 0491570156 from 61481074185 saying 'Your order has shipped!'"

"Send an SMS to my 'March Campaign' list saying 'Sale starts tomorrow!'"

Send an MMS

"Send an MMS to 0435795809 with the image at https://example.com/product.jpg, subject 'New Arrival'"

Set up a webhook

"Set up a webhook at https://myapp.com/sms-status to receive SMS delivery status and inbound messages"

Commands

Command	Description
/kudosity-sms:setup	Interactive credential configuration — collects your API Key and Secret, saves them to your shell profile, and validates against both V1 and V2 APIs

Skills

Skill	Description
send-sms	Send SMS to a single recipient (V2 API) or to contact lists / multiple numbers (V1 API). Supports scheduling, link tracking, and delivery callbacks.
send-mms	Send multimedia messages with images, GIFs, video, or audio attachments (V2 API).
create-list	Create contact lists and add contacts for campaign sends (V1 API).
setup-webhook	Configure webhooks for delivery status, inbound messages, MMS events, link hits, and opt-outs (V2 API).

Agents

Agent	Description
kudosity-assistant	A specialized messaging assistant that coordinates multi-step Kudosity operations. Understands API routing rules, authentication methods, and can chain multiple operations together.

API Coverage

Operation	API Version	Auth Method
Create list	V1	Basic Auth
Add contact to list	V1	Basic Auth
Send SMS (single recipient)	V2	x-api-key
Send SMS (to list / multiple)	V1	Basic Auth
Send MMS	V2	x-api-key
Create/manage webhooks	V2	x-api-key

The full API specifications are available as OpenAPI documents:

• V1: api_documentation.yml — Lists, contacts, bulk SMS
• V2: public-openapi.yaml — Single SMS, MMS, webhooks

Architecture & Trust Boundaries

This plugin has two distinct components with different trust boundaries:

MCP server (remote, read-only)

The plugin connects to the public Kudosity MCP server at developers.kudosity.com/mcp. This server provides API documentation and endpoint metadata only. It does not execute API operations, receive message content, or have access to your credentials.

MCP tools available:

• list-specs, list-endpoints, get-endpoint, search-endpoints — browse and search API documentation
• route-kudosity-operations — determines which API version to use for a given operation

API execution (local, authenticated)

All actual API operations (sending messages, creating lists, configuring webhooks) are executed locally by Claude Code on your machine using curl commands. API calls go directly from your machine to the Kudosity API servers:

• V1 API (api.transmitsms.com) — Basic Auth with -u flag
• V2 API (api.transmitmessage.com) — x-api-key header

Your credentials are never sent to the MCP server or to Claude. They are used only in direct API calls to Kudosity.

Security

• Credentials are stored locally as environment variables in your shell configuration file (e.g. ~/.zshrc). They are not embedded in any plugin file, sent to Claude, or transmitted to any remote service other than the Kudosity API during authenticated requests.
• API calls are executed locally by Claude Code using curl. Requests go directly from your machine to the Kudosity API — they do not pass through the MCP server or any intermediary.
• MCP server access is read-only — it serves API documentation and endpoint metadata only. No credentials, message content, or user data are sent to it.
• No telemetry or analytics are collected by this plugin.
• Shared machine risk: If you are on a shared machine, be aware that other users with access to your shell configuration file may be able to read your stored credentials. Consider your local machine security accordingly.

Plugin Structure

├── .claude-plugin/
│   ├── plugin.json              # Plugin manifest
│   └── marketplace.json         # Marketplace catalog entry
├── .mcp.json                    # MCP server connection config
├── skills/
│   ├── create-list/SKILL.md     # Contact list management
│   ├── send-sms/SKILL.md        # SMS sending
│   ├── send-mms/SKILL.md        # MMS sending
│   └── setup-webhook/SKILL.md   # Webhook configuration
├── agents/
│   └── kudosity-assistant.md    # Specialized messaging agent
├── commands/
│   └── setup.md                 # Credential setup wizard
├── .gitignore
├── CHANGELOG.md
├── LICENSE
└── README.md

Support & Resources

• API Documentation: developers.kudosity.com
• MCP Server: developers.kudosity.com/mcp
• V1 API Spec (OpenAPI): api_documentation.yml
• V2 API Spec (OpenAPI): public-openapi.yaml
• Kudosity Support: kudosity.com

License

MIT — see LICENSE