{"_id":"@arplyx/mcp","_rev":"3-d32cbbd676deee4f3fbf03bfc4552df5","name":"@arplyx/mcp","dist-tags":{"latest":"0.3.0"},"versions":{"0.1.0":{"name":"@arplyx/mcp","version":"0.1.0","keywords":["mcp","model-context-protocol","arplyx","whatsapp","whatsapp-api","ai-agent"],"license":"MIT","_id":"@arplyx/mcp@0.1.0","maintainers":[{"name":"leobon","email":"leonelb@gmail.com"}],"homepage":"https://docs.arplyx.com/api/","bin":{"arplyx-mcp":"dist/index.js"},"dist":{"shasum":"6a4a517aa64613b3ba092bd7551a3361e88dd002","tarball":"https://registry.npmjs.org/@arplyx/mcp/-/mcp-0.1.0.tgz","fileCount":4,"integrity":"sha512-coQ3Agd18cqFikCcZ3FVVO8nJlhq6kj81qFeqtzfgEAdffBa9adatRkAhgckd4uH0lsZgk/hXDHrJDT7HJQCFg==","signatures":[{"sig":"MEYCIQCn3z6bHceaTx1hksjZz/QCkHLGFNlQJ1B7bk5L1vWszAIhAIMdAjCo++oVknMxzAPtbhzp/mpwNsSUA3f00W+9THZZ","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":10490},"type":"module","engines":{"node":">=18"},"gitHead":"6fb2aa3f9fac0676cba1496a58ff6313e33d29ec","scripts":{"dev":"tsc && node dist/index.js","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"leobon","email":"leonelb@gmail.com"},"_npmVersion":"10.8.2","description":"Servidor MCP de Arplyx: enviá mensajes y broadcasts de WhatsApp y consultá estados desde tu agente de IA.","directories":{},"_nodeVersion":"20.20.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.6.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.0_1781747550213_0.7798052000792433","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@arplyx/mcp","version":"0.2.0","keywords":["mcp","model-context-protocol","arplyx","whatsapp","whatsapp-api","ai-agent"],"license":"MIT","_id":"@arplyx/mcp@0.2.0","maintainers":[{"name":"leobon","email":"leonelb@gmail.com"}],"homepage":"https://docs.arplyx.com/api/","bin":{"arplyx-mcp":"dist/index.js"},"dist":{"shasum":"f25715b9ce004ade31e397a555276783cbe707cf","tarball":"https://registry.npmjs.org/@arplyx/mcp/-/mcp-0.2.0.tgz","fileCount":4,"integrity":"sha512-jMZy1tSfDULc1C9SY29QXJ66u5ty5wH+yyvJCFYR/Gh/adCv/7+oGYR9HPTcpkRs6mIpW5t/ikA6g3r9MY+eJA==","signatures":[{"sig":"MEUCIQD4j44DjSNg3zcDqK+mMPZ9Fotx1prFinSLmSuG/F4+KgIgR3ihfrPIgRCwZsbMwcamQWK9esX52VJJfVwKzpnOxsY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":12344},"type":"module","engines":{"node":">=18"},"gitHead":"f8e16cc2581735c00c7e1af3e04f59a7c68a611d","scripts":{"dev":"tsc && node dist/index.js","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"leobon","email":"leonelb@gmail.com"},"_npmVersion":"10.9.8","description":"Servidor MCP de Arplyx: enviá mensajes y broadcasts de WhatsApp y consultá estados desde tu agente de IA.","directories":{},"_nodeVersion":"22.23.1","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.6.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.2.0_1783178695448_0.3862785791265353","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@arplyx/mcp","version":"0.3.0","description":"Servidor MCP de Arplyx: enviá mensajes y broadcasts de WhatsApp y consultá estados desde tu agente de IA.","type":"module","license":"MIT","homepage":"https://docs.arplyx.com/api/","bin":{"arplyx-mcp":"dist/index.js"},"engines":{"node":">=18"},"scripts":{"build":"tsc","start":"node dist/index.js","dev":"tsc && node dist/index.js","prepublishOnly":"npm run build"},"keywords":["mcp","model-context-protocol","arplyx","whatsapp","whatsapp-api","ai-agent"],"dependencies":{"@modelcontextprotocol/sdk":"^1.12.0","zod":"^3.23.8"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.6.0"},"_id":"@arplyx/mcp@0.3.0","gitHead":"43d8e77a38383a62546bab9bdb25d255ecc607b5","_nodeVersion":"22.23.1","_npmVersion":"10.9.8","dist":{"integrity":"sha512-WJoO5NYIfEYSOnJ8fEdorasLqG2id2BcWGgQWDJac+uriK9uPrBcnvneQ+mrU5kRx5rw4aFndUn74+loRUOX9w==","shasum":"34e85060e3906024db9005db618e19b628d62309","tarball":"https://registry.npmjs.org/@arplyx/mcp/-/mcp-0.3.0.tgz","fileCount":4,"unpackedSize":13932,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCICs4TBCUMRqwnc5LntYaLBGdDsBWk++DAHSD/sueQlPSAiEA/n1fwPyUJfw1IgjagJModF/nAd2tqo2u4uxjCmZHjc8="}]},"_npmUser":{"name":"leobon","email":"leonelb@gmail.com"},"directories":{},"maintainers":[{"name":"leobon","email":"leonelb@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.3.0_1785334505633_0.8362772089430308"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-18T01:52:29.981Z","modified":"2026-07-29T14:15:05.991Z","0.1.0":"2026-06-18T01:52:30.354Z","0.2.0":"2026-07-04T15:24:55.579Z","0.3.0":"2026-07-29T14:15:05.790Z"},"license":"MIT","homepage":"https://docs.arplyx.com/api/","keywords":["mcp","model-context-protocol","arplyx","whatsapp","whatsapp-api","ai-agent"],"description":"Servidor MCP de Arplyx: enviá mensajes y broadcasts de WhatsApp y consultá estados desde tu agente de IA.","maintainers":[{"name":"leobon","email":"leonelb@gmail.com"}],"readme":"# @arplyx/mcp\r\n\r\nServidor [MCP](https://modelcontextprotocol.io/) 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.\r\n\r\n## Requisitos\r\n\r\n- Node.js 18+\r\n- Una **API key** de Arplyx (Portal → API Keys → Generar API Key)\r\n\r\n## Configuración\r\n\r\nEl servidor corre por **stdio** y se configura en tu cliente MCP. Tu API key va en la variable de entorno `ARPLYX_API_KEY`.\r\n\r\n### Claude Desktop / Claude Code\r\n\r\nAgregá esto a tu config de MCP (`claude_desktop_config.json` o `.mcp.json`):\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"arplyx\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"-y\", \"@arplyx/mcp\"],\r\n      \"env\": {\r\n        \"ARPLYX_API_KEY\": \"ak_live_xxxxxxxx\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n### Cursor / otros clientes\r\n\r\nMismo patrón: comando `npx -y @arplyx/mcp` y la variable `ARPLYX_API_KEY`.\r\n\r\n| Variable | Requerida | Default |\r\n|---|---|---|\r\n| `ARPLYX_API_KEY` | Sí | — |\r\n| `ARPLYX_BASE_URL` | No | `https://api.arplyx.com` |\r\n\r\n## Tools disponibles\r\n\r\n| Tool | Qué hace |\r\n|---|---|\r\n| `send_message` | Envía un mensaje de WhatsApp (texto o plantilla de Meta) a un número. |\r\n| `send_broadcast` | Envía un texto a todos los contactos de una lista (planes Basic/Pro). |\r\n| `list_whatsapp_accounts` | Lista tus cuentas de WhatsApp (id, tipo, estado, número). |\r\n| `get_message_status` | Consulta el estado de un mensaje por `messageId` o `externalId`. |\r\n| `list_messages` | Lista mensajes enviados con filtros (estado, canal, cuenta, fechas) y paginación. |\r\n| `get_inbound_sender_status` | ¿Este número ya le escribió a mi cuenta? (verificación de opt-in para WhatsApp Direct). |\r\n\r\nEjemplo de pedido a un agente:\r\n\r\n> \"Mandale por WhatsApp a +5491155551234 el texto 'Tu pedido fue confirmado', usá externalId pedido-10045.\"\r\n\r\nEl agente llama a `send_message` y te devuelve el `messageId` y el estado.\r\n\r\n## Notas\r\n\r\n- Todos los envíos usan un `externalId` tuyo como clave de **idempotencia**: reintentar con el mismo `externalId` y payload no duplica el envío.\r\n- 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.\r\n- `whatsapp_direct` requiere `whatsappAccountId` (lo obtenés con `list_whatsapp_accounts`).\r\n\r\n## Desarrollo\r\n\r\n```bash\r\nnpm install\r\nnpm run build\r\nARPLYX_API_KEY=ak_live_xxx npm start\r\n```\r\n\r\nDocumentación de la API: https://docs.arplyx.com/api/ · OpenAPI: https://api.arplyx.com/openapi.yaml\r\n","readmeFilename":"README.md"}