@daisyintel/whatsapp-cloud-mcp 0.1.0

package/dist/test/webhook.test.js

@@ -0,0 +1,154 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import { createHmac } from "node:crypto";
+import { InMemoryWebhookEventStore } from "../src/eventStore.js";
+import { loadConfig } from "../src/config.js";
+import { handleWebhookRequest, normalizeWebhookEvents } from "../src/webhook.js";
+function createMockRequest(options = {
+    method: "GET",
+    url: "/"
+}) {
+    const body = options.body ?? "";
+    const chunks = body ? [Buffer.from(body)] : [];
+    return {
+        method: options.method,
+        url: options.url,
+        headers: options.headers ?? {},
+        async *[Symbol.asyncIterator]() {
+            for (const chunk of chunks) {
+                yield chunk;
+            }
+        }
+    };
+}
+function createMockResponse() {
+    let body = "";
+    const headers = new Map();
+    return {
+        statusCode: 200,
+        setHeader(name, value) {
+            headers.set(name.toLowerCase(), value);
+        },
+        end(chunk) {
+            body = chunk ?? "";
+        },
+        getBody() {
+            return body;
+        },
+        getHeader(name) {
+            return headers.get(name.toLowerCase());
+        }
+    };
+}
+test("normalizeWebhookEvents extracts messages and statuses", () => {
+    const events = normalizeWebhookEvents({
+        entry: [
+            {
+                id: "waba-1",
+                changes: [
+                    {
+                        value: {
+                            metadata: {
+                                phone_number_id: "phone-1"
+                            },
+                            messages: [
+                                {
+                                    id: "message-1",
+                                    from: "15550000000",
+                                    type: "text"
+                                }
+                            ],
+                            statuses: [
+                                {
+                                    id: "message-2",
+                                    recipient_id: "15559999999",
+                                    status: "delivered"
+                                }
+                            ]
+                        }
+                    }
+                ]
+            }
+        ]
+    });
+    assert.equal(events.length, 2);
+    assert.equal(events[0]?.kind, "inbound_message");
+    assert.equal(events[1]?.kind, "message_status");
+});
+test("webhook verification succeeds with matching verify token", async () => {
+    const config = loadConfig({
+        WHATSAPP_ACCESS_TOKEN: "token",
+        WHATSAPP_VERIFY_TOKEN: "verify"
+    });
+    const request = createMockRequest({
+        method: "GET",
+        url: "/webhook?hub.mode=subscribe&hub.verify_token=verify&hub.challenge=challenge"
+    });
+    const response = createMockResponse();
+    await handleWebhookRequest(request, response, config, new InMemoryWebhookEventStore(10));
+    assert.equal(response.statusCode, 200);
+    assert.equal(response.getBody(), "challenge");
+});
+test("webhook post validates signed payloads", async () => {
+    const config = loadConfig({
+        WHATSAPP_ACCESS_TOKEN: "token",
+        META_APP_SECRET: "secret"
+    });
+    const payload = JSON.stringify({
+        entry: [
+            {
+                id: "waba-1",
+                changes: [
+                    {
+                        value: {
+                            metadata: {
+                                phone_number_id: "phone-1"
+                            },
+                            messages: [
+                                {
+                                    id: "message-1",
+                                    from: "15550000000",
+                                    type: "text"
+                                }
+                            ]
+                        }
+                    }
+                ]
+            }
+        ]
+    });
+    const signature = createHmac("sha256", "secret").update(payload).digest("hex");
+    const request = createMockRequest({
+        method: "POST",
+        url: "/webhook",
+        body: payload,
+        headers: {
+            host: "localhost",
+            "x-hub-signature-256": `sha256=${signature}`
+        }
+    });
+    const response = createMockResponse();
+    const store = new InMemoryWebhookEventStore(10);
+    await handleWebhookRequest(request, response, config, store);
+    assert.equal(response.statusCode, 200);
+    assert.equal(store.list(10).length, 1);
+});
+test("webhook post can allow unsigned payloads in dev mode", async () => {
+    const config = loadConfig({
+        WHATSAPP_ACCESS_TOKEN: "token",
+        WHATSAPP_ALLOW_UNSIGNED_WEBHOOKS: "true"
+    });
+    const request = createMockRequest({
+        method: "POST",
+        url: "/webhook",
+        body: JSON.stringify({ entry: [] }),
+        headers: {
+            host: "localhost"
+        }
+    });
+    const response = createMockResponse();
+    await handleWebhookRequest(request, response, config, new InMemoryWebhookEventStore(10));
+    assert.equal(response.statusCode, 200);
+    assert.equal(JSON.parse(response.getBody()).received_events, 0);
+});
+//# sourceMappingURL=webhook.test.js.map

