JoltSMS

Proporciona números de teléfono dedicados de EE. UU. y recibe códigos SMS/OTP para flujos de trabajo de verificación automatizados.

GitHub

Prueba este MCPPatrocinado

Documentación

@joltsms/mcp-server

Servidor MCP para JoltSMS: proporciona números de teléfono estadounidenses dedicados con SIM real y recibe códigos SMS/OTP a través de agentes de IA.

Construido sobre el Protocolo de Contexto de Modelo, este servidor brinda a los agentes de IA (Claude Code, Claude Desktop, Cursor, etc.) la capacidad de alquilar números de teléfono, esperar SMS entrantes, extraer códigos OTP y gestionar la facturación, todo mediante llamadas de herramientas estandarizadas.

Inicio rápido

1. Obtén una clave de API

Crea una cuenta de JoltSMS y genera una clave de API en Panel → Configuración → Claves de API.

2. Configura tu cliente MCP

Agrega a tu .mcp.json (Claude Code) o a la configuración de MCP (Claude Desktop, Cursor):

{
  "mcpServers": {
    "joltsms": {
      "command": "npx",
      "args": ["-y", "@joltsms/mcp-server"],
      "env": {
        "JOLTSMS_API_KEY": "jolt_sk_your_key_here"
      }
    }
  }
}

3. Úsalo

Tu agente de IA ahora tiene acceso a todas las herramientas de JoltSMS. Prueba:

"Aprovisiona un nuevo número de teléfono con código de área 650 y espera un OTP"

Herramientas

Herramienta	Descripción
`joltsms_list_numbers`	Lista los números activos con etiquetas de servicio, etiquetas y recuentos de no leídos
`joltsms_get_number`	Detalles completos de un solo número
`joltsms_update_number`	Establece etiqueta de servicio, etiquetas o notas en un número
`joltsms_provision_number`	Alquila un nuevo número estadounidense dedicado con SIM real ($50/mes)
`joltsms_release_number`	Cancela/libera un número al final del período de facturación
`joltsms_list_messages`	Lista los SMS recientes con códigos OTP analizados
`joltsms_mark_read`	Marca mensajes individuales o masivos como leídos
`joltsms_wait_for_sms`	Sondea hasta que llegue un SMS (herramienta clave para flujos OTP)
`joltsms_get_latest_otp`	Obtiene el código de verificación analizado más reciente
`joltsms_billing_status`	Verifica todas las suscripciones con estado de facturación

Flujo de verificación OTP

El caso de uso más común: verificación telefónica automatizada:

1. joltsms_provision_number({ area_code: "650" })
   → Number provisioning started! Phone: +16505551234

2. joltsms_update_number({ number_id: "+16505551234", service_name: "PayPal" })
   → Tagged for easy lookup later

3. [Agent enters phone number on PayPal and requests OTP]

4. joltsms_wait_for_sms({ number_id: "+16505551234", timeout_seconds: 120 })
   → SMS received after 8.2s: "Your PayPal code is 847291"
   → OTP Code: 847291

5. joltsms_mark_read({ number_id: "+16505551234" })
   → Inbox clean

6. [Agent enters 847291 on PayPal — verification complete]

Variables de entorno

Variable	Requerida	Descripción
`JOLTSMS_API_KEY`	Sí	Tu clave de API (`jolt_sk_*`)
`JOLTSMS_API_URL`	No	URL base de la API (por defecto `https://api.joltsms.com`)

Requisitos

Node.js 18+
Una cuenta de JoltSMS con un método de pago registrado
Tu primer número debe solicitarse a través del Panel para completar la verificación inicial 3D Secure

Documentación

Licencia

MIT