ChatPush MCP server
2026년 11월 2일 커밋AI agent이 WhatsApp, Telegram, SMS, VK/OK, MAX를 통해 메시지, 파일 및 대량 메일을 보낼 수 있도록 지원합니다.
다른 이름 ChatPush/mcp-chatpush
- 스타
- 0
- Tools
- 11
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 11월 2일
- 라이선스
- MIT
ChatPush MCP란?
AI agent이 WhatsApp, Telegram, SMS, VK/OK, MAX를 통해 메시지, 파일 및 대량 메일을 보낼 수 있도록 지원합니다. 11개 도구를 제공합니다. 예: get_account, get_balance, get_utm_tags.
프로젝트 README에서 생성된 요약
ChatPush MCP server 정보
mcp-chatpush는 AI agent 내부에서 여러 통신 채널을 통해 메시지를 전송할 수 있게 해줍니다. 개발자는 이 MCP server를 사용하여 WhatsApp, Telegram, SMS, VK/OK, MAX를 통해 텍스트, 파일 및 대량 메일을 발송할 수 있습니다. 예약 전송, 우선순위 설정, 첫 번째 시도 실패 시 다른 채널로 전환하는 캐스케이딩 등 복잡한 메시징 워크플로우를 지원합니다.
사용자는 환경에 따라 두 가지 방식으로 이 서버를 실행할 수 있습니다. Claude Desktop, Claude Code, Cursor 또는 VS Code를 사용하는 로컬 개발 환경에서는 CHATPUSH_TOKEN을 사용하여 stdio를 통해 작동합니다. URL 연결이 필요한 Yandex와 같은 플랫폼의 경우 streamable HTTP를 사용하는 원격 모드를 제공합니다. 원격 설정에서는 호출자가 Authorization 헤더에 자체 토큰을 제공하므로 호스트 인스턴트의 상태를 유지하지 않고 보안을 유지할 수 있습니다.
도구 모음에는 계정 잔액 관리, 전송 상태 확인 및 최대 100 MB의 파일 전송을 처리하는 기능이 포함되어 있습니다. 또한 QR 코드 링크를 통해 메신저 연결을 관리하고 서브 고객을 통해 다중 계정 설정을 구성할 수 있습니다.
활용 사례
- 1자동화된 멀티 채널 알림AI에게 WhatsApp으로 메시지를 보내고, 실패할 경우 SMS로 전환하도록 지시합니다.
- 2예약된 예약 알림에이전트에게 특정 날짜와 시간에 메시지를 예약하도록 요청합니다.
- 3채팅을 통한 파일 배포AI가 로컬 경로 또는 URL을 사용하여 수신자에게 문서나 이미지를 보내도록 합니다.
- 4메신저 계정 연결QR 코드를 통해 개인 WhatsApp 또는 Telegram 계정을 연결하는 링크를 생성합니다.
- 5대량 메시지 캠페인에이전트에게 대량의 전화번호 목록에 단일 메시지를 보내도록 명령합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
ChatPush MCP 도구 11
README에서 감지됨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 | — |
구성
CHATPUSH_TOKEN
| 이름 | 설명 | 유형 |
|---|---|---|
| CHATPUSH_TOKEN | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능chatpush/mcp-chatpush is public and reachablegithub.com/chatpush/mcp-chatpush ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-02github.com/chatpush/mcp-chatpush ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음11 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기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 질문
ChatPush MCP는 어떤 도구를 제공하나요?
11개 도구를 제공합니다. 예: get_account, get_balance, get_utm_tags, send_message, send_bulk.
WhatsApp 또는 Telegram 계정을 어떻게 연결하나요?
ChatPush 대시보드에서 메신저를 연결하거나 get_messenger_auth_link 도구를 호출하여 QR 코드를 스캔할 수 있습니다.
ChatPush MCP server를 통해 파일을 보낼 수 있나요?
네, 로컬 경로, URL 또는 base64를 통해 최대 100 MB 크기의 문서, 이미지, 오디오 또는 비디오 파일을 보낼 수 있습니다.
한 채널을 통한 메시지 전송이 실패하면 어떻게 되나요?
캐스케이드 라우팅을 사용하여 여러 채널을 순차적으로 시도할 수 있습니다. 이전 채널의 전송이 실패한 경우에만 서버가 다음 채널로 넘어갑니다.