ChatPush MCP sunucusu
Commit 2 Kas 2026AI agent'larının WhatsApp, Telegram, SMS, VK/OK ve MAX üzerinden mesaj, dosya ve toplu e-posta göndermesini sağlar.
Ayrıca bilinen adı ChatPush/mcp-chatpush
- Yıldızlar
- 0
- Araçlar
- 11
- İndirmeler, 30 gün
- —
- En son sürüm
- —
- Son commit
- 2 Kas 2026
- Lisans
- MIT
ChatPush MCP nedir?
AI agent'larının WhatsApp, Telegram, SMS, VK/OK ve MAX üzerinden mesaj, dosya ve toplu e-posta göndermesini sağlar. 11 araç sunar; örneğin get_account, get_balance, get_utm_tags.
Özet, projenin README dosyasından oluşturuldu
ChatPush MCP sunucusu hakkında
mcp-chatpush, bir AI agent içerisinden birden fazla iletişim kanalı üzerinden mesaj gönderilmesine olanak tanır. Geliştiriciler; WhatsApp, Telegram, SMS, VK/OK ve MAX aracılığıyla metin, dosya ve toplu gönderim yapmak için bu server'ı kullanabilirler. Zamanlanmış gönderim, öncelik ayarları ve ilk deneme başarısız olduğunda farklı kanallar arasında kademeli geçiş gibi karmaşık mesajlaşma iş akışlarını destekler.
Kullanıcılar, ortamlarına bağlı olarak bu server'ı iki farklı şekilde çalıştırabilirler. Claude Desktop, Claude Code, Cursor veya VS Code ile yerel geliştirme için CHATPUSH_TOKEN kullanarak stdio üzerinden çalışır. Yandex gibi bir URL bağlantısı gerektiren platformlar için ise streamable HTTP kullanarak uzak mod (remote mode) sağlar. Uzak kurulumda, çağrıyı yapanlar Authorization header kısmında kendi token'larını sağlayarak barındırılan instance'ın stateless ve güvenli kalmasını sağlarlar.
Araç seti; hesap bakiyelerini yönetmek, teslimat durumlarını kontrol etmek ve 100 MB'a kadar dosya transferlerini gerçekleştirmek için fonksiyonlar içerir. Ayrıca, QR kodu bağlantıları aracılığıyla mesajlaşma uygulaması bağlantılarını yönetmeye ve alt müşterilerle çoklu hesap kurulumlarını organize etmeye olanak tanır.
Neler yapabilirsiniz
- 1Otomatik çok kanallı bildirimlerBir AI'ya WhatsApp üzerinden mesaj göndermesini, eğer başarısız olursa SMS'e geçmesini söyleyin.
- 2Zamanlanmış randevu hatırlatıcılarıAgent'tan belirli bir mesajı gelecekteki bir tarih ve saat için planlamasını isteyin.
- 3Sohbet üzerinden dosya dağıtımıAI'nın yerel bir yol veya URL kullanarak bir alıcıya belge veya resim göndermesini sağlayın.
- 4Mesajlaşma uygulaması hesabı bağlantısıKişisel bir WhatsApp veya Telegram hesabını QR kodu aracılığıyla bağlamak için bir bağlantı oluşturun.
- 5Toplu mesajlaşma kampanyalarıAgent'a geniş bir telefon numarası listesine tek bir mesaj göndermesi komutunu verin.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
ChatPush MCP araçları 11
README dosyasından algılandıget_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 | — |
Yapılandırma
CHATPUSH_TOKEN
| Ad | Açıklama | Sunucu |
|---|---|---|
| CHATPUSH_TOKEN | — |
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Henüz doğrulanmadı. Bir sunucunun 80 puana, ciddi bir bulgu olmamasına ve kontrol edebilmemiz için yeterli veriye ihtiyacı vardır. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirchatpush/mcp-chatpush is public and reachablegithub.com/chatpush/mcp-chatpush ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorKontrol edilmedi
- Derleme kökeni (Sigstore onayı)Kontrol edilmedi
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-11-02github.com/chatpush/mcp-chatpush ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilKontrol edilmedi
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
- Modele yönelik gizli talimat yok11 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
ChatPush 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 soruları
ChatPush MCP hangi araçları sunar?
11 araç sunar; bunlar arasında get_account, get_balance, get_utm_tags, send_message, send_bulk yer alır.
WhatsApp veya Telegram hesabımı nasıl bağlarım?
Mesajlaşma uygulamanızı ChatPush panelinden bağlayabilir veya bir QR kodu taratmak için get_messenger_auth_link aracını çağırabilirsiniz.
ChatPush MCP server üzerinden dosya gönderebilir miyim?
Evet; yerel bir yol, URL veya base64 kullanarak 100 MB'a kadar belge, resim, ses veya video dosyası gönderebilirsiniz.
Bir kanal üzerinden mesaj iletilemezse ne olur?
Birden fazla kanalı sırayla denemek için kademeli yönlendirme (cascade routing) kullanabilirsiniz; sunucu, yalnızca önceki kanal üzerinden gönderim başarısız olursa bir sonraki kanala geçer.