@arplyx/mcp

Servidor MCP de Arplyx: permite que tu agente de IA (Claude, Cursor, etc.) envíe mensajes y broadcasts de WhatsApp y consulte estados a través de la API de Arplyx, sin escribir código.

Requisitos

• Node.js 18+
• Una API key de Arplyx (Portal → API Keys → Generar API Key)

Configuración

El servidor corre por stdio y se configura en tu cliente MCP. Tu API key va en la variable de entorno ARPLYX_API_KEY.

Claude Desktop / Claude Code

Agregá esto a tu config de MCP (claude_desktop_config.json o .mcp.json):

{
  "mcpServers": {
    "arplyx": {
      "command": "npx",
      "args": ["-y", "@arplyx/mcp"],
      "env": {
        "ARPLYX_API_KEY": "ak_live_xxxxxxxx"
      }
    }
  }
}

Cursor / otros clientes

Mismo patrón: comando npx -y @arplyx/mcp y la variable ARPLYX_API_KEY.

| Variable | Requerida | Default | |---|---|---| | ARPLYX_API_KEY | Sí | — | | ARPLYX_BASE_URL | No | https://api.arplyx.com |

Tools disponibles

| Tool | Qué hace | |---|---| | send_message | Envía un mensaje de WhatsApp (texto o plantilla de Meta) a un número. | | send_broadcast | Envía un texto a todos los contactos de una lista (planes Basic/Pro). | | list_whatsapp_accounts | Lista tus cuentas de WhatsApp (id, tipo, estado, número). | | get_message_status | Consulta el estado de un mensaje por messageId o externalId. |

Ejemplo de pedido a un agente:

"Mandale por WhatsApp a +5491155551234 el texto 'Tu pedido fue confirmado', usá externalId pedido-10045."

El agente llama a send_message y te devuelve el messageId y el estado.

Notas

• Todos los envíos usan un externalId tuyo como clave de idempotencia: reintentar con el mismo externalId y payload no duplica el envío.
• Las plantillas (mensajería proactiva fuera de la ventana de 24 h) requieren channel: whatsapp_meta y que la plantilla esté aprobada en tu WhatsApp Manager.
• whatsapp_direct requiere whatsappAccountId (lo obtenés con list_whatsapp_accounts).

Desarrollo

npm install
npm run build
ARPLYX_API_KEY=ak_live_xxx npm start

Documentación de la API: https://docs.arplyx.com/api/ · OpenAPI: https://api.arplyx.com/openapi.yaml