Wavix

officiel

Wavix est une plateforme de communications mondiale proposant des API pour la voix, les SMS, la 2FA et les numéros de téléphone. Notre serveur MCP apporte ces capacités aux agents IA et aux workflows agentiques.

GitHub

Essayer ce MCPSponsorisé

Que pouvez-vous faire avec Wavix MCP ?

Envoyer des SMS/MMS transactionnels — Demander l'envoi d'un message via sms_and_mms_messages_send, renvoyant l'identifiant du message et le statut de livraison.
Exécuter des flux de vérification 2FA — Créer un code avec two_fa_verification_create, puis le valider via two_fa_verification_check.
Rechercher et acheter des numéros de téléphone — Trouver les numéros disponibles avec buy_numbers_list, les ajouter au panier via cart_add, et finaliser l'achat avec cart_checkout.
Rechercher des transcriptions d'appels — Utiliser cdrs_search pour trouver des appels par mots-clés de transcription, puis enrichir les résultats avec cdrs_get.
Récupérer et transcrire des enregistrements — Obtenir un enregistrement via call_recording_get, demander la transcription avec cdrs_retranscribe, et récupérer les résultats via cdrs_transcription_get.
Auditer la facturation et les factures — Examiner les dépenses avec billing_transactions_list et télécharger les PDF de factures via billing_invoices_download.

Documentation

Serveur MCP Wavix

Un serveur Model Context Protocol qui donne aux LLM et aux agents IA un accès direct à la plateforme télécom Wavix — SMS/MMS, appels vocaux, 2FA, trunking SIP, gestion de numéros de téléphone, enregistrement 10DLC, enregistrements d'appels, analyse de la parole et facturation.

Wavix est une plateforme de communications mondiale pour l'envoi de SMS, la passation d'appels vocaux et l'exécution de flux 2FA via une API unique. Un essai gratuit est disponible ; l'utilisation payante suit le plan de tarification Wavix associé à votre compte.

Le moyen le plus rapide d'utiliser ce serveur MCP est le point de terminaison hébergé à https://mcp.wavix.com/mcp — pointez n'importe quel client compatible MCP dessus et authentifiez-vous avec votre clé API Wavix. Si vous devez auto-héberger (déploiement Wavix personnalisé, derrière un pare-feu, instance dédiée), consultez Exécuter votre propre serveur.

Table des matières

Point de terminaison
Installation — en un clic, Claude Code, Claude Desktop / Web, Cursor, VS Code, Codex CLI, Windsurf
Exécuter votre propre serveur (auto-hébergement)
Exemples
Outils → catalogue complet dans TOOLS.md
Ressources
Authentification (bonnes pratiques, si un jeton est compromis)
Dépannage
Compatibilité et limites
Support, Contribution, Sécurité, Licence

Point de terminaison

Champ	Valeur
URL	`https://mcp.wavix.com/mcp`
Transport	HTTP streamable
Authentification	`Authorization: Bearer <api_key>`
Outils	voir TOOLS.md
Ressources	Documentation Wavix + spécification OpenAPI (découverte automatique)

Obtenez une clé API Wavix depuis la Console Wavix → Administration → Clés API → Créer une nouvelle.

Installation

Avant de commencer : récupérez votre clé API Wavix.

Connectez-vous à https://wavix.com.
Ouvrez Administration → Clés API.
Cliquez sur Créer une nouvelle (ou copiez une clé existante). Gardez-la à portée de main — vous la collerez à la place de YOUR_API_KEY ci-dessous.

Installation en un clic

⚠️ Les boutons ci-dessous initialisent la configuration MCP de votre éditeur avec un jeton d'espace réservé YOUR_API_KEY. Une fois l'installation terminée par l'éditeur, ouvrez la configuration générée et remplacez le jeton d'espace réservé par votre véritable clé API avant d'envoyer toute requête — sinon chaque appel renverra 401 Unauthorized.

