{"_id":"@alltomatos/izapia-mcp","_rev":"5-d72a95e4594778506a3e38eeb0ddacef","name":"@alltomatos/izapia-mcp","dist-tags":{"latest":"0.3.0"},"versions":{"0.1.0":{"name":"@alltomatos/izapia-mcp","version":"0.1.0","keywords":["mcp","modelcontextprotocol","whatsapp","izapia","ai-agents"],"license":"MIT","_id":"@alltomatos/izapia-mcp@0.1.0","maintainers":[{"name":"alltomatos","email":"alltomatosbr@gmail.com"}],"homepage":"https://izapia.com","bin":{"izapia-mcp":"dist/cli.js"},"dist":{"shasum":"a2a57ce9c3843c1c15ecea5d6ee40c9fa3ccc81e","tarball":"https://registry.npmjs.org/@alltomatos/izapia-mcp/-/izapia-mcp-0.1.0.tgz","fileCount":13,"integrity":"sha512-hjgJiTUZXNkLyz4D3Wp3gnnu3zmY+QpmMuIO2VUpinvvCGpAyG8oTry9JIDxvG2cOQ7q8Rism7CHLaRiSQad3A==","signatures":[{"sig":"MEUCIQC1z9kt0Dg2gRUyAC+g9p4lCCMXYAm7Wl2UBqzFz3DAdgIgIkdh+YUY97FweISu9HHy1sABHz0ucVgEhuXEAvhBojo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":240930},"type":"module","engines":{"node":">=20"},"scripts":{"dev":"tsup --watch","gen":"pnpm gen:spec && pnpm gen:types && pnpm gen:skill","lint":"eslint .","test":"vitest run","build":"tsup","smoke":"node scripts/smoke.mjs","start":"node dist/cli.js","gen:spec":"node scripts/copy-assets.mjs","gen:skill":"node scripts/gen-cheatsheet.mjs","gen:types":"openapi-typescript assets/openapi-public.yaml -o src/izapia/generated/schema.d.ts","typecheck":"tsc --noEmit","install-skill":"node dist/cli.js install-skill"},"_npmUser":{"name":"alltomatos","email":"alltomatosbr@gmail.com"},"repository":{"url":"https://github.com/alltomatos/izapia.git","type":"git","directory":"mcp"},"description":"Servidor MCP para a API WhatsApp da izapia (api.izapia.com) — operar e desenvolver contra a izapia a partir de agentes de IA.","directories":{},"_nodeVersion":"22.23.1","dependencies":{"zod":"^3.23.8","yaml":"^2.5.0","openapi-fetch":"^0.13.0","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.0","eslint":"^9.13.0","vitest":"^2.1.0","globals":"^15.11.0","@eslint/js":"^9.13.0","typescript":"^5.6.0","@types/node":"^22.0.0","typescript-eslint":"^8.10.0","openapi-typescript":"^7.5.0"},"_npmOperationalInternal":{"tmp":"tmp/izapia-mcp_0.1.0_1784818972333_0.4592388684941675","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@alltomatos/izapia-mcp","version":"0.1.1","keywords":["mcp","modelcontextprotocol","whatsapp","izapia","ai-agents"],"license":"MIT","_id":"@alltomatos/izapia-mcp@0.1.1","maintainers":[{"name":"alltomatos","email":"alltomatosbr@gmail.com"}],"homepage":"https://izapia.com","bin":{"izapia-mcp":"dist/cli.js"},"dist":{"shasum":"9060cba5557883751cd28939166168562dd6e447","tarball":"https://registry.npmjs.org/@alltomatos/izapia-mcp/-/izapia-mcp-0.1.1.tgz","fileCount":13,"integrity":"sha512-rMElbZStVHlTF8r1bMP4Vf1pLWtR36qwuEAt7RgYO+r/s4ZsJunHyTvrMrfmP6Xo5MDL4lPLfMy59yAYzWTEuw==","signatures":[{"sig":"MEQCIHlvgY1hTvIYktag4BosAPaJmg/BdzfhBEHqyF9yQuHLAiBc6P6omPN+3DqF77W8AAUcXD6rNx+djEBi560S0cDQTA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":244245},"type":"module","engines":{"node":">=20"},"scripts":{"dev":"tsup --watch","gen":"pnpm gen:spec && pnpm gen:types && pnpm gen:skill","lint":"eslint .","test":"vitest run","build":"tsup","smoke":"node scripts/smoke.mjs","start":"node dist/cli.js","gen:spec":"node scripts/copy-assets.mjs","gen:skill":"node scripts/gen-cheatsheet.mjs","gen:types":"openapi-typescript assets/openapi-public.yaml -o src/izapia/generated/schema.d.ts","typecheck":"tsc --noEmit","install-skill":"node dist/cli.js install-skill"},"_npmUser":{"name":"alltomatos","email":"alltomatosbr@gmail.com"},"repository":{"url":"https://github.com/alltomatos/izapia.git","type":"git","directory":"mcp"},"description":"Servidor MCP para a API WhatsApp da izapia (api.izapia.com) — conecte seu agente de IA pra enviar mensagens, gerenciar sessões/grupos/webhooks e construir integrações WhatsApp.","directories":{},"_nodeVersion":"22.23.1","dependencies":{"zod":"^3.23.8","yaml":"^2.5.0","openapi-fetch":"^0.13.0","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.0","eslint":"^9.13.0","vitest":"^2.1.0","globals":"^15.11.0","@eslint/js":"^9.13.0","typescript":"^5.6.0","@types/node":"^22.0.0","typescript-eslint":"^8.10.0","openapi-typescript":"^7.5.0"},"_npmOperationalInternal":{"tmp":"tmp/izapia-mcp_0.1.1_1784819475204_0.5851845487195522","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@alltomatos/izapia-mcp","version":"0.1.2","keywords":["mcp","modelcontextprotocol","whatsapp","izapia","ai-agents"],"license":"MIT","_id":"@alltomatos/izapia-mcp@0.1.2","maintainers":[{"name":"alltomatos","email":"alltomatosbr@gmail.com"}],"homepage":"https://izapia.com","bin":{"izapia-mcp":"dist/cli.js"},"dist":{"shasum":"c73bd4c916daeb87418a45e29951f40b3891e476","tarball":"https://registry.npmjs.org/@alltomatos/izapia-mcp/-/izapia-mcp-0.1.2.tgz","fileCount":13,"integrity":"sha512-BdNUxzlUcks4QNlOv/Wpx85DacQ/XKMq3TuVKZo3TGxI8O/qu+Cl0mx/rqSHUsqwqQDFirk0cnhb2GCgY9T/Qg==","signatures":[{"sig":"MEYCIQC9hp0bX/x9u00HBz5LO35EXMQCUSLYcw55/zE2WE39vwIhAPGrOiTac0FAADpZvAxRopoNQjhV92bKDekGhUUDrASE","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":244689},"type":"module","engines":{"node":">=20"},"scripts":{"dev":"tsup --watch","gen":"pnpm gen:spec && pnpm gen:types && pnpm gen:skill","lint":"eslint .","test":"vitest run","build":"tsup","smoke":"node scripts/smoke.mjs","start":"node dist/cli.js","gen:spec":"node scripts/copy-assets.mjs","gen:skill":"node scripts/gen-cheatsheet.mjs","gen:types":"openapi-typescript assets/openapi-public.yaml -o src/izapia/generated/schema.d.ts","typecheck":"tsc --noEmit","install-skill":"node dist/cli.js install-skill"},"_npmUser":{"name":"alltomatos","email":"alltomatosbr@gmail.com"},"repository":{"url":"https://github.com/alltomatos/izapia.git","type":"git","directory":"mcp"},"description":"Servidor MCP para a API WhatsApp da izapia (api.izapia.com) — conecte seu agente de IA pra enviar mensagens, gerenciar sessões/grupos/webhooks e construir integrações WhatsApp.","directories":{},"_nodeVersion":"22.23.1","dependencies":{"zod":"^3.23.8","yaml":"^2.5.0","openapi-fetch":"^0.13.0","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.0","eslint":"^9.13.0","vitest":"^2.1.0","globals":"^15.11.0","@eslint/js":"^9.13.0","typescript":"^5.6.0","@types/node":"^22.0.0","typescript-eslint":"^8.10.0","openapi-typescript":"^7.5.0"},"_npmOperationalInternal":{"tmp":"tmp/izapia-mcp_0.1.2_1784894301417_0.3116787471531062","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@alltomatos/izapia-mcp","version":"0.1.3","keywords":["mcp","modelcontextprotocol","whatsapp","izapia","ai-agents"],"license":"MIT","_id":"@alltomatos/izapia-mcp@0.1.3","maintainers":[{"name":"alltomatos","email":"alltomatosbr@gmail.com"}],"homepage":"https://izapia.com","bugs":{"url":"https://github.com/alltomatos/izapia/issues"},"bin":{"izapia-mcp":"dist/cli.js"},"dist":{"shasum":"8a38954e95cce7bbaf21b5d6d4140525587dde86","tarball":"https://registry.npmjs.org/@alltomatos/izapia-mcp/-/izapia-mcp-0.1.3.tgz","fileCount":13,"integrity":"sha512-YGglDofWW8lUml+4vjAfxuzYbS+92ImNM1DnM7QjxEKTiOREzIgJoy8J0BuENSCY5tQQKkjgKY2Foj2w+9ivLA==","signatures":[{"sig":"MEYCIQDzXwAEqal11tSz924V6AqQYehUmx1/P8hSMk3FfkbK4wIhAIlr2K7pyouAL4wRrlrx2UsENJt8371xHqG34Fr/Erot","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":274488},"type":"module","engines":{"node":">=20"},"gitHead":"08cb051e62753b381d9f8efccdea4a89ae51f3c9","scripts":{"dev":"tsup --watch","gen":"pnpm gen:spec && pnpm gen:types && pnpm gen:skill","lint":"eslint .","test":"vitest run","build":"tsup","smoke":"node scripts/smoke.mjs","start":"node dist/cli.js","gen:spec":"node scripts/copy-assets.mjs","gen:skill":"node scripts/gen-cheatsheet.mjs","gen:types":"openapi-typescript assets/openapi-public.yaml -o src/izapia/generated/schema.d.ts","typecheck":"tsc --noEmit","install-skill":"node dist/cli.js install-skill"},"_npmUser":{"name":"alltomatos","email":"alltomatosbr@gmail.com"},"repository":{"url":"git+https://github.com/alltomatos/izapia.git","type":"git","directory":"mcp"},"_npmVersion":"10.9.8","description":"Servidor MCP para a API WhatsApp da izapia (api.izapia.com) — conecte seu agente de IA pra enviar mensagens, gerenciar sessões/grupos/webhooks e construir integrações WhatsApp.","directories":{},"_nodeVersion":"22.22.3","dependencies":{"zod":"^3.23.8","yaml":"^2.5.0","openapi-fetch":"^0.13.0","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.13.0","devDependencies":{"tsup":"^8.3.0","eslint":"^9.13.0","vitest":"^2.1.0","globals":"^15.11.0","@eslint/js":"^9.13.0","typescript":"^5.6.0","@types/node":"^22.0.0","typescript-eslint":"^8.10.0","openapi-typescript":"^7.5.0"},"_npmOperationalInternal":{"tmp":"tmp/izapia-mcp_0.1.3_1785260101445_0.8312616824370902","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@alltomatos/izapia-mcp","version":"0.3.0","description":"Servidor MCP para a API WhatsApp da izapia (api.izapia.com) — conecte seu agente de IA pra enviar mensagens, gerenciar sessões/grupos/webhooks e construir integrações WhatsApp.","type":"module","license":"MIT","packageManager":"pnpm@11.13.0","homepage":"https://izapia.com","repository":{"type":"git","url":"git+https://github.com/alltomatos/izapia.git","directory":"mcp"},"engines":{"node":">=20"},"bin":{"izapia-mcp":"dist/cli.js"},"keywords":["mcp","modelcontextprotocol","whatsapp","izapia","ai-agents"],"scripts":{"gen:spec":"node scripts/copy-assets.mjs","gen:types":"openapi-typescript assets/openapi-public.yaml -o src/izapia/generated/schema.d.ts","gen:skill":"node scripts/gen-cheatsheet.mjs","gen":"pnpm gen:spec && pnpm gen:types && pnpm gen:skill","build":"tsup","dev":"tsup --watch","typecheck":"tsc --noEmit","lint":"eslint .","test":"vitest run","smoke":"node scripts/smoke.mjs","start":"node dist/cli.js","install-skill":"node dist/cli.js install-skill"},"dependencies":{"@modelcontextprotocol/sdk":"^1.12.0","openapi-fetch":"^0.13.0","yaml":"^2.5.0","zod":"^3.23.8"},"devDependencies":{"@eslint/js":"^9.13.0","@types/node":"^22.0.0","eslint":"^9.13.0","globals":"^15.11.0","openapi-typescript":"^7.5.0","tsup":"^8.3.0","typescript":"^5.6.0","typescript-eslint":"^8.10.0","vitest":"^2.1.0"},"_id":"@alltomatos/izapia-mcp@0.3.0","gitHead":"81222a1ce51a330f44068de28c3f914f349d9e9c","bugs":{"url":"https://github.com/alltomatos/izapia/issues"},"_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-oglPCWunyaJnlzeZdlPfg/FKUNjDNKZAQVNwmCvXGBeY1EGfqVlS0kEYQ9G9cigQb3OSQ6uXtE3LHlWMkS/CKA==","shasum":"062f968a7f05901bf5448441f1cffb302069a282","tarball":"https://registry.npmjs.org/@alltomatos/izapia-mcp/-/izapia-mcp-0.3.0.tgz","fileCount":13,"unpackedSize":312399,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIF7gcXomG8H1WNGdkS/8AJAHszhTnEic49IVRwBQxl+CAiAo0IP6qhNSVKnfU4zwrgI/6FNqCnlR/iDbLW/EWe9mKg=="}]},"_npmUser":{"name":"alltomatos","email":"alltomatosbr@gmail.com"},"directories":{},"maintainers":[{"name":"alltomatos","email":"alltomatosbr@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/izapia-mcp_0.3.0_1786557299448_0.42189130954095044"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-23T15:02:52.153Z","modified":"2026-08-12T17:54:59.905Z","0.1.0":"2026-07-23T15:02:52.523Z","0.1.1":"2026-07-23T15:11:15.350Z","0.1.2":"2026-07-24T11:58:21.556Z","0.1.3":"2026-07-28T17:35:01.638Z","0.3.0":"2026-08-12T17:54:59.606Z"},"bugs":{"url":"https://github.com/alltomatos/izapia/issues"},"license":"MIT","homepage":"https://izapia.com","keywords":["mcp","modelcontextprotocol","whatsapp","izapia","ai-agents"],"repository":{"type":"git","url":"git+https://github.com/alltomatos/izapia.git","directory":"mcp"},"description":"Servidor MCP para a API WhatsApp da izapia (api.izapia.com) — conecte seu agente de IA pra enviar mensagens, gerenciar sessões/grupos/webhooks e construir integrações WhatsApp.","maintainers":[{"name":"alltomatos","email":"alltomatosbr@gmail.com"}],"readme":"# @alltomatos/izapia-mcp\n\nServidor **MCP (Model Context Protocol)** para a **izapia**, a API WhatsApp\npara desenvolvedores. Conecte seu agente de IA (Claude Code, Cursor,\nWindsurf, Claude Desktop, …) e ele passa a **enviar mensagens, gerenciar\nsessões/grupos/webhooks e construir integrações WhatsApp** sem sair do chat —\nconsultando o contrato real da API em vez de alucinar endpoints.\n\n## Instalação\n\n```jsonc\n// .mcp.json (ou a config MCP do seu cliente)\n{\n  \"mcpServers\": {\n    \"izapia\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@alltomatos/izapia-mcp\"],\n      \"env\": {\n        \"IZAPIA_API_KEY\": \"izapia_sk_...\"\n      }\n    }\n  }\n}\n```\n\nPegue sua `IZAPIA_API_KEY` no painel da sua conta izapia. Sem ela, as tools\nque chamam a API ao vivo (envio, sessões, grupos, webhooks) ficam\nindisponíveis — as tools de consulta ao contrato (`izapia_search_endpoints`,\n`izapia_get_endpoint`, `izapia_get_events`) funcionam mesmo sem chave.\n\n## O que seu agente ganha\n\n**Modo padrão = leitura.** Por segurança, tools que enviam mensagem, criam\nsessão ou mudam configuração só ficam disponíveis com\n`\"env\": { \"IZAPIA_MCP_MODE\": \"write\" }` — assim seu agente não dispara um\nenvio real sem você habilitar explicitamente.\n\n### Descobrir a API (sem gastar tokens alucinando)\n\n| Tool | Para que serve |\n| --- | --- |\n| `izapia_search_endpoints` | \"Como eu marco uma mensagem como lida?\" — busca no contrato real por palavra-chave/tag e devolve o endpoint certo. |\n| `izapia_get_endpoint` | Schema completo (params, body, resposta) de um endpoint específico — o agente monta a chamada certa de primeira. |\n| `izapia_get_events` | Catálogo de eventos que chegam por webhook/SSE (`message.received`, `call.offer`, …) e o formato exato do payload. |\n| `izapia_verify_webhook_signature` | Valida a assinatura `X-izapia-Signature` de um webhook recebido — útil pra debugar integração de webhook. |\n| `izapia_capabilities` | Mostra o modo atual (read/write) e como habilitar escrita. |\n\n### Operar o WhatsApp (modo `write`)\n\n| Tool | Para que serve |\n| --- | --- |\n| `izapia_create_session` / `izapia_pair_session` | Cria uma conexão e gera o QR code de pareamento. |\n| `izapia_send_text` / `izapia_send_media` | Envia mensagem de texto ou mídia. |\n| `izapia_list_sessions` / `izapia_list_groups` / `izapia_list_contacts` | Consulta sessões, grupos e contatos. |\n| `izapia_create_group` | Cria um grupo com os participantes informados. |\n| `izapia_set_presence` | Define presença (online/digitando/etc.). |\n| `izapia_set_webhook` / `izapia_get_webhook` | Configura pra onde a izapia envia os eventos recebidos. |\n| `izapia_watch_events` | Observa eventos em tempo real por alguns segundos — ótimo pra testar se um webhook está chegando. |\n| `izapia_request` | Chama **qualquer** endpoint da API (todas as ~104 rotas), pra tudo que não tem um atalho dedicado acima. |\n\nToda tool de escrita aceita `dry_run: true` — o agente monta e mostra a\nrequisição exata sem executar, útil pra revisar antes de confirmar.\n\n## Exemplos do que pedir ao seu agente\n\n- *\"Cria uma sessão izapia e me mostra o QR code pra parear meu WhatsApp.\"*\n- *\"Envia 'Pedido confirmado!' pro número 5585999999999.\"*\n- *\"Configura um webhook na minha sessão apontando pra\n  https://meu-app.com/webhook, só pra eventos de mensagem recebida.\"*\n- *\"Observa os próximos eventos por 20 segundos pra eu ver se o webhook tá\n  chegando certo.\"*\n- *\"Qual o schema de resposta do endpoint de criar grupo?\"*\n\n## Configuração (env)\n\n| Env | Default | Descrição |\n| --- | --- | --- |\n| `IZAPIA_API_KEY` | — | Sua chave de API (`izapia_sk_…`). Nunca é logada. |\n| `IZAPIA_MCP_MODE` | `read` | `read` (só consulta) ou `write` (habilita envio/gerenciamento). |\n| `IZAPIA_MCP_ALLOW_DESTRUCTIVE` | `false` | Habilita ações destrutivas (logout, exclusão) via `izapia_request`. |\n| `IZAPIA_MCP_ALLOW` | — | Lista (CSV) de tools permitidas, se você quiser restringir ainda mais. |\n| `IZAPIA_BASE_URL` | `https://api.izapia.com` | Normalmente não precisa mexer. |\n\n## Também vem com uma Agent Skill\n\nO pacote inclui uma [Agent Skill](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills)\ncom o guia completo da API (auth, todos os endpoints por domínio, eventos,\nlimites) pra agentes que preferem ler documentação em vez de chamar tools.\nInstale com:\n\n```bash\nnpx -y @alltomatos/izapia-mcp install-skill\n```\n\n## Saiba mais\n\n- Documentação completa da API: [docs.izapia.com](https://docs.izapia.com)\n- Site: [izapia.com](https://izapia.com)\n\n---\n\n<details>\n<summary>Desenvolvimento e contribuição</summary>\n\n```bash\npnpm install\npnpm gen        # vendora os specs (../docs/{openapi-public.yaml,events-catalog.json}) + gera tipos + cheatsheet da skill\npnpm typecheck\npnpm lint\npnpm test\npnpm build      # gera dist/cli.js (bin: izapia-mcp)\npnpm smoke      # sobe o binário buildado via stdio (end-to-end)\n```\n\n**Sincronia com o contrato (drift):** `docs/openapi.yaml` →\n`docs/openapi-public.yaml` (via `go run ./cmd/openapigen`) e\n`internal/events/events.go` → `docs/events-catalog.json` (via\n`go run ./cmd/eventsgen`) → `mcp/assets/` (via `pnpm gen:spec`) →\n`src/izapia/generated/schema.d.ts` + `skill/izapia-api/references/*.md`\n(via `pnpm gen:types` / `pnpm gen:skill`). Quem editar o OpenAPI ou\n`internal/events` precisa rodar o gerador Go correspondente **e** `pnpm gen`\nneste pacote (`ci-mcp.yml` falha se ficarem desatualizados).\n\n**Publicação:** `.github/workflows/publish-mcp.yml` dispara em tags `mcp-v*`\ne publica com `pnpm publish --access public`, usando o secret `NPM_TOKEN`.\n\n```bash\ngit tag mcp-vX.Y.Z\ngit push origin mcp-vX.Y.Z\n```\n\n**Segurança:** o backend da izapia não aplica escopos por API key hoje — a\nchave tem poder total no tenant. O modo `read`-default e o `dry_run` deste\nservidor são a única salvaguarda no lado do MCP; trate a chave como segredo.\n\n</details>\n","readmeFilename":"README.md"}