mcp-meta-ads-incrementality 0.2.3 → 0.3.0

package/dist/writeGate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeGate.d.ts","sourceRoot":"","sources":["../src/writeGate.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,MAAM,CAkB1C,CAAC;AAOH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAE5E;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EACpD,QAAQ,EAAE,SAAS,CAAC,EAAE,EACtB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,CAAC,EAAE,CAEL;AAED,eAAO,MAAM,sBAAsB,QAEgD,CAAC;AAEpF;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,IAAI,CAQN"}

package/dist/writeGate.js

@@ -0,0 +1,60 @@
+import { createWriteGate } from 'mcp-write-gate';
+/**
+ * Tools that mutate Meta Ads state. These are hidden from the tool list and
+ * refused at call time unless META_ADS_MCP_WRITE=true.
+ *
+ * The env prefix is deliberately META_ADS — shared with the Python meta-ads
+ * MCP server — so one flag means "Meta writes allowed this session" across
+ * both servers.
+ *
+ * Adding a new tool? Put it in this set if it creates, updates, deletes,
+ * uploads, swaps, rebinds, edits, or renames anything. The shape test in
+ * writeGate.test.ts enforces this by name pattern.
+ */
+export const WRITE_TOOLS = new Set([
+    'meta_ads_update_ad_url_tags',
+    'meta_ads_rename_ad',
+    'meta_ads_swap_ad_lead_form',
+    'meta_ads_rebind_ad_creative',
+    'meta_ads_edit_creative_text',
+    'meta_ads_create_campaign',
+    'meta_ads_create_adset',
+    'meta_ads_create_ad_creative',
+    'meta_ads_create_ad',
+    'meta_ads_upload_image',
+    'meta_ads_create_leadgen_form',
+    'meta_ads_create_custom_audience',
+    'meta_ads_upload_users_to_audience',
+    'meta_ads_create_lookalike_audience',
+    'meta_ads_update_object_status',
+    'meta_ads_update_budget',
+    'meta_ads_delete_object',
+]);
+const gate = createWriteGate({
+    writeTools: WRITE_TOOLS,
+    envPrefix: 'META_ADS',
+});
+export function isWriteTool(name) {
+    return gate.isWriteTool(name);
+}
+export function isWriteEnabled(env = process.env) {
+    return gate.isWriteEnabled(env);
+}
+export function filterTools(allTools, env = process.env) {
+    return gate.filterTools(allTools, env);
+}
+export const WRITE_DISABLED_MESSAGE = 'Write operations are disabled. Set META_ADS_MCP_WRITE=true in the MCP server environment ' +
+    'to enable mutating tools (create/update/delete/upload/swap/rebind/edit/rename).';
+/**
+ * Assert that a tool call is allowed under the current write-mode setting.
+ * Throws a clear Error if the tool mutates state and writes are disabled.
+ */
+export function assertWriteAllowed(toolName, env = process.env) {
+    try {
+        gate.assertWriteAllowed(toolName, env);
+    }
+    catch {
+        throw new Error(`Tool "${toolName}" is a write operation. ${WRITE_DISABLED_MESSAGE}`);
+    }
+}
+//# sourceMappingURL=writeGate.js.map

package/dist/writeGate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeGate.js","sourceRoot":"","sources":["../src/writeGate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,WAAW,GAAwB,IAAI,GAAG,CAAC;IACtD,6BAA6B;IAC7B,oBAAoB;IACpB,4BAA4B;IAC5B,6BAA6B;IAC7B,6BAA6B;IAC7B,0BAA0B;IAC1B,uBAAuB;IACvB,6BAA6B;IAC7B,oBAAoB;IACpB,uBAAuB;IACvB,8BAA8B;IAC9B,iCAAiC;IACjC,mCAAmC;IACnC,oCAAoC;IACpC,+BAA+B;IAC/B,wBAAwB;IACxB,wBAAwB;CACzB,CAAC,CAAC;AAEH,MAAM,IAAI,GAAG,eAAe,CAAC;IAC3B,UAAU,EAAE,WAAW;IACvB,SAAS,EAAE,UAAU;CACtB,CAAC,CAAC;AAEH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAyB,OAAO,CAAC,GAAG;IACjE,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,QAAsB,EACtB,MAAyB,OAAO,CAAC,GAAG;IAEpC,OAAO,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,CAAC,MAAM,sBAAsB,GACjC,2FAA2F;IAC3F,iFAAiF,CAAC;AAEpF;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAgB,EAChB,MAAyB,OAAO,CAAC,GAAG;IAEpC,IAAI,CAAC;QACH,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,SAAS,QAAQ,2BAA2B,sBAAsB,EAAE,CACrE,CAAC;IACJ,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-meta-ads-incrementality",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "description": "MCP server for Meta Marketing API focused on incrementality reporting. Surfaces Meta's incremental conversion attribution alongside default 7d-click/1d-view and dda windows so agencies can see the gap between reported and incremental performance.",
   "main": "dist/index.js",
   "bin": {
@@ -17,8 +17,9 @@
     "build": "tsc",
     "start": "node dist/index.js",
     "dev": "tsx src/index.ts",
-    "test": "vitest run",
+    "test": "vitest run && npm run test:shell",
     "test:watch": "vitest",
+    "test:shell": "bash tests/run-mcp-keychain.test.sh",
     "smoke": "scripts/healthcheck.sh"
   },
   "keywords": [
@@ -41,6 +42,7 @@
     "@modelcontextprotocol/sdk": "^0.5.0",
     "env-paths": "^3.0.0",
     "facebook-nodejs-business-sdk": "^24.0.1",
+    "mcp-write-gate": "^1.0.0",
     "open": "^10.0.0",
     "zod": "^3.22.4"
   },