@attrkit/mcp 1.3.0 → 1.4.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 1.4.0 (2026-10-21)
+
+### Added
+
+- `create_integration` accepts two optional options for a Meta or TikTok integration:
+  `delivery_scope` (`all` or `attributed`) and `renewal_event` (`purchase` or `custom`). Each is
+  sent only when you give it, so a create without them sends exactly what 1.3.0 sent, and the API
+  applies its defaults, `all` and `purchase`. Existing integrations are unchanged.
+- `update_integration` has a new action, `set_delivery_options`, which sets `delivery_scope`,
+  `renewal_event` or both in any status and leaves the credential and status as they were. The
+  API refuses the action when it names neither option, and refuses `attributed` or `custom` on a
+  Google integration.
+- `list_event_deliveries` names `attributed_only_suppressed` among the reasons it can return: the
+  connection sends only the events of installs attributed to its network, and this install is
+  organic or attributed to another network.
+
 ## 1.3.0 (2026-10-20)
 
 ### Added

package/README.md

@@ -28,6 +28,16 @@ The server provides 39 tools.
 `get_campaign_decision` returns the engine's call verbatim. The model reports it;
 it does not recompute it.
 
+A Meta or TikTok integration has two delivery options. `delivery_scope` is `all`
+(the default: every install with measurement consent, organic ones included) or
+`attributed` (only installs AttriKit attributes to that network: a click ID, a link
+token, or a device match at or above the delivery floor). `renewal_event`
+is `purchase` (the default: a renewal is sent as Purchase) or `custom` (it is
+sent as the custom event `subscription_renewed`, with its value). Set them on
+`create_integration`, or later with `update_integration` and the action
+`set_delivery_options`, which leaves the credential and status as they are. A
+Google integration refuses `attributed` and `custom`.
+
 ## Before you connect
 
 Install Node.js 18 or newer. The `npx -y @attrkit/mcp` command downloads and

package/dist/cli.js

@@ -13730,6 +13730,13 @@ var META_NOT_SERVING_CODES = new Set([
   80014
 ]);
 var META_TOKEN_CODES = new Set([102, 190]);
+var META_ACCESS_CODES = new Set([
+  10,
+  ...Array.from({ length: 100 }, (_, offset) => 200 + offset)
+]);
+var META_ACCESS_SUBCODES = new Map([
+  [100, new Set([33])]
+]);
 // ../shared/src/canonical-events.ts
 var LEDGER_ONLY_CANONICAL_EVENT_NAMES = Object.freeze(["refund_reversed"]);
 // ../shared/src/derived-events.ts
