wacrm-mcp: deja que un agente de IA use WACRM
wacrm-mcp es un servidor MCP en Node con cinco herramientas sobre la Core API de WACRM: enviar una plantilla de WhatsApp, leer una conversación, crear un contacto, vigilar pedidos y actualizaciones de estado de mensajes, y leer el saldo de la billetera de tokens. Se autentica con una clave de API de WACRM que das como variable de entorno.
Por el equipo de WACRM Actualizado el
Vive en el repositorio de WACRM hoy — todavía no está publicado en npm ni en ningún registro de paquetes
5 herramientas, cada una una traducción directa a una llamada existente y ya probada de la Core API
Protocolo: el @modelcontextprotocol/sdk oficial sobre stdio (initialize, tools/list, tools/call)
Autenticación: una clave de API de WACRM con alcance vía la variable de entorno WACRM_API_KEY, enviada solo como Authorization: Bearer
Sin lógica de negocio en el servidor — la revisión de alcances, la repetición idempotente y el descuento de billetera ocurren en la Core API
WACRM no está afiliado ni respaldado por Meta
Para qué sirve wacrm-mcp
Un agente de IA que ya habla MCP puede usar estas cinco herramientas de la misma forma en que una persona usa la bandeja del Workspace de WACRM: enviar una plantilla aprobada, ponerse al día con una conversación, agregar un contacto nuevo, vigilar actualizaciones de pedidos y de entrega, y revisar cuánto queda de la billetera de tokens. Cada herramienta es una traducción directa a una llamada de la Core API hecha con la propia clave de API con alcance de quien llama — el servidor nunca guarda lógica de negocio, una decisión de política, ni una caché propia.
Habla con un experto
Huy Nguyen (David), Fundador y CEO
Pregunta qué herramienta encaja con tu agente, o cómo apuntar un cliente MCP al servidor.
Herramientas
| Herramienta | Llamada a la Core API | Alcance | Notas |
|---|---|---|---|
send_template | POST /v1/messages (type: template) | messages:send | Siempre lleva un Idempotency-Key — un reintento con la misma clave nunca envía dos veces. |
read_conversation | GET /v1/contacts/{contact}/messages | contacts:read | Paginación por marca de agua — pasa next_since_id de vuelta para avanzar de página. |
create_contact | POST /v1/contacts | contacts:write | Puede responder 402 plan_limit_reached si el límite de contactos del proyecto ya se usó. |
notify_order | POST /v1/webhook-endpoints | wa_webhooks:write | Suscribe tu propio endpoint HTTPS al evento message.status — todavía no existe una ruta de notificación de pedidos separada. |
wallet_balance | GET /v1/token-balance | wallet:read | Sin entrada — devuelve el saldo actual del proyecto y el uso de este ciclo. |
Configuración
Apunta un cliente MCP al servidor por stdio, con tu propia clave con alcance en el entorno:
{
"mcpServers": {
"wacrm": {
"command": "node",
"args": ["/path/to/apps/mcp/src/index.mjs"],
"env": {
"WACRM_API_KEY": "sk_live_tu_clave_con_alcance",
"WACRM_API_BASE": "https://api.wacrm.ai"
}
}
}
}Lo que esto no es
- No está publicado en npm ni en ningún registro de paquetes todavía — el paquete vive solo en este repositorio.
- No es un repositorio público — hoy no hay un enlace de código fuente público para esto.
- WACRM no está afiliado ni respaldado por Meta.
- Ningún descuento de billetera ni control de plan ocurre dentro de este servidor — eso vive en la propia Core API.
Preguntas frecuentes
¿wacrm-mcp ya está publicado en npm?
Todavía no. El paquete vive dentro del repositorio privado de WACRM hoy, sin configuración de publicación y sin repositorio público en GitHub. Se planea una versión pública del paquete.
¿Cómo se autentica wacrm-mcp?
Con una clave de API de WACRM que das como la variable de entorno WACRM_API_KEY al iniciar el servidor. La clave solo se envía como el encabezado Authorization: Bearer de cada solicitud a la Core API — nunca se registra, ni aparece en el resultado de una herramienta o en un error.
¿El servidor MCP agrega su propia facturación o revisión de alcances?
No. wacrm-mcp no tiene lógica de negocio propia: la revisión de alcances, la repetición idempotente y el descuento de la billetera ocurren dentro de la Core API detrás de la clave que proporcionas, igual que en una llamada directa a la API.
¿Qué pasa cuando falla una llamada a una herramienta?
La herramienta devuelve un resultado de error con el propio {code, message} de la Core API — insufficient_scope, una credencial inválida, un 404, un conflicto o un límite de tasa — nunca un resultado vacío en silencio.
¿WACRM está afiliado a Meta?
No. WACRM es un producto independiente construido sobre la WhatsApp Business Platform y no está afiliado ni respaldado por Meta, en esta página ni en ningún otro lugar de wacrm.ai.
Relacionado
Consigue una clave de API de WACRM para tu agente
Solicita acceso anticipado para obtener un Workspace y crear una clave de API con alcance para wacrm-mcp.