ChatPush MCP server
Commit 2 Nov 2026Memungkinkan AI agent untuk mengirim pesan, file, dan bulk mailing melalui WhatsApp, Telegram, SMS, VK/OK, dan MAX.
Juga dikenal sebagai ChatPush/mcp-chatpush
- Stars
- 0
- Tools
- 11
- Unduhan, 30 hari
- —
- Versi terbaru
- —
- Commit terakhir
- 2 Nov 2026
- Lisensi
- MIT
Apa itu ChatPush MCP?
Memungkinkan AI agent untuk mengirim pesan, file, dan bulk mailing melalui WhatsApp, Telegram, SMS, VK/OK, dan MAX. Server ini menyediakan 11 tool, seperti get_account, get_balance, get_utm_tags.
Ringkasan dibuat dari README proyek
Tentang ChatPush MCP server
mcp-chatpush memungkinkan pengiriman pesan ke berbagai channel komunikasi langsung dari dalam AI agent. Developer dapat menggunakan server ini untuk mengirim teks, file, dan bulk mailing melalui WhatsApp, Telegram, SMS, VK/OK, dan MAX. Server ini mendukung workflow pengiriman pesan yang kompleks termasuk jadwal pengiriman (scheduled delivery), pengaturan prioritas, dan cascading melalui berbagai channel jika upaya pertama gagal.
User dapat menjalankan server ini dengan dua cara berbeda tergantung pada environment mereka. Untuk pengembangan lokal menggunakan Claude Desktop, Claude Code, Cursor, atau VS Code, server beroperasi via stdio menggunakan CHATPUSH_TOKEN. Untuk platform seperti Yandex yang memerlukan koneksi URL, server menyediakan remote mode menggunakan streamable HTTP. Dalam setup remote, pemanggil menyediakan token mereka sendiri di Authorization header, memastikan instance yang di-host tetap stateless dan aman.
Toolset yang tersedia mencakup fungsi untuk mengelola saldo akun, memeriksa status pengiriman, dan menangani transfer file hingga 100 MB. Tool ini juga memungkinkan pengelolaan koneksi messenger melalui link kode QR dan pengorganisasian setup multi-akun dengan sub-customer.
Apa yang bisa Anda lakukan dengannya
- 1Notifikasi multi-channel otomatisInstruksikan AI untuk mengirim pesan via WhatsApp dan beralih ke SMS jika pengiriman gagal.
- 2Pengingat janji temu terjadwalMinta agent untuk menjadwalkan pesan tertentu pada tanggal dan waktu di masa mendatang.
- 3Distribusi file melalui chatBiarkan AI mengirim dokumen atau gambar ke penerima menggunakan path lokal atau URL.
- 4Koneksi akun messengerGenerate link untuk menghubungkan akun WhatsApp atau Telegram pribadi melalui kode QR.
- 5Kampanye bulk messagingPerintahkan agent untuk mengirim satu pesan ke daftar nomor telepon dalam jumlah besar.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Tool ChatPush MCP 11
Terdeteksi dari 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 | — |
Konfigurasi
CHATPUSH_TOKEN
| Nama | Deskripsi | Tipe |
|---|---|---|
| CHATPUSH_TOKEN | — |
Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Belum diverifikasi. Sebuah server memerlukan skor 80, tidak ada temuan serius, dan data yang cukup untuk kami periksa. Cara kerja checks · Yang perlu diperbaiki untuk menambah poin
- Source repository terhubung dan dapat dijangkauchatpush/mcp-chatpush is public and reachablegithub.com/chatpush/mcp-chatpush ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyaTidak diperiksa
- Provenance build (atestasi Sigstore)Tidak diperiksa
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-11-02github.com/chatpush/mcp-chatpush ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerTidak diperiksa
- Tidak ada advisory kritis pada paket atau dependensinyaTidak diperiksa
- Tidak ada instruksi tersembunyi untuk model11 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di 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
Pertanyaan tentang ChatPush MCP
Tool apa yang disediakan ChatPush MCP?
Server ini menyediakan 11 tool, termasuk get_account, get_balance, get_utm_tags, send_message, send_bulk.
Bagaimana cara menghubungkan akun WhatsApp atau Telegram saya?
Anda dapat menghubungkan messenger Anda di dashboard ChatPush atau memanggil tool get_messenger_auth_link untuk memindai kode QR.
Apakah saya bisa mengirim file melalui ChatPush MCP server?
Ya, Anda dapat mengirim dokumen, gambar, audio, atau file video hingga 100 MB dari path lokal, URL, atau base64.
Apa yang terjadi jika pesan gagal terkirim melalui satu channel?
Anda dapat menggunakan cascade routing untuk mencoba beberapa channel secara berurutan; server akan berpindah ke channel berikutnya hanya jika pengiriman melalui channel sebelumnya gagal.