@@ -15075,13 +15082,15 @@ ${body}`
     structuredContent: structured
   }, result.nextCursor);
 }
-var SERVER_VERSION = "1.3.0";
+var SERVER_VERSION = "1.4.0";
 var periodSchema = z5.enum(["7d", "30d", "90d", "all"]).describe("Reporting window. Omit to use the endpoint's documented default.").optional();
 var appIdSchema = z5.string().describe("Optional app id to scope the result to one app.").optional();
 var requiredAppIdSchema = z5.string().min(1).describe("The AttriKit app id.");
 var encodeOpaquePathSegment = (value) => encodeURIComponent(value).replaceAll(".", "%252E");
 var idempotencyKeySchema = z5.string().max(255).describe("Stable retry key for this exact mutation.").optional();
 var ownersSchema = z5.record(z5.string(), z5.enum(["attrkit", "revenuecat", "customer"]));
+var deliveryScopeSchema = z5.enum(["all", "attributed"]).optional().describe("Which events a Meta or TikTok integration sends. all (the API's default): the events of every install with measurement consent, organic ones included. attributed: send only events of installs AttriKit attributes to this connection's network (click ID, link token, or device match at or above the delivery floor); others are suppressed with attributed_only_suppressed. Meta and TikTok only: a Google integration refuses attributed.");
+var renewalEventSchema = z5.enum(["purchase", "custom"]).optional().describe("How a renewal reaches Meta website and TikTok web events. purchase (the API's default): as Purchase with its price and currency. custom: as the custom event subscription_renewed with its price and currency, so Purchase counts one-time purchases only. App events are unchanged. A Google integration refuses custom.");
 var cursorSchema = z5.string().optional().describe("Pass the next_cursor from the previous response to fetch the following page. Omit for the first page.");
 var listLimitSchema = z5.number().int().min(1).max(200).optional().describe("Rows per page, 1-200. The API defaults to 50, so a workspace with more than that needs paging.");
 var calendarDaySchema = z5.string().regex(/^\d{4}-\d{2}-\d{2}$/, "Use a UTC calendar day, YYYY-MM-DD.");
@@ -15436,7 +15445,7 @@ function createServer(config, fetchImpl) {
   server.registerTool("list_event_deliveries", {
     annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
     title: "List what happened to each event sent to ad networks",
-    description: "Return one row per delivery of an event to a network connection, newest first: its state (held, queued, sending, retrying, sent, suppressed or failed), the reason with a one-line explanation (for example consent_suppressed or destination_event_too_old), attempts, the last HTTP status, and for a held row when it is expected to be released. Use it to answer why an event did not reach Meta, TikTok or Google. Read scope is enough.",
+    description: "Return one row per delivery of an event to a network connection, newest first: its state (held, queued, sending, retrying, sent, suppressed or failed), the reason with a one-line explanation (for example consent_suppressed, attributed_only_suppressed or destination_event_too_old), attempts, the last HTTP status, and for a held row when it is expected to be released. Use it to answer why an event did not reach Meta, TikTok or Google. Read scope is enough.",
     inputSchema: {
       app_id: requiredAppIdSchema,
       install_id: z5.string().optional().describe("Only this install: the install epoch id the events feed and the export call the install id."),
@@ -15710,33 +15719,48 @@ function createServer(config, fetchImpl) {
   server.registerTool("create_integration", {
     annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
     title: "Create an ad-network integration",
-    description: "Store encrypted network credentials and choose, for each of the eight event families (install, session, trial, subscription, purchase, refund, paywall, business), which source's copy AttriKit forwards to the network. AttriKit always does the sending; the owner only picks the copy. attrkit = the events your app reports through the AttriKit SDK (the RevenueCat copy of that family is dropped). revenuecat = the events AttriKit received from your RevenueCat webhook (the SDK copy is dropped); RevenueCat itself sends nothing to the network. customer = events your own servers post to AttriKit. If your app reports subscriptions only through RevenueCat, set trial, subscription, purchase and refund to revenuecat, or none of them reach the network.",
+    description: "Store encrypted network credentials and choose, for each of the eight event families (install, session, trial, subscription, purchase, refund, paywall, business), which source's copy AttriKit forwards to the network. AttriKit always does the sending; the owner only picks the copy. attrkit = the events your app reports through the AttriKit SDK (the RevenueCat copy of that family is dropped). revenuecat = the events AttriKit received from your RevenueCat webhook (the SDK copy is dropped); RevenueCat itself sends nothing to the network. customer = events your own servers post to AttriKit. If your app reports subscriptions only through RevenueCat, set trial, subscription, purchase and refund to revenuecat, or none of them reach the network. For Meta and TikTok, delivery_scope and renewal_event are optional; left out, the integration sends every install's events and renewals as Purchase.",
     inputSchema: {
       network: z5.enum(["meta", "google", "tiktok"]),
       account_ref: z5.string().min(1),
       credential: z5.string().min(1),
       owners: ownersSchema.describe("For each event family, whose copy is forwarded: attrkit, revenuecat or customer (see the tool description). Enabling a destination requires ALL eight families to be present, or the API rejects the call."),
       enable: z5.boolean().optional(),
+      delivery_scope: deliveryScopeSchema,
+      renewal_event: renewalEventSchema,
       idempotency_key: idempotencyKeySchema
     }
-  }, async ({ network, account_ref, credential, owners, enable, idempotency_key }) => toToolResult(await call("/api/v1/integrations", {
-    method: "POST",
-    idempotencyKey: idempotency_key,
-    body: { network, account_ref, credential, owners, enable: enable ?? false }
-  })));
+  }, async ({ network, account_ref, credential, owners, enable, delivery_scope, renewal_event, idempotency_key }) => {
+    const body = { network, account_ref, credential, owners, enable: enable ?? false };
+    if (delivery_scope !== undefined)
+      body.delivery_scope = delivery_scope;
+    if (renewal_event !== undefined)
+      body.renewal_event = renewal_event;
+    return toToolResult(await call("/api/v1/integrations", {
+      method: "POST",
+      idempotencyKey: idempotency_key,
+      body
+    }));
+  });
   server.registerTool("update_integration", {
     annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
     title: "Update an ad-network integration",
-    description: "Rotate credentials or enable/disable an integration.",
+    description: "Rotate credentials or enable/disable an integration. set_delivery_options changes delivery_scope, renewal_event or both on a Meta or TikTok integration, in any status, without touching its credential or status; give at least one of the two.",
     inputSchema: {
       connection_id: z5.string(),
-      action: z5.enum(["rotate", "disable", "enable"]),
+      action: z5.enum(["rotate", "disable", "enable", "set_delivery_options"]),
       credential: z5.string().optional(),
       owners: ownersSchema.optional(),
+      delivery_scope: deliveryScopeSchema,
+      renewal_event: renewalEventSchema,
       idempotency_key: idempotencyKeySchema
     }
-  }, async ({ connection_id, action, credential, owners, idempotency_key }) => {
+  }, async ({ connection_id, action, credential, owners, delivery_scope, renewal_event, idempotency_key }) => {
     const body = { action };
+    if (delivery_scope !== undefined)
+      body.delivery_scope = delivery_scope;
+    if (renewal_event !== undefined)
+      body.renewal_event = renewal_event;
     if (credential !== undefined)
       body.credential = credential;
     if (owners)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@attrkit/mcp",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "AttriKit's stdio MCP server for its public Management API",
   "keywords": [
     "attrkit",
@@ -32,7 +32,7 @@
   "scripts": {
     "build": "bun build ./src/cli.ts --outdir ./dist --target=node --format=esm --external @modelcontextprotocol/sdk --external zod",
     "prepack": "bun run build",
-    "typecheck": "../../node_modules/typescript-7/bin/tsc --noEmit",
+    "typecheck": "tsrs --noEmit",
     "lint": "node ../../scripts/checks/code-quality-eslint.mjs --workspace packages/mcp",
     "test": "cd ../.. && vitest run packages/mcp/src"
   },