Servidor MCP

Conecta asistentes de IA como Claude, Cursor o Windsurf a tu cuenta de SMS Masivos con el servidor MCP oficial. Envía SMS, verifica números y consulta campañas en lenguaje natural, usando tu misma API Key.

Qué es el servidor MCP

El Model Context Protocol (MCP) es un estándar abierto que permite a los asistentes de IA usar herramientas externas. El servidor MCP de SMS Masivos expone tu cuenta como un conjunto de herramientas que tu asistente puede invocar: enviar SMS, verificar números por OTP, gestionar contactos y agendas, consultar campañas y saldo y más.

En la práctica, en lugar de escribir código llamas a la API en lenguaje natural desde tu asistente:

«Envía un SMS al 5512345678 con "Tu cita es mañana a las 10am"»

El asistente traduce la petición a la herramienta correcta y la ejecuta con tu API Key. Es la misma cuenta, el mismo saldo y las mismas reglas que la API REST: el MCP es solo otra forma de acceder a ella.

El servidor se publica como el paquete @smsmasivos/mcp-server y su código es abierto en github.com/SMS-Masivos/mcp-server. Expone 30 herramientas sobre SMS, verificación OTP, contactos, webhooks, reportes, lealtad, monedero y solicitudes de pago.

Antes de empezar

Ten tu API Key a la mano

El servidor se autentica con tu API Key de SMS Masivos. Si aún no la tienes, genérala en la sección Integraciones del panel; el paso a paso está en Autenticación.

Elige conexión remota o local

La conexión remota (recomendada) no instala nada: tu asistente se conecta a https://mcp.smsmasivos.com.mx/mcp. La conexión local ejecuta el servidor en tu máquina con npx y requiere Node.js 18 o superior.

Conecta tu asistente

Usa la conexión remota siempre que tu cliente la soporte: no hay nada que instalar ni actualizar, y tu asistente siempre corre la última versión del servidor.

Claude Desktop

Abre el archivo de configuración (créalo si no existe):

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Conexión remota (recomendada):

{
  "mcpServers": {
    "smsmasivos": {
      "type": "http",
      "url": "https://mcp.smsmasivos.com.mx/mcp",
      "headers": {
        "Authorization": "Bearer TU_API_KEY"
      }
    }
  }
}

Conexión local con npx:

{
  "mcpServers": {
    "smsmasivos": {
      "command": "npx",
      "args": ["-y", "@smsmasivos/mcp-server"],
      "env": {
        "API_KEY": "TU_API_KEY"
      }
    }
  }
}

Reinicia Claude Desktop para que cargue el servidor.

Claude Code

Desde la terminal, agrégalo con un solo comando:

claude mcp add smsmasivos --transport http https://mcp.smsmasivos.com.mx/mcp -H "Authorization: Bearer TU_API_KEY"

Cursor

Agrega la misma configuración remota o local al archivo .cursor/mcp.json de tu proyecto (mismo formato JSON que Claude Desktop).

Windsurf

Agrega la configuración al archivo ~/.codeium/windsurf/mcp_config.json (mismo formato JSON que Cursor).

Herramientas disponibles

El servidor expone 30 herramientas. Cada una llama al mismo endpoint de la Referencia API que usarías por REST.

Área	Herramientas
SMS y campañas	`check_balance`, `send_sms` (hasta 500 números), `list_campaigns`, `get_campaign_stats`
Contactos y agendas	`list_agendas`, `find_agenda`, `create_agenda`, `rename_agenda`, `delete_agenda`, `get_contacts`, `add_contact`, `update_contact`, `duplicate_contact`, `delete_contact`
Verificación OTP	`send_otp` (SMS, voz o WhatsApp; reenvía, rota y cambia de canal), `verify_otp`, `get_otp_status`, `delete_otp`
Programa de lealtad	`list_loyalty_cards`, `add_loyalty_contact`, `get_loyalty_contact`
Monedero	`list_wallets`, `add_wallet_contact`, `get_wallet_contact`, `update_wallet_balance`
Webhooks	`manage_webhook` (acciones: `list`, `add`, `toggle`, `delete`; solo HTTPS)
Reportes y pagos	`generate_report` (máximo 7 días), `get_report_details`, `send_payment_request`
Utilidades	`get_metrics` (uso de la sesión)

¿Buscas el detalle de parámetros y respuestas de cada operación? Cada herramienta corresponde a un endpoint documentado en la Referencia API, donde puedes probarlo en vivo con el playground.

Ejemplos de uso

Una vez conectado, habla con tu asistente en lenguaje natural:

«¿Cuántos créditos me quedan?»
«Envía un SMS al 5512345678: Tu cita es mañana a las 10am»
«Muéstrame mis últimas campañas»
«Verifica el número 5598765432 por WhatsApp»
«Agrega a Juan (5512345678) a mi agenda de recordatorios»
«Genera un reporte de los envíos de esta semana»

El código de país por defecto es 52 (México), así que puedes pasar los números a 10 dígitos sin prefijo.

Modo de pruebas

Antes de enviar mensajes reales, prueba tu integración sin gastar saldo:

Pide a tu asistente que use modo sandbox al enviar (sandbox: 1 en send_sms): la petición se valida y responde igual que en producción, pero no consume créditos ni entrega el mensaje.
Consulta primero tu saldo con check_balance para confirmar que la conexión y tu API Key funcionan.

Si check_balance devuelve tus créditos, el servidor está conectado y autenticado correctamente.

Seguridad

Tu API Key da acceso completo a tu cuenta y tu saldo. Trátala como una contraseña: no la compartas ni la subas al control de versiones.
En conexión local, guárdala en la variable de entorno API_KEY, no en texto plano dentro de tu código.
Las restricciones de tu cuenta siguen aplicando a través del MCP: la lista blanca de IPs, los rate limits y las subcuentas funcionan igual que en la API REST.
Si sospechas que tu llave se filtró, rótala desde el panel y actualiza la configuración de tu asistente.

🔑 Autenticación

Genera, protege y rota tu API Key. Es la misma llave que usa el servidor MCP y la API REST.

← Previous

Errores y límites

Webhooks entrantes