Conectar por MCP (agentes de IA)

Arplyx publica un servidor MCP (Model Context Protocol) para que un agente de IA —Claude, Cursor y cualquier cliente compatible— envíe mensajes y consulte estados a través de Arplyx sin escribir código.

Configuración

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

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

Requiere Node.js 18+. La API key se genera en Portal → API Keys (ver Autenticación).

Tools disponibles

Tool	Qué hace
send_message	Envía un mensaje de WhatsApp (texto o plantilla) 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 por tu externalId.

Ejemplo

Con el servidor configurado, le pedís al agente en lenguaje natural:

"Mandale por WhatsApp al +5491155551234 el mensaje 'Tu pedido fue confirmado', con externalId pedido-10045 por WhatsApp Direct."

El agente llama a send_message y te devuelve el messageId y el estado. Podés pedirle también que liste tus cuentas o que chequee si un mensaje se entregó.

Misma cuota e idempotencia

Los envíos por MCP cuentan en la misma cuota mensual de tu plan y respetan la idempotencia por externalId, igual que la API y el portal.