@smsmasivos/mcp-server

MCP server para SMS Masivos — plataforma de envio de SMS masivos en Mexico.

Conecta tu asistente de IA con SMS Masivos para enviar mensajes, gestionar contactos, verificar numeros y consultar campanas usando lenguaje natural.

Features

• 30 tools — SMS, campanas, contactos, agendas CRUD, webhooks, reports, payment requests, verificacion OTP completa (start/check/resend/reset), lealtad, monederos y metricas

• FAQ integrado — 6 recursos de ayuda accesibles desde tu asistente

• Prompts guiados — 4 flujos paso a paso para tareas comunes

• Telemetria — metricas de uso por sesion (latencia, errores, sandbox vs produccion)

• Sandbox — prueba sin enviar mensajes reales ni gastar creditos

• Compatible — funciona con Claude, Cursor, Windsurf y cualquier cliente MCP

Related MCP server: Wassenger WhatsApp MCP Server

Quick Start

Necesitas una API key de SMS Masivos. Obtenla en tu panel.

Opcion 1: Remoto (recomendado — sin instalar nada)

Agrega esta configuracion a tu herramienta de IA y listo:

{
  "mcpServers": {
    "smsmasivos": {
      "type": "http",
      "url": "https://mcp.smsmasivos.com.mx/mcp",
      "headers": {
        "Authorization": "Bearer tu-api-key"
      }
    }
  }
}

Opcion 2: Local (requiere Node.js)

npx @smsmasivos/mcp-server

{
  "mcpServers": {
    "smsmasivos": {
      "command": "npx",
      "args": ["-y", "@smsmasivos/mcp-server"],
      "env": {
        "SMSMASIVOS_API_KEY": "tu-api-key"
      }
    }
  }
}

Configuracion por herramienta

Claude Desktop

Agrega a tu archivo de configuracion:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Remoto (recomendado):

{
  "mcpServers": {
    "smsmasivos": {
      "type": "http",
      "url": "https://mcp.smsmasivos.com.mx/mcp",
      "headers": {
        "Authorization": "Bearer tu-api-key"
      }
    }
  }
}

Local:

{
  "mcpServers": {
    "smsmasivos": {
      "command": "npx",
      "args": ["-y", "@smsmasivos/mcp-server"],
      "env": {
        "SMSMASIVOS_API_KEY": "tu-api-key"
      }
    }
  }
}

Claude Code

Remoto (recomendado):

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

Local:

claude mcp add smsmasivos -e SMSMASIVOS_API_KEY=tu-api-key -- npx -y @smsmasivos/mcp-server

Cursor

Agrega a .cursor/mcp.json en tu proyecto:

Remoto (recomendado):

{
  "mcpServers": {
    "smsmasivos": {
      "type": "http",
      "url": "https://mcp.smsmasivos.com.mx/mcp",
      "headers": {
        "Authorization": "Bearer tu-api-key"
      }
    }
  }
}

Local:

{
  "mcpServers": {
    "smsmasivos": {
      "command": "npx",
      "args": ["-y", "@smsmasivos/mcp-server"],
      "env": {
        "SMSMASIVOS_API_KEY": "tu-api-key"
      }
    }
  }
}

Windsurf

Agrega a ~/.codeium/windsurf/mcp_config.json — misma configuracion que Cursor (remoto o local).

Tools disponibles

SMS y campanas

Contactos y agendas

Verificacion OTP

Programa de lealtad

⚠️ register_loyalty_sale fue removida en v1.0.0 (breaking) por falta de idempotency en el endpoint del API. Ver CHANGELOG.

Monedero electronico

Webhooks

manage_webhook consolida las 4 operaciones en una sola tool vía el campo action:

Solo se permite un webhook por cuenta. Las URLs deben ser https://; se rechazan IPs privadas, loopback e IPv6 link-local.

Reports

Solicitudes de pago

Utilidades

FAQ Resources

El servidor incluye 6 recursos de ayuda accesibles via MCP resources:

Prompts guiados

Flujos paso a paso que tu asistente puede ejecutar:

Ejemplos

Una vez configurado, puedes pedirle a tu asistente:

• "Cuantos creditos me quedan?"

• "Envia un SMS al 5512345678 con el texto: Tu cita es manana a las 10am"

• "Muestrame mis ultimas campanas"

• "Como fue la entrega de la campana 12345?"

• "Verifica el numero 5598765432 por WhatsApp"

• "Agrega a Juan (5512345678) a mi agenda de recordatorios"

• "Muestrame mis tarjetas de lealtad"

• "Cuantos sellos tiene el cliente 5512345678?"

• "Agrega $50 al monedero del cliente 5598765432"

Desarrollo

git clone https://github.com/SMS-Masivos/mcp-server.git
cd mcp-server
npm install
npm run build
npm test

Publicación (mantenedores)

La publicación a npm es manual (granular access token con 2FA configurado en ~/.npmrc):

# 1. Bump de versión en package.json + entrada en CHANGELOG.md
# 2. Publicar
npm publish
# 3. Redeploy del worker remoto (recoge la nueva versión vía caret ^x.y.z)
gh workflow run deploy.yml --repo SMS-Masivos/mcp-worker --ref main

El worker mcp-worker auto-deploya en cada push a su main y hace npm ci, por lo que recoge la última versión publicada. Si solo publicaste en este repo (sin cambios en el worker), dispara su deploy manualmente con el comando de arriba.

Licencia

MIT