https://github.com/jimscope/vendel-mcp
MCP server for Vendel SMS Gateway
https://github.com/jimscope/vendel-mcp
Last synced: 3 months ago
JSON representation
MCP server for Vendel SMS Gateway
- Host: GitHub
- URL: https://github.com/jimscope/vendel-mcp
- Owner: JimScope
- Created: 2026-03-21T17:16:00.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-05T03:21:25.000Z (3 months ago)
- Last Synced: 2026-04-05T04:25:53.452Z (3 months ago)
- Language: Go
- Size: 26.4 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# vendel-mcp
MCP server for [Vendel SMS Gateway](https://vendel.cc) — 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
```bash
go install github.com/JimScope/vendel-mcp@latest
```
## Setup
### Claude Code
```bash
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`:
```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
```bash
go build -o vendel-mcp .
VENDEL_URL=http://localhost:8090 VENDEL_API_KEY=vk_test ./vendel-mcp
```
## License
MIT