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

Que pouvez-vous faire avec Wavix MCP ?

Envoyer des messages SMS ou MMS — demandez à l'assistant d'envoyer un message texte ou multimédia en utilisant sms_and_mms_messages_send.
Exécuter un flux de vérification 2FA — demandez à l'assistant de créer une vérification avec two_fa_verification_create et de vérifier le code que vous recevez via two_fa_verification_check.
Rechercher et acheter des numéros de téléphone — trouvez les numéros disponibles par pays et capacité avec buy_numbers_list, ajoutez-les à votre panier et finalisez l'achat.
Analyser les transcriptions d'appels — recherchez des enregistrements d'appels pour des phrases spécifiques à l'aide de cdrs_search et récupérez les métadonnées complètes avec cdrs_get.
Télécharger des enregistrements et des transcriptions — obtenez une URL d'enregistrement d'appel via call_recording_get, demandez une transcription avec cdrs_retranscribe et récupérez le résultat.
Auditer la facturation et télécharger les factures — examinez les transactions avec billing_transactions_list et obtenez un lien de téléchargement PDF pré-signé 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 vocale et facturation.

Wavix est une plateforme de communications mondiale pour envoyer des SMS, passer des appels vocaux et exécuter des flux 2FA via une API unique. Un essai gratuit est disponible ; l'utilisation payante suit le plan tarifaire 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 vers celui-ci et authentifiez-vous avec votre clé API Wavix. Si vous devez l'auto-héberger (déploiement Wavix personnalisé, derrière un pare-feu, instance dédiée), consultez Exécuter le vôtre.

Table des matières

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

Point de terminaison

Champ	Valeur
URL	`https://mcp.wavix.com/mcp`
Transport	HTTP diffusable en continu
Auth	`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.

Installer

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

Connectez-vous sur 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 amorcent la configuration MCP de votre éditeur avec un jeton de substitution YOUR_API_KEY. Une fois l'installation terminée par l'éditeur, ouvrez la configuration générée et remplacez le jeton de substitution par votre véritable clé API avant d'envoyer toute requête — sinon chaque appel retournera 401 Unauthorized.

Pour supprimer ultérieurement : 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 le statut.

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 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 sont limitées à 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 l'utilisateur settings.json) :

{
  "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. Faites le pont vers le 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 prenant en charge le transport HTTP diffusable en continu avec des 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 donne 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 le vôtre

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'env	Valeur par défaut	Objectif
`WAVIX_API_BASE_URL`	`https://api.wavix.com`	Remplacer le point de terminaison API Wavix en amont (pour les déploiements internes ou de préproduction)

Aucune information d'identification Wavix n'est requise pour exécuter le serveur — elles sont transmises 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

Des 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) sont dans des plages de test réservées (NANP 555 et Ofcom 070 09xx) — vous pouvez les copier textuellement en toute sécurité, aucun abonné réel n'est joignable via ceux-ci.

Envoyer un SMS transactionnel

Invite : "Envoie un SMS de +13105550100 à +447700900123 disant 'Votre code de vérification est 4821'."

L'agent appelle sms_and_mms_messages_send avec from, to et text. Retourne l'ID du message et le statut de livraison.

Exécuter une vérification 2FA

Invite : "Envoie un code de vérification 2FA à +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 qui arrive 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 procède au paiement."

L'agent enchaîne buy_numbers_list (filtrage par pays et fonctionnalité), cart_add et cart_checkout. Confirmez avec l'utilisateur avant le paiement — 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 : "Obtiens l'enregistrement de l'appel abc-123, demande à Wavix de le transcrire et retourne la transcription."

L'agent appelle call_recording_get (retourne 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 retourne 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 les messages ; ID expéditeur ; désabonnements
Contrôle d'appel	9	Démarrer / répondre / terminer les appels ; lire l'audio ; collecter DTMF
Enregistrement d'appel	3	Lister, télécharger (URL pré-signée), supprimer
Diffusion d'appel	2	Démarrer / arrêter le flux média
Webhooks d'appel	3	Lister, créer, supprimer
CDRs	6	Lister, exporter, récupérer ; recherche de transcription et retranscrire
Analyse vocale	4	Téléverser, transcrire, récupérer le fichier original
2FA	6	Créer / vérifier / annuler / renvoyer la vérification ; événements
Mes numéros	7	Lister, mettre à jour, libérer ; routage SMS / voix ; téléversement de document
Acheter	5	Pays, régions, villes ; recherche de numéro disponible
Panier	4	Ajouter, retirer, récupérer, payer
Validateur de numéro	3	Validation unique et en masse
Trunks 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	5	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é
Campagnes vocales	2	Déclencher et récupérer
Wavix Embeddable (WebRTC)	5	CRUD des jetons de widget
Raccourcisseur de lien	2	Créer des liens courts ; métriques

Voir 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 extraire un contexte faisant autorité à la demande au lieu 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 accessibles au public et peuvent être consultées 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 de 1 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 de 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 retourné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 distincte sur 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 perturber les autres intégrations.
Alternez périodiquement. Traitez la clé API comme n'importe quel secret de production : alternez selon un calendrier et en cas de suspicion de fuite.
Gardez les clés API hors de git. Les configurations des 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 de clés OS et référencez-la depuis la configuration. Comme filet de sécurité, ajoutez les chemins de configuration client courants à 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 une clé de remplacement via api_keys_create ou la console.
Mettez à jour la configuration du client et reconnectez-vous.
Consultez billing_transactions_list et cdrs_list pour détecter toute activité inhabituelle.

Dépannage

Symptôme	Cause probable / solution
`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 anciens clients 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 listé dans ce README	Le client local met peut-être en cache une ancienne liste d'outils. Redémarrez le client, ou supprimez et rajoutez le serveur.
Erreur 4xx avec un tableau `errors`	Erreur de validation de l'API Wavix. Inspectez `errors` ; référez-vous à la page `wavix://docs/*` correspondante ou à la spécification OpenAPI.
Impossible de joindre le serveur	Vérifiez le DNS et le trafic HTTPS sortant vers `mcp.wavix.com:443`.
Un agent appelle un outil destructeur de manière inattendue	La plupart des clients permettent d'exiger une confirmation avant les appels d'outils — activez ce paramètre et basculez vers une clé API MCP dédiée (voir Bonnes pratiques).

Compatibilité et limites

Compatible avec tout client MCP prenant en charge le transport HTTP streamable (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 anciens clients peuvent imposer une limite d'outils par serveur ; passez à une version récente pour accéder au catalogue complet.
Les limites de débit et les frais d'utilisation suivent votre forfait de compte Wavix. Voir Tarification Wavix.

Journal des modifications

Le serveur hébergé est mis à jour en continu au fur et à mesure de l'évolution de la spécification OpenAPI de Wavix ; de nouveaux outils apparaissent automatiquement et les arguments d'outils existants peuvent gagner des champs optionnels. Les modifications de la documentation de ce dépôt sont suivies sous Versions. Pour les changements de comportement substantiels affectant les entrées des outils ou l'authentification, nous publierons un avis à la fois ici 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

Contribuer

Ce dépôt est à code source disponible mais non ouvert aux contributions externes. Les pull requests sont automatiquement fermées et les Issues / Discussions sont désactivées. 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 sous-jacent FastMCP, veuillez le signaler en amont sur ce projet.

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 ticket public. Voir SECURITY.md pour plus de détails.