jetapi-mcp-server
OfficialThis MCP server lets AI agents interact with JetAPI to send messages and files, track deliveries, and manage webhooks.
View account info, balance, dispatch routing, sender names, subscription status, and WhatsApp/Telegram session status.
List UTM tags for tracking dispatches.
Send text messages via WhatsApp, Telegram (tdlib or Bot), SMS, VK/OK, or MAX, with cascade fallback, scheduling, priority, reply-to, typing simulation, and callbacks.
Send the same message to many phone numbers at once.
Send documents, images, audio, video, or contacts up to 100 MB from a local path, URL, or base64.
Check delivery status and delete delivered WhatsApp/Telegram messages.
Look up phone number country, operator, and normalized international format.
Create, retrieve, list, update, and delete webhooks for incoming messages, WhatsApp statuses, and login/logout events.
Enables sending messages through the MAX messenger to phone numbers.
Enables sending Telegram messages via personal accounts (tdlib) or Telegram bots, including scheduling, priority, reply-to and callbacks, and allows deleting delivered messages on all recipient devices.
Enables sending WhatsApp messages, files and bulk mailings, checking session status, and deleting delivered messages on all recipient devices.
JetAPI MCP Server
Official MCP server for JetAPI — send WhatsApp, Telegram, SMS and MAX messages, files and bulk mailings from AI agents like Claude, Cursor and VS Code.
Tools
Tool | Description |
| Full account info: balance, dispatch routing, sender names, subscription, WhatsApp/Telegram session status (token is masked) |
| Balance, customer ID, dispatch routing channels and registered sender names |
| List UTM tags used to track dispatches |
| Send a text via WhatsApp, Telegram (tdlib), Telegram Bot, SMS, VK/OK or MAX — with cascade, scheduling, priority, reply-to and callbacks |
| Send the same message to many phone numbers at once |
| Status and details of a delivery, with the status explained in plain words |
| Delete a delivered WhatsApp/Telegram message on all recipient devices |
| Country, operator and normalized format of a phone number |
| Send a document, image, audio or video from a local path, URL or base64 (up to 100 MB) |
| Subscribe a URL to events: incoming messages, WhatsApp statuses, login/logout |
| Details of one webhook |
| All registered webhooks |
| Delete a webhook |
| Change a webhook's URL and/or event types |
Related MCP server: lingtai-whatsapp
Get a token
Sign up at jetapi.io and copy the API token from the dashboard. To send through WhatsApp or Telegram, connect the messenger in the dashboard first.
Installation
Claude Desktop — one click
Download
jetapi-mcp-server.mcpbfrom the latest release.Double-click it (or drag it into Claude Desktop → Settings → Extensions).
Paste your JetAPI token when asked. It is stored securely by Claude Desktop.
Claude Desktop — config file
Requires Node.js 18.17 or newer. Open Settings → Developer → Edit Config (claude_desktop_config.json) and add:
{
"mcpServers": {
"jetapi": {
"command": "npx",
"args": ["-y", "jetapi-mcp-server"],
"env": { "JETAPI_TOKEN": "your_token_here" }
}
}
}Restart Claude Desktop.
Claude Code
claude mcp add jetapi -- npx -y jetapi-mcp-serverThe server needs JETAPI_TOKEN, so pass it when adding:
claude mcp add jetapi --env JETAPI_TOKEN=your_token_here -- npx -y jetapi-mcp-serverCursor
Add to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):
{
"mcpServers": {
"jetapi": {
"command": "npx",
"args": ["-y", "jetapi-mcp-server"],
"env": { "JETAPI_TOKEN": "your_token_here" }
}
}
}VS Code
Add to .vscode/mcp.json — VS Code will prompt for the token and keep it out of the file:
{
"inputs": [
{ "type": "promptString", "id": "jetapi_token", "description": "JetAPI token", "password": true }
],
"servers": {
"jetapi": {
"type": "stdio",
"command": "npx",
"args": ["-y", "jetapi-mcp-server"],
"env": { "JETAPI_TOKEN": "${input:jetapi_token}" }
}
}
}MCP Registry
The server is listed in the official MCP Registry as io.github.jetapi/jetapi-mcp-server, so clients and catalogs that read the registry can install it directly.
Other MCP clients
Any client that supports stdio servers:
{
"command": "npx",
"args": ["-y", "jetapi-mcp-server"],
"env": { "JETAPI_TOKEN": "your_token_here" }
}Configuration
Variable | Required | Default | Description |
| yes | — | Bearer token from the JetAPI dashboard |
| no |
| API host |
| no |
|
|
Channels
dispatch_routing is an ordered list of channels. JetAPI tries them one by one and moves to the next channel only if delivery through the previous one fails. Without it, the default routing from your JetAPI dashboard is used.
Value | Channel | Recipient |
|
| |
| Personal Telegram account |
|
| Telegram Bot |
|
| SMS |
|
| VK / OK notifications |
|
| MAX messenger |
|
Usage examples
Ask Claude in plain language:
Say | Tool |
"Show my JetAPI account — is WhatsApp connected?" |
|
"How much money is left on JetAPI?" |
|
"Which UTM tags do I have?" |
|
"Send a WhatsApp message to +7 999 123-45-67: Your order has shipped." |
|
"Message @john_doe on Telegram that the meeting moved to 3 pm." |
|
"Try WhatsApp first, then SMS: Your code is 4821." |
|
"Remind 79991234567 tomorrow at 09:00 UTC about the appointment." |
|
"Send 'Sale starts today!' to 79991234567, 79997654321 and 995598464533." |
|
"Was message 94396942 delivered?" |
|
"Delete message 94396942." |
|
"Which operator is +995 598 464 533?" |
|
"Send ~/Documents/invoice.pdf to 79991234567 on WhatsApp." |
|
"Send incoming WhatsApp messages to https://example.com/hook." |
|
"Show webhook 57." |
|
"List my webhooks." |
|
"Delete webhook 57." |
|
"Point webhook 57 to https://example.com/new-hook." |
|
Behaviour
Parameters are sent as URL query parameters, as the JetAPI API expects;
send_fileuploads the file asmultipart/form-data.Incompatible parameters (e.g. a Telegram
usernamewithout thetdlibchannel, orscheduled_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 responses are retried twice after 1 s — except for requests that send messages or create webhooks (
send_message,send_bulk,send_file,create_webhook), so nothing is sent twice.Requests time out after 30 seconds.
Errors are returned as readable tool errors, e.g.
Invalid JetAPI token. Check your JETAPI_TOKEN.orValidation error: text: the text cannot be empty.All logs go to stderr; stdout is reserved for the MCP protocol.
Development
git clone https://github.com/jetapi/jetapi-mcp-server.git
cd jetapi-mcp-server
npm install
cp .env.example .env # put your token in .env
npm run build
npm startScript | What it does |
| Run the TypeScript source directly |
| Open the MCP Inspector with all tools |
| Verify versions in |
| Build the Claude Desktop extension into |
Releasing
Bump the version in
package.json,server.json(bothversionfields) andmanifest.json, and add aCHANGELOG.mdentry.Merge to
main, then push a tag:git tag v1.2.3 && git push origin v1.2.3.The Release workflow publishes to npm (trusted publishing with provenance), creates a GitHub release with the
.mcpbbundle and updates the MCP Registry.
Privacy Policy
The extension runs locally, collects no analytics or telemetry, and sends data only to the JetAPI API to perform the actions you request. Your API token is stored by your MCP client (Claude Desktop keeps it in secure storage).
JetAPI MCP Server privacy policy — what the extension handles, stores and shares
JETAPI LLC Privacy Policy — how the JetAPI service processes personal data
Questions: support@jetapi.io
License
Available Tools
14 toolscreate_webhookCreate webhookA
Register a webhook URL to receive real-time notifications for specific JetAPI 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.
Inputs: url (required), types (required).
delete_deliveryDelete deliveryADestructiveIdempotent
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 JetAPI via the tdlib or whatsapp channels can be deleted; SMS cannot. Use it when the user asks to unsend or recall a message.
Inputs: delivery_id (required).
delete_webhookDelete webhookADestructiveIdempotent
Delete a webhook by ID. The webhook will stop receiving notifications.
Inputs: id (required).
get_accountGet accountARead-only
Get full JetAPI 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.
Inputs: no named parameters.
get_balanceGet balanceARead-only
Get JetAPI 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.
Inputs: no named parameters.
get_delivery_statusGet delivery statusARead-only
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.
Inputs: id (required).
get_phone_infoGet phone infoARead-only
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.
Inputs: phone (required).
get_utm_tagsGet UTM tagsARead-only
Get list of all UTM tags (utm_marks) configured in the JetAPI 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.
Inputs: no named parameters.
get_webhookGet webhookARead-only
Get details of a specific webhook by its ID: the URL it posts to and the event types it subscribes to.
Inputs: id (required).
list_webhooksList webhooksARead-only
List all registered webhooks for this JetAPI account. Use it to see where events are delivered or to find a webhook ID before updating or deleting it.
Inputs: no named parameters.
send_bulkSend bulk messageA
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.
Inputs: text (required), phones_numbers (required), utm_mark, usernames, +4 more.
send_fileSend 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.
Inputs: type, phone, caption, file_url, +15 more.
send_messageSend 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: phone is required, except for personal Telegram (dispatch_routing ["tdlib"]) where username or tdlib_user_id can be used instead, and WhatsApp where whatsapp_lid can be used.
Returns the delivery ID for get_delivery_status and delete_delivery.
Inputs: text (required), phone, priority, username, +10 more.
update_webhookUpdate webhookAIdempotent
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.
Inputs: id (required), url, types.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 14 tools
Most tools are clearly separated by resource and action (balance vs account vs delivery vs webhooks). The only potential confusion is get_balance vs get_account, but the descriptions explicitly differentiate them, and send_message vs send_bulk vs send_file are well delineated.
All tool names follow a consistent verb_noun pattern: get_*, send_*, create_*, list_*, update_*, delete_*. The verbs are predictable and the nouns clearly indicate the resource, making the API surface easy to navigate.
14 tools is well within the ideal range for a messaging API server. Each tool covers a distinct operation: account info, messaging (single, bulk, file), delivery tracking, phone lookup, and webhook management. No tool feels redundant or unnecessary.
The tool surface covers the core messaging lifecycle well: send (message/bulk/file), track (get_delivery_status), and delete (delete_delivery). Webhook CRUD is complete. Minor gaps include no explicit tool for listing sent messages or managing contacts, but these are not essential for the stated purpose.
Maintenance
Related MCP Connectors
Unified messaging MCP server: WhatsApp, Instagram, Telegram, SMS, Messenger & email support inbox
Unified inbox MCP for WhatsApp, Telegram, Email, voice — read/send messages, search, AI agents.
WhatsApp (Web + Business API), SMS, contacts, and call records via 2Chat's MCP server.
The Mobile Text Alerts SMS MCP server enables your AI to send SMS messages & manage contacts
Related MCP Servers
- AlicenseBqualityDmaintenanceMCP server for ManyContacts WhatsApp Business CRM that enables AI agents to manage contacts, send messages, run campaigns, and configure auto-replies through comprehensive CRM operations.5585 npmMIT

lingtai-whatsappofficial
AlicenseNot gradedqualityFmaintenanceMCP server for interacting with the official Meta WhatsApp Business Platform/Cloud API, enabling sending messages, managing contacts, templates, and handling webhook callbacks.Apache 2.0
SendAPI MCP Serverofficial
AlicenseAqualityDmaintenanceEnables any MCP-compatible AI agent to send WhatsApp messages, SMS, OTP codes, and email through a single REST API.18MIT- AlicenseAqualityBmaintenanceMCP server for Kirimi WhatsApp API, enabling AI agents to send messages, broadcast, manage devices, and contacts.20232 npmMIT