{
  "markdown": "# Kudosity SMS Plugin for Claude Code\n\nSend SMS, MMS, manage contact lists, and configure webhooks using the [Kudosity](https://kudosity.com) messaging platform — directly from Claude Code.\n\n## Overview\n\nThis 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.\n\nAll 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.\n\n## Features\n\n| Skill | Description |\n|-------|-------------|\n| `/kudosity-sms:send-sms` | Send SMS to individuals or contact lists (V1 + V2 API) |\n| `/kudosity-sms:send-mms` | Send multimedia messages with images, GIFs, video, or audio (V2 API) |\n| `/kudosity-sms:create-list` | Create contact lists and add recipients (V1 API) |\n| `/kudosity-sms:setup-webhook` | Configure delivery status notifications, inbound messages, and more (V2 API) |\n\nThe plugin also includes:\n- `/kudosity-sms:setup` — interactive credential configuration and verification command\n- `kudosity-assistant` — a specialized agent for coordinating multi-step messaging operations\n\n## Prerequisites\n\n1. **Kudosity account** — [Sign up for your free account](https://kudosity.com/signup)\n2. **API credentials** — Found in your account under **Developers → API Settings**\n3. **Claude Code v1.0.33+** — Run `claude --version` to check\n\n## Installation\n\n### From the official Anthropic marketplace\n\nIf approved on the official marketplace:\n\n```\n/plugin install kudosity-sms@claude-plugins-official\n```\n\n### From the Kudosity marketplace (GitHub)\n\nAdd the Kudosity plugin marketplace and install:\n\n```\n/plugin marketplace add https://github.com/kudosity/kudosity-claude-sms-plugin\n/reload-plugins\n/plugin install kudosity-sms\n```\n\n> **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.\n\n### For local development\n\n```bash\ngit clone https://github.com/kudosity/kudosity-claude-sms-plugin.git\ncd kudosity-claude-sms-plugin\nclaude\n```\n\nClaude Code will automatically detect the plugin files (`.mcp.json`, skills, commands, and agents) from the current directory.\n\n## Setup\n\n### 1. Set your environment variables\n\nAdd these to your shell profile (`~/.zshrc` or `~/.bashrc`):\n\n```bash\nexport KUDOSITY_API_KEY=\"your_api_key\"\nexport KUDOSITY_API_SECRET=\"your_api_secret\"\n```\n\nThen reload your shell:\n\n```bash\nsource ~/.zshrc\n```\n\n### 2. Verify your credentials\n\nRun the setup command in Claude Code:\n\n```\n/kudosity-sms:setup\n```\n\nThis will verify both your V1 and V2 API credentials and show your account balance.\n\n## Usage Examples\n\n### Create a contact list\n\n> \"Create a contact list called 'March Campaign' with fields for email and postcode, then add John Doe (0491570156) and Jane Smith (0435795809)\"\n\n### Send an SMS\n\n> \"Send an SMS to 0491570156 from 61481074185 saying 'Your order has shipped!'\"\n\n> \"Send an SMS to my 'March Campaign' list saying 'Sale starts tomorrow!'\"\n\n### Send an MMS\n\n> \"Send an MMS to 0435795809 with the image at https://example.com/product.jpg, subject 'New Arrival'\"\n\n### Set up a webhook\n\n> \"Set up a webhook at https://myapp.com/sms-status to receive SMS delivery status and inbound messages\"\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `/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 |\n\n## Skills\n\n| Skill | Description |\n|-------|-------------|\n| `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. |\n| `send-mms` | Send multimedia messages with images, GIFs, video, or audio attachments (V2 API). |\n| `create-list` | Create contact lists and add contacts for campaign sends (V1 API). |\n| `setup-webhook` | Configure webhooks for delivery status, inbound messages, MMS events, link hits, and opt-outs (V2 API). |\n\n## Agents\n\n| Agent | Description |\n|-------|-------------|\n| `kudosity-assistant` | A specialized messaging assistant that coordinates multi-step Kudosity operations. Understands API routing rules, authentication methods, and can chain multiple operations together. |\n\n## API Coverage\n\n| Operation | API Version | Auth Method |\n|-----------|------------|-------------|\n| Create list | V1 | Basic Auth |\n| Add contact to list | V1 | Basic Auth |\n| Send SMS (single recipient) | V2 | x-api-key |\n| Send SMS (to list / multiple) | V1 | Basic Auth |\n| Send MMS | V2 | x-api-key |\n| Create/manage webhooks | V2 | x-api-key |\n\nThe full API specifications are available as OpenAPI documents:\n- **V1**: [`api_documentation.yml`](https://developers.kudosity.com/openapi/api_documentation.yml) — Lists, contacts, bulk SMS\n- **V2**: [`public-openapi.yaml`](https://developers.kudosity.com/openapi/public-openapi.yaml) — Single SMS, MMS, webhooks\n\n## Architecture & Trust Boundaries\n\nThis plugin has two distinct components with different trust boundaries:\n\n### MCP server (remote, read-only)\n\nThe plugin connects to the public Kudosity MCP server at [`developers.kudosity.com/mcp`](https://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.\n\nMCP tools available:\n- `list-specs`, `list-endpoints`, `get-endpoint`, `search-endpoints` — browse and search API documentation\n- `route-kudosity-operations` — determines which API version to use for a given operation\n\n### API execution (local, authenticated)\n\nAll 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:\n\n- **V1 API** (`api.transmitsms.com`) — Basic Auth with `-u` flag\n- **V2 API** (`api.transmitmessage.com`) — `x-api-key` header\n\nYour credentials are never sent to the MCP server or to Claude. They are used only in direct API calls to Kudosity.\n\n## Security\n\n- **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.\n- **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.\n- **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.\n- **No telemetry or analytics** are collected by this plugin.\n- **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.\n\n## Plugin Structure\n\n```\n├── .claude-plugin/\n│   ├── plugin.json              # Plugin manifest\n│   └── marketplace.json         # Marketplace catalog entry\n├── .mcp.json                    # MCP server connection config\n├── skills/\n│   ├── create-list/SKILL.md     # Contact list management\n│   ├── send-sms/SKILL.md        # SMS sending\n│   ├── send-mms/SKILL.md        # MMS sending\n│   └── setup-webhook/SKILL.md   # Webhook configuration\n├── agents/\n│   └── kudosity-assistant.md    # Specialized messaging agent\n├── commands/\n│   └── setup.md                 # Credential setup wizard\n├── .gitignore\n├── CHANGELOG.md\n├── LICENSE\n└── README.md\n```\n\n## Support & Resources\n\n- **API Documentation**: [developers.kudosity.com](https://developers.kudosity.com)\n- **MCP Server**: [developers.kudosity.com/mcp](https://developers.kudosity.com/mcp)\n- **V1 API Spec (OpenAPI)**: [api_documentation.yml](https://developers.kudosity.com/openapi/api_documentation.yml)\n- **V2 API Spec (OpenAPI)**: [public-openapi.yaml](https://developers.kudosity.com/openapi/public-openapi.yaml)\n- **Kudosity Support**: [kudosity.com](https://kudosity.com)\n\n## License\n\nMIT — see [LICENSE](LICENSE)",
  "bytes": 8460,
  "sha": "6a546590e4d40a6b5a008b1977d97632b53d6e9133ec8411c30b47e71e60f292",
  "repo_slug": "kudosity/kudosity-claude-sms-plugin",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_kudosity_kudosity_claude_sms_plugin_kudo_d165906d/readme"
}