package/dist/test/webhook.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.test.js","sourceRoot":"","sources":["../../test/webhook.test.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAEjF,SAAS,iBAAiB,CACxB,UAKI;IACF,MAAM,EAAE,KAAK;IACb,GAAG,EAAE,GAAG;CACT;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE/C,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;QAC9B,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC;YAC3B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB;IACzB,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE1C,OAAO;QACL,UAAU,EAAE,GAAG;QACf,SAAS,CAAC,IAAY,EAAE,KAAa;YACnC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,KAAK,CAAC,CAAC;QACzC,CAAC;QACD,GAAG,CAAC,KAAc;YAChB,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACrB,CAAC;QACD,OAAO;YACL,OAAO,IAAI,CAAC;QACd,CAAC;QACD,SAAS,CAAC,IAAY;YACpB,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACzC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,IAAI,CAAC,uDAAuD,EAAE,GAAG,EAAE;IACjE,MAAM,MAAM,GAAG,sBAAsB,CAAC;QACpC,KAAK,EAAE;YACL;gBACE,EAAE,EAAE,QAAQ;gBACZ,OAAO,EAAE;oBACP;wBACE,KAAK,EAAE;4BACL,QAAQ,EAAE;gCACR,eAAe,EAAE,SAAS;6BAC3B;4BACD,QAAQ,EAAE;gCACR;oCACE,EAAE,EAAE,WAAW;oCACf,IAAI,EAAE,aAAa;oCACnB,IAAI,EAAE,MAAM;iCACb;6BACF;4BACD,QAAQ,EAAE;gCACR;oCACE,EAAE,EAAE,WAAW;oCACf,YAAY,EAAE,aAAa;oCAC3B,MAAM,EAAE,WAAW;iCACpB;6BACF;yBACF;qBACF;iBACF;aACF;SACF;KACF,CAAC,CAAC;IAEH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC/B,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC;IACjD,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC;AAClD,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;IAC1E,MAAM,MAAM,GAAG,UAAU,CAAC;QACxB,qBAAqB,EAAE,OAAO;QAC9B,qBAAqB,EAAE,QAAQ;KAChC,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,iBAAiB,CAAC;QAChC,MAAM,EAAE,KAAK;QACb,GAAG,EAAE,6EAA6E;KACnF,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAC;IAEtC,MAAM,oBAAoB,CAAC,OAAgB,EAAE,QAAiB,EAAE,MAAM,EAAE,IAAI,yBAAyB,CAAC,EAAE,CAAC,CAAC,CAAC;IAE3G,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IACvC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,WAAW,CAAC,CAAC;AAChD,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;IACxD,MAAM,MAAM,GAAG,UAAU,CAAC;QACxB,qBAAqB,EAAE,OAAO;QAC9B,eAAe,EAAE,QAAQ;KAC1B,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC;QAC7B,KAAK,EAAE;YACL;gBACE,EAAE,EAAE,QAAQ;gBACZ,OAAO,EAAE;oBACP;wBACE,KAAK,EAAE;4BACL,QAAQ,EAAE;gCACR,eAAe,EAAE,SAAS;6BAC3B;4BACD,QAAQ,EAAE;gCACR;oCACE,EAAE,EAAE,WAAW;oCACf,IAAI,EAAE,aAAa;oCACnB,IAAI,EAAE,MAAM;iCACb;6BACF;yBACF;qBACF;iBACF;aACF;SACF;KACF,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/E,MAAM,OAAO,GAAG,iBAAiB,CAAC;QAChC,MAAM,EAAE,MAAM;QACd,GAAG,EAAE,UAAU;QACf,IAAI,EAAE,OAAO;QACb,OAAO,EAAE;YACP,IAAI,EAAE,WAAW;YACjB,qBAAqB,EAAE,UAAU,SAAS,EAAE;SAC7C;KACF,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAC;IACtC,MAAM,KAAK,GAAG,IAAI,yBAAyB,CAAC,EAAE,CAAC,CAAC;IAEhD,MAAM,oBAAoB,CAAC,OAAgB,EAAE,QAAiB,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAE/E,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IACvC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;AACzC,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;IACtE,MAAM,MAAM,GAAG,UAAU,CAAC;QACxB,qBAAqB,EAAE,OAAO;QAC9B,gCAAgC,EAAE,MAAM;KACzC,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,iBAAiB,CAAC;QAChC,MAAM,EAAE,MAAM;QACd,GAAG,EAAE,UAAU;QACf,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QACnC,OAAO,EAAE;YACP,IAAI,EAAE,WAAW;SAClB;KACF,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAC;IAEtC,MAAM,oBAAoB,CAAC,OAAgB,EAAE,QAAiB,EAAE,MAAM,EAAE,IAAI,yBAAyB,CAAC,EAAE,CAAC,CAAC,CAAC;IAE3G,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IACvC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;AAClE,CAAC,CAAC,CAAC"}

package/mcp.json.example

@@ -0,0 +1,19 @@
+{
+  "mcpServers": {
+    "whatsapp-cloud-api": {
+      "command": "node",
+      "args": ["dist/index.js"],
+      "env": {
+        "WHATSAPP_ACCESS_TOKEN": "replace-me",
+        "WHATSAPP_API_VERSION": "v23.0",
+        "WHATSAPP_BUSINESS_ID": "",
+        "WHATSAPP_WABA_ID": "",
+        "WHATSAPP_PHONE_NUMBER_ID": "",
+        "WHATSAPP_VERIFY_TOKEN": "replace-me",
+        "META_APP_SECRET": "",
+        "PORT": "3000",
+        "WHATSAPP_ALLOW_UNSIGNED_WEBHOOKS": "false"
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@daisyintel/whatsapp-cloud-mcp",
+  "version": "0.1.0",
+  "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-inspect": "dist/src/bin/inspect.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "mcp.json.example"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepack": "npm run build",
+    "start": "node dist/src/bin/server.js",
+    "dev": "tsx src/index.ts",
+    "test": "tsx --test test/**/*.test.ts",
+    "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"
+  }
+}