# Kudosity MCP server

> Enables AI agents to send SMS, MMS, and WhatsApp messages, manage contact lists, and configure webhooks via the Kudosity API.

- Repository: https://github.com/kudosity/mcp
- Page: https://hostedmcp.org/servers/kudosity/mcp
- Transport: stdio
- Stars: 1
- License: MIT
- Latest version: 0.5.0

## Install

### Claude Code

```sh
claude mcp add --env 'KUDOSITY_API_KEY=<YOUR_KUDOSITY_API_KEY>' --env 'KUDOSITY_API_SECRET=<YOUR_KUDOSITY_API_SECRET>' mcp -- npx -y kudosity-mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "kudosity-mcp"
      ],
      "env": {
        "KUDOSITY_API_KEY": "<YOUR_KUDOSITY_API_KEY>",
        "KUDOSITY_API_SECRET": "<YOUR_KUDOSITY_API_SECRET>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "kudosity-mcp"
      ],
      "env": {
        "KUDOSITY_API_KEY": "<YOUR_KUDOSITY_API_KEY>",
        "KUDOSITY_API_SECRET": "<YOUR_KUDOSITY_API_SECRET>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","kudosity-mcp"],"env":{"KUDOSITY_API_KEY":"<YOUR_KUDOSITY_API_KEY>","KUDOSITY_API_SECRET":"<YOUR_KUDOSITY_API_SECRET>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "kudosity-mcp"
      ],
      "env": {
        "KUDOSITY_API_KEY": "<YOUR_KUDOSITY_API_KEY>",
        "KUDOSITY_API_SECRET": "<YOUR_KUDOSITY_API_SECRET>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add mcp --env 'KUDOSITY_API_KEY=<YOUR_KUDOSITY_API_KEY>' --env 'KUDOSITY_API_SECRET=<YOUR_KUDOSITY_API_SECRET>' -- npx -y kudosity-mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.mcp]
command = "npx"
args = ["-y", "kudosity-mcp"]

[mcp_servers.mcp.env]
KUDOSITY_API_KEY = "<YOUR_KUDOSITY_API_KEY>"
KUDOSITY_API_SECRET = "<YOUR_KUDOSITY_API_SECRET>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'KUDOSITY_API_KEY=<YOUR_KUDOSITY_API_KEY>' -e 'KUDOSITY_API_SECRET=<YOUR_KUDOSITY_API_SECRET>' mcp npx -- -y kudosity-mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "kudosity-mcp"
      ],
      "env": {
        "KUDOSITY_API_KEY": "<YOUR_KUDOSITY_API_KEY>",
        "KUDOSITY_API_SECRET": "<YOUR_KUDOSITY_API_SECRET>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `KUDOSITY_API_KEY` | yes | yes | Your Kudosity API key (Settings → API Settings). |
| `KUDOSITY_API_SECRET` | no | yes | Your Kudosity API secret. Required only for contact-list and balance tools. |

## Tools (19)

- `send_sms`
- `send_mms`
- `send_whatsapp`
- `get_message`
- `list_messages`
- `create_webhook`
- `list_webhooks`
- `delete_webhook`
- `create_list`
- `get_lists`
- `get_list`
- `add_contact_to_list`
- `remove_contact_from_list`
- `delete_list`
- `get_balance`
- `list_specs`
- `list_endpoints`
- `search_endpoints`
- `get_endpoint`

## FAQ

### What credentials do I need to use the Kudosity MCP server?

You need a Kudosity API key, and for contact list and balance tools, you also need your API secret.

### Can I use the server without an API secret?

Yes, the API secret is optional if you only intend to use messaging, webhooks, and API discovery tools.

### How do I install the Kudosity MCP server?

The server can be run via npx without needing to clone the repository.

### Does the server support WhatsApp messaging?

Yes, it allows sending WhatsApp messages using either free-form text or approved templates.
