@funnelchat-hq/mcp
Provides tools for interacting with the Funnelchat public API to manage WhatsApp numbers, messages, contacts, templates, groups, webhooks, campaigns, broadcasts, automations, forms, boards, tickets, and account resources.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
@funnelchat-hq/mcp
El servidor MCP de la API pública de Funnelchat. Con él, tu asistente (Claude Code, Cursor u otro cliente MCP) usa tus números de WhatsApp, tus mensajes, contactos, plantillas, grupos y webhooks con tu clave de API: los mismos permisos, límites y errores que la API.
Cubre todas las llamadas que publica el portal de desarrolladores con 20 tools, unos 3.100 tokens en total.
Antes de empezar
Node 20.11 o más.
Una clave de API: en el panel, Desarrolladores → Crear clave. Dale solo los permisos que necesitas. La clave va en la configuración del servidor MCP, nunca en el chat.
Related MCP server: whatsapp_MCP
Instalarlo
Claude Code
claude mcp add funnelchat -e FUNNELCHAT_API_KEY=tu_clave -- npx -y @funnelchat-hq/mcpPara que solo pueda leer, agrega --read-only al final:
claude mcp add funnelchat -e FUNNELCHAT_API_KEY=tu_clave -- npx -y @funnelchat-hq/mcp --read-onlyCursor
En .cursor/mcp.json (de tu proyecto) o en ~/.cursor/mcp.json:
{
"mcpServers": {
"funnelchat": {
"command": "npx",
"args": ["-y", "@funnelchat-hq/mcp"],
"env": { "FUNNELCHAT_API_KEY": "tu_clave" }
}
}
}Otros clientes MCP
Todos piden lo mismo: el comando npx -y @funnelchat-hq/mcp y la variable FUNNELCHAT_API_KEY.
Claude Desktop: el mismo bloque
mcpServersde Cursor, enclaude_desktop_config.json.VS Code: en
.vscode/mcp.json, dentro de"servers", con"type": "stdio"y los mismoscommand,argsyenv.Codex: en
~/.codex/config.toml:[mcp_servers.funnelchat] command = "npx" args = ["-y", "@funnelchat-hq/mcp"] env = { FUNNELCHAT_API_KEY = "tu_clave" }
Si tu cliente solo se conecta por HTTP, mira Modo HTTP.
Probarlo con el sandbox
El sandbox imita la API en tu máquina, sin cuenta y sin mandar nada a WhatsApp. Arráncalo en una terminal y déjalo corriendo:
npx @funnelchat-hq/sandboxY apunta el MCP a él con FUNNELCHAT_BASE_URL. Contra el sandbox sirve cualquier clave bien formada:
claude mcp add funnelchat-sandbox -e 'FUNNELCHAT_API_KEY=1|fc_live_sandbox' -e FUNNELCHAT_BASE_URL=http://127.0.0.1:4010 -- npx -y @funnelchat-hq/mcpSin FUNNELCHAT_BASE_URL, el MCP va a la API real (https://api.funnelchat.com). El tool status dice siempre a qué URL está apuntando.
Cómo se usa
Le pides a tu asistente lo que quieres («manda un WhatsApp a…», «¿cuántas conversaciones sin leer tengo?») y él elige el tool. Empieza por status: dice qué números tienes conectados, si tienes webhooks y cuál es el siguiente paso.
Cada tool agrupa las llamadas de un recurso y recibe action, params y, en lo que no se deshace, confirm:
{ "action": "help" }
{ "action": "help", "params": { "action": "send" } }
{ "action": "send", "params": { "device_id": "dev_…", "phone": "5491122334455", "text": "Hola, Ana" } }help lista las acciones del tool; con params.action da los parámetros de una, con su ejemplo.
Generado desde la spec del portal v0.7.0-49-g31766eb (sha256 766230d4a8ce…): 253 llamadas en 18 tools por recurso, más status y search_docs.
Tool | Qué hace | Acciones | Lecturas | No se deshacen |
| Números de WhatsApp: ver, crear por QR, editar, desconectar, salud, cola de mensajes y Conversions API. | 22 | 12 | 5 |
| Links para conectar un número por QR, tuyo o de un cliente, o para reconectarlo. | 4 | 2 | 1 |
| Mandar mensajes y plantillas, ver un mensaje, marcarlo leído, reaccionar, reenviar y mandar formularios. | 11 | 1 | 0 |
| Conversaciones: mensajes con un contacto, listar, contar, marcar leídas y respuestas rápidas. | 13 | 8 | 1 |
| Contactos: ver, crear, editar y borrar, su ventana de 24 h, sus notas y su puntaje. | 16 | 8 | 2 |
| Etiquetas: crearlas, editarlas y ponerlas o quitarlas a contactos. | 9 | 4 | 1 |
| Campos personalizados y sus valores en cada contacto. | 8 | 3 | 1 |
| Plantillas de WhatsApp: ver, crear, editar, traer de Meta, métricas y borrar. | 7 | 3 | 1 |
| Grupos de WhatsApp: ver, seguir, mandarles un mensaje, participantes y canales. | 11 | 9 | 0 |
| Cambiar un grupo: crearlo, participantes, admins, nombre, foto, link y solicitudes. | 16 | 4 | 3 |
| Campañas de grupos, envíos programados y estadísticas, solo lectura. | 28 | 28 | 0 |
| Difusiones: ver, buscar contactos, costo, estadísticas, cancelar y carpetas. | 16 | 10 | 3 |
| Flujos: verlos, sus contactos, cancelar una ejecución, pausar a un contacto y carpetas. | 16 | 11 | 2 |
| Formularios de WhatsApp: ver, crear, publicar, números, versiones y respuestas. | 18 | 9 | 1 |
| Tableros: etapas y mover contactos entre ellas. | 16 | 5 | 2 |
| Tickets: ver, crear, editar, asignar, cerrar y reabrir. | 7 | 2 | 0 |
| Webhooks: crear, ver, editar, probar y borrar, sus entregas y los tipos de evento. | 8 | 4 | 1 |
| Tu cuenta: datos, equipo, contactos activos, costos de Meta, ventas, dominios y alertas. | 27 | 20 | 1 |
status y search_docs completan los 20: search_docs busca en los textos del portal, que van dentro del paquete.
Antes de llamar a la API
Los parámetros se revisan contra la spec: nombres, obligatorios, tipos y valores permitidos. Si sobra o falta algo, la llamada no sale y el error dice qué corregir, con el
helpde la acción. Un filtro mal escrito nunca devuelve la lista entera.Lo que no se deshace pide
confirm: true: borrar contactos, etiquetas o campos, cancelar una difusión, desconectar o borrar un número, sacar personas de un grupo… Sinconfirm, el MCP no llama a la API y le pide al asistente que te pregunte primero.helpmarca esas acciones con «no se deshace».--read-onlydeja solo las lecturas: no crea, no cambia ni borra nada, y tampoco da el QR de un número, porque con él se toma el control del número.
Errores
Un error vuelve marcado como error y con el cuerpo de la API: status, error (un código estable), message, y según el caso errors por campo o retry_after en segundos. Los errores del propio MCP, antes de llamar, son unknown_params, invalid_params, confirmation_required, read_only y missing_api_key.
Modo HTTP
Para hospedarlo o para clientes que solo hablan HTTP:
npx -y @funnelchat-hq/mcp --http --port 3333Escucha en
POST http://127.0.0.1:3333/mcp, sin sesión.Cada pedido trae su clave en
Authorization: Bearer <clave>(oX-API-Key). Sin clave responde401: en este modoFUNNELCHAT_API_KEYno se usa.Revisa
HostyOriginde cada pedido, para que una página web no pueda usarlo (DNS rebinding). Por defecto acepta127.0.0.1,localhosty[::1]con su puerto.Para escuchar fuera de tu máquina tienes que decir con qué nombre te llegan los pedidos:
npx -y @funnelchat-hq/mcp --http --host 0.0.0.0 --port 3333 \ --allowed-hosts mcp.tu-dominio.com --allowed-origins https://app.tu-dominio.comPonlo detrás de un proxy con HTTPS: la clave viaja en cada pedido.
GET /healthresponde{"ok": true}.
Opciones
Opción | Variable | Qué hace |
| La clave, en stdio. | |
|
| El host de la API. Por defecto |
| Solo lecturas. | |
| HTTP en vez de stdio. | |
| Dónde escucha en HTTP. Por defecto | |
|
| El puerto en HTTP. Por defecto |
|
| Los |
|
| Los |
| La versión y la ayuda. |
La spec y las versiones
Los tools salen de la spec que publica el portal (spec/funnelchat.json). De dónde salió, con su versión del portal y su sha256, está en spec/procedencia.json, que va dentro del paquete; status también la dice. Qué no se deshace, y qué se pierde, lo dice la spec con x-fc-destructive. Lo único escrito a mano es diseno.json: qué grupos del portal van a cada tool, algunos nombres de acción, lo poco que pide confirmación aunque la spec no lo marque y los ejemplos de las acciones principales.
Una versión nueva de la spec es una versión nueva del paquete. Las acciones no cambian de nombre entre versiones: si una tuviera que cambiar, sale en una versión mayor.
Desarrollo
npm ci
npm test # pruebas unitarias, sin red
npx @funnelchat-hq/sandbox --port 4010 # en otra terminal
SANDBOX_URL=http://127.0.0.1:4010 npm run test:e2e # contra el sandbox: stdio, HTTP, el ejemplo de cada acción y la prueba adversaria
npm run test:pack # npm pack, instalarlo en un proyecto vacío y correrlo con npx
npm run measure # cuántos tokens cargan los toolsCon una spec nueva del portal:
npm run generate -- --spec <ruta>/funnelchat.json # la copia a spec/, anota su procedencia y regenera generated/tabla.json
npm run docs -- --portal <carpeta del portal construido> # regenera docs/indice.json, lo que busca search_docsSi el archivo no viene de un checkout del portal, di de dónde salió con --source url=… --source portal_version=…. npm run generate:check y npm run docs:check fallan si algo no está al día, si docs/ ofrece lo que no existe o si la spec y la doc salieron de portales distintos; el CI corre los dos.
Para publicar, sube un tag vX.Y.Z igual a la versión de package.json sobre un commit de main: publish.yml corre el CI y publica en npm con provenance.
Licencia
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
All public upAPI operations as MCP tools: web scraping, search, screenshots, PDF, OCR and more.
WhatsApp (Web + Business API), SMS, contacts, and call records via 2Chat's MCP server.
Remote MCP for amoCRM and Kommo: leads, contacts, tasks, pipelines, chats, Salesbot. OAuth.
Marketo MCP server for AI. 130 tools to operate Marketo from Claude, Cursor, or ChatGPT.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables programmatic WhatsApp automation through MCP, including sending messages, managing chats and contacts, searching conversation history, and exchanging media files.MIT
- FlicenseNot gradedqualityCmaintenanceEnables linking a WhatsApp number via QR code and then sending, reading, listing chats, and checking status through MCP tools, with per-account API key authentication.-
- AlicenseAqualityBmaintenanceEnables local MCP clients to interact with the Superchat public API, supporting contact search, conversation management, notes, exports, and message sending using your own API key.26MIT
- AlicenseNot gradedqualityCmaintenanceEnables any MCP client to operate a SmartSend workspace through its REST API — looking up and searching customers, managing tags, lists, custom fields and blacklists, and sending or scheduling WhatsApp template messages, flows and push notifications. All 31 tools are scoped to a single organization's API key, with destructive sends flagged for confirmation.MIT