Which integrations are available for this server?

Enables sending Telegram messages through ChatPush via personal Telegram account (tdlib) or Telegram Bot, including text, files, bulk sends, scheduling, cascade routing, delivery status tracking, deletion of delivered messages, and webhook subscriptions for incoming messages and statuses. Enables sending WhatsApp messages and files through ChatPush, including bulk mailings, scheduling, cascade routing with other channels, delivery status tracking, deletion of delivered messages, and linking WhatsApp accounts via QR/auth link.

How do I use ChatPush MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@ChatPush MCP Server send WhatsApp to +7 916 555-01-23 saying order is ready" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

ChatPush MCP Server

Official

by ChatPush

Overview Schema Source Related Servers Discussions Admin

TypeScript

Hybrid

ChatPush MCP Server

License: MIT

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

Related MCP server: Twilio SMS MCP Server

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 /healthz returns {"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`	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_file uploads the file as multipart/form-data.
Incompatible parameters (a Telegram username without the tdlib channel, scheduled_at in 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

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

Sending A
dev.sending
Email, WhatsApp and Telegram for AI agents: send, campaigns, automations, contacts, agent inboxes.
Communication Email Customer Support
761
TopMessageOAuth
com.topmessage
Send and schedule SMS and WhatsApp messages, manage contacts and templates, and track delivery.
Communication App Automation
1
WSENDEROAuth
io.wsender
Manage WhatsApp, Telegram and MAX mailings: audiences, drafts, moderation and sending.
Communication Marketing App Automation
1
whatsmcp AOAuth
com.whatsmcp
WhatsApp for AI agents — your own number or the official Cloud API: messages, media, templates.
Communication Social Media
451

Related MCP Servers

WhatsApp Cloud API MCP Server
Communication App Automation Customer Support
mmarqueti
F
license
Not graded
quality
D
maintenance
Enables AI agents to send WhatsApp messages, templates, and retrieve media through the WhatsApp Cloud API. Provides webhook handling and seamless integration with Meta's WhatsApp Business platform.
Updated 3 months ago (2026-07-14 20:22 UTC)
23
-
Twilio SMS MCP Server
Communication App Automation
0x-Professor
A
license
C
quality
D
maintenance
Enables AI agents to send, receive, schedule, and manage SMS and MMS messages using the Twilio Programmable Messaging API. It provides comprehensive tools for handling bulk messaging, conversation threads, and real-time inbox monitoring through a secure, production-grade architecture.
Updated 7 months ago (2026-03-10 18:27 UTC)
16
1
MIT
SendAPI MCP Serverofficial
Communication Email
SendAPI-co
A
license
A
quality
D
maintenance
Enables any MCP-compatible AI agent to send WhatsApp messages, SMS, OTP codes, and email through a single REST API.
Updated 3 months ago (2026-06-26 03:37 UTC)
18
MIT
jetapi-mcp-serverofficial
Communication App Automation
jetapi
A
license
A
quality
A
maintenance
Official JetAPI MCP server for sending WhatsApp, Telegram (personal account or bot), SMS, VK/OK and MAX messages and files from AI agents. Supports channel cascades, scheduling, bulk mailings, delivery status tracking, phone number lookup and webhook management.
Updated 15 days ago (2026-09-23 00:44 UTC)
14
58 npm
MIT

ChatPush MCP Server

Tools

Get a token

Remote mode (hosted)

Deployment

Local mode (stdio)

Claude Desktop

Claude Code

Cursor

VS Code

Channels

Usage examples

Behaviour

Development

License

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

WhatsApp Cloud API MCP Server

Twilio SMS MCP Server

SendAPI MCP Serverofficial

jetapi-mcp-serverofficial