Serveur MCP ChatPush
Commit 2 nov. 2026Permet aux agents IA d'envoyer des messages, des fichiers et des campagnes d'e-mailing groupées via WhatsApp, Telegram, SMS, VK/OK et MAX.
Aussi connu sous ChatPush/mcp-chatpush
- Étoiles
- 0
- Outils
- 11
- Téléchargements, 30 jours
- —
- Dernière version
- —
- Dernier commit
- 2 nov. 2026
- Licence
- MIT
Qu'est-ce que ChatPush MCP ?
Permet aux agents IA d'envoyer des messages, des fichiers et des campagnes d'e-mailing groupées via WhatsApp, Telegram, SMS, VK/OK et MAX. Il expose 11 outils, comme get_account, get_balance, get_utm_tags.
Résumé généré à partir du README du projet
À propos du MCP server ChatPush
L'extension mcp-chatpush permet d'envoyer des messages sur plusieurs canaux de communication directement depuis un agent IA. Les développeurs peuvent utiliser ce serveur pour diffuser du texte, des fichiers et des envois groupés via WhatsApp, Telegram, SMS, VK/OK et MAX. Il prend en charge des workflows de messagerie complexes, notamment la livraison programmée, les paramètres de priorité et le basculement vers différents canaux si la première tentative échoue.
Les utilisateurs peuvent exécuter ce serveur de deux manières distinctes selon leur environnement. Pour le développement local avec Claude Desktop, Claude Code, Cursor ou VS Code, il fonctionne via stdio en utilisant un CHATPUSH_TOKEN. Pour les plateformes comme Yandex qui nécessitent une connexion par URL, il propose un mode distant via streamable HTTP. Dans la configuration distante, les appelants fournissent leur propre jeton dans l'en-tête Authorization, garantissant que l'instance hébergée reste sans état et sécurisée.
La boîte à outils comprend des fonctions pour gérer les soldes de compte, vérifier les statuts de livraison et gérer les transferts de fichiers jusqu'à 100 MB. Elle permet également de gérer les connexions aux messageries via des liens de code QR et d'organiser des configurations multi-comptes avec des sous-clients.
Ce que vous pouvez faire avec
- 1Notifications multi-canaux automatiséesDonnez l'instruction à une IA d'envoyer un message via WhatsApp et de basculer sur SMS en cas d'échec.
- 2Rappels de rendez-vous programmésDemandez à l'agent de programmer un message spécifique pour une date et une heure ultérieures.
- 3Distribution de fichiers via chatDemandez à l'IA d'envoyer un document ou une image à un destinataire en utilisant un chemin local ou une URL.
- 4Connexion de compte de messagerieGénérez un lien pour connecter un compte personnel WhatsApp ou Telegram via un code QR.
- 5Campagnes de messagerie groupéeCommandez à l'agent d'envoyer un message unique à une liste importante de numéros de téléphone.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Outils MCP ChatPush 11
Détectés depuis le 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 | — |
Configuration
CHATPUSH_TOKEN
| Nom | Description | Type |
|---|---|---|
| CHATPUSH_TOKEN | — |
Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →Pas encore vérifié. Un serveur nécessite un score de 80, aucune faille sérieuse et suffisamment de données pour que nous puissions effectuer les vérifications. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessiblechatpush/mcp-chatpush is public and reachablegithub.com/chatpush/mcp-chatpush ↗Réussi
- Le nom du package correspond au dépôt sourceNon vérifié
- Provenance du build (attestation Sigstore)Non vérifié
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-11-02github.com/chatpush/mcp-chatpush ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNon vérifié
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle11 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur 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
Questions sur ChatPush MCP
Quels outils ChatPush MCP fournit-il ?
Il expose 11 outils, dont get_account, get_balance, get_utm_tags, send_message, send_bulk.
Comment puis-je connecter mon compte WhatsApp ou Telegram ?
Vous pouvez connecter votre messagerie depuis le tableau de bord ChatPush ou appeler l'outil get_messenger_auth_link pour scanner un code QR.
Puis-je envoyer des fichiers via le MCP server de ChatPush ?
Oui, vous pouvez envoyer des documents, des images, de l'audio ou des fichiers vidéo jusqu'à 100 MB à partir d'un chemin local, d'une URL ou en base64.
Que se passe-t-il si un message ne peut pas être délivré via un canal ?
Vous pouvez utiliser le routage en cascade pour tester plusieurs canaux par ordre de priorité ; le serveur passe au canal suivant uniquement si la livraison via le précédent échoue.