SMS, OTP y webhooks para Claude Code, Cursor y Windsurf
Conecta tu móvil Android al asistente de código y envía SMS ilimitados, valida OTPs y recibe respuestas por webhook desde la misma sesión. Una sola clave de SMS8, herramientas JSON-RPC para cada paso. Sin Twilio, sin A2P 10DLC y sin pagar por mensaje.
Lo que tu asistente puede hacer desde el editor
Cada herramienta pasa por el mismo motor que el panel de SMS8. Créditos, reintentos, enrutado entre dispositivos y firma de webhooks funcionan igual que si llamaras la API directamente.
setup_sms8
El saludo inicial. Valida tu clave y devuelve dispositivos, plan y contexto de integración.
send_sms
Manda un SMS a través de un Android emparejado. Enrutado por dispositivo o por SIM.
send_otp
Genera el código y lo envía. Tú decides la longitud, el tiempo de vida y los intentos.
verify_otp
Compara en tiempo constante con el último código emitido. Si falla, te dice cuántos intentos quedan.
wait_for_otp NUEVO
Bloquea al agente hasta que un SMS con código llegue a tu Android, y extrae el número solo. Cierra el hueco que tenían los agentes autónomos.
get_messages
Recupera los SMS recientes, entrantes o salientes. Filtra por dirección o por número.
list_devices
Lista los Androids emparejados. Elige el emisor cuando reparten carga entre varias SIMs.
get_balance NUEVO
Saldo en un vistazo. SMS restantes, días hasta la renovación y resumen en una línea.
create_webhook
Registra una URL de callback para los SMS entrantes. Solo HTTPS, protegida ante SSRF y firmada con HMAC.
Lee la documentación
Referencia completa de la API y de OTP con ejemplos en curl, límites y modelo de seguridad.
Tres caminos, elige el que prefieras
SMS8 viene como servidor MCP HTTP gestionado, como plugin de Claude Code con su Skill incluida, y como lanzador npx para clientes stdio.
- HTTP gestionado funciona en Claude Code, Cursor y Windsurf con un Bearer token
- Plugin de Claude con
/plugin marketplace add 1fancy/sms8-sms-gateway - npx arranca el puente stdio:
npx -y @sms8/mcp
{
"mcpServers": {
"sms8": {
"url": "https://mcp.sms8.io",
"transport": "http",
"headers": {
"Authorization":
"Bearer YOUR_SMS8_API_KEY"
}
}
}
}
Instalación con npm
Nueve paquetes npm cubren cada flujo: agente IA mediante MCP, scripts de terminal, flujos de OTP, hooks React y plugins Capacitor + Cordova para apps Ionic. Una clave API, un Android emparejado.
Lanzador MCP para Claude Code, Cursor, Windsurf, OpenCode. Pégalo en tu configuración MCP y tu asistente de IA obtiene 9 herramientas SMS.
$ npx -y sms8-mcp
CLI de terminal. Envía SMS, envía / verifica / espera OTPs, lee la bandeja, lista dispositivos. Perfecto para scripts, cron, CI.
$ npx sms8-cli send +14155550100 "Hi"
Hook React useSms8Otp() + componente <OtpInput /> listo para usar con separadores, RTL, modo máscara y render props.
$ npm i react-sms-otp
Mismo código que react-sms-otp, optimizado para SEO en búsquedas de «sms otp verify» e «input OTP».
$ npm i sms-otp-verify
Plugin Capacitor para apps Ionic: puentes nativos iOS Swift + Android Kotlin con fallback web.
$ npm i capacitor-sms-otp-send-verify
Plugin Cordova para apps Ionic: puentes nativos iOS Swift + Android Kotlin para envío y verificación de OTP.
$ cordova plugin add cordova-plugin-sms-otp-send
Variante centrada en OTP de la CLI. Envía y verifica códigos OTP por SMS a través de tu propio teléfono, sin Twilio ni cargos por OTP.
$ npx sms-otp-using-myphone send +1234
Variante «teléfono como pasarela» de la CLI. Mismo backend, optimizado para equipos que buscan una pasarela SMS por teléfono.
$ npx phone-sms-gateway send +1234 "Hi"
Variante Android-first de la CLI. Mismo código, optimizado para desarrolladores que buscan «enviar SMS desde Android».
$ npx send-sms-from-android send +1234 "Hi"
O explora el código en GitHub ↗
Casos de uso para copiar y pegar
Verificación de móvil
"Mete la verificación por SMS en esta app con sms8 MCP. Usa send_otp en /signup, verify_otp en /verify-phone y muestra los intentos restantes cuando falle."
Avisos de pedido
"Cuando un pedido se envíe, manda un SMS al cliente con su enlace de seguimiento usando sms8 MCP."
Bandeja de soporte bidireccional
"Registra un webhook con sms8 MCP en https://app.com/sms-in. Genera el handler que valida el HMAC y dirige los SMS entrantes a la cola de soporte."
Login sin contraseña
"Sustituye el login por enlace de email por OTPs vía sms8 MCP. 6 dígitos, vencen a los 5 minutos."
Recordatorios de citas
"Lee las citas de mañana de la base de datos y manda un SMS de recordatorio 24h antes con send_sms."
2FA para el panel admin
"Añade 2FA por SMS al login de /admin con sms8 MCP. Bloquea la cuenta tras 5 intentos fallidos de verify_otp."
SMS8 MCP frente a Twilio y MessageBird
| Característica | SMS8 MCP | Twilio | MessageBird |
|---|---|---|---|
| Servidor MCP integrado | Sí | No | No |
| Coste por mensaje | Ninguno | $0.0079+ | $0.05+ |
| A2P 10DLC obligatorio | No | Sí | Sí |
| Alquiler de número | No hace falta | $1+ al mes | $2+ al mes |
| Tiempo de puesta en marcha | 60 segundos | Días o semanas | Días |
| Verificación OTP | Incluida, gratis | Servicio aparte | Servicio aparte |
| Código MCP open source | MIT | No | No |
Seguridad por defecto, sin trampas
Tope por número
Máximo 5 OTPs por número cada 24h. No se puede subir desde la cuenta.
A prueba de races
Las comprobaciones de cooldown y límite van dentro de transacciones con bloqueo de fila.
OTP solo por POST
Los GET devuelven 405. Las cookies se ignoran.
Clave API oculta
setup_sms8 solo te muestra los 4 últimos caracteres de tu clave.
Webhooks blindados ante SSRF
Bloquea loopback, RFC1918, CGNAT, link-local e IPv4 mapeadas en IPv6.
Firma HMAC en cada envío
Los SMS entrantes y los eventos de entrega llegan firmados con HMAC-SHA256.
Preguntas frecuentes
¿Qué es el servidor SMS8 MCP?
Un servidor Model Context Protocol en mcp.sms8.io para que las herramientas de código con IA (Claude Code, Cursor, Windsurf, Codex, Devin) envíen SMS, generen códigos OTP y configuren webhooks. Cada mensaje sale por tu Android emparejado, no por Twilio.
¿Necesito A2P 10DLC?
No. SMS8 usa tu móvil Android y tu SIM como pasarela. Sin registro A2P 10DLC, sin coste por mensaje, sin alquilar números.
¿Cómo añado SMS a un proyecto de Claude Code?
Añade el servidor MCP a ~/.config/claude/mcp-servers.json con transporte HTTP apuntando a https://mcp.sms8.io y tu clave de SMS8 como Bearer token. O lanza /plugin marketplace add 1fancy/sms8-sms-gateway seguido de /plugin install sms8-sms-gateway.
¿Funciona con Cursor y Windsurf?
Sí. Ambos aceptan servidores MCP por HTTP. Añade https://mcp.sms8.io con tu clave de SMS8 en la cabecera Bearer a ~/.cursor/mcp.json o ~/.codeium/windsurf/mcp_config.json.
¿Es una alternativa a Twilio?
Sí. SMS8 tira de tu propio Android con la SIM que ya tienes. Sin coste por mensaje, sin A2P 10DLC, sin números que aprovisionar. Tarifa plana desde $29 al mes con SMS ilimitados.
¿El código es público?
Sí, con licencia MIT en github.com/1fancy/sms8-sms-gateway.