ChatPush MCP server
Commit 2. Nov. 2026Ermöglicht es AI-Agenten, WhatsApp, Telegram, SMS, VK/OK und MAX Nachrichten, Dateien und Bulk-Mailings zu versenden.
Auch bekannt als ChatPush/mcp-chatpush
- Stars
- 0
- Tools
- 11
- Downloads, 30 Tage
- —
- Neueste Version
- —
- Letzter Commit
- 2. Nov. 2026
- Lizenz
- MIT
Was ist ChatPush MCP?
Ermöglicht es AI-Agenten, WhatsApp, Telegram, SMS, VK/OK und MAX Nachrichten, Dateien und Bulk-Mailings zu versenden. Er stellt 11 Tools bereit, etwa get_account, get_balance, get_utm_tags.
Zusammenfassung generiert aus dem README des Projekts
Über ChatPush MCP server
mcp-chatpush ermöglicht es, Nachrichten über mehrere Kommunikationskanäle direkt aus einem AI-Agenten heraus zu versenden. Entwickler können diesen Server nutzen, um Text, Dateien und Bulk-Mailings via WhatsApp, Telegram, SMS, VK/OK und MAX zu verschicken. Er unterstützt komplexe Messaging-Workflows inklusive geplanter Zustellung, Prioritätseinstellungen und dem Wechsel durch verschiedene Kanäle (Cascading), falls der erste Versuch fehlschlägt.
Nutzer können diesen Server auf zwei verschiedene Arten betreiben, abhängig von ihrer Umgebung. Für die lokale Entwicklung mit Claude Desktop, Claude Code, Cursor oder VS Code läuft er via stdio unter Verwendung eines CHATPUSH_TOKEN. Für Plattformen wie Yandex, die eine URL-Verbindung erfordern, bietet er einen Remote-Modus via streamable HTTP an. Bei der Remote-Einrichtung übergeben die Aufrufer ihren eigenen Token im Authorization-Header, wodurch sichergestellt wird, dass die gehostete Instanz stateless und sicher bleibt.
Das Toolset umfasst Funktionen zur Verwaltung von Kontoguthaben, zur Überprüfung des Zustellstatus und zur Handhabung von Dateiübertragungen bis zu 100 MB. Zudem ermöglicht es die Verwaltung von Messenger-Verbindungen über QR-Code-Links und die Organisation von Multi-Account-Setups mit Sub-Customers.
Was du damit machen kannst
- 1Automatisierte Multi-Channel-BenachrichtigungenWeise eine KI an, eine Nachricht via WhatsApp zu senden und auf SMS auszuweichen, falls die Zustellung fehlschlägt.
- 2Geplante TerminerinnerungenBitte den Agenten, eine spezifische Nachricht für ein zukünftiges Datum und eine Uhrzeit zu planen.
- 3Dateiversand via ChatLasse die KI ein Dokument oder ein Bild an einen Empfänger senden, indem du einen lokalen Pfad oder eine URL nutzt.
- 4Messenger-Konto verbindenGeneriere einen Link, um ein persönliches WhatsApp- oder Telegram-Konto via QR-Code zu verbinden.
- 5Bulk-Messaging-KampagnenGib dem Agenten den Befehl, eine einzelne Nachricht an eine große Liste von Telefonnummern zu senden.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
ChatPush MCP tools 11
Erkannt aus dem 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 | — |
Konfiguration
CHATPUSH_TOKEN
| Name | Beschreibung | Typ |
|---|---|---|
| CHATPUSH_TOKEN | — |
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbarchatpush/mcp-chatpush is public and reachablegithub.com/chatpush/mcp-chatpush ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-11-02github.com/chatpush/mcp-chatpush ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell11 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenChatPush 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
ChatPush MCP Fragen
Welche Tools bietet ChatPush MCP?
Er stellt 11 Tools bereit, darunter get_account, get_balance, get_utm_tags, send_message, send_bulk.
Wie verbinde ich mein WhatsApp- oder Telegram-Konto?
Du kannst deinen Messenger im ChatPush-Dashboard verbinden oder das Tool get_messenger_auth_link aufrufen, um einen QR-Code zu scannen.
Kann ich über den ChatPush MCP server Dateien versenden?
Ja, du kannst Dokumente, Bilder, Audio- oder Videodateien bis zu 100 MB von einem lokalen Pfad, einer URL oder als base64 versenden.
Was passiert, wenn eine Nachricht über einen Kanal nicht zugestellt werden kann?
Du kannst Cascade Routing nutzen, um mehrere Kanäle nacheinander auszuprobieren; der Server wechselt erst zum nächsten Kanal, wenn die Zustellung über den vorherigen fehlgeschlagen ist.