kudosity-sms

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