{"_id":"@daisyintel/whatsapp-cloud-mcp","_rev":"5-565c43de6ce87f40d33b213c584f4865","name":"@daisyintel/whatsapp-cloud-mcp","dist-tags":{"latest":"2.0.2"},"versions":{"0.1.0":{"name":"@daisyintel/whatsapp-cloud-mcp","version":"0.1.0","keywords":["mcp","model-context-protocol","whatsapp","whatsapp-cloud-api","meta"],"license":"MIT","_id":"@daisyintel/whatsapp-cloud-mcp@0.1.0","maintainers":[{"name":"aasrith65","email":"aasrith@citimedia.com"}],"bin":{"whatsapp-cloud-mcp":"dist/src/bin/server.js","whatsapp-cloud-mcp-inspect":"dist/src/bin/inspect.js"},"dist":{"shasum":"4573bb56d41c33327dec20c7fa80d0ddb03bbd91","tarball":"https://registry.npmjs.org/@daisyintel/whatsapp-cloud-mcp/-/whatsapp-cloud-mcp-0.1.0.tgz","fileCount":29,"integrity":"sha512-+yTb0EAblkpVgJ0qiZkq7Yc9901My920v8JFftOwxD6csclABF4sspU8Y8AvUcG911BMOdb1XHENuken+0jrCg==","signatures":[{"sig":"MEUCIGt2s73b6xnxd/R0TOtQJ/OnfhGoJmXdtyiK1XD+JjCdAiEA15h/aH0OpJBycD61kXe3KD/xC1AzbtzTS99hzr5FqJ4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":164892},"type":"module","engines":{"node":">=20.0.0"},"scripts":{"dev":"tsx src/index.ts","test":"tsx --test test/**/*.test.ts","build":"tsc -p tsconfig.json","start":"node dist/src/bin/server.js","inspect":"node dist/src/bin/inspect.js","prepack":"npm run build","inspect:dev":"mcp-inspector tsx src/index.ts"},"_npmUser":{"name":"aasrith65","email":"aasrith@citimedia.com"},"_npmVersion":"11.11.0","description":"MCP server for the WhatsApp Cloud API with webhook support.","directories":{},"_nodeVersion":"24.14.1","dependencies":{"zod":"^3.24.2","dotenv":"^16.4.7","@modelcontextprotocol/sdk":"^1.5.0","@modelcontextprotocol/inspector":"^0.21.1"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.2","typescript":"^5.8.3","@types/node":"^24.0.0"},"_npmOperationalInternal":{"tmp":"tmp/whatsapp-cloud-mcp_0.1.0_1775220225027_0.8996609029674687","host":"s3://npm-registry-packages-npm-production"}},"2.0.0":{"name":"@daisyintel/whatsapp-cloud-mcp","version":"2.0.0","keywords":["mcp","model-context-protocol","whatsapp","whatsapp-cloud-api","meta"],"license":"MIT","_id":"@daisyintel/whatsapp-cloud-mcp@2.0.0","maintainers":[{"name":"aasrith65","email":"aasrith@citimedia.com"}],"bin":{"whatsapp-cloud-mcp":"dist/src/bin/server.js","whatsapp-cloud-mcp-http":"dist/src/bin/http.js","whatsapp-cloud-mcp-inspect":"dist/src/bin/inspect.js"},"dist":{"shasum":"d0031dcb5195fcb3bcbc9d4f2cf17d40eb561a25","tarball":"https://registry.npmjs.org/@daisyintel/whatsapp-cloud-mcp/-/whatsapp-cloud-mcp-2.0.0.tgz","fileCount":33,"integrity":"sha512-ZscGi3CTQhePfwVJ/j64635n6HidhyLdNcB2oXZ47f54fbvh6ncNTJ5VePYdy2oO6Nf6ArqXRTM1rvQiFxdQuQ==","signatures":[{"sig":"MEQCIBiMlOBriu9J1GjsBUL+wHNKEN3Wfw630avRA2hPDt0XAiBzYO8uZrzmk2fxbtegmZ7ftKdV8ONr5x5O81JPi1AKlQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":174172},"type":"module","engines":{"node":">=20.0.0"},"scripts":{"dev":"tsx src/index.ts","test":"tsx --test test/**/*.test.ts","build":"tsc -p tsconfig.json","start":"node dist/src/bin/server.js","inspect":"node dist/src/bin/inspect.js","prepack":"npm run build","dev:http":"tsx src/http.ts","start:http":"node dist/src/bin/http.js","inspect:dev":"mcp-inspector tsx src/index.ts","test:package":"npm run build && node scripts/package-smoke.mjs"},"_npmUser":{"name":"aasrith65","email":"aasrith@citimedia.com"},"deprecated":"README updated in 2.0.1. Please upgrade to @daisyintel/whatsapp-cloud-mcp@2.0.1.","_npmVersion":"11.11.0","description":"MCP server for the WhatsApp Cloud API with webhook support.","directories":{},"_nodeVersion":"24.14.1","dependencies":{"zod":"^3.24.2","dotenv":"^16.4.7","@modelcontextprotocol/sdk":"^1.5.0","@modelcontextprotocol/inspector":"^0.21.1"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.2","typescript":"^5.8.3","@types/node":"^24.0.0"},"_npmOperationalInternal":{"tmp":"tmp/whatsapp-cloud-mcp_2.0.0_1775228053822_0.7231859459373955","host":"s3://npm-registry-packages-npm-production"}},"2.0.1":{"name":"@daisyintel/whatsapp-cloud-mcp","version":"2.0.1","keywords":["mcp","model-context-protocol","whatsapp","whatsapp-cloud-api","meta"],"license":"MIT","_id":"@daisyintel/whatsapp-cloud-mcp@2.0.1","maintainers":[{"name":"aasrith65","email":"aasrith@citimedia.com"}],"bin":{"whatsapp-cloud-mcp":"dist/src/bin/server.js","whatsapp-cloud-mcp-http":"dist/src/bin/http.js","whatsapp-cloud-mcp-inspect":"dist/src/bin/inspect.js"},"dist":{"shasum":"f225615c16f7cf585b3dc7f8cec7c4c532f94e6d","tarball":"https://registry.npmjs.org/@daisyintel/whatsapp-cloud-mcp/-/whatsapp-cloud-mcp-2.0.1.tgz","fileCount":33,"integrity":"sha512-1C9t/l6oMAtFmSep/oRLqNSWjk7mJn5rstYnEZpxAg57X8Ee1mDgBJZxOed4oXaP7K2zqSI/5SZ5HczIbkX/5w==","signatures":[{"sig":"MEYCIQCZP7MZz67foW+c16ToHcr8XAin/jf2CvmAIhY4n3/hvwIhAMNxWocgtbfyxDQJw1etLR3ylornEcVUhZpJau4Mz9Q4","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":175188},"type":"module","engines":{"node":">=20.0.0"},"scripts":{"dev":"tsx src/index.ts","test":"tsx --test test/**/*.test.ts","build":"tsc -p tsconfig.json","start":"node dist/src/bin/server.js","inspect":"node dist/src/bin/inspect.js","prepack":"npm run build","dev:http":"tsx src/http.ts","start:http":"node dist/src/bin/http.js","inspect:dev":"mcp-inspector tsx src/index.ts","test:package":"npm run build && node scripts/package-smoke.mjs"},"_npmUser":{"name":"aasrith65","email":"aasrith@citimedia.com"},"_npmVersion":"11.11.0","description":"MCP server for the WhatsApp Cloud API with webhook support.","directories":{},"_nodeVersion":"24.14.1","dependencies":{"zod":"^3.24.2","dotenv":"^16.4.7","@modelcontextprotocol/sdk":"^1.5.0","@modelcontextprotocol/inspector":"^0.21.1"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.2","typescript":"^5.8.3","@types/node":"^24.0.0"},"_npmOperationalInternal":{"tmp":"tmp/whatsapp-cloud-mcp_2.0.1_1775228259759_0.6032510390133852","host":"s3://npm-registry-packages-npm-production"}},"2.0.2":{"name":"@daisyintel/whatsapp-cloud-mcp","version":"2.0.2","type":"module","description":"MCP server for the WhatsApp Cloud API with webhook support.","license":"MIT","keywords":["mcp","model-context-protocol","whatsapp","whatsapp-cloud-api","meta"],"bin":{"whatsapp-cloud-mcp":"dist/src/bin/server.js","whatsapp-cloud-mcp-http":"dist/src/bin/http.js","whatsapp-cloud-mcp-inspect":"dist/src/bin/inspect.js"},"scripts":{"build":"tsc -p tsconfig.json","prepack":"npm run build","start":"node dist/src/bin/server.js","start:http":"node dist/src/bin/http.js","dev":"tsx src/index.ts","dev:http":"tsx src/http.ts","test":"tsx --test test/**/*.test.ts","test:package":"npm run build && node scripts/package-smoke.mjs","inspect":"node dist/src/bin/inspect.js","inspect:dev":"mcp-inspector tsx src/index.ts"},"engines":{"node":">=20.0.0"},"dependencies":{"@modelcontextprotocol/inspector":"^0.21.1","@modelcontextprotocol/sdk":"^1.5.0","dotenv":"^16.4.7","zod":"^3.24.2"},"devDependencies":{"@types/node":"^24.0.0","tsx":"^4.19.2","typescript":"^5.8.3"},"_id":"@daisyintel/whatsapp-cloud-mcp@2.0.2","_nodeVersion":"24.14.1","_npmVersion":"11.11.0","dist":{"integrity":"sha512-hR683EVUJfB7t7I/WxHVxkcdJ/Npq+OzFKUVSPLCxI91rVgdR345l58pB4cPcvIm1VJFffPTQKAhJCLKgtT+yQ==","shasum":"878bdb3935ddc4ed1afd14b6f0e2ba5f23f100d4","tarball":"https://registry.npmjs.org/@daisyintel/whatsapp-cloud-mcp/-/whatsapp-cloud-mcp-2.0.2.tgz","fileCount":33,"unpackedSize":175462,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCKhncKMSMQkxtZfSl37u9UvHCtDBGPI1+51iZvQgJ8rQIgdpjSn6zTf3FyAjQSxs7lHmG84boha04ZWwHyqZ/1Fdo="}]},"_npmUser":{"name":"aasrith65","email":"aasrith@citimedia.com"},"directories":{},"maintainers":[{"name":"aasrith65","email":"aasrith@citimedia.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/whatsapp-cloud-mcp_2.0.2_1775461167177_0.9281374787816934"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-03T12:43:44.897Z","modified":"2026-04-06T07:39:27.451Z","0.1.0":"2026-04-03T12:43:45.166Z","2.0.0":"2026-04-03T14:54:13.963Z","2.0.1":"2026-04-03T14:57:39.916Z","2.0.2":"2026-04-06T07:39:27.325Z"},"license":"MIT","keywords":["mcp","model-context-protocol","whatsapp","whatsapp-cloud-api","meta"],"description":"MCP server for the WhatsApp Cloud API with webhook support.","maintainers":[{"name":"aasrith65","email":"aasrith@citimedia.com"}],"readme":"# WhatsApp Cloud API MCP Server\n\nTypeScript MCP server for Meta's WhatsApp Cloud API.\n\nIt can run as a local `stdio` MCP server, or as a hosted server with `streamable-http`, `sse`, and webhook endpoints. Each running process uses one WhatsApp account context from the environment variables provided at startup.\n\n## Quick Start\n\n### Standard MCP Client Config\n\nThis is the main usage model for Claude, Cursor, Inspector, and package importers that launch MCP servers over `stdio`.\n\n```json\n{\n  \"mcpServers\": {\n    \"whatsapp-cloud\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@daisyintel/whatsapp-cloud-mcp\"],\n      \"env\": {\n        \"WHATSAPP_ACCESS_TOKEN\": \"replace-me\",\n        \"WHATSAPP_API_VERSION\": \"v23.0\",\n        \"WHATSAPP_BUSINESS_ID\": \"\",\n        \"WHATSAPP_WABA_ID\": \"\",\n        \"WHATSAPP_PHONE_NUMBER_ID\": \"\",\n        \"WHATSAPP_VERIFY_TOKEN\": \"\",\n        \"META_APP_SECRET\": \"\"\n      }\n    }\n  }\n}\n```\n\nHow it works:\n\n- the MCP client launches the package with `npx`\n- the server reads the `WHATSAPP_*` values from `env`\n- all tool calls in that process use that one configured WhatsApp account\n\n### Import From npm Package UI\n\nFor platforms with fields such as `Package Name`, `Command`, `Command Args`, and `Environment Variables`, use:\n\n- `Package Name`: `@daisyintel/whatsapp-cloud-mcp`\n- `Command`: `npx`\n- `Command Args`: `-y @daisyintel/whatsapp-cloud-mcp`\n\nIf the platform has trouble with scoped npm packages, use the unscoped alias package:\n\n- `Package Name`: `whatsapp-cloud-mcp`\n- `Command`: `npx`\n- `Command Args`: `-y whatsapp-cloud-mcp`\n\n### Minimum Environment\n\n```json\n{\n  \"WHATSAPP_ACCESS_TOKEN\": \"replace-me\"\n}\n```\n\nUseful defaults for real usage:\n\n```json\n{\n  \"WHATSAPP_ACCESS_TOKEN\": \"replace-me\",\n  \"WHATSAPP_API_VERSION\": \"v23.0\",\n  \"WHATSAPP_BUSINESS_ID\": \"your_business_id\",\n  \"WHATSAPP_WABA_ID\": \"your_waba_id\",\n  \"WHATSAPP_PHONE_NUMBER_ID\": \"your_phone_number_id\",\n  \"WHATSAPP_VERIFY_TOKEN\": \"your_verify_token\",\n  \"META_APP_SECRET\": \"your_app_secret\"\n}\n```\n\n## Hosted Server Mode\n\nIf you want to expose MCP over HTTP/SSE and receive WhatsApp webhooks, run the hosted entrypoint:\n\n```powershell\n$env:WHATSAPP_ACCESS_TOKEN=\"EAAG...\"\n$env:WHATSAPP_API_VERSION=\"v23.0\"\n$env:WHATSAPP_WABA_ID=\"123456789\"\n$env:WHATSAPP_PHONE_NUMBER_ID=\"987654321\"\n$env:WHATSAPP_VERIFY_TOKEN=\"my-verify-token\"\n$env:META_APP_SECRET=\"my-app-secret\"\n$env:PORT=\"3000\"\n$env:WHATSAPP_MAX_WEBHOOK_EVENTS=\"100\"\n$env:WHATSAPP_ALLOW_UNSIGNED_WEBHOOKS=\"false\"\n\nnpx --yes --package @daisyintel/whatsapp-cloud-mcp whatsapp-cloud-mcp-http\n```\n\nHosted endpoints:\n\n- `GET /health`\n- `POST /mcp`\n- `GET /sse`\n- `POST /messages?sessionId=...`\n- `GET /webhook`\n- `POST /webhook`\n\n## Environment Variables\n\n### Account Configuration\n\n| Variable | Required | Description |\n| --- | --- | --- |\n| `WHATSAPP_ACCESS_TOKEN` | Yes | Meta access token used for all WhatsApp API calls in the running process. |\n| `WHATSAPP_API_VERSION` | No | Graph API version. Defaults to `v23.0`. |\n| `WHATSAPP_BUSINESS_ID` | No | Default business ID for business-scoped operations. |\n| `WHATSAPP_WABA_ID` | No | Default WhatsApp Business Account ID. |\n| `WHATSAPP_PHONE_NUMBER_ID` | No | Default phone number ID used by message and phone-number operations. |\n| `WHATSAPP_VERIFY_TOKEN` | No | Verify token used for webhook verification. |\n| `META_APP_SECRET` | No | App secret used to validate webhook signatures. |\n\n### Hosted Server Configuration\n\n| Variable | Required | Description |\n| --- | --- | --- |\n| `PORT` | No | HTTP port for hosted mode. Defaults to `3000`. |\n| `WHATSAPP_MAX_WEBHOOK_EVENTS` | No | Number of recent webhook events kept in memory. |\n| `WHATSAPP_ALLOW_UNSIGNED_WEBHOOKS` | No | Allows unsigned webhook payloads for local development only. |\n\n## Deployment Model\n\nThis package is account-scoped by process.\n\n- one running process = one WhatsApp account context\n- one MCP server config = one set of WhatsApp credentials\n- per-call ID overrides still use the same underlying access token\n\nIf you need to serve multiple downstream clients with different Meta credentials, run multiple isolated instances and start each one with that client's own environment variables.\n\n## CLI Commands\n\nPublished binaries:\n\n- `whatsapp-cloud-mcp`\n- `whatsapp-cloud-mcp-http`\n- `whatsapp-cloud-mcp-inspect`\n\nExamples:\n\n```powershell\nnpx -y @daisyintel/whatsapp-cloud-mcp\nnpx --yes --package @daisyintel/whatsapp-cloud-mcp whatsapp-cloud-mcp-http\nnpx --yes --package @daisyintel/whatsapp-cloud-mcp whatsapp-cloud-mcp-inspect\n```\n\n## Local Development\n\n```powershell\nnpm install\nnpm run build\nnpm test\nnpm run test:package\nnpm run dev\nnpm run dev:http\nnpm run inspect:dev\n```\n\n## MCP Inspector\n\nInspect the published `stdio` package from a clean folder:\n\n```powershell\nnpx @modelcontextprotocol/inspector --config .\\mcp.json --server whatsapp-cloud\n```\n\nInspect the hosted server:\n\n1. Start it with `npm run dev:http`.\n2. Open MCP Inspector.\n3. Use `http://127.0.0.1:3000/mcp` for `streamable-http`.\n4. Use `http://127.0.0.1:3000/sse` for `sse`.\n","readmeFilename":"README.md"}