SMS, OTP et webhooks pour Claude Code, Cursor et Windsurf
Branchez votre mobile Android sur votre assistant de code et envoyez des SMS illimités, validez des OTP, recevez les réponses par webhook — le tout dans la même session. Une seule clé SMS8, des outils JSON-RPC pour chaque étape. Pas de Twilio, pas d'A2P 10DLC, pas de frais au message.
Ce que votre assistant peut faire depuis l'éditeur
Chaque outil emprunte le même pipeline d'envoi que le tableau de bord SMS8. Crédits, retries, routage multi-appareils, signature des webhooks : tout réagit comme un appel API direct.
setup_sms8
La poignée de main. Valide votre clé et renvoie vos appareils, votre forfait et le contexte d'intégration.
send_sms
Envoie un SMS via un Android appairé. Routage par appareil ou par SIM.
send_otp
Génère le code et l'envoie. Vous fixez la longueur, la durée, le nombre de tentatives.
verify_otp
Comparaison en temps constant avec le dernier code émis. Renvoie le nombre de tentatives restantes si ça ne colle pas.
wait_for_otp NOUVEAU
Bloque l'agent jusqu'à ce qu'un SMS au format OTP arrive sur votre Android, et extrait le code automatiquement. Le chaînon manquant pour les agents autonomes.
get_messages
Récupère les SMS récents reçus ou envoyés. Filtre par sens ou par numéro.
list_devices
Liste les Android appairés. Choisissez l'émetteur quand vous équilibrez la charge entre vos SIMs.
get_balance NOUVEAU
Coup d'œil au solde. SMS restants, jours avant renouvellement, résumé en une ligne.
create_webhook
Enregistre une URL de callback pour les SMS entrants. HTTPS uniquement, protégé contre le SSRF, signé en HMAC.
Trois manières d'installer, à vous de choisir
SMS8 se décline en serveur MCP HTTP hébergé, en plugin Claude Code avec son Skill embarqué, et en lanceur npx pour les clients stdio.
- HTTP hébergé fonctionne dans Claude Code, Cursor et Windsurf avec un Bearer token
- Plugin Claude via
/plugin marketplace add 1fancy/sms8-sms-gateway - npx lance le pont stdio :
npx -y @sms8/mcp
{
"mcpServers": {
"sms8": {
"url": "https://mcp.sms8.io",
"transport": "http",
"headers": {
"Authorization":
"Bearer YOUR_SMS8_API_KEY"
}
}
}
}
Installer via npm
Neuf paquets npm couvrent tous les flux : agent IA via MCP, scripts terminal, flux OTP, hooks React + plugins Capacitor et Cordova pour apps Ionic. Une clé API, un Android appairé.
Lanceur MCP pour Claude Code, Cursor, Windsurf, OpenCode. Collez-le dans votre configuration MCP et votre assistant IA obtient 9 outils SMS.
$ npx -y sms8-mcp
CLI terminal. Envoyer SMS, envoyer / vérifier / attendre des OTP, lire la boîte de réception, lister les appareils. Parfait pour scripts, cron, CI.
$ npx sms8-cli send +14155550100 "Hi"
Hook React useSms8Otp() + composant <OtpInput /> prêt à l'emploi avec séparateurs, RTL, mode masque et render props.
$ npm i react-sms-otp
Même code que react-sms-otp, optimisé SEO pour les recherches « sms otp verify » et « input OTP ».
$ npm i sms-otp-verify
Plugin Capacitor pour apps Ionic : ponts natifs iOS Swift + Android Kotlin avec fallback web.
$ npm i capacitor-sms-otp-send-verify
Plugin Cordova pour apps Ionic : ponts natifs iOS Swift + Android Kotlin pour envoi et vérification OTP.
$ cordova plugin add cordova-plugin-sms-otp-send
Variante OTP de la CLI. Envoyez et vérifiez des codes OTP par SMS via votre propre téléphone, sans Twilio ni frais par OTP.
$ npx sms-otp-using-myphone send +1234
Variante « téléphone comme passerelle » de la CLI. Même backend, optimisée pour les équipes cherchant une passerelle SMS depuis téléphone.
$ npx phone-sms-gateway send +1234 "Hi"
Variante Android-first de la CLI. Même code, optimisée pour les développeurs cherchant « envoyer SMS depuis Android ».
$ npx send-sms-from-android send +1234 "Hi"
Ou parcourez le code sur GitHub ↗
Cas d'usage à copier-coller
Vérification de numéro
"Branche la vérification par SMS dans cette app via sms8 MCP. Utilise send_otp sur /signup, verify_otp sur /verify-phone, et affiche les tentatives restantes en cas d'erreur."
Notifications de commande
"Quand une commande part en livraison, envoie un SMS au client avec son lien de suivi via sms8 MCP."
Inbox support bidirectionnelle
"Enregistre un webhook sur sms8 MCP vers https://app.com/sms-in. Génère le handler qui vérifie le HMAC et redirige les SMS entrants vers la file de support."
Connexion sans mot de passe
"Remplace le login par lien magique par des OTP via sms8 MCP. Code à 6 chiffres, valable 5 minutes."
Rappels de rendez-vous
"Lis les rendez-vous de demain en base et envoie un SMS de rappel 24h avant chacun, avec send_sms."
2FA pour l'admin
"Ajoute une 2FA SMS sur /admin via sms8 MCP. Bloque le compte après 5 verify_otp ratés."
SMS8 MCP vs Twilio vs MessageBird
| Capacité | SMS8 MCP | Twilio | MessageBird |
|---|---|---|---|
| Serveur MCP intégré | Oui | Non | Non |
| Coût par message | Zéro | $0.0079+ | $0.05+ |
| A2P 10DLC obligatoire | Non | Oui | Oui |
| Location de numéro | Inutile | $1+ / mois | $2+ / mois |
| Temps de mise en route | 60 secondes | Jours à semaines | Plusieurs jours |
| Vérification OTP | Inclus, gratuit | Service à part | Service à part |
| Code MCP open source | MIT | Non | Non |
Sécurité par défaut, sans pièges
Plafond par numéro
5 OTP maximum par numéro toutes les 24h. Impossible de relever ce plafond depuis le compte.
Anti-race
Cooldown et plafond vérifiés dans une transaction SQL avec verrou de ligne. Pas moyen de doubler le quota en parallèle.
OTP en POST uniquement
Les GET renvoient 405. Les cookies sont ignorés.
Clé API masquée
setup_sms8 ne montre que les 4 derniers caractères de votre clé.
Webhooks anti-SSRF
Bloque loopback, RFC1918, CGNAT, link-local et IPv4 mappées en IPv6.
Signature HMAC
Les SMS entrants et les événements de livraison arrivent signés en HMAC-SHA256, impossible à usurper.
Questions fréquentes
C'est quoi le serveur SMS8 MCP ?
Un serveur Model Context Protocol hébergé sur mcp.sms8.io pour que les outils de code IA (Claude Code, Cursor, Windsurf, Codex, Devin) envoient des SMS, génèrent des OTP et configurent des webhooks. Chaque message sort par votre Android appairé, pas par Twilio.
Faut-il du A2P 10DLC ?
Non. SMS8 s'appuie sur votre Android et votre SIM. Aucune inscription A2P 10DLC, aucun frais par message, aucun numéro à louer.
Comment brancher SMS dans un projet Claude Code ?
Ajoutez le serveur MCP à ~/.config/claude/mcp-servers.json avec le transport HTTP vers https://mcp.sms8.io et votre clé SMS8 en Bearer token. Ou lancez /plugin marketplace add 1fancy/sms8-sms-gateway puis /plugin install sms8-sms-gateway.
Ça marche avec Cursor et Windsurf ?
Oui. Les deux gèrent les serveurs MCP en HTTP. Ajoutez https://mcp.sms8.io avec votre clé SMS8 en Bearer dans ~/.cursor/mcp.json ou ~/.codeium/windsurf/mcp_config.json.
C'est une alternative à Twilio ?
Oui. SMS8 passe par votre propre Android avec la SIM que vous avez déjà. Pas de frais au message, pas d'A2P 10DLC, pas de numéro à provisionner. Forfait à partir de $29/mois avec SMS illimités.
Le code est public ?
Oui, sous licence MIT sur github.com/1fancy/sms8-sms-gateway.