ChatPush MCP Server
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CHATPUSH_TOKEN | Yes | Your ChatPush API token |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_accountA | Get full ChatPush account information including token, balance, dispatch routing, sender names, subscription status and Telegram/WhatsApp sessions count. Use it to verify the token works, check whether the subscription is active, or diagnose undelivered messages (e.g. WhatsApp or Telegram not authorized). For just the balance use get_balance. |
| get_balanceA | Get ChatPush account balance, customer ID, available dispatch routing channels, and registered sender names. Use it when the user asks how much money is left, before a large mailing, or to find a valid sender_name for SMS. |
| get_utm_tagsA | Get list of all UTM tags (utm_marks) configured in the ChatPush account for tracking message dispatches. Use it to reuse an existing label as utm_mark in send_message, send_bulk or send_file, so statistics stay grouped. |
| send_messageA | Send a text message via WhatsApp, Telegram (tdlib), Telegram Bot, SMS, VK/OK (notify), or MAX (max), with optional cascade fallback between channels. Supports scheduling, priority, reply-to, typing simulation, and delivery callbacks. Use it when the user asks to text, message, notify or reply to one person or group chat. For many phone numbers use send_bulk; for documents, images, audio or video use send_file. Recipient: Returns the delivery ID for get_delivery_status and delete_delivery. |
| get_delivery_statusA | Get the current status and full details of a specific message delivery by its ID. Returns status, operator info, phone, scheduled time, costs and more. Use it after send_message or send_file when the user asks whether a message was delivered or read, or why it failed — the status is explained in plain words. |
| delete_deliveryA | Delete a sent message from WhatsApp or Telegram (tdlib). Only works for messages with final 'Delivered' status. Deletion occurs on all recipient devices. Only messages sent through ChatPush via the tdlib or whatsapp channels can be deleted; SMS cannot. Use it when the user asks to unsend or recall a message. |
| send_bulkA | Send the same message to multiple phone numbers at once. Supports scheduling, UTM marks, dispatch routing cascade, Telegram usernames and tdlib user IDs. Use it for announcements, campaigns or reminders to a list of recipients. For one recipient, or when a delivery ID is needed for tracking, use send_message. |
| get_phone_infoA | Look up phone number information including country, mobile operator name and brand. Useful before sending to verify the number and determine routing. Also returns the number normalized to international format, e.g. when the user wrote it with spaces or brackets. |
| send_fileA | Send a file (document, image, audio, video, contact) to a recipient via WhatsApp or Telegram. File is uploaded as multipart/form-data. Images under 10MB sent natively, larger files as download links active for 7 days. Use it when the user wants to share a document, photo, voice message, video or contact card. Provide the file as exactly one of: file_path (local file), file_url (downloaded by the server) or file_base64 (with file_name). Supported: pdf, doc, docx, ppt, pptx, xls, xlsx, zip, 7z; ogg, opus, mp3, aac, amr, 3gp; jpeg, png, webp; mp4; vcf. Max 100 MB. Recipient rules are the same as send_message. |
| create_webhookA | Register a webhook URL to receive real-time notifications for specific ChatPush events (e.g. whatsapp_log_out, delivery status updates, incoming messages). Use it when the user wants their server, CRM or automation (n8n, Make, Zapier) to receive replies or react to WhatsApp/Telegram events. |
| get_webhookA | Get details of a specific webhook by its ID: the URL it posts to and the event types it subscribes to. |
| list_webhooksA | List all registered webhooks for this ChatPush account. Use it to see where events are delivered or to find a webhook ID before updating or deleting it. |
| delete_webhookA | Delete a webhook by ID. The webhook will stop receiving notifications. |
| update_webhookA | Update an existing webhook — change its URL or the list of event types it subscribes to. Pass only what should change; types replaces the whole list. |
| set_chat_client_nameA | Rename a contact in the ChatPush web messenger, so operators see a person's real name instead of a phone number. The name is stored as the CRM client name of the conversation. Find the conversation by phone, Telegram username or Telegram user ID — at least one is required. If the contact has both WhatsApp and Telegram conversations, both are renamed. |
| get_messenger_auth_linkA | Get a link to the QR-code page that connects a WhatsApp or personal Telegram account to ChatPush. Open the link in a browser and scan the code with the phone that will send messages. Use it when sending fails because the messenger is not connected (WhatsApp session not started, Telegram not authorized), or when setting the account up for the first time. Check the result afterwards with get_account. |
| create_sub_customerA | Create a sub-client under your ChatPush multi-customer account. The response contains the sub-customer's own API token — it is shown only here, so save it. Use it when onboarding a new client of a platform built on ChatPush: each sub-customer gets a separate account, its own messengers and its own subscription. Requires a multi-customer account: a ChatPush client that may create sub-clients through the API. |
| list_sub_customersA | List the sub-clients of your ChatPush multi-customer account with their subscription status and whether WhatsApp and Telegram are connected. Requires a multi-customer account: a ChatPush client that may create sub-clients through the API. |
| get_sub_customerA | Show one sub-client by its customer_id: subscription status and expiry, and whether WhatsApp and Telegram are connected. Requires a multi-customer account: a ChatPush client that may create sub-clients through the API. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 19 tools
Most tools target clearly distinct resources and actions, and the descriptions explicitly route users between similar tools such as get_account vs get_balance and send_message vs send_bulk vs send_file. The main residual ambiguity is overlapping account/balance information, so it is not quite perfectly distinct.
All tools use consistent snake_case with predictable verb_noun phrasing such as get_webhook, create_webhook, list_webhooks, and delete_webhook. Singular/plural forms are used appropriately for single-resource versus list operations.
Nineteen tools is above the ideal 3-15 range and feels somewhat heavy for this server's scope. Most tools earn their place, but there is some natural overlap between account/balance and messaging variants that could be tightened.
Core messaging workflows are well covered: send, bulk send, file send, delivery status, deletion, webhook CRUD, account diagnostics, and auth linking. However, sub-customer management has create/list/get but no update or delete, delivery management lacks listing or cancelling operations, and UTM tags are read-only.