Permet aux agents IA d'envoyer des messages WhatsApp, Telegram, SMS et des envois en masse, de gérer des fichiers et de suivre les statuts de livraison.
Aussi connu sous jetapi/jetapi-mcp-server, jetapi-mcp-server
- Étoiles
- 0
- Outils
- 14
- Téléchargements, 30 jours
- —
- Dernière version
- 1.0.3
- Dernier commit
- 23 sept. 2026
- Licence
- MIT
Qu'est-ce que JetAPI MCP ?
JetAPI est un serveur MCP. Permet aux agents IA d'envoyer des messages WhatsApp, Telegram, SMS et des envois en masse, de gérer des fichiers et de suivre les statuts de livraison. Il expose 14 outils, comme get_account, get_balance, get_utm_tags.
Résumé généré à partir du README du projet
À propos du MCP server JetAPI
JetAPI fournit une interface permettant aux agents IA de gérer des communications multicanaux via une intégration unique. Les développeurs utilisant des clients comme Claude Desktop, Cursor, VS Code ou Claude Code peuvent connecter leurs agents à divers services de messagerie, notamment WhatsApp, Telegram, SMS, VK, OK et MAX. Le serveur fonctionne localement via stdio et nécessite un JETAPI_TOKEN obtenu depuis le tableau de bord JetAPI pour fonctionner.
Cet ensemble d'outils permet des flux de messagerie sophistiqués tels que l'envoi de messages en masse à plusieurs numéros, la planification d'envois futurs et l'utilisation du routage en cascade pour tester différents canaux si l'un d'eux échoue. Il prend également en charge le transfert de fichiers pour les documents, les images, l'audio ou la vidéo jusqu'à 100 MB. Au-delà de l'envoi de contenu, les utilisateurs peuvent surveiller les statuts de livraison, gérer les webhooks pour les événements entrants et récupérer les détails du compte comme les soldes actuels ou les statuts de session.
Ce que vous pouvez faire avec
- 1Messagerie multicanal automatiséeUn agent IA peut envoyer un message via WhatsApp et basculer sur le SMS si la première tentative échoue.
- 2Campagnes de communication de masseUn développeur peut ordonner à un agent de distribuer un message unique à une large liste de numéros de téléphone simultanément.
- 3Distribution de médias et de documentsLes agents peuvent transmettre des fichiers tels que des PDF ou des images depuis un chemin local ou une URL vers un destinataire.
- 4Surveillance d'événements en temps réelLes utilisateurs peuvent configurer des webhooks pour recevoir des notifications lors de la réception de messages ou de changements de statut WhatsApp.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer JetAPI MCP
Formats vérifiés le 10 nov. 2026Installer JetAPI MCP dans Claude Code
$ claude mcp add --env JETAPI_TOKEN=<YOUR_JETAPI_TOKEN> jetapi-mcp-server -- npx -y jetapi-mcp-serverInstaller JetAPI MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"jetapi-mcp-server": {
"command": "npx",
"args": [
"-y",
"jetapi-mcp-server"
],
"env": {
"JETAPI_TOKEN": "<YOUR_JETAPI_TOKEN>"
}
}
}
}Installer JetAPI MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"jetapi-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"jetapi-mcp-server"
],
"env": {
"JETAPI_TOKEN": "<YOUR_JETAPI_TOKEN>"
}
}
}
}Installer JetAPI MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"jetapi-mcp-server": {
"command": "npx",
"args": [
"-y",
"jetapi-mcp-server"
],
"env": {
"JETAPI_TOKEN": "<YOUR_JETAPI_TOKEN>"
}
}
}
}Installer JetAPI MCP dans Codex
~/.codex/config.toml
[mcp_servers.jetapi-mcp-server] command = "npx" args = ["-y", "jetapi-mcp-server"] [mcp_servers.jetapi-mcp-server.env] JETAPI_TOKEN = "<YOUR_JETAPI_TOKEN>"
Installer JetAPI MCP dans Gemini CLI
~/.gemini/settings.json
{
"mcpServers": {
"jetapi-mcp-server": {
"command": "npx",
"args": [
"-y",
"jetapi-mcp-server"
],
"env": {
"JETAPI_TOKEN": "<YOUR_JETAPI_TOKEN>"
}
}
}
}Outils MCP JetAPI 14
Détectés depuis le READMEget_accountget_balanceget_utm_tagssend_messagesend_bulkget_delivery_statusdelete_deliveryget_phone_infosend_filecreate_webhookget_webhooklist_webhooks
| get_account | — | |
| get_balance | — | |
| get_utm_tags | — | |
| send_message | — | |
| send_bulk | — | |
| get_delivery_status | — | |
| delete_delivery | — | |
| get_phone_info | — | |
| send_file | — | |
| create_webhook | — | |
| get_webhook | — | |
| list_webhooks | — |
Afficher les 14 outilsAfficher moins d'outils
delete_webhookupdate_webhook
| delete_webhook | — | |
| update_webhook | — |
Configuration
JETAPI_TOKENRequisSecretBearer token from the JetAPI dashboard (https://jetapi.io)
JETAPI_BASE_URLAPI host. Change only for a white-label JetAPI installation.
| Nom | Description | Type |
|---|---|---|
| JETAPI_TOKEN | Bearer token from the JetAPI dashboard (https://jetapi.io) | RequisSecret |
| JETAPI_BASE_URL | API host. Change only for a white-label JetAPI installation. |
Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →A passé nos vérifications automatisées. Il ne s'agit pas d'un audit de sécurité : lisez le code et donnez au serveur l'accès le plus restreint dont il a besoin. Fonctionnement des vérifications
- Dépôt source lié et accessiblejetapi/jetapi-mcp-server is public and reachablegithub.com/jetapi/jetapi-mcp-server ↗Réussi
- Le paquet cite ce dépôt comme sourcejetapi-mcp-server names jetapi/jetapi-mcp-server as sourcenpmjs.com/package/jetapi-mcp-server ↗Réussi
- Provenance du build (attestation Sigstore)Sigstore attestation for jetapi-mcp-servernpmjs.com/package/jetapi-mcp-server/v/1.0.3#provenance ↗Réussi
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-09-23github.com/jetapi/jetapi-mcp-server ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNo popular package one edit away from jetapi-mcp-serverRéussi
- Aucun avis critique dans le paquet ni ses dépendances100 resolved dependencies checked; no critical advisoryosv.dev ↗Réussi
- Aucune instruction cachée destinée au modèle14 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- L'endpoint distant répond au handshake MCPNon vérifié
README
Voir sur GitHubJetAPI 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 |
|---|---|
get_account |
Full account info: balance, dispatch routing, sender names, subscription, WhatsApp/Telegram session status (token is masked) |
get_balance |
Balance, customer ID, dispatch routing channels and registered sender names |
get_utm_tags |
List 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, reply-to and callbacks |
send_bulk |
Send the same message to many phone numbers at once |
get_delivery_status |
Status and details of a delivery, with the status 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 |
send_file |
Send a document, image, audio or video from a local path, URL or base64 (up to 100 MB) |
create_webhook |
Subscribe a URL to events: incoming messages, WhatsApp statuses, login/logout |
get_webhook |
Details of one webhook |
list_webhooks |
All registered webhooks |
delete_webhook |
Delete a webhook |
update_webhook |
Change a webhook's URL and/or event types |
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-server
The server needs JETAPI_TOKEN, so pass it when adding:
claude mcp add jetapi --env JETAPI_TOKEN=your_token_here -- npx -y jetapi-mcp-server
Cursor
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 |
|---|---|---|---|
JETAPI_TOKEN |
yes | — | Bearer token from the JetAPI dashboard |
JETAPI_BASE_URL |
no | https://api.jetapi.io |
API host |
JETAPI_DEBUG |
no | 0 |
1 logs every request to stderr |
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 |
|---|---|---|
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
Ask Claude in plain language:
| Say | Tool |
|---|---|
| "Show my JetAPI account — is WhatsApp connected?" | get_account |
| "How much money is left on JetAPI?" | get_balance |
| "Which UTM tags do I have?" | get_utm_tags |
| "Send a WhatsApp message to +7 999 123-45-67: Your order has shipped." | send_message |
| "Message @john_doe on Telegram that the meeting moved to 3 pm." | send_message (tdlib) |
| "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 'Sale starts today!' to 79991234567, 79997654321 and 995598464533." | send_bulk |
| "Was message 94396942 delivered?" | get_delivery_status |
| "Delete message 94396942." | delete_delivery |
| "Which operator is +995 598 464 533?" | get_phone_info |
| "Send ~/Documents/invoice.pdf to 79991234567 on WhatsApp." | send_file |
| "Send incoming WhatsApp messages to https://example.com/hook." | create_webhook |
| "Show webhook 57." | get_webhook |
| "List my webhooks." | list_webhooks |
| "Delete webhook 57." | delete_webhook |
| "Point webhook 57 to https://example.com/new-hook." | update_webhook |
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 start
| Script | What it does |
|---|---|
npm run dev |
Run the TypeScript source directly |
npm run inspector |
Open the MCP Inspector with all tools |
npm run check |
Verify versions in package.json / server.json / manifest.json and that the server exposes all 14 tools |
npm run build:mcpb |
Build the Claude Desktop extension into build/jetapi-mcp-server.mcpb |
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
Questions sur JetAPI MCP
Comment ajouter JetAPI MCP à Claude Code ?
Exécutez claude mcp add --env JETAPI_TOKEN=<YOUR_JETAPI_TOKEN> jetapi-mcp-server -- npx -y jetapi-mcp-server dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter JetAPI MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Quels outils JetAPI MCP fournit-il ?
Il expose 14 outils, dont get_account, get_balance, get_utm_tags, send_message, send_bulk.
Puis-je envoyer des fichiers via le serveur ?
Oui, vous pouvez envoyer des documents, des images, de l'audio ou de la vidéo à partir d'un chemin local, d'une URL ou en base64, avec une taille maximale de 100 MB.
Comment fonctionne le routage de l'envoi ?
JetAPI utilise une liste ordonnée de canaux et les teste un par un, passant au suivant uniquement si le précédent échoue.
Mes données sont-elles privées ?
L'extension s'exécute localement, ne collecte aucune analyse ni télémétrie, et envoie uniquement les données à l'API JetAPI pour effectuer les actions demandées.