Pour supprimer plus tard : ouvrez le même fichier de configuration (~/.cursor/mcp.json, .vscode/mcp.json, ou l'équivalent pour votre éditeur) et supprimez l'entrée wavix, ou retirez le connecteur via l'interface MCP / Connecteurs de votre éditeur.

Claude Code

claude mcp add --transport http wavix https://mcp.wavix.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Utilisez claude mcp list pour vérifier et /mcp dans une session pour l'état.

Claude Desktop / Claude Web

Paramètres → Connecteurs → Ajouter un connecteur personnalisé :

Nom : Wavix
URL : https://mcp.wavix.com/mcp
Transport : Streamable HTTP
En-tête d'authentification : Authorization: Bearer <api_key>

Cursor (manuel)

Ajoutez à ~/.cursor/mcp.json (ou au niveau du projet .cursor/mcp.json) :

{
  "mcpServers": {
    "wavix": {
      "url": "https://mcp.wavix.com/mcp",
      "headers": {
        "Authorization": "Bearer <api_key>"
      }
    }
  }
}

Cursor 2.4+ expose le catalogue complet ; les versions antérieures plafonnent à 40.

VS Code (manuel, GitHub Copilot Chat)

Créez .vscode/mcp.json dans votre espace de travail (ou ajoutez le même objet servers sous la clé "mcp" dans le settings.json utilisateur) :

{
  "servers": {
    "wavix": {
      "type": "http",
      "url": "https://mcp.wavix.com/mcp",
      "headers": {
        "Authorization": "Bearer <api_key>"
      }
    }
  }
}

Consultez le guide des serveurs MCP VS Code pour le schéma à jour.

Codex CLI

Codex CLI prend en charge MCP via stdio. Connectez-vous au serveur hébergé via mcp-remote. Modifiez ~/.codex/config.toml :

[mcp_servers.wavix]
command = "npx"
args = [
  "-y",
  "mcp-remote",
  "https://mcp.wavix.com/mcp",
  "--header",
  "Authorization:Bearer ${WAVIX_API_KEY}"
]

[mcp_servers.wavix.env]
WAVIX_API_KEY = "YOUR_API_KEY"

Windsurf / autres clients

Tout client MCP qui prend en charge le transport HTTP streamable avec en-têtes personnalisés fonctionnera. Utilisez :

URL : https://mcp.wavix.com/mcp
En-tête : Authorization: Bearer <api_key>

Configuration via un agent IA ? Pointez votre agent vers llms-install.md — c'est un guide d'installation lisible par machine qui fournit au modèle l'URL, l'en-tête et la configuration par client dans un format déterministe afin qu'il n'improvise pas les valeurs du point de terminaison.

Exécuter votre propre serveur

Le serveur hébergé fonctionne immédiatement pour la plupart des utilisateurs. Auto-hébergez si vous devez pointer vers un déploiement Wavix non public, exécuter derrière un pare-feu, ou opérer dans votre propre infrastructure.

Docker

docker build -t wavix-mcp-server .
docker run --rm -p 8000:8000 wavix-mcp-server

Le serveur écoute sur le port 8000 et expose le point de terminaison MCP à /mcp. Pointez votre client vers http://<host>:8000/mcp.

Depuis les sources

git clone https://github.com/Wavix/wavix-mcp-server.git
cd wavix-mcp-server
pip install -e .
wavix-mcp

Nécessite Python 3.10+.

Configuration

Variable d'environnement	Défaut	Objet
`WAVIX_API_BASE_URL`	`https://api.wavix.com`	Remplace le point de terminaison API Wavix en amont (pour les déploiements internes ou de préproduction)

Aucun identifiant Wavix n'est requis pour exécuter le serveur — ils sont transmis par requête depuis l'en-tête Authorization: Bearer <api_key> du client MCP. Les auto-hébergeurs sont responsables de la terminaison TLS devant le serveur (nginx, Caddy, équilibreur de charge cloud) avant de l'exposer publiquement.

Exemples

Invites concrètes que vous pouvez déposer dans n'importe quel client connecté.

Les numéros de téléphone ci-dessous (+1 310 555 0100, +44 7700 900123) se trouvent dans des plages de test réservées (NANP 555 et Ofcom 070 09xx) — sans risque de les copier tels quels, aucun abonné réel n'est joignable via eux.

Envoyer un SMS transactionnel

Invite : « Envoie un SMS du +13105550100 au +447700900123 disant "Votre code de vérification est 4821". »

L'agent appelle sms_and_mms_messages_send avec from, to et text. Renvoie l'ID du message et l'état de livraison.

Exécuter une vérification 2FA

Invite : « Envoie un code de vérification 2FA au +13105550100 par SMS. Quand je te donne le code que je reçois, vérifie s'il est correct. »

L'agent appelle two_fa_verification_create, attend que vous partagiez le code reçu par SMS, puis appelle two_fa_verification_check. Utile pour prototyper des flux sans mot de passe sans écrire de code d'intégration.

Trouver et acheter un numéro de téléphone

Invite : « Trouve un numéro gratuit américain disponible avec capacité SMS, ajoute-le à mon panier et finalise la commande. »

L'agent enchaîne buy_numbers_list (en filtrant par pays et fonctionnalité), cart_add et cart_checkout. Confirmez avec l'utilisateur avant la finalisation — cela débite le compte.

Rechercher des transcriptions d'appels

Invite : « Montre-moi tous les appels entrants d'hier de plus de deux minutes où l'appelant a mentionné "remboursement". »

L'agent utilise cdrs_search sur les transcriptions, puis enrichit chaque résultat via cdrs_get pour les métadonnées complètes de l'appel.

Récupérer un enregistrement et le transcrire

Invite : « Récupère l'enregistrement de l'appel abc-123, demande à Wavix de le transcrire et renvoie la transcription. »

L'agent appelle call_recording_get (renvoie une URL de téléchargement pré-signée), cdrs_retranscribe, puis interroge cdrs_transcription_get.

Auditer la facturation

Invite : « Combien avons-nous dépensé en SMS le mois dernier ? Donne-moi un lien de téléchargement pour la facture PDF la plus récente. »

L'agent appelle billing_transactions_list filtré par type et date, puis billing_invoices_list + billing_invoices_download. L'outil de téléchargement renvoie une URL pré-signée vers le PDF, pas le fichier lui-même — ouvrez l'URL dans un navigateur ou transmettez-la à votre client pour récupérer le document réel.

Outils

122 outils, générés à partir de la spécification OpenAPI Wavix. Les arguments reflètent les paramètres de requête et les champs du corps.

Groupe	#	Couverture
SMS et MMS	10	Envoyer, lister, récupérer des messages ; identifiants d'expéditeur ; désinscriptions
Contrôle des appels	9	Démarrer / répondre / terminer des appels ; lire de l'audio ; collecter DTMF
Enregistrement d'appels	4	Lister, télécharger (URL pré-signée), supprimer
Flux d'appels	2	Démarrer / arrêter le flux média
Webhooks d'appels	3	Lister, créer, supprimer
CDR	7	Lister, exporter, récupérer ; recherche de transcription et re-transcription
Analyse de la parole	4	Téléverser, transcrire, récupérer le fichier d'origine
2FA	6	Créer / vérifier / annuler / renvoyer une vérification ; événements
Mes numéros	6	Lister, mettre à jour, libérer ; routage SMS / vocal ; téléversement de documents
Achat	5	Pays, régions, villes ; recherche de numéros disponibles
Panier	4	Ajouter, retirer, récupérer, finaliser
Validateur de numéros	3	Validation unique et par lot
Troncs SIP	5	CRUD complet
10DLC	30	Marques, campagnes, vérification, preuves, abonnements aux événements
Profil	3	Obtenir / mettre à jour le profil ; configuration du compte
Clés API	4	Lister, créer, activer / désactiver, supprimer
Sous-comptes	5	Lister, créer, obtenir, mettre à jour ; transactions
Facturation	3	Transactions, factures, téléchargement de relevés
Campagnes vocales	2	Déclencher et récupérer
Wavix Embeddable (WebRTC)	5	CRUD des jetons de widget
Raccourcisseur de liens	2	Créer des liens courts ; métriques

Consultez TOOLS.md pour la liste complète des outils avec des descriptions en une ligne. La source faisant autorité est la spécification OpenAPI Wavix — votre client voit toujours le catalogue en direct actuel.

Ressources

En plus des outils, le serveur expose la documentation Wavix en tant que ressources MCP, afin que le modèle puisse puiser un contexte faisant autorité à la demande plutôt que de deviner à partir de connaissances antérieures.

Schéma d'URI	Contenu
`wavix://docs/<path>`	Pages de documentation de docs.wavix.com (découverte automatique via `llms.txt`).
`wavix://api/openapi.yaml`	La spécification complète Wavix OpenAPI 3.0.

Les deux sources — docs.wavix.com et la spécification OpenAPI Wavix — sont publiquement disponibles et peuvent être parcourues directement sans authentification.

Les ressources sont récupérées paresseusement sur resources/read et mises en cache côté serveur avec une durée de vie d'une heure. Le jeton Bearer en amont n'est jamais transmis aux hôtes de documentation — uniquement à api.wavix.com.

Authentification

Chaque requête du client doit inclure :

Authorization: Bearer <api_key>

Le serveur transmet cet en-tête à api.wavix.com par requête. Le jeton :

n'est jamais journalisé,
n'est jamais transmis lors des redirections inter-hôtes (par exemple les URL de téléchargement S3 pré-signées),
n'est jamais envoyé aux hôtes de documentation.

Si votre client suit une URL de téléchargement pré-signée renvoyée par call_recording_get, billing_invoices_download, speech_analytics_file_get ou ten_dlc_brand_evidence_get, récupérez-la directement sans l'en-tête Authorization.

Bonnes pratiques

Utilisez une clé API dédiée pour MCP. Créez une clé API séparée à https://wavix.com → Administration → Clés API (ou via l'outil api_keys_create lui-même, depuis une autre session). Cela vous permet de révoquer l'accès MCP sans interrompre d'autres intégrations.
Faites une rotation périodique. Traitez la clé API comme tout secret de production : rotation selon un calendrier et à toute suspicion de fuite.
Gardez les clés API hors de git. Les configurations de clients MCP sont faciles à valider par accident, emportant le jeton avec elles dans l'historique et les journaux CI. La plupart des clients prennent en charge la substitution ${env:VAR} dans la valeur de l'en-tête — stockez la clé API dans une variable d'environnement ou votre trousseau OS et référencez-la depuis la configuration. Comme filet de sécurité, ajoutez les chemins courants de configuration client à votre .gitignore :
```
.cursor/mcp.json
.vscode/mcp.json
claude_desktop_config.json
.claude/mcp.json
.codex/config.toml
```

Si un jeton est compromis

Dans la console Wavix, désactivez immédiatement la clé (ou appelez api_keys_deactivate).
Créez un remplacement via api_keys_create ou la console.
Mettez à jour la configuration du client et reconnectez-vous.
Examinez billing_transactions_list et cdrs_list pour toute activité inattendue.

Dépannage

Symptôme	Cause probable / correctif
`401 Unauthorized` depuis n'importe quel outil	En-tête `Authorization: Bearer …` manquant ou invalide. Vérifiez que la clé API est active dans la console Wavix.
L'outil renvoie un `download_url`, pas le fichier lui-même	Comportement normal. Les points de terminaison d'enregistrement, de facture, d'analyse vocale et de preuve 10DLC renvoient des URL pré-signées (voir Authentification). Récupérez l'URL directement sans l'en-tête `Authorization`.
Le client n'affiche qu'environ 40 outils, pas le catalogue complet	Les clients plus anciens imposent une limite d'outils par serveur. Mettez à niveau (Cursor 2.4+, dernière version de VS Code, dernière version de Claude).
`Tool not found` pour un outil répertorié dans ce README	Le client local peut mettre en cache une ancienne liste d'outils. Redémarrez le client, ou supprimez et réajoutez le serveur.
4xx avec un tableau `errors`	Erreur de validation de l'API Wavix. Inspectez `errors` ; recoupez avec la page `wavix://docs/*` concernée ou la spécification OpenAPI.
Impossible de joindre le serveur	Vérifiez le DNS et le HTTPS sortant vers `mcp.wavix.com:443`.
L'agent appelle un outil destructeur de manière inattendue	La plupart des clients peuvent exiger une confirmation avant les appels d'outils — activez ce paramètre et utilisez une clé API MCP dédiée (voir Bonnes pratiques).

Compatibilité et limites

Compatible avec tout client MCP prenant en charge le transport Streamable HTTP (Claude Desktop / Web / Code, Cursor 2.4+, VS Code, Windsurf, SDK MCP personnalisés) et tout framework d'agent disposant d'un adaptateur client MCP.
Les clients plus anciens peuvent imposer une limite d'outils par serveur ; mettez à niveau vers une version récente pour accéder au catalogue complet.
Les limites de débit et les frais d'utilisation dépendent de votre plan de compte Wavix. Voir Tarifs Wavix.

Journal des modifications

Le serveur hébergé est mis à jour en continu à mesure que la spécification OpenAPI Wavix évolue ; de nouveaux outils apparaissent automatiquement et les arguments des outils existants peuvent gagner des champs optionnels. Les modifications de documentation de ce dépôt sont suivies dans Releases. Pour les changements de comportement importants affectant les entrées d'outils ou l'authentification, nous publierons un avis à la fois dans [Releases] et dans les notes de version Wavix.

Support

Documentation produit : https://docs.wavix.com
Référence API : https://docs.wavix.com/api-reference
Questions / retours : support@wavix.com

Contribution

Ce dépôt est disponible en source mais n'est pas ouvert aux contributions externes. Les pull requests sont automatiquement fermées, et les Issues / Discussions sont désactivés. Envoyez les rapports de bugs, les demandes de fonctionnalités et les retours à support@wavix.com. Voir CONTRIBUTING.md pour plus de détails.

Si vous trouvez un bug dans le framework FastMCP sous-jacent, veuillez le signaler en amont, sur ce dépôt.

Sécurité

Pour signaler une vulnérabilité de sécurité, veuillez envoyer un e-mail à support@wavix.com avec pour objet Security: <short summary> plutôt que d'ouvrir un problème public. Voir SECURITY.md pour plus de détails.