{"_id":"@jskirk/mcp-whatsapp-evo","_rev":"4-bbc9b78d2288e7d33bf55319eb9938ff","name":"@jskirk/mcp-whatsapp-evo","dist-tags":{"latest":"1.0.3"},"versions":{"1.0.0":{"name":"@jskirk/mcp-whatsapp-evo","version":"1.0.0","keywords":["mcp","whatsapp","evolution-api","ai-agent","modelcontextprotocol","chatbot","messaging"],"author":{"name":"Jorge Solano Kirk"},"license":"ISC","_id":"@jskirk/mcp-whatsapp-evo@1.0.0","maintainers":[{"name":"jskirk","email":"jskirk@gmail.com"}],"homepage":"https://github.com/jskfox/mcp-whatsapp-evo#readme","bugs":{"url":"https://github.com/jskfox/mcp-whatsapp-evo/issues"},"bin":{"mcp-whatsapp-evo":"dist/cli.js"},"dist":{"shasum":"c41caff246f3880f8979adf3d3875c6a49b55b83","tarball":"https://registry.npmjs.org/@jskirk/mcp-whatsapp-evo/-/mcp-whatsapp-evo-1.0.0.tgz","fileCount":99,"integrity":"sha512-QJLMziHY8dB8XBhZ2nw3TSEPIsn0sWziHSROism/zbKaRfIoE1MWnsK3B8FtL6jY7lmIemtUAWyWG6AlEBC/cg==","signatures":[{"sig":"MEQCIGgamKkd3bHvrO4fbb9GJ0ehFRjxRti2SSTY8rScnAsGAiA0jgyCUf3hohJK1Bs/fRwli6AV9NwPqjbDhMVSvcY7Ww==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":270257},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"c5e6eb5202ba75b09513e43f2b2e32c90aff6800","scripts":{"lint":"eslint src --ext .ts","test":"vitest","build":"tsc && node scripts/add-shebang.js","watch":"tsc --watch","prepublishOnly":"npm run build"},"_npmUser":{"name":"jskirk","email":"jskirk@gmail.com"},"repository":{"url":"git+https://github.com/jskfox/mcp-whatsapp-evo.git","type":"git"},"_npmVersion":"10.2.4","description":"MCP server for WhatsApp integration using evolution2-api-sdk. Connect AI agents to WhatsApp with permission controls and whitelist validation.","directories":{},"_nodeVersion":"21.4.0","dependencies":{"zod":"3.25.76","yaml":"2.8.3","evolution2-api-sdk":"^3.0.0","@modelcontextprotocol/sdk":"1.29.0"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"9.39.4","vitest":"2.1.9","typescript":"5.9.3","@types/node":"22.19.17","@typescript-eslint/parser":"8.58.1","@typescript-eslint/eslint-plugin":"8.58.1"},"_npmOperationalInternal":{"tmp":"tmp/mcp-whatsapp-evo_1.0.0_1775784374355_0.5998814026791197","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@jskirk/mcp-whatsapp-evo","version":"1.0.1","keywords":["mcp","whatsapp","evolution-api","ai-agent","modelcontextprotocol","chatbot","messaging"],"author":{"name":"Jorge Solano Kirk"},"license":"ISC","_id":"@jskirk/mcp-whatsapp-evo@1.0.1","maintainers":[{"name":"jskirk","email":"jskirk@gmail.com"}],"homepage":"https://github.com/jskfox/mcp-whatsapp-evo#readme","bugs":{"url":"https://github.com/jskfox/mcp-whatsapp-evo/issues"},"bin":{"mcp-whatsapp-evo":"dist/cli.js"},"dist":{"shasum":"ba2e4109d352856585e422121dce1b6fd7225b01","tarball":"https://registry.npmjs.org/@jskirk/mcp-whatsapp-evo/-/mcp-whatsapp-evo-1.0.1.tgz","fileCount":99,"integrity":"sha512-0YG6TTMJsOOLsDaViEkYwo59CTzufELwYNvSV0VgBfWbxNtZCpjXwpeEloC473fH+k7JZTsAnr90YtTrmGSknA==","signatures":[{"sig":"MEUCIQC9kQ6h20tEUFtlMl5uHCtSlwuIcp48ZlaMo8PZjbghQAIgUMmLypOyIuft7lRlJ62WuwaxwEja9X2KgIhLVZKCB1A=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":270130},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"f8b5c14169640b32fdbeb25200c355e915cca100","scripts":{"lint":"eslint src --ext .ts","test":"vitest","build":"tsc && node scripts/add-shebang.js","watch":"tsc --watch","prepublishOnly":"npm run build"},"_npmUser":{"name":"jskirk","email":"jskirk@gmail.com"},"repository":{"url":"git+https://github.com/jskfox/mcp-whatsapp-evo.git","type":"git"},"_npmVersion":"10.2.4","description":"MCP server for WhatsApp integration using evolution2-api-sdk. Connect AI agents to WhatsApp with permission controls and whitelist validation.","directories":{},"_nodeVersion":"21.4.0","dependencies":{"zod":"3.25.76","yaml":"2.8.3","evolution2-api-sdk":"^3.0.0","@modelcontextprotocol/sdk":"1.29.0"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"9.39.4","vitest":"2.1.9","typescript":"5.9.3","@types/node":"22.19.17","@typescript-eslint/parser":"8.58.1","@typescript-eslint/eslint-plugin":"8.58.1"},"_npmOperationalInternal":{"tmp":"tmp/mcp-whatsapp-evo_1.0.1_1775798551400_0.2290210830351247","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@jskirk/mcp-whatsapp-evo","version":"1.0.2","keywords":["mcp","whatsapp","evolution-api","ai-agent","modelcontextprotocol","chatbot","messaging"],"author":{"name":"Jorge Solano Kirk"},"license":"ISC","_id":"@jskirk/mcp-whatsapp-evo@1.0.2","maintainers":[{"name":"jskirk","email":"jskirk@gmail.com"}],"homepage":"https://github.com/jskfox/mcp-whatsapp-evo#readme","bugs":{"url":"https://github.com/jskfox/mcp-whatsapp-evo/issues"},"bin":{"mcp-whatsapp-evo":"dist/cli.js"},"dist":{"shasum":"4e27d35505819fc566fbcb164c2220f126d10d30","tarball":"https://registry.npmjs.org/@jskirk/mcp-whatsapp-evo/-/mcp-whatsapp-evo-1.0.2.tgz","fileCount":99,"integrity":"sha512-aBA4HRIo/Hntoetxy0iWVdBvNORrRTm1iyqSBcfHWDBVj701stGbKsJ5zSCxc2rvHQbcVTEQoo4Gi3sfkibb3g==","signatures":[{"sig":"MEYCIQCtUmigGoxanYCMo/dI80OTc5TNrrkojddI81AORTxyDAIhAOMWBrBIMyv0TQR6BQvglO/2HhA+bUG4WaD7ww8ul5Si","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":270392},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"365e2fdde133e1e583a49378502bbed133f98cb2","scripts":{"lint":"eslint src --ext .ts","test":"vitest","build":"tsc && node scripts/add-shebang.js","watch":"tsc --watch","prepublishOnly":"npm run build"},"_npmUser":{"name":"jskirk","email":"jskirk@gmail.com"},"repository":{"url":"git+https://github.com/jskfox/mcp-whatsapp-evo.git","type":"git"},"_npmVersion":"10.2.4","description":"MCP server for WhatsApp integration using evolution2-api-sdk. Connect AI agents to WhatsApp with permission controls and whitelist validation.","directories":{},"_nodeVersion":"21.4.0","dependencies":{"zod":"3.25.76","evolution2-api-sdk":"3.0.0","@modelcontextprotocol/sdk":"1.29.0"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"9.39.4","vitest":"2.1.9","typescript":"5.9.3","@types/node":"22.19.17","@typescript-eslint/parser":"8.58.1","@typescript-eslint/eslint-plugin":"8.58.1"},"_npmOperationalInternal":{"tmp":"tmp/mcp-whatsapp-evo_1.0.2_1775801683492_0.3529254817359502","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@jskirk/mcp-whatsapp-evo","version":"1.0.3","description":"MCP server for WhatsApp integration using evolution2-api-sdk. Connect AI agents to WhatsApp with permission controls and whitelist validation.","type":"module","main":"./dist/index.js","bin":{"mcp-whatsapp-evo":"dist/cli.js"},"scripts":{"build":"tsc && node scripts/add-shebang.js","watch":"tsc --watch","test":"vitest","lint":"eslint src --ext .ts","prepublishOnly":"npm run build"},"keywords":["mcp","whatsapp","evolution-api","ai-agent","modelcontextprotocol","chatbot","messaging"],"author":{"name":"Jorge Solano Kirk"},"license":"ISC","repository":{"type":"git","url":"git+https://github.com/jskfox/mcp-whatsapp-evo.git"},"engines":{"node":">=18.0.0"},"dependencies":{"@modelcontextprotocol/sdk":"1.29.0","evolution2-api-sdk":"3.0.0","zod":"3.25.76"},"devDependencies":{"@types/node":"22.19.17","@typescript-eslint/eslint-plugin":"8.58.1","@typescript-eslint/parser":"8.58.1","eslint":"9.39.4","typescript":"5.9.3","vitest":"2.1.9"},"_id":"@jskirk/mcp-whatsapp-evo@1.0.3","gitHead":"e9a15b44b94c14c4afc0e3bbce01ec5709e24305","types":"./dist/index.d.ts","bugs":{"url":"https://github.com/jskfox/mcp-whatsapp-evo/issues"},"homepage":"https://github.com/jskfox/mcp-whatsapp-evo#readme","_nodeVersion":"22.22.2","_npmVersion":"10.9.7","dist":{"integrity":"sha512-1xNrWmNGEmfh22rXUzpcLddHi/fVuRUBzetdop7jf+fl1X81xuEWTdnh4ljRJrBJZmouCRR0dP7+C3GTPN6frw==","shasum":"1d49c4dd7066016a7c7e57b8e535d634be1d119a","tarball":"https://registry.npmjs.org/@jskirk/mcp-whatsapp-evo/-/mcp-whatsapp-evo-1.0.3.tgz","fileCount":99,"unpackedSize":270486,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIHthUEIAbxsmOBUndOhwGW6FUWmCG6nzWNJoR038UWmRAiEA772JJjYo0R+ow5b1NXzlc/2rDf8U67aQtDiXLbVrUgI="}]},"_npmUser":{"name":"jskirk","email":"jskirk@gmail.com"},"directories":{},"maintainers":[{"name":"jskirk","email":"jskirk@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-whatsapp-evo_1.0.3_1775802272716_0.039071055569916524"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-10T01:26:14.203Z","modified":"2026-04-10T06:24:32.976Z","1.0.0":"2026-04-10T01:26:14.533Z","1.0.1":"2026-04-10T05:22:31.547Z","1.0.2":"2026-04-10T06:14:43.624Z","1.0.3":"2026-04-10T06:24:32.862Z"},"bugs":{"url":"https://github.com/jskfox/mcp-whatsapp-evo/issues"},"author":{"name":"Jorge Solano Kirk"},"license":"ISC","homepage":"https://github.com/jskfox/mcp-whatsapp-evo#readme","keywords":["mcp","whatsapp","evolution-api","ai-agent","modelcontextprotocol","chatbot","messaging"],"repository":{"type":"git","url":"git+https://github.com/jskfox/mcp-whatsapp-evo.git"},"description":"MCP server for WhatsApp integration using evolution2-api-sdk. Connect AI agents to WhatsApp with permission controls and whitelist validation.","maintainers":[{"name":"jskirk","email":"jskirk@gmail.com"}],"readme":"# WhatsApp MCP Server\n\nMCP server que conecta agentes de AI a WhatsApp usando la librería `evolution2-api-sdk`.\n\nPermite a un agente de AI enviar y recibir mensajes de WhatsApp de forma controlada, con permisos configurables y validación de whitelist.\n\n## Instalación\n\n### Paquete npm\n\n```bash\nnpm install -g @jskirk/mcp-whatsapp-evo\n```\n\n### Requisitos previos\n\n- Node.js 18+ (preferiblemente 20+)\n- npm o yarn\n- Una instancia de [Evolution API](https://github.com/jskfox/evolution2-api-sdk) corriendo\n\n### Desarrollo (desde el repo)\n\n```bash\ngit clone https://github.com/jskfox/mcp-whatsapp-evo.git\ncd mcp-whatsapp-evo\nnpm install\nnpm run build\n```\n\n## Configuración\n\nLa configuración se realiza mediante variables de entorno. Copia `.env.example` a `.env` y edita las credenciales:\n\n```bash\ncp .env.example .env\n```\n\n### Variables de entorno\n\n| Variable | Descripción | Requerido |\n|----------|-------------|-----------|\n| `EVOLUTION_HOST` | URL de tu Evolution API | ✅ Sí |\n| `EVOLUTION_API_KEY` | API key de autenticación | ✅ Sí |\n| `EVOLUTION_INSTANCE_NAME` | Nombre de la instancia WhatsApp | ✅ Sí |\n| `PERMISSIONS_TIER` | Nivel de permisos (read, send, admin) | No (default: admin) |\n| `WHITELIST_ENABLED` | Habilitar whitelist (true/false) | No (default: true) |\n| `WHITELIST_PHONES` | Teléfonos permitidos (comma-separated, E.164) | No |\n| `WHITELIST_GROUPS` | Grupos permitidos (comma-separated, JID) | No |\n| `WHITELIST_BLOCK_UNKNOWN` | Bloquear remitentes unknown | No (default: true) |\n| `WEBHOOK_PORT` | Puerto del servidor webhook | No (default: 3000) |\n| `WEBHOOK_PATH` | Path del endpoint webhook | No (default: /webhook) |\n| `WEBHOOK_TOKEN` | Token para autenticación del webhook | No |\n\n### Ejemplo .env\n\n```env\nEVOLUTION_HOST=http://localhost:8080\nEVOLUTION_API_KEY=mi-api-key\nEVOLUTION_INSTANCE_NAME=mi-instancia\n\nPERMISSIONS_TIER=admin\n\nWHITELIST_ENABLED=true\nWHITELIST_PHONES=+5491112345678,+5491187654321\nWHITELIST_GROUPS=123456789@g.us\nWHITELIST_BLOCK_UNKNOWN=true\n\nWEBHOOK_PORT=3000\nWEBHOOK_PATH=/webhook\nWEBHOOK_TOKEN=mi-token-secreto\n```\n\n## Uso\n\n### Ejecución con npx (sin instalar)\n\n```bash\n# Carga variables de entorno desde .env\nexport $(cat .env | xargs)\nnpx @jskirk/mcp-whatsapp-evo\n\n# O directamente con dotenv\nnode -r dotenv/config node_modules/.bin/mcp-whatsapp-evo\n```\n\n### Ejecución instalada globalmente\n\n```bash\n# Después de: npm install -g @jskirk/mcp-whatsapp-evo\nmcp-whatsapp-evo\n```\n\n### Integración con Editors usando npx\n\nSi prefieres usar `npx` en lugar del binario global, configura tu editor así:\n\n#### Windsurf (npx)\n\n```json\n{\n  \"mcpServers\": {\n    \"whatsapp\": {\n      \"command\": \"bash\",\n      \"args\": [\"-c\", \"source ~/.env_whatsapp && npx @jskirk/mcp-whatsapp-evo\"]\n    }\n  }\n}\n```\n\n#### Cursor (npx)\n\n```json\n{\n  \"mcpServers\": {\n    \"whatsapp\": {\n      \"command\": \"bash\",\n      \"args\": [\"-c\", \"source ~/.env_whatsapp && npx @jskirk/mcp-whatsapp-evo\"]\n    }\n  }\n}\n```\n\n#### Claude Desktop (npx)\n\n```json\n{\n  \"mcpServers\": {\n    \"whatsapp\": {\n      \"command\": \"bash\",\n      \"args\": [\"-c\", \"source ~/.env_whatsapp && npx @jskirk/mcp-whatsapp-evo\"]\n    }\n  }\n}\n```\n\n#### VS Code (npx)\n\n```json\n{\n  \"mcpServers\": {\n    \"whatsapp\": {\n      \"command\": \"bash\",\n      \"args\": [\"-c\", \"source ~/.env_whatsapp && npx @jskirk/mcp-whatsapp-evo\"]\n    }\n  }\n}\n```\n\nCrea `~/.env_whatsapp` con las variables:\n\n```env\nEVOLUTION_HOST=http://localhost:8080\nEVOLUTION_API_KEY=mi-api-key\nEVOLUTION_INSTANCE_NAME=mi-instancia\nPERMISSIONS_TIER=admin\nWHITELIST_ENABLED=true\nWHITELIST_PHONES=+5491112345678\nWEBHOOK_PORT=3000\nWEBHOOK_TOKEN=mi-token\n```\n\n## Herramientas Disponibles (16 tools)\n\n### Mensajería\n\n| Tool | Descripción | Permiso |\n|------|-------------|---------|\n| `whatsapp_send_text` | Enviar mensaje de texto | send |\n| `whatsapp_send_media` | Enviar imagen, video, documento | send |\n| `whatsapp_send_location` | Enviar ubicación | send |\n| `whatsapp_send_contact` | Enviar contacto | send |\n| `whatsapp_send_reaction` | Enviar reacción | send |\n\n### Instancia\n\n| Tool | Descripción | Permiso |\n|------|-------------|---------|\n| `whatsapp_connect` | Conectar instancia | admin |\n| `whatsapp_disconnect` | Desconectar instancia | admin |\n| `whatsapp_connection_status` | Estado de conexión | read |\n| `whatsapp_set_presence` | Configurar presencia | admin |\n\n### Chats\n\n| Tool | Descripción | Permiso |\n|------|-------------|---------|\n| `whatsapp_get_chats` | Listar chats | read |\n| `whatsapp_get_contacts` | Listar contactos | read |\n| `whatsapp_get_messages` | Historial de mensajes | read |\n| `whatsapp_mark_as_read` | Marcar como leído | send |\n| `whatsapp_check_number` | Verificar si tiene WhatsApp | read |\n| `whatsapp_block_number` | Bloquear/desbloquear número | send |\n\n### Grupos\n\n| Tool | Descripción | Permiso |\n|------|-------------|---------|\n| `whatsapp_get_groups` | Listar grupos | read |\n| `whatsapp_get_group_members` | Miembros de grupo | read |\n| `whatsapp_send_group_message` | Mensaje a grupo | send |\n| `whatsapp_create_group` | Crear grupo | admin |\n| `whatsapp_update_group` | Actualizar grupo | admin |\n\n## Sistema de Permisos\n\n3 niveles jerárquicos:\n\n```\nadmin > send > read\n```\n\nUn agente con tier `send` puede usar herramientas `read` y `send`, pero no `admin`.\n\n## Whitelist\n\nCuando `WHITELIST_ENABLED=true`:\n\n- **Envíos salientes**: Solo puede enviar a números/grupos en la whitelist\n- **Recepciones entrantes**: Si `WHITELIST_BLOCK_UNKNOWN=true`, ignora mensajes de números no en whitelist\n\nCuando `WHITELIST_ENABLED=false`:\n- Puede enviar a cualquier número\n- recibe de cualquier número\n\n## Webhook (Mensajes Entrantes)\n\nEl servidor levanta un HTTP server en el puerto configurado (`default: 3000`).\n\nEl endpoint `POST /webhook` recibe mensajes entrantes de WhatsApp.\n\n### Configurar Webhook en Evolution API\n\nEn tu Evolution API, configura la URL del webhook:\n\n```\nhttp://tu-servidor:3000/webhook?token=tu-token-secreto\n```\n\n### Formato del Webhook\n\n```json\n{\n  \"event\": \"messages.upsert\",\n  \"data\": {\n    \"key\": {\n      \"remoteJid\": \"5491112345678@s.whatsapp.net\",\n      \"fromMe\": false\n    },\n    \"message\": {\n      \"conversation\": \"Hola!\"\n    },\n    \"pushName\": \"Nombre\"\n  }\n}\n```\n\n## Integración con n8n\n\n### Opción 1: n8n como MCP Client\n\nn8n puede usar este MCP server como integración:\n\n1. ** Instala el n8n MCP extension** (si disponible)\n2. **Configura en n8n settings:**\n\n```json\n{\n  \"mcpServers\": {\n    \"whatsapp\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/mcp-whatsapp-evo/dist/index.js\"]\n    }\n  }\n}\n```\n\n3. **Usa las tools en workflows n8n** para enviar mensajes de WhatsApp desde tus automatizaciones.\n\n### Opción 2: n8n como Webhook Receiver\n\nPuedes usar n8n para recibir eventos del MCP y procesarlos:\n\n1. El MCP recibe un mensaje entrante por webhook\n2. n8n hace polling a los recursos del MCP o recibe notificaciones\n3. n8n procesa y actúa según el contenido\n\n### Opción 3: HTTP Request Node\n\nUsa el n8n HTTP Request Node para llamar directamente a la Evolution API:\n\n```\n┌─────────────┐      HTTP Request       ┌──────────────┐\n│   n8n       │ ──────────────────────► │ Evolution API│\n│  Workflow   │                         │   (directo)  │\n└─────────────┘                         └──────────────┘\n```\n\nEsta opción es útil si prefieres no usar MCP pero quieres automatizar con n8n.\n\n## Casos de Uso\n\n### 1. Escalation Agent (Man in the Loop)\n\nCuando un agente necesita ayuda humana:\n\n```\nAgente AI ──send_message──► WhatsApp ──webhook──► Humano\n                                        ▲\n                                        │\n                                    Responde\n                                        │\nAgente AI ◄──── Continúa ──────────────┘\n```\n\n### 2. Notificaciones\n\nEl agente envía actualizaciones a usuarios:\n\n```\nAgente AI ──send_message──► WhatsApp ──► Usuario\n```\n\n### 3. Queries\n\nEl agente consulta información:\n\n```\nAgente AI ──get_messages──► WhatsApp ◄── Chat History\n```\n\n## Logs\n\nLos logs van a stdout/stderr:\n\n```\n[server] Starting WhatsApp MCP server...\n[config] Loaded configuration from environment\n[sdk] Evolution API SDK initialized\n[sdk] Connected to WhatsApp instance\n[mcp] Registered 16 tools\n[mcp] MCP server started on stdio transport\n[webhook] Webhook server running at http://localhost:3000\n```\n\n## Troubleshooting\n\n### \"Instance not connected\"\n\nVerifica que tu Evolution API tenga la instancia conectada y el webhook configurado.\n\n### \"Number not in whitelist\"\n\nEl número no está en la whitelist. Agrégalo a `.env` en `WHITELIST_PHONES`.\n\n### \"Permission denied\"\n\nEl tier del agente es insuficiente para esa tool. Aumenta el tier en `PERMISSIONS_TIER`.\n\n### Tests fallan\n\n```bash\nnpm test\n```\n\n## Desarrollo\n\n```bash\n# Instalar dependencias\nnpm install\n\n# Build\nnpm run build\n\n# Modo watch\nnpm run watch\n\n# Lint\nnpm run lint\n\n# Tests\nnpm test\n```\n\n## Publicar en npm\n\n```bash\n# Login en npm\nnpm login\n\n# Publicar (scoped package requiere access)\nnpm publish --access public\n```\n\n## Arquitectura de Seguridad\n\n```\n┌─────────────────────────────────────────────────────────┐\n│                    Agente AI                            │\n└─────────────────┬───────────────────────────────────────┘\n                  │ MCP (stdio)\n┌─────────────────▼───────────────────────────────────────┐\n│              MCP Server (mcp-whatsapp)                 │\n│  ┌─────────────────────────────────────────────────┐   │\n│  │ 1. Permission Guard (¿tiene tier suficiente?)    │   │\n│  └─────────────────────┬───────────────────────────┘   │\n│  ┌─────────────────────▼───────────────────────────┐   │\n│  │ 2. Whitelist Validator (¿está en lista blanca?) │   │\n│  └─────────────────────┬───────────────────────────┘   │\n│  ┌─────────────────────▼───────────────────────────┐   │\n│  │ 3. Sanitizer (¿input seguro?)                   │   │\n│  └─────────────────────┬───────────────────────────┘   │\n│  ┌─────────────────────▼───────────────────────────┐   │\n│  │ 4. Evolution SDK (¿respuesta válida?)            │   │\n│  └─────────────────────────────────────────────────┘   │\n└─────────────────────────────────────────────────────────┘\n                  │\n┌─────────────────▼───────────────────────────────────────┐\n│              Evolution API / WhatsApp                    │\n└─────────────────────────────────────────────────────────┘\n```\n\n## Licencia\n\nISC\n\n## Autor\n\n**Jorge Solano Kirk**\n\n- GitHub: [jskfox](https://github.com/jskfox)\n- Twitter/X: [@jskfox](https://x.com/jskfox)\n- LinkedIn: jorge.skirk\n\n---\n\nHecho con ❤️\n","readmeFilename":"README.md"}