MCP server de ChatPush
Commit 2 nov 2026Permite que los agentes de IA envíen mensajes, archivos y envíos masivos a través de WhatsApp, Telegram, SMS, VK/OK y MAX.
También conocido como ChatPush/mcp-chatpush
- Stars
- 0
- Herramientas
- 11
- Descargas, 30 días
- —
- Última versión
- —
- Último commit
- 2 nov 2026
- Licencia
- MIT
¿Qué es ChatPush MCP?
Permite que los agentes de IA envíen mensajes, archivos y envíos masivos a través de WhatsApp, Telegram, SMS, VK/OK y MAX. Expone 11 herramientas, como get_account, get_balance, get_utm_tags.
Resumen generado a partir del README del proyecto
Acerca del MCP server de ChatPush
mcp-chatpush permite enviar mensajes a través de múltiples canales de comunicación desde un agente de IA. Los desarrolladores pueden usar este server para despachar texto, archivos y envíos masivos vía WhatsApp, Telegram, SMS, VK/OK y MAX. Soporta flujos de mensajería complejos que incluyen entrega programada, configuración de prioridad y cascada a través de diferentes canales si el primer intento falla.
Los usuarios pueden ejecutar este server de dos formas distintas según su entorno. Para desarrollo local con Claude Desktop, Claude Code, Cursor o VS Code, funciona vía stdio usando un CHATPUSH_TOKEN. Para plataformas como Yandex que requieren una conexión por URL, ofrece un modo remoto usando streamable HTTP. En la configuración remota, los clientes proporcionan su propio token en el header de Authorization, asegurando que la instancia alojada sea stateless y segura.
El conjunto de herramientas incluye funciones para gestionar saldos de cuenta, verificar estados de entrega y manejar transferencias de archivos de hasta 100 MB. También permite gestionar conexiones de mensajería mediante enlaces de código QR y organizar configuraciones de múltiples cuentas con subclientes.
Qué puedes hacer con él
- 1Notificaciones multicanal automatizadasInstruye a una IA para que envíe un mensaje por WhatsApp y use SMS como respaldo si falla.
- 2Recordatorios de citas programadosPide al agente que programe un mensaje específico para una fecha y hora futura.
- 3Distribución de archivos vía chatHaz que la IA envíe un documento o imagen a un destinatario usando una ruta local o una URL.
- 4Conexión de cuentas de mensajeríaGenera un enlace para conectar una cuenta personal de WhatsApp o Telegram mediante código QR.
- 5Campañas de mensajería masivaOrdena al agente que envíe un único mensaje a una lista extensa de números de teléfono.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Herramientas de ChatPush MCP 11
Detectado desde el READMEget_accountget_balanceget_utm_tagssend_messagesend_bulksend_fileget_delivery_statusdelete_deliveryget_phone_infoset_chat_client_nameget_messenger_auth_link
| get_account | — | |
| get_balance | — | |
| get_utm_tags | — | |
| send_message | — | |
| send_bulk | — | |
| send_file | — | |
| get_delivery_status | — | |
| delete_delivery | — | |
| get_phone_info | — | |
| set_chat_client_name | — | |
| get_messenger_auth_link | — |
Configuración
CHATPUSH_TOKEN
| Nombre | Descripción | Tipo |
|---|---|---|
| CHATPUSH_TOKEN | — |
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesiblechatpush/mcp-chatpush is public and reachablegithub.com/chatpush/mcp-chatpush ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-11-02github.com/chatpush/mcp-chatpush ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo11 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en GitHubChatPush MCP Server
Official MCP server for ChatPush — send WhatsApp, Telegram, SMS, VK/OK and MAX messages, files and bulk mailings from AI agents.
It runs in two modes from the same codebase:
| Mode | Transport | Who it is for | Token |
|---|---|---|---|
| Remote | Streamable HTTP, hosted at https://mcp.chatpush.ru/mcp |
Yandex and other platforms that connect to a URL; users with no local Node.js | Each caller sends their own token in the Authorization header |
| Local | stdio, npx -y chatpush-mcp-server |
Claude Desktop, Claude Code, Cursor, VS Code | CHATPUSH_TOKEN in the client config |
Tools
| Tool | Description |
|---|---|
get_account |
Full account info: balance, dispatch routing, sender names, subscription, WhatsApp/Telegram session status |
get_balance |
Balance, customer ID, dispatch routing channels and registered sender names |
get_utm_tags |
UTM tags used to track dispatches |
send_message |
Send a text via WhatsApp, Telegram (tdlib), Telegram Bot, SMS, VK/OK or MAX — with cascade, scheduling, priority and reply-to |
send_bulk |
Send the same message to many phone numbers at once |
send_file |
Send a document, image, audio or video from a local path, URL or base64 (up to 100 MB) |
get_delivery_status |
Status and details of a delivery, explained in plain words |
delete_delivery |
Delete a delivered WhatsApp/Telegram message on all recipient devices |
get_phone_info |
Country, operator and normalized format of a phone number |
create_webhook · get_webhook · list_webhooks · update_webhook · delete_webhook |
Subscribe your backend to incoming messages, delivery statuses and login events |
set_chat_client_name |
Rename a contact in the ChatPush web messenger |
get_messenger_auth_link |
Link to the QR page that connects WhatsApp or a personal Telegram account |
create_sub_customer · list_sub_customers · get_sub_customer |
Multi-account: create and inspect sub-clients, each with its own token |
Get a token
Sign up at chatpush.ru and copy the API token from the dashboard. To send through WhatsApp or Telegram, connect the messenger in the dashboard first — or call get_messenger_auth_link and scan the QR code.
Remote mode (hosted)
The hosted server exposes one MCP endpoint:
POST https://mcp.chatpush.ru/mcp
Authorization: Bearer <ChatPush API token>
- Transport: Streamable HTTP (MCP protocol 2025-06-18), JSON responses enabled.
- Stateless: a fresh server instance per request, so it scales horizontally behind any proxy.
- No credentials on the server: the token is read from the request header and used only for that request. Nothing is stored or logged.
GET /healthzreturns{"status":"ok",...}without a token, for load-balancer checks.
Connecting from a client that supports remote MCP servers:
{
"url": "https://mcp.chatpush.ru/mcp",
"headers": { "Authorization": "Bearer your_token_here" }
}
Deployment
docker build -t chatpush-mcp-server .
docker run -p 3000:3000 -e CHATPUSH_ALLOWED_HOSTS=mcp.chatpush.ru chatpush-mcp-server
Without Docker: npm ci && npm run build && npm run start:http.
Put TLS in front (nginx, Traefik, a cloud load balancer) and point mcp.chatpush.ru at it. The service needs no database, no disk and no secrets.
| Variable | Default | Description |
|---|---|---|
PORT |
3000 |
Port to listen on |
HOST |
0.0.0.0 |
Interface to bind |
CHATPUSH_MCP_PATH |
/mcp |
Path of the MCP endpoint |
CHATPUSH_BASE_URL |
https://api.chatpush.ru |
ChatPush API host |
CHATPUSH_ALLOWED_HOSTS |
— | Comma-separated Host values to accept, e.g. mcp.chatpush.ru. Set it in production: it blocks DNS-rebinding attacks |
CHATPUSH_ALLOWED_ORIGIN |
* |
Value for Access-Control-Allow-Origin |
CHATPUSH_DEBUG |
0 |
1 logs every request to stderr |
Local mode (stdio)
Requires Node.js 20 or newer.
Claude Desktop
Settings → Developer → Edit Config (claude_desktop_config.json):
{
"mcpServers": {
"chatpush": {
"command": "npx",
"args": ["-y", "chatpush-mcp-server"],
"env": { "CHATPUSH_TOKEN": "your_token_here" }
}
}
}
Claude Code
claude mcp add chatpush --env CHATPUSH_TOKEN=your_token_here -- npx -y chatpush-mcp-server
Cursor
Add the same mcpServers block to ~/.cursor/mcp.json.
VS Code
.vscode/mcp.json — VS Code asks for the token and keeps it out of the file:
{
"inputs": [
{ "type": "promptString", "id": "chatpush_token", "description": "ChatPush token", "password": true }
],
"servers": {
"chatpush": {
"type": "stdio",
"command": "npx",
"args": ["-y", "chatpush-mcp-server"],
"env": { "CHATPUSH_TOKEN": "${input:chatpush_token}" }
}
}
}
Channels
dispatch_routing is an ordered list of channels. ChatPush tries them one by one and moves to the next only if delivery through the previous one fails. Without it, the default routing from your dashboard is used.
| Value | Channel | Recipient |
|---|---|---|
whatsapp |
phone or whatsapp_lid |
|
tdlib |
Personal Telegram account | phone, username or tdlib_user_id (negative ID = group chat) |
telegram |
Telegram Bot | phone |
sms |
SMS | phone |
notify |
VK / OK notifications | phone |
max |
MAX messenger | phone |
Usage examples
| Say | Tool |
|---|---|
| "Send a WhatsApp message to +7 999 123-45-67: your order has shipped." | send_message |
| "Try WhatsApp first, then SMS: your code is 4821." | send_message (cascade) |
| "Remind 79991234567 tomorrow at 09:00 UTC about the appointment." | send_message (scheduled) |
| "Send invoice.pdf to 79991234567." | send_file |
| "Was message 94396942 delivered?" | get_delivery_status |
| "Connect my WhatsApp." | get_messenger_auth_link |
| "Create a sub-client called Acme." | create_sub_customer |
| "Rename the contact 79991234567 to Ivan from Acme." | set_chat_client_name |
Behaviour
- Parameters go in the URL query string, as the ChatPush API expects;
send_fileuploads the file asmultipart/form-data. - Incompatible parameters (a Telegram
usernamewithout thetdlibchannel,scheduled_atin the past) are rejected before any request is sent. - HTTP 429 is retried up to 3 times with exponential backoff, honouring
Retry-After; 5xx twice — except for requests that send messages, so nothing is sent twice. - Requests time out after 30 seconds.
- Errors come back as readable tool errors, e.g.
Invalid ChatPush token. Check your CHATPUSH_TOKEN. - All logs go to stderr; stdout carries the MCP protocol in stdio mode.
Development
npm install
cp .env.example .env # put your token in .env
npm run build
npm run dev # stdio
npm run dev:http # remote, http://localhost:3000/mcp
| Script | What it does |
|---|---|
npm run check |
Versions in sync across package.json / server.json / manifest.json and all 19 tools exposed |
npm run build:mcpb |
Build the Claude Desktop extension into build/chatpush-mcp-server.mcpb |
npm run inspector |
Open the MCP Inspector against the local server |
License
Preguntas sobre ChatPush MCP
¿Qué herramientas proporciona ChatPush MCP?
Expone 11 herramientas, incluidas get_account, get_balance, get_utm_tags, send_message, send_bulk.
¿Cómo conecto mi cuenta de WhatsApp o Telegram?
Puedes conectar tu mensajería desde el dashboard de ChatPush o llamar a la herramienta get_messenger_auth_link para escanear un código QR.
¿Puedo enviar archivos a través del MCP server de ChatPush?
Sí, puedes enviar documentos, imágenes, audio o archivos de video de hasta 100 MB desde una ruta local, una URL o base64.
¿Qué pasa si un mensaje no se entrega por un canal?
Puedes usar el enrutamiento en cascada para intentar varios canales en orden; el servidor pasará al siguiente canal solo si la entrega en el anterior falla.