vendel-mcp

MCP server for Vendel SMS Gateway — send and receive SMS from Claude.

Exposes Vendel's SMS gateway as MCP tools, allowing Claude Desktop, Claude Code, and any MCP client to send messages, check quotas, manage templates, and schedule SMS.

Install

go install github.com/JimScope/vendel-mcp@latest

Setup

Claude Code

claude mcp add vendel -e VENDEL_URL=https://your-instance.com -e VENDEL_API_KEY=vk_your_key -- vendel-mcp

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "vendel": {
      "command": "vendel-mcp",
      "env": {
        "VENDEL_URL": "https://api.vendel.cc",
        "VENDEL_API_KEY": "vk_your_api_key"
      }
    }
  }
}

Configuration

| Variable | Required | Description | |----------|----------|-------------| | VENDEL_URL | Yes | Your Vendel instance URL (e.g. https://api.vendel.cc) | | VENDEL_API_KEY | Yes | Integration API key (starts with vk_) |

Tools

| Tool | Description | |------|-------------| | send_sms | Send an SMS to one or more phone numbers | | list_messages | List sent/received messages with filters | | get_message | Get details of a specific message | | check_quota | Check plan limits and current usage | | list_devices | List registered gateway devices | | list_templates | List available SMS templates | | send_template | Send an SMS using a saved template | | schedule_sms | Schedule an SMS for future delivery | | list_scheduled | List scheduled SMS messages |

Resources

| URI | Description | |-----|-------------| | vendel://quota | Current quota and plan limits as JSON |

Development

go build -o vendel-mcp .
VENDEL_URL=http://localhost:8090 VENDEL_API_KEY=vk_test ./vendel-mcp

License

MIT