LigueLead

MCP Server for sendingSMS,SMS Flash,voice calls, andRCSin Brazil via theLigueLead API. EnableClaude,Cursor,Windsurf, and any MCP-compatible AI agent to send real communications — no code, no complex setup.

{ "mcpServers": { "liguelead": { "command": "npx", "args": ["-y", "@liguelead/mcp-server"], "env": { "LIGUELEAD_API_TOKEN": "your-token", "LIGUELEAD_APP_ID": "your-app-id", "TRANSPORT": "stdio" } } } }

git clone https://github.com/liguelead/mcp.git cd mcp npm install cp .env.example .env # Edit with your credentials npm run build npm start

The server starts athttp://localhost:3000by default.
- Go toareadocliente.liguelead.app.br
- Navigate toIntegrações → API Token
- Create an App and copy theAPI TokenandApp ID

{ "mcpServers": { "liguelead": { "command": "npx", "args": ["-y", "@liguelead/mcp-server"], "env": { "LIGUELEAD_API_TOKEN": "your-token", "LIGUELEAD_APP_ID": "your-app-id", "TRANSPORT": "stdio" } } } }

claude mcp add -s user liguelead \ -e LIGUELEAD_API_TOKEN=your-token \ -e LIGUELEAD_APP_ID=your-app-id \ -e TRANSPORT=stdio \ -- npx -y @liguelead/mcp-server

Add to your MCP settings with the same configuration as Claude Desktop above.

Any MCP client that supports Streamable HTTP can connect via:

Credentials stay on the server — the client doesn't need them.

For clients that don't support HTTP natively (e.g., Claude Desktop connecting to a remote server):

{ "mcpServers": { "liguelead": { "command": "npx", "args": ["mcp-remote", "https://your-server.com/mcp"] } } }

docker build -t liguelead-mcp . docker run -d -p 3000:3000 \ -e LIGUELEAD_API_TOKEN=your-token \ -e LIGUELEAD_APP_ID=your-app-id \ liguelead-mcp

- Connect the Git repository
- Set environment variables:LIGUELEAD_API_TOKEN,LIGUELEAD_APP_ID
- Build command:npm install && npm run build
- Start command:npm start

⚠️ Credentials are NEVER committed to code. The.envfile is in.gitignore.
- Go toareadocliente.liguelead.app.br
- Navigate toIntegrações → API Token → Webhook URL
- Enter your public HTTPS endpoint URL
- Save

{ "total": 42, "webhooks": [...] }

⚠️CRITICAL:LigueLead does NOT retry failed webhooks. If your endpoint is down, the webhook is lost permanently.

Brazilian phone numbers are accepted in three formats:

🚫SMS Flash does NOT allow URLsin message content.

- Supported formats:MP3 and WAV (no AAC/M4A)
- Max file size:50 MB (recommended: 5–10 MB)
- Billing:Up to 30s = 1 credit; over 30s = 2 credits
- Dialing window:08:00–21:44 (America/Sao_Paulo). Requests after 21:45 are queued until 08:00.

RCS campaigns are built from a template registered via one of thecreate_rcs_template_tools, then sent withsend_rcsusing the returnedtemplate_id(or as a freeform, template-less message).

liguelead-mcp/ ├── src/ │ ├── index.ts # Entry point — HTTP or stdio │ ├── config.ts # Env var validation (Zod) + .env loader │ ├── lib/ │ │ ├── api-client.ts # HTTP client for LigueLead API │ │ ├── validators.ts # Phone/RCS schemas (Zod) │ │ └── webhook.ts # Webhook handler + GET /webhooks │ └── tools/ │ ├── sms.ts # Tool: send_sms │ ├── voice.ts # Tools: voice (list/get/upload/send) │ └── rcs.ts # Tools: RCS (templates + send_rcs) ├── skill/ # Claude Code Skill │ └── SKILL.md ├── .env.example ├── Dockerfile ├── LICENSE ├── package.json ├── server.json ├── glama.json └── README.md

{ "mcpServers": { "liguelead": { "command": "npx", "args": ["-y", "@liguelead/mcp-server"], "env": { "LIGUELEAD_API_TOKEN": "seu-token", "LIGUELEAD_APP_ID": "seu-app-id", "TRANSPORT": "stdio" } } } }

git clone https://github.com/liguelead/mcp.git cd mcp npm install cp .env.example .env # Edite com suas credenciais npm run build npm start

{ "mcpServers": { "liguelead": { "command": "npx", "args": ["-y", "@liguelead/mcp-server"], "env": { "LIGUELEAD_API_TOKEN": "seu-token", "LIGUELEAD_APP_ID": "seu-app-id", "TRANSPORT": "stdio" } } } }

claude mcp add -s user liguelead \ -e LIGUELEAD_API_TOKEN=seu-token \ -e LIGUELEAD_APP_ID=seu-app-id \ -e TRANSPORT=stdio \ -- npx -y @liguelead/mcp-server

Uma campanha de RCS é criada a partir de um template registrado com uma das toolscreate_rcs_template_, e enviada comsend_rcsusando otemplate_idretornado (ou como mensagem livre, sem template).

- bodyaté 1.600 chars; suporta placeholders{{N}}, sobrescrevíveis viadefault_variables(template) outemplate_variables(no envio)
- media_fileaceita um data URI em base64, máximo 5 MB decodificado
- fallback_message(máx 306 chars) é o SMS enviado caso a entrega via RCS falhe
- Omessagelivre dosend_rcsé limitado a 306 chars (mutuamente exclusivo comtemplate_id) — reaproveitado como fallback de SMS
- Operação assíncrona — retorna 202 ao ser enfileirada; o status chega pelo webhook configurado
- Acesseareadocliente.liguelead.app.br
- Vá emIntegrações → API Token → Webhook URL
- Insira a URL HTTPS do seu endpoint
- Salve

Wavix is a global communications platform offering APIs for voice, SMS, 2FA, and phone numbers. Our MCP server brings these capabilities to AI agents and agentic workflows.