@cookiemunch/mcp 0.3.0 → 0.4.1

package/dist/index.cjs

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
+  MCP_VERSION: () => MCP_VERSION,
   createCookieMunchMcp: () => createCookieMunchMcp,
   registerTools: () => registerTools
 });
@@ -28,7 +29,7 @@ var import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
 var import_sdk = require("@cookiemunch/sdk");
 
 // src/tools.ts
-var import_zod4 = require("zod");
+var import_zod5 = require("zod");
 
 // src/tools-config.ts
 var import_zod = require("zod");
@@ -115,7 +116,7 @@ function registerConfigTools(tool, client) {
   const setLanguagesSchema = import_zod.z.object({
     cbid: import_zod.z.string().describe("Site identifier (cbid)."),
     defaultCulture: import_zod.z.string().optional().describe('Default locale/culture code, e.g. "en", "fr". Stored in i18n.defaultCulture.'),
-    autoDetect: import_zod.z.boolean().optional().describe("Auto-detect visitor language from browser locale. Stored in i18n.autoDetect."),
+    autoDetect: import_zod.z.union([import_zod.z.boolean(), import_zod.z.literal("page")]).optional().describe(`true: follow the visitor's browser language; false: defaultCulture for everyone; "page": follow the page's <html lang>, then the browser. Stored in i18n.autoDetect.`),
     translations: import_zod.z.record(import_zod.z.record(import_zod.z.unknown())).optional().describe("Per-locale banner copy overrides. Merged onto banner.i18n (locale keys preserved)."),
     overrides: import_zod.z.record(import_zod.z.object({ banner: import_zod.z.record(import_zod.z.string()).optional(), categories: import_zod.z.record(import_zod.z.object({ label: import_zod.z.string().optional(), description: import_zod.z.string().optional() })).optional() })).optional().describe("The site's own copy per language, keyed by tag (de, pt-BR): { banner: { title, body, \u2026 }, categories: { <id>: { label, description } } }. Each language given replaces its entry in i18n.overrides; other languages are kept. Strings the site wrote are shown as written in any language without an override \u2014 stock translations never replace them.")
   });
@@ -563,12 +564,16 @@ function registerPlatformTools(tool, client) {
     "connect_dsar_executor",
     "Connect a system that runs part of a rights request \u2014 an identity platform, a CRM, anything with a rights API. Cookie Munch is not specific to any platform: the `profile` describes that system's API (paths, the words it uses for export/erase, its status vocabulary, how it signs webhooks), so connecting a new one needs no code. The secret key is stored encrypted and never returned; the response carries the webhook URL to configure in that system. Sub-tasks open automatically once a request reaches fulfilment (after identity verification), and completions are picked up by webhook or by polling.",
     {
-      system: import_zod2.z.string().describe("The name this connection answers to in a plan, e.g. identity or crm."),
-      baseUrl: import_zod2.z.string().describe("The system's public https origin."),
+      preset: import_zod2.z.string().optional().describe("Build profile (and, unless the preset takes baseUrl as a param, baseUrl) from a versioned preset instead of sending profile. list_dsar_executor_presets names them, what each needs, and which wait on another platform."),
+      presetVersion: import_zod2.z.number().int().optional().describe("With preset: the version to build. Default the latest."),
+      orgId: import_zod2.z.string().optional().describe("A preset param, when the preset's params list it."),
+      atlasIdAppId: import_zod2.z.string().optional().describe("A preset param, when the preset's params list it: the identity platform's app id, so an erasure also revokes the app's grant."),
+      system: import_zod2.z.string().optional().describe("The name this connection answers to in a plan, e.g. identity or crm. Required unless the preset has a default."),
+      baseUrl: import_zod2.z.string().optional().describe("The system's public https origin. Required unless the preset sets it."),
       secretKey: import_zod2.z.string().describe("Its API key, with whatever scope that system needs to export and erase a user."),
       webhookSecret: import_zod2.z.string().optional().describe("Signing secret of its webhook endpoint. Optional: polling closes tasks without it."),
       auto: import_zod2.z.boolean().optional().describe("Open a sub-task automatically when a request reaches fulfilment. Default true."),
-      profile: import_zod2.z.record(import_zod2.z.unknown()).describe("How to drive that system: { open, poll, statuses } required, plus optional subjectLookup, auth, idempotencyHeader and webhook. See the connected-systems docs for the shape."),
+      profile: import_zod2.z.record(import_zod2.z.unknown()).optional().describe("How to drive that system: { open, poll, statuses } required, plus optional subjectLookup, auth, idempotencyHeader, grantRevoke and webhook. Omit it when using preset."),
       dryRun: import_zod2.z.boolean().optional().describe("Validate everything and answer the connection that would be created, storing nothing.")
     },
     (a) => {
@@ -576,6 +581,28 @@ function registerPlatformTools(tool, client) {
       return dryRun === true ? client.fulfillment.dryRunConnectExecutor(input) : client.fulfillment.connectExecutor(input);
     }
   );
+  tool(
+    "list_dsar_executor_presets",
+    "The versioned executor presets: each one's name, params, latest version, and whether it is usable now or waits on another platform's API (waitingOn names the platform and its spec items). Also this org's canary address for connection tests. Read-only.",
+    {},
+    () => client.fulfillment.executorPresets()
+  );
+  tool(
+    "upgrade_dsar_executor_preset",
+    "Rebuild a connection's profile and address from its preset's latest version (or presetVersion), keeping its id, credentials, system and scope \u2014 or adopt a preset on a hand-written connection by naming it. Answers with a diff. Use dryRun first: the answer shows exactly what would change and nothing is stored.",
+    {
+      id: import_zod2.z.string().describe("The connection id."),
+      preset: import_zod2.z.string().optional().describe("Only to adopt a preset on a connection that has none."),
+      presetVersion: import_zod2.z.number().int().optional(),
+      orgId: import_zod2.z.string().optional(),
+      atlasIdAppId: import_zod2.z.string().optional(),
+      dryRun: import_zod2.z.boolean().optional().describe("Answer the diff and change nothing.")
+    },
+    (a) => {
+      const { id, dryRun, ...input } = a;
+      return dryRun === true ? client.fulfillment.dryRunUpgradeExecutorPreset(id, input) : client.fulfillment.upgradeExecutorPreset(id, input);
+    }
+  );
   tool(
     "test_dsar_executor_webhook",
     "Would this webhook delivery from a connected system verify? Runs the receiver's exact check (headers, timestamp tolerance, prefix, HMAC) on headers and a raw body you supply, acts on nothing, and returns { verified, stage, reason } naming the stage that failed. `body` must be the raw request body string, byte for byte. Read-only.",
@@ -609,15 +636,17 @@ function registerPlatformTools(tool, client) {
   );
   tool(
     "test_dsar_executor",
-    "Try a connected system against one email WITHOUT filing a rights request. Runs its subject lookup and returns the raw upstream answers (credentials removed) and a one-line verdict. The open step is rendered but not sent, unless open is true on an export, which opens and polls a real export once. An erasure is never sent by a test.",
+    "Try a connected system against one email (or the org canary, canary: true) WITHOUT filing a rights request. Runs its subject lookup and returns the raw upstream answers (credentials removed) and a one-line verdict; code base_url_redirects means its baseUrl redirects and the verdict names where. The open step is rendered but not sent, unless open is true on an export, which opens and polls a real export once. An erasure is never sent by a test.",
     {
       id: import_zod2.z.string().describe("The connection id."),
-      email: import_zod2.z.string().describe("The address to look up."),
+      email: import_zod2.z.string().optional().describe("The address to look up. Omit it with canary."),
+      canary: import_zod2.z.boolean().optional().describe("Use this org's canary address \u2014 no real person involved. A canary locate also updates the connection's health."),
       operation: import_zod2.z.enum(["locate", "export", "erase"]).optional().describe("Default locate."),
       open: import_zod2.z.boolean().optional().describe("For export only: open a real export and poll it once.")
     },
     (a) => client.fulfillment.testExecutor(a.id, {
-      email: a.email,
+      ...typeof a.email === "string" ? { email: a.email } : {},
+      ...a.canary === true ? { canary: true } : {},
       ...a.operation ? { operation: a.operation } : {},
       ...typeof a.open === "boolean" ? { open: a.open } : {}
     })
@@ -703,31 +732,107 @@ function registerPlatformTools(tool, client) {
   );
 }
 
-// src/tools-rights-page.ts
+// src/tools-integrations.ts
 var import_zod3 = require("zod");
+function registerIntegrationTools(tool, client) {
+  const updateSiteSchema = import_zod3.z.object({
+    cbid: import_zod3.z.string().describe("Site identifier (cbid)."),
+    domain: import_zod3.z.string().optional().describe("New domain, a bare hostname. A move clears verification: verify the new domain afterwards."),
+    name: import_zod3.z.string().nullable().optional().describe("Display name data subjects see on the rights page and in notices; null clears it."),
+    aliases: import_zod3.z.array(import_zod3.z.string()).optional().describe("Other hosts serving the site (replaces the list; [] clears it). Accepted consent origins, never verified claims."),
+    dryRun: import_zod3.z.boolean().optional().describe("Answer with the diff and its effects, storing nothing.")
+  });
+  tool(
+    "update_site",
+    "Rename or move a site: its domain, display name and aliases. The cbid and the consent ledger stay. Moving the domain clears verification; the scanner and preview links follow the new domain. Use dryRun first to see the diff and every effect.",
+    updateSiteSchema.shape,
+    (a) => {
+      const { cbid, dryRun, ...patch } = updateSiteSchema.parse(a);
+      return client.sites.update(cbid, patch, { dryRun });
+    }
+  );
+  tool(
+    "integration_health",
+    "Check every link a site\u2019s privacy wiring depends on: the domain, the snippet and CSP on the live page, connected systems (base URL redirects, a test lookup), webhooks, partner links, Atlas cookie_consent, cookies needing review, the rights page, the mail provider and the request SLA. Each row has ok (null = could not check) and a fix hint. Read-only.",
+    { cbid: import_zod3.z.string().optional().describe("Site identifier; optional when the org has one site.") },
+    (a) => client.integrationHealth(a.cbid)
+  );
+  const provisionSchema = import_zod3.z.object({
+    product: import_zod3.z.string().describe("A slug naming the product."),
+    domain: import_zod3.z.string().describe("The product\u2019s domain (bare hostname)."),
+    name: import_zod3.z.string().optional(),
+    aliases: import_zod3.z.array(import_zod3.z.string()).optional(),
+    cbid: import_zod3.z.string().optional().describe("Update this site instead of matching by domain."),
+    atlas: import_zod3.z.object({ secretKey: import_zod3.z.string(), cookieConsent: import_zod3.z.boolean().optional(), dsrWebhook: import_zod3.z.boolean().optional(), frontendApiHost: import_zod3.z.string().optional().describe("Your Atlas frontend API host (auth.example.com): declares the Atlas sign-in cookies on the site.") }).optional().describe("Atlas secret key (sk_\u2026) \u2014 used for this call only, never stored or returned."),
+    forumulate: import_zod3.z.object({ token: import_zod3.z.string(), orgId: import_zod3.z.string(), consent: import_zod3.z.boolean().optional(), executorKey: import_zod3.z.boolean().optional(), label: import_zod3.z.string().optional() }).optional().describe("Forumulate org token \u2014 used for this call only, never stored or returned."),
+    rightsApi: import_zod3.z.object({ baseUrl: import_zod3.z.string(), secretKey: import_zod3.z.string(), profilePreset: import_zod3.z.string().optional() }).optional(),
+    dryRun: import_zod3.z.boolean().optional().describe("Report what each step would do; write nothing on any platform. Run this first.")
+  });
+  tool(
+    "provision_product",
+    "Wire a product\u2019s privacy in one call: create or update the site, connected systems, the Atlas request-completion webhook and hosted-page consent banner, and Forumulate consent and executor key. Writes across three platforms; run with dryRun first. Idempotent: a re-run answers every step unchanged. No secret appears in the result.",
+    provisionSchema.shape,
+    (a) => {
+      const { dryRun, ...input } = provisionSchema.parse(a);
+      return client.provision(input, { dryRun });
+    }
+  );
+  tool(
+    "list_site_partners",
+    "Which partner platforms (Forumulate, Atlas) receive this site\u2019s consent events, each with its status, and which partners are on offer. Read-only.",
+    { cbid: import_zod3.z.string() },
+    (a) => client.sites.listPartners(a.cbid)
+  );
+  const linkSchema = import_zod3.z.object({
+    cbid: import_zod3.z.string(),
+    partner: import_zod3.z.enum(["forumulate", "atlas"]),
+    externalId: import_zod3.z.string().describe("The partner\u2019s id for the receiving account, e.g. a Forumulate organisation id."),
+    label: import_zod3.z.string().optional().describe('Shown with the partner name, e.g. "docs".'),
+    events: import_zod3.z.array(import_zod3.z.enum(["consent.recorded", "consent.withdrawn"])).optional(),
+    dryRun: import_zod3.z.boolean().optional()
+  });
+  tool(
+    "link_site_partner",
+    "Grant a partner platform this site\u2019s consent events (they start flowing out to it). No secret is created: deliveries are signed with Cookie Munch\u2019s own key. Idempotent.",
+    linkSchema.shape,
+    (a) => {
+      const { cbid, dryRun, ...input } = linkSchema.parse(a);
+      return client.sites.linkPartner(cbid, input, { dryRun });
+    }
+  );
+  tool(
+    "unlink_site_partner",
+    "Revoke a partner link: no further consent events go to that partner.",
+    { cbid: import_zod3.z.string(), linkId: import_zod3.z.string() },
+    (a) => client.sites.unlinkPartner(a.cbid, a.linkId)
+  );
+}
+
+// src/tools-rights-page.ts
+var import_zod4 = require("zod");
 function registerRightsTools(tool, client) {
-  const cbid = { cbid: import_zod3.z.string().describe("Site identifier (cbid). Must belong to your org.") };
+  const cbid = { cbid: import_zod4.z.string().describe("Site identifier (cbid). Must belong to your org.") };
   const base = {
-    baseUpdatedAt: import_zod3.z.union([import_zod3.z.number().int(), import_zod3.z.string(), import_zod3.z.null()]).optional().describe("The draft\u2019s updatedAt from your last read (null if it had none). If someone saved since, the write is refused with 409 draft_conflict and the current draft; omit to overwrite regardless.")
+    baseUpdatedAt: import_zod4.z.union([import_zod4.z.number().int(), import_zod4.z.string(), import_zod4.z.null()]).optional().describe("The draft\u2019s updatedAt from your last read (null if it had none). If someone saved since, the write is refused with 409 draft_conflict and the current draft; omit to overwrite regardless.")
   };
   const baseOpt = (a) => a.baseUpdatedAt !== void 0 ? { baseUpdatedAt: a.baseUpdatedAt } : {};
   tool("get_rights_page", "Read the site\u2019s rights page DRAFT (the default page until first saved), with warnings that would block publishing.", cbid, (a) => client.rightsPage.get(a.cbid));
   tool(
     "update_rights_page",
     "Replace the rights page draft with a full document (theme, sections, form, i18n, seo, customCss). Nothing goes live until publish_rights_page. Prefer patch_rights_page for small changes and preview_rights_page when unsure. Pass baseUpdatedAt (from get_rights_page) to avoid overwriting someone else\u2019s save: a mismatch is 409 draft_conflict with the current draft.",
-    { ...cbid, page: import_zod3.z.record(import_zod3.z.unknown()).describe("The whole RightsPage document (v: 1)."), ...base },
+    { ...cbid, page: import_zod4.z.record(import_zod4.z.unknown()).describe("The whole RightsPage document (v: 1)."), ...base },
     (a) => client.rightsPage.put(a.cbid, a.page, baseOpt(a))
   );
   tool(
     "patch_rights_page",
     "Change part of the rights page draft: objects merge, arrays (sections, request types, fields) replace whole, null removes a field. baseUpdatedAt works as on update_rights_page (409 draft_conflict).",
-    { ...cbid, patch: import_zod3.z.record(import_zod3.z.unknown()), ...base },
+    { ...cbid, patch: import_zod4.z.record(import_zod4.z.unknown()), ...base },
     (a) => client.rightsPage.patch(a.cbid, a.patch, baseOpt(a))
   );
   tool(
     "preview_rights_page",
     'Validate a rights-page write WITHOUT saving: returns the document as it would be stored and any publish warnings. mode "patch" (default) or "put".',
-    { ...cbid, page: import_zod3.z.record(import_zod3.z.unknown()), mode: import_zod3.z.enum(["patch", "put"]).optional() },
+    { ...cbid, page: import_zod4.z.record(import_zod4.z.unknown()), mode: import_zod4.z.enum(["patch", "put"]).optional() },
     (a) => client.rightsPage.dryRun(a.cbid, a.page, { mode: a.mode ?? "patch" })
   );
   tool("get_published_rights_page", "Read the LIVE rights page document (404 not_published while the site shows the default page).", cbid, (a) => client.rightsPage.getPublished(a.cbid));
@@ -741,14 +846,14 @@ function registerRightsTools(tool, client) {
   tool(
     "rollback_rights_page",
     "Publish an earlier version of the rights page again (as a new version): it goes live at once and REPLACES the current draft, so unpublished edits are lost and cannot be recovered (versions hold only published documents). Pass baseUpdatedAt (from get_rights_page) to refuse with 409 draft_conflict if anyone saved the draft since you read it.",
-    { ...cbid, version: import_zod3.z.number().int().min(1), ...base },
+    { ...cbid, version: import_zod4.z.number().int().min(1), ...base },
     (a) => client.rightsPage.rollback(a.cbid, a.version, baseOpt(a))
   );
 }
 function registerRightsPageTools(tool, client) {
-  const site = import_zod3.z.object({ cbid: import_zod3.z.string().describe("Site identifier (cbid). Must belong to your org.") });
+  const site = import_zod4.z.object({ cbid: import_zod4.z.string().describe("Site identifier (cbid). Must belong to your org.") });
   const host = site.extend({
-    hostname: import_zod3.z.string().describe("The custom hostname, e.g. privacy.example.com (unicode or punycode).")
+    hostname: import_zod4.z.string().describe("The custom hostname, e.g. privacy.example.com (unicode or punycode).")
   });
   tool(
     "list_rights_page_domains",
@@ -888,10 +993,10 @@ function registerTools(server, client) {
       }
     });
   };
-  const cbid = { cbid: import_zod4.z.string().describe("Site identifier (cbid). Must belong to your org.") };
+  const cbid = { cbid: import_zod5.z.string().describe("Site identifier (cbid). Must belong to your org.") };
   const range = {
-    from: import_zod4.z.number().optional().describe("Epoch-ms lower bound."),
-    to: import_zod4.z.number().optional().describe("Epoch-ms upper bound.")
+    from: import_zod5.z.number().optional().describe("Epoch-ms lower bound."),
+    to: import_zod5.z.number().optional().describe("Epoch-ms upper bound.")
   };
   tool(
     "whoami",
@@ -909,19 +1014,19 @@ function registerTools(server, client) {
   tool(
     "get_site",
     "One site: its domain, cbid and verification status. Read-only.",
-    { cbid: import_zod4.z.string() },
+    { cbid: import_zod5.z.string() },
     (a) => client.sites.get(a.cbid)
   );
   tool(
     "get_site_banner",
     "Which banner design a site uses, or bannerId null when none is assigned. Read-only.",
-    { cbid: import_zod4.z.string() },
+    { cbid: import_zod5.z.string() },
     (a) => client.sites.banner(a.cbid)
   );
   tool(
     "get_privacy_policy",
     "Generate the site's privacy and cookie policy as Markdown, naming the org's data controller. Needs a contact email: the one given, else the org controller's, else the owner's. Read-only \u2014 nothing is published.",
-    { cbid: import_zod4.z.string(), contactEmail: import_zod4.z.string().optional(), effectiveDate: import_zod4.z.string().optional().describe("YYYY-MM-DD; defaults to today."), jurisdictions: import_zod4.z.array(import_zod4.z.string()).optional() },
+    { cbid: import_zod5.z.string(), contactEmail: import_zod5.z.string().optional(), effectiveDate: import_zod5.z.string().optional().describe("YYYY-MM-DD; defaults to today."), jurisdictions: import_zod5.z.array(import_zod5.z.string()).optional() },
     (a) => client.sites.policy(a.cbid, {
       ...a.contactEmail ? { contactEmail: a.contactEmail } : {},
       ...a.effectiveDate ? { effectiveDate: a.effectiveDate } : {},
@@ -931,7 +1036,7 @@ function registerTools(server, client) {
   tool(
     "set_ad_personalization",
     "Add or remove the separate 'personalised ads' choice on the site's live banner. With it on, accepting marketing no longer implies personalised ads unless `default` is true.",
-    { cbid: import_zod4.z.string(), enabled: import_zod4.z.boolean(), default: import_zod4.z.boolean().optional(), label: import_zod4.z.string().optional() },
+    { cbid: import_zod5.z.string(), enabled: import_zod5.z.boolean(), default: import_zod5.z.boolean().optional(), label: import_zod5.z.string().optional() },
     (a) => client.sites.setAdPersonalization(a.cbid, {
       enabled: a.enabled,
       ...a.default !== void 0 ? { default: a.default } : {},
@@ -942,11 +1047,11 @@ function registerTools(server, client) {
     "analyze_session",
     "Analyse a captured browsing session against the consent it ran under: which trackers fired after the visitor opted out, and what personal data left the page. Read-only.",
     {
-      cbid: import_zod4.z.string(),
-      har: import_zod4.z.unknown().optional().describe("A HAR export of the session."),
-      requests: import_zod4.z.array(import_zod4.z.unknown()).optional().describe("Or the requests directly."),
-      consent: import_zod4.z.record(import_zod4.z.string(), import_zod4.z.boolean()).optional(),
-      gpc: import_zod4.z.boolean().optional()
+      cbid: import_zod5.z.string(),
+      har: import_zod5.z.unknown().optional().describe("A HAR export of the session."),
+      requests: import_zod5.z.array(import_zod5.z.unknown()).optional().describe("Or the requests directly."),
+      consent: import_zod5.z.record(import_zod5.z.string(), import_zod5.z.boolean()).optional(),
+      gpc: import_zod5.z.boolean().optional()
     },
     (a) => client.sites.analyzeSession(a.cbid, {
       ...a.har !== void 0 ? { har: a.har } : {},
@@ -958,14 +1063,14 @@ function registerTools(server, client) {
   tool(
     "create_site",
     "Create a new site. The cbid is auto-generated if you omit it.",
-    { domain: import_zod4.z.string().describe("The site domain, e.g. example.com."), cbid: import_zod4.z.string().optional().describe("Optional explicit cbid.") },
+    { domain: import_zod5.z.string().describe("The site domain, e.g. example.com."), cbid: import_zod5.z.string().optional().describe("Optional explicit cbid.") },
     (a) => client.sites.create({ domain: a.domain, ...typeof a.cbid === "string" ? { cbid: a.cbid } : {} })
   );
   tool(
     "create_sites_bulk",
     "Create up to 100 sites in one call. Partial success: each item reports ok or its own error, and a bad or duplicate item fails only itself.",
     {
-      sites: import_zod4.z.array(import_zod4.z.object({ domain: import_zod4.z.string(), cbid: import_zod4.z.string().optional(), platform: import_zod4.z.string().optional() })).min(1).max(100)
+      sites: import_zod5.z.array(import_zod5.z.object({ domain: import_zod5.z.string(), cbid: import_zod5.z.string().optional(), platform: import_zod5.z.string().optional() })).min(1).max(100)
     },
     (a) => client.sites.createBulk(a.sites)
   );
@@ -975,15 +1080,15 @@ function registerTools(server, client) {
     "Replace (overwrite) the banner/consent configuration for a site via PUT. This is destructive, not a merge: any top-level SiteConfig field you omit from `config` reverts to its default rather than keeping its current value \u2014 unless keepUnspecified is true, in which case omitted top-level fields keep their stored value and only the fields you send are replaced (each whole). A top-level field sent as null reverts to its default. To change one setting, use patch_site_config instead \u2014 it merges server-side. Prefer the narrower set_* tools (set_blocking, set_banner_basics, etc.) when they cover your change.",
     {
       ...cbid,
-      config: import_zod4.z.record(import_zod4.z.unknown()).describe("The full SiteConfig to write, not a patch. Without keepUnspecified, omitted top-level fields are NOT preserved from the current config."),
-      keepUnspecified: import_zod4.z.boolean().optional().describe("PUT ?keep=unspecified: keep the stored value of every top-level field `config` omits, instead of reverting it to its default.")
+      config: import_zod5.z.record(import_zod5.z.unknown()).describe("The full SiteConfig to write, not a patch. Without keepUnspecified, omitted top-level fields are NOT preserved from the current config."),
+      keepUnspecified: import_zod5.z.boolean().optional().describe("PUT ?keep=unspecified: keep the stored value of every top-level field `config` omits, instead of reverting it to its default.")
     },
     (a) => a.keepUnspecified === true ? client.sites.putConfig(a.cbid, a.config, { keep: "unspecified" }) : client.sites.putConfig(a.cbid, a.config)
   );
   tool(
     "patch_site_config",
     `Change part of a site's banner/consent configuration. The patch is a JSON Merge Patch (RFC 7386) over the stored config server-side: any field you omit keeps its current value, and a field set to null is REMOVED (it falls back to its default) \u2014 e.g. { "banner": { "i18n": { "es": null } } } drops the Spanish override. This is the safe way to flip one setting, and it needs no read-modify-write. Use update_site_config only when you genuinely mean to replace the whole document.`,
-    { ...cbid, config: import_zod4.z.record(import_zod4.z.unknown()).describe('The subset of SiteConfig to change, e.g. { "banner": { "showRightsLink": true } }. Everything else is preserved; null removes a field.') },
+    { ...cbid, config: import_zod5.z.record(import_zod5.z.unknown()).describe('The subset of SiteConfig to change, e.g. { "banner": { "showRightsLink": true } }. Everything else is preserved; null removes a field.') },
     (a) => client.sites.patchConfig(a.cbid, a.config)
   );
   tool(
@@ -991,9 +1096,9 @@ function registerTools(server, client) {
     'Preview a config change WITHOUT saving it: returns the config as it would be saved, a diff of every field that would change, and any warnings (plan-gated or unrecognised fields). mode "patch" (default) previews patch_site_config; mode "put" previews update_site_config, and its diff lists everything a replace would revert to its default (unless keepUnspecified is true). Use it before any write you are not sure of.',
     {
       ...cbid,
-      config: import_zod4.z.record(import_zod4.z.unknown()).describe('The patch (or, with mode "put", the full config) to preview.'),
-      mode: import_zod4.z.enum(["patch", "put"]).optional().describe("patch (default) merges; put replaces."),
-      keepUnspecified: import_zod4.z.boolean().optional().describe('With mode "put": preview update_site_config with keepUnspecified (omitted top-level fields keep their stored value).')
+      config: import_zod5.z.record(import_zod5.z.unknown()).describe('The patch (or, with mode "put", the full config) to preview.'),
+      mode: import_zod5.z.enum(["patch", "put"]).optional().describe("patch (default) merges; put replaces."),
+      keepUnspecified: import_zod5.z.boolean().optional().describe('With mode "put": preview update_site_config with keepUnspecified (omitted top-level fields keep their stored value).')
     },
     (a) => client.sites.dryRunConfig(a.cbid, a.config, {
       mode: a.mode ?? "patch",
@@ -1005,8 +1110,8 @@ function registerTools(server, client) {
     'Check a banner config for consent-button parity WITHOUT saving it: is "Accept all" more prominent than "Reject all" anywhere \u2014 a brighter or more saturated colour, a bigger or bolder button, Reject styled as a link, hidden, below the fold, set apart, missing from the first layer, or worded to guilt-trip? Regulators (EDPB, CNIL) treat that as a dark pattern. Returns findings, a 0\u2013100 score and the reject style that would match Accept. It checks exactly what the write would store: merged over the stored config as patch_site_config would, or with replace: true replaced as update_site_config would. Run it before writing any banner design.',
     {
       ...cbid,
-      config: import_zod4.z.record(import_zod4.z.unknown()).describe("The proposed SiteConfig (or a partial one, or a v2 flow design)."),
-      replace: import_zod4.z.boolean().optional().describe("Check what update_site_config (a full replace) would store, instead of what patch_site_config (a merge) would.")
+      config: import_zod5.z.record(import_zod5.z.unknown()).describe("The proposed SiteConfig (or a partial one, or a v2 flow design)."),
+      replace: import_zod5.z.boolean().optional().describe("Check what update_site_config (a full replace) would store, instead of what patch_site_config (a merge) would.")
     },
     async (a) => {
       const r = await client.sites.lintConfig(a.cbid, a.config, a.replace === true ? { replace: true } : {});
@@ -1030,7 +1135,7 @@ ${JSON.stringify(r, null, 2)}` : r;
   tool(
     "get_consent_log",
     "Get recent anonymised consent records for a site.",
-    { ...cbid, ...range, limit: import_zod4.z.number().optional().describe("Max records to return (default 200).") },
+    { ...cbid, ...range, limit: import_zod5.z.number().optional().describe("Max records to return (default 200).") },
     (a) => client.consent.log(a.cbid, {
       from: a.from,
       to: a.to,
@@ -1040,7 +1145,7 @@ ${JSON.stringify(r, null, 2)}` : r;
   tool(
     "get_subject_consent",
     "One person's consent records across every site in the org \u2014 web, mobile and desktop \u2014 by the subjectId your apps attach. Consent data: needs the consent:read scope. Read-only.",
-    { subjectId: import_zod4.z.string() },
+    { subjectId: import_zod5.z.string() },
     (a) => client.subjects.consent(a.subjectId)
   );
   tool("list_dsar", "List all Data Subject Access Requests for your organization.", {}, () => client.dsar.list());
@@ -1048,51 +1153,53 @@ ${JSON.stringify(r, null, 2)}` : r;
     "update_dsar_executor",
     "Change a connected system in place \u2014 its profile, address, credential or auto flag. Only what you pass changes; the stored credential is kept unless you give a new one. With dryRun, answers the connection as it would be and a diff, and changes nothing.",
     {
-      id: import_zod4.z.string(),
-      patch: import_zod4.z.record(import_zod4.z.unknown()),
-      dryRun: import_zod4.z.boolean().optional().describe("Validate and diff without saving.")
+      id: import_zod5.z.string(),
+      patch: import_zod5.z.record(import_zod5.z.unknown()),
+      dryRun: import_zod5.z.boolean().optional().describe("Validate and diff without saving.")
     },
     (a) => a.dryRun === true ? client.fulfillment.dryRunUpdateExecutor(a.id, a.patch) : client.fulfillment.updateExecutor(a.id, a.patch)
   );
   tool(
     "get_dsar",
     "One rights request by id, including its status and the deadline it must be answered by.",
-    { id: import_zod4.z.string() },
+    { id: import_zod5.z.string() },
     (a) => client.dsar.get(a.id)
   );
   tool(
     "erase_dsar_subject",
     "For a deletion request that is past identity verification: erase the person\u2019s consent records on one site, identified by their consent stamp. Irreversible. The erasure is noted on the request. If the response carries a warning, nothing was cryptographically erased \u2014 tell the user.",
-    { id: import_zod4.z.string(), cbid: import_zod4.z.string(), stamp: import_zod4.z.string() },
+    { id: import_zod5.z.string(), cbid: import_zod5.z.string(), stamp: import_zod5.z.string() },
     (a) => client.dsar.erase(a.id, a.cbid, a.stamp)
   );
   tool(
     "export_dsar_subject",
     "For an access or portability request that is past identity verification: the person\u2019s consent records on one site, identified by their consent stamp. The export is noted on the request.",
-    { id: import_zod4.z.string(), cbid: import_zod4.z.string(), stamp: import_zod4.z.string() },
+    { id: import_zod5.z.string(), cbid: import_zod5.z.string(), stamp: import_zod5.z.string() },
     (a) => client.dsar.export(a.id, a.cbid, a.stamp)
   );
   tool(
     "get_dsar_response_notice",
     "The subject-facing response notice for a request, as plain text \u2014 what to send the person. Read-only; nothing is sent.",
-    { id: import_zod4.z.string() },
+    { id: import_zod5.z.string() },
     (a) => client.dsar.response(a.id)
   );
   tool(
     "create_dsar",
     "Open a new Data Subject Access Request.",
     {
-      type: import_zod4.z.enum(["access", "deletion", "rectification", "portability", "opt-out"]).describe("DSAR right being exercised."),
-      subjectEmail: import_zod4.z.string().describe("The data subject\u2019s email."),
-      regulation: import_zod4.z.enum(["gdpr", "ccpa"]).describe("Governing regulation."),
-      note: import_zod4.z.string().optional().describe("Optional free-text note."),
-      test: import_zod4.z.boolean().optional().describe("Mark it as a test request: kept off the SLA board and deletable afterwards with delete_test_dsar.")
+      type: import_zod5.z.enum(["access", "deletion", "rectification", "portability", "opt-out"]).describe("DSAR right being exercised."),
+      subjectEmail: import_zod5.z.string().describe("The data subject\u2019s email."),
+      regulation: import_zod5.z.enum(["gdpr", "ccpa"]).describe("Governing regulation."),
+      note: import_zod5.z.string().optional().describe("Optional INTERNAL note; never shown to the data subject."),
+      messageToSubject: import_zod5.z.string().max(2e3).optional().describe("The line the data subject reads in the response notice. Never an API key."),
+      test: import_zod5.z.boolean().optional().describe("Mark it as a test request: kept off the SLA board and deletable afterwards with delete_test_dsar.")
     },
     (a) => client.dsar.create({
       type: a.type,
       subjectEmail: a.subjectEmail,
       regulation: a.regulation,
       ...typeof a.note === "string" ? { note: a.note } : {},
+      ...typeof a.messageToSubject === "string" ? { messageToSubject: a.messageToSubject } : {},
       ...a.test === true ? { test: true } : {}
     })
   );
@@ -1100,11 +1207,11 @@ ${JSON.stringify(r, null, 2)}` : r;
     "create_rights_link",
     "Mint a signed, single-use link to a site\u2019s hosted rights page for a person you know is signed in to that site. On the page their email is filled in and locked and the email-code step is skipped; the filed request is recorded as verified by their account. Give the link only to that person. Expires in 15 minutes by default (max 1 hour). Needs dsar:write.",
     {
-      cbid: import_zod4.z.string().describe("Site identifier (cbid). Must belong to your org."),
-      email: import_zod4.z.string().describe("The signed-in person\u2019s verified email address."),
-      userId: import_zod4.z.string().optional().describe("Your own account id for them; recorded on the request."),
-      rights: import_zod4.z.array(import_zod4.z.enum(["access", "erasure", "rectification", "portability", "restriction", "objection", "opt_out_sale", "opt_out_targeted", "limit_sensitive"])).min(1).optional().describe("Limit the link to these rights. Default: every right the page offers."),
-      ttlSeconds: import_zod4.z.number().int().min(60).max(3600).optional().describe("How long the link works, in seconds (default 900).")
+      cbid: import_zod5.z.string().describe("Site identifier (cbid). Must belong to your org."),
+      email: import_zod5.z.string().describe("The signed-in person\u2019s verified email address."),
+      userId: import_zod5.z.string().optional().describe("Your own account id for them; recorded on the request."),
+      rights: import_zod5.z.array(import_zod5.z.enum(["access", "erasure", "rectification", "portability", "restriction", "objection", "opt_out_sale", "opt_out_targeted", "limit_sensitive"])).min(1).optional().describe("Limit the link to these rights. Default: every right the page offers."),
+      ttlSeconds: import_zod5.z.number().int().min(60).max(3600).optional().describe("How long the link works, in seconds (default 900).")
     },
     (a) => client.rightsLinks.create(a.cbid, {
       subject: { email: a.email, ...typeof a.userId === "string" ? { userId: a.userId } : {} },
@@ -1115,7 +1222,7 @@ ${JSON.stringify(r, null, 2)}` : r;
   tool(
     "delete_test_dsar",
     "Delete a TEST rights request (one created with test: true), with its tasks and their upstream log. Real requests cannot be deleted and are refused. The deletion is recorded in the audit log.",
-    { id: import_zod4.z.string().describe("The test request id.") },
+    { id: import_zod5.z.string().describe("The test request id.") },
     async (a) => {
       await client.dsar.delete(a.id);
       return { deleted: a.id };
@@ -1124,17 +1231,18 @@ ${JSON.stringify(r, null, 2)}` : r;
   tool(
     "mark_dsar_test",
     "Mark a CLOSED rights request (completed or rejected) as a test request, after the fact \u2014 for trial requests filed before test: true existed. An open request is refused (request_not_closed), so a live obligation can never be relabelled. Recorded in the audit log; afterwards delete_test_dsar can remove it. Returns { request, changed }.",
-    { id: import_zod4.z.string().describe("The closed request id.") },
+    { id: import_zod5.z.string().describe("The closed request id.") },
     (a) => client.dsar.markTest(a.id)
   );
   tool(
     "advance_dsar",
     "Advance a DSAR to a new status (received \u2192 verifying \u2192 in_progress \u2192 completed, or rejected).",
     {
-      id: import_zod4.z.string().describe("The DSAR id."),
-      toStatus: import_zod4.z.enum(["received", "verifying", "in_progress", "completed", "rejected"]).describe("Target status.")
+      id: import_zod5.z.string().describe("The DSAR id."),
+      toStatus: import_zod5.z.enum(["received", "verifying", "in_progress", "completed", "rejected"]).describe("Target status."),
+      messageToSubject: import_zod5.z.string().max(2e3).optional().describe("Replaces the line the data subject reads in the notice \u2014 for a rejection, why.")
     },
-    (a) => client.dsar.advance(a.id, a.toStatus)
+    (a) => typeof a.messageToSubject === "string" ? client.dsar.advance(a.id, a.toStatus, { messageToSubject: a.messageToSubject }) : client.dsar.advance(a.id, a.toStatus)
   );
   tool(
     "export_consent",
@@ -1145,7 +1253,7 @@ ${JSON.stringify(r, null, 2)}` : r;
   tool(
     "get_receipt",
     "Fetch the signed consent receipt for a single consent record (by stamp).",
-    { ...cbid, stamp: import_zod4.z.string().describe("The consent record stamp/id.") },
+    { ...cbid, stamp: import_zod5.z.string().describe("The consent record stamp/id.") },
     (a) => client.consent.receipt(a.cbid, a.stamp)
   );
   tool("delete_site", "Delete a site (cbid) and its configuration from your org.", { ...cbid }, async (a) => {
@@ -1157,13 +1265,13 @@ ${JSON.stringify(r, null, 2)}` : r;
     "create_vendor",
     "Register a vendor (processor) and compute its risk score.",
     {
-      name: import_zod4.z.string().describe("Vendor name."),
-      category: import_zod4.z.string().describe("Vendor category, e.g. analytics."),
-      dataShared: import_zod4.z.array(import_zod4.z.string()).describe("Categories of data shared with the vendor."),
-      dpaSigned: import_zod4.z.boolean().describe("Whether a Data Processing Agreement is signed."),
-      subprocessors: import_zod4.z.number().describe("Number of subprocessors."),
-      certifications: import_zod4.z.array(import_zod4.z.string()).describe("Compliance certifications, e.g. ISO27001."),
-      region: import_zod4.z.string().describe("Primary processing region, e.g. EU.")
+      name: import_zod5.z.string().describe("Vendor name."),
+      category: import_zod5.z.string().describe("Vendor category, e.g. analytics."),
+      dataShared: import_zod5.z.array(import_zod5.z.string()).describe("Categories of data shared with the vendor."),
+      dpaSigned: import_zod5.z.boolean().describe("Whether a Data Processing Agreement is signed."),
+      subprocessors: import_zod5.z.number().describe("Number of subprocessors."),
+      certifications: import_zod5.z.array(import_zod5.z.string()).describe("Compliance certifications, e.g. ISO27001."),
+      region: import_zod5.z.string().describe("Primary processing region, e.g. EU.")
     },
     (a) => client.vendors.create({
       name: a.name,
@@ -1181,13 +1289,13 @@ ${JSON.stringify(r, null, 2)}` : r;
     "create_ropa",
     "Create a Record of Processing Activity (RoPA) entry.",
     {
-      name: import_zod4.z.string().describe("Activity name."),
-      purpose: import_zod4.z.string().describe("Purpose of processing."),
-      legalBasis: import_zod4.z.enum(["consent", "contract", "legal-obligation", "vital-interests", "public-task", "legitimate-interests"]).describe("GDPR legal basis."),
-      dataCategories: import_zod4.z.array(import_zod4.z.string()).describe("Categories of personal data."),
-      recipients: import_zod4.z.array(import_zod4.z.string()).describe("Recipients of the data."),
-      retentionDays: import_zod4.z.number().describe("Retention period in days."),
-      crossBorderTransfer: import_zod4.z.boolean().describe("Whether data is transferred across borders.")
+      name: import_zod5.z.string().describe("Activity name."),
+      purpose: import_zod5.z.string().describe("Purpose of processing."),
+      legalBasis: import_zod5.z.enum(["consent", "contract", "legal-obligation", "vital-interests", "public-task", "legitimate-interests"]).describe("GDPR legal basis."),
+      dataCategories: import_zod5.z.array(import_zod5.z.string()).describe("Categories of personal data."),
+      recipients: import_zod5.z.array(import_zod5.z.string()).describe("Recipients of the data."),
+      retentionDays: import_zod5.z.number().describe("Retention period in days."),
+      crossBorderTransfer: import_zod5.z.boolean().describe("Whether data is transferred across borders.")
     },
     (a) => client.ropa.create({
       name: a.name,
@@ -1208,7 +1316,7 @@ ${JSON.stringify(r, null, 2)}` : r;
   tool(
     "scan_site",
     "Trigger a cookie crawl of a site (at most 90 s). Returns its scanId and state (queued). With wait: true, returns once it is done or failed \u2014 state, cookieCount, pagesVisited, durationMs, error. The stored list keeps cookies earlier crawls and real visits found; retire one the site no longer sets.",
-    { ...cbid, wait: import_zod4.z.boolean().optional().describe("Wait for the scan to finish (up to 100 s) and return its outcome.") },
+    { ...cbid, wait: import_zod5.z.boolean().optional().describe("Wait for the scan to finish (up to 100 s) and return its outcome.") },
     async (a) => {
       let started;
       try {
@@ -1222,7 +1330,7 @@ ${JSON.stringify(r, null, 2)}` : r;
   tool(
     "get_scan_status",
     "Get a site\u2019s last cookie scan: state (queued, scanning, done, failed), scanId, durationMs, cookieCount, pagesVisited and error when it failed.",
-    { ...cbid, wait: import_zod4.z.number().min(0).max(60).optional().describe("Seconds (\u226460) to wait for a running scan to settle before answering.") },
+    { ...cbid, wait: import_zod5.z.number().min(0).max(60).optional().describe("Seconds (\u226460) to wait for a running scan to settle before answering.") },
     (a) => a.wait !== void 0 ? client.sites.scanStatus(a.cbid, { wait: a.wait }) : client.sites.scanStatus(a.cbid)
   );
   tool(
@@ -1234,16 +1342,25 @@ ${JSON.stringify(r, null, 2)}` : r;
   tool("list_brand_kits", "List reusable brand kits (colors/logo/typography) for your org.", {}, () => client.brandKits.list());
   tool("list_preferences", "List configurable consent preferences/purposes for your org.", {}, () => client.preferences.list());
   tool("list_members", "List the members of your organization.", {}, () => client.members.list());
-  tool("list_api_keys", "List the API keys for your organization (secrets are not returned).", {}, () => client.keys.list());
+  tool("list_api_keys", "List the API keys for your organization (secrets are not returned), with each key\u2019s scopes, expiry and when it was last used.", {}, () => client.keys.list());
+  tool(
+    "api_key_report",
+    "Key hygiene: keys not used for a while, keys with broad (full or wide write) access, and keys expiring soon, each with the reason. Read-only.",
+    {
+      unusedDays: import_zod5.z.number().int().min(1).max(3650).optional().describe("Unused for at least this many days (default 90)."),
+      expiringDays: import_zod5.z.number().int().min(1).max(3650).optional().describe("Expiring within this many days (default 14).")
+    },
+    (a) => client.keys.report({ ...a.unusedDays !== void 0 ? { unusedDays: a.unusedDays } : {}, ...a.expiringDays !== void 0 ? { expiringDays: a.expiringDays } : {} })
+  );
   tool("get_usage", "Get the current usage/quota summary for your organization.", {}, () => client.usage());
   tool("list_webhooks", "List webhook subscriptions for your organization.", {}, () => client.webhooks.list());
   tool(
     "create_webhook",
     "Create a webhook subscription. The response includes the signing secret (shown once).",
     {
-      url: import_zod4.z.string().describe("HTTPS endpoint to deliver events to."),
-      events: import_zod4.z.array(import_zod4.z.string()).describe("Event names to subscribe to, e.g. consent.created."),
-      cbid: import_zod4.z.string().optional().describe("Optional site cbid to scope the subscription to.")
+      url: import_zod5.z.string().describe("HTTPS endpoint to deliver events to."),
+      events: import_zod5.z.array(import_zod5.z.string()).describe("Event names to subscribe to, e.g. consent.created."),
+      cbid: import_zod5.z.string().optional().describe("Optional site cbid to scope the subscription to.")
     },
     (a) => client.webhooks.create({
       url: a.url,
@@ -1254,13 +1371,13 @@ ${JSON.stringify(r, null, 2)}` : r;
   tool(
     "roll_webhook_secret",
     "Rotate a webhook subscription\u2019s signing secret. The new secret is returned once; the receiving endpoint must be updated to verify with it.",
-    { id: import_zod4.z.string() },
+    { id: import_zod5.z.string() },
     (a) => client.webhooks.rollSecret(a.id)
   );
   tool(
     "test_webhook",
     "Send a signed test event to a webhook subscription now, and report what the endpoint answered.",
-    { id: import_zod4.z.string() },
+    { id: import_zod5.z.string() },
     (a) => client.webhooks.test(a.id)
   );
   tool(
@@ -1272,18 +1389,18 @@ ${JSON.stringify(r, null, 2)}` : r;
   tool(
     "replay_webhook_dead_letter",
     "Deliver a dead-lettered webhook event again, to the subscription as it is now.",
-    { id: import_zod4.z.string() },
+    { id: import_zod5.z.string() },
     (a) => client.webhooks.replayDeadLetter(a.id)
   );
   tool(
     "update_webhook",
     "Change a webhook subscription, or pause it with active:false (delivery stops; the subscription is kept). Only the fields given change. cbid: null widens it to every property in the org.",
     {
-      id: import_zod4.z.string(),
-      url: import_zod4.z.string().optional(),
-      events: import_zod4.z.array(import_zod4.z.string()).optional(),
-      cbid: import_zod4.z.string().nullable().optional(),
-      active: import_zod4.z.boolean().optional()
+      id: import_zod5.z.string(),
+      url: import_zod5.z.string().optional(),
+      events: import_zod5.z.array(import_zod5.z.string()).optional(),
+      cbid: import_zod5.z.string().nullable().optional(),
+      active: import_zod5.z.boolean().optional()
     },
     (a) => client.webhooks.update(a.id, {
       ...a.url !== void 0 ? { url: a.url } : {},
@@ -1292,20 +1409,20 @@ ${JSON.stringify(r, null, 2)}` : r;
       ...a.active !== void 0 ? { active: a.active } : {}
     })
   );
-  tool("delete_webhook", "Delete a webhook subscription by id.", { id: import_zod4.z.string().describe("The webhook subscription id.") }, async (a) => {
+  tool("delete_webhook", "Delete a webhook subscription by id.", { id: import_zod5.z.string().describe("The webhook subscription id.") }, async (a) => {
     await client.webhooks.delete(a.id);
     return { ok: true };
   });
   tool(
     "verify_site",
     "Verify that your organization controls a domain by one of three challenge methods (dns / meta / file). Required to unlock consent export and signed receipts.",
-    { ...cbid, method: import_zod4.z.enum(["dns", "meta", "file"]).describe("Challenge method: dns (TXT record), meta (HTML tag), or file (/.well-known/cookiemunch-verify.txt).") },
+    { ...cbid, method: import_zod5.z.enum(["dns", "meta", "file"]).describe("Challenge method: dns (TXT record), meta (HTML tag), or file (/.well-known/cookiemunch-verify.txt).") },
     (a) => client.sites.verify(a.cbid, a.method)
   );
   tool(
     "get_verification_challenge",
     "Exactly what to publish to prove control of a site\u2019s domain: the DNS TXT record, the meta tag, the file, or installing the embed. Read-only \u2014 publish one, then call verify_site.",
-    { cbid: import_zod4.z.string() },
+    { cbid: import_zod5.z.string() },
     (a) => client.sites.verifyChallenge(a.cbid)
   );
   tool(
@@ -1317,15 +1434,15 @@ ${JSON.stringify(r, null, 2)}` : r;
   tool(
     "get_flow",
     "Get the v2 banner flow config for a site, including current views, categories, and any lint issues.",
-    { cbid: import_zod4.z.string().describe("Site identifier (cbid).") },
+    { cbid: import_zod5.z.string().describe("Site identifier (cbid).") },
     (a) => client.sites.getFlow(a.cbid)
   );
   tool(
     "edit_flow",
     "Apply a batch of structured edit operations to a site's v2 banner flow. All ops are validated server-side and the final config must be lint-clean before it is saved.",
     {
-      cbid: import_zod4.z.string().describe("Site identifier (cbid)."),
-      operations: import_zod4.z.array(import_zod4.z.record(import_zod4.z.unknown())).describe(
+      cbid: import_zod5.z.string().describe("Site identifier (cbid)."),
+      operations: import_zod5.z.array(import_zod5.z.record(import_zod5.z.unknown())).describe(
         'Ordered list of ops. Each must have an "op" field: addView | removeView | addElement | setButtonTransition | addCustomCategory.'
       )
     },
@@ -1335,21 +1452,22 @@ ${JSON.stringify(r, null, 2)}` : r;
     "set_flow",
     "Wholesale replace a site's v2 banner flow with a complete config (e.g. from a template). Validated server-side before it is saved.",
     {
-      cbid: import_zod4.z.string().describe("Site identifier (cbid)."),
-      config: import_zod4.z.record(import_zod4.z.unknown()).describe("A full v2 FlowConfig object ({ v:2, flow, categories, ... }).")
+      cbid: import_zod5.z.string().describe("Site identifier (cbid)."),
+      config: import_zod5.z.record(import_zod5.z.unknown()).describe("A full v2 FlowConfig object ({ v:2, flow, categories, ... }).")
     },
     (a) => client.sites.setFlow(a.cbid, a.config)
   );
   registerConfigTools(tool, client);
   registerPlatformTools(tool, client);
+  registerIntegrationTools(tool, client);
   registerRightsTools(tool, client);
   registerRightsPageTools(tool, client);
   tool(
     "invite_member",
     "Invite a person to your organization by email. role must be admin, member, or viewer. The org is derived from the API key \u2014 you cannot invite into a different org.",
     {
-      email: import_zod4.z.string().describe("Email address of the person to invite."),
-      role: import_zod4.z.enum(["admin", "member", "viewer"]).describe("Role to assign: admin, member, or viewer. owner is not assignable via API key.")
+      email: import_zod5.z.string().describe("Email address of the person to invite."),
+      role: import_zod5.z.enum(["admin", "member", "viewer"]).describe("Role to assign: admin, member, or viewer. owner is not assignable via API key.")
     },
     (a) => client.members.invite(a.email, a.role)
   );
@@ -1357,8 +1475,8 @@ ${JSON.stringify(r, null, 2)}` : r;
     "set_member_role",
     "Change the role of a member in your organization. The org owner's role cannot be changed.",
     {
-      userId: import_zod4.z.string().describe("The userId of the member whose role to change."),
-      role: import_zod4.z.enum(["admin", "member", "viewer"]).describe("New role: admin, member, or viewer.")
+      userId: import_zod5.z.string().describe("The userId of the member whose role to change."),
+      role: import_zod5.z.enum(["admin", "member", "viewer"]).describe("New role: admin, member, or viewer.")
     },
     (a) => client.members.setRole(a.userId, a.role)
   );
@@ -1366,7 +1484,7 @@ ${JSON.stringify(r, null, 2)}` : r;
     "remove_member",
     "Remove a member from your organization. The org owner cannot be removed.",
     {
-      userId: import_zod4.z.string().describe("The userId of the member to remove.")
+      userId: import_zod5.z.string().describe("The userId of the member to remove.")
     },
     async (a) => {
       await client.members.remove(a.userId);
@@ -1377,11 +1495,11 @@ ${JSON.stringify(r, null, 2)}` : r;
     "create_brand_kit",
     "Create a reusable brand kit (colors, logo, typography) for your organization's consent banners.",
     {
-      name: import_zod4.z.string().describe("Display name for the brand kit."),
-      theme: import_zod4.z.record(import_zod4.z.unknown()).describe("Theme tokens (colors, fonts, etc.) as a JSON object."),
-      content: import_zod4.z.record(import_zod4.z.unknown()).optional().describe("Optional banner copy overrides."),
-      logoUrl: import_zod4.z.string().optional().describe("Optional URL for your org logo."),
-      customCss: import_zod4.z.string().optional().describe("Optional custom CSS string to inject into the banner.")
+      name: import_zod5.z.string().describe("Display name for the brand kit."),
+      theme: import_zod5.z.record(import_zod5.z.unknown()).describe("Theme tokens (colors, fonts, etc.) as a JSON object."),
+      content: import_zod5.z.record(import_zod5.z.unknown()).optional().describe("Optional banner copy overrides."),
+      logoUrl: import_zod5.z.string().optional().describe("Optional URL for your org logo."),
+      customCss: import_zod5.z.string().optional().describe("Optional custom CSS string to inject into the banner.")
     },
     (a) => client.brandKits.create({
       name: a.name,
@@ -1395,7 +1513,7 @@ ${JSON.stringify(r, null, 2)}` : r;
     "delete_brand_kit",
     "Delete a brand kit by id. The kit must belong to your organization (cross-org deletes are rejected).",
     {
-      id: import_zod4.z.string().describe("The brand kit id to delete.")
+      id: import_zod5.z.string().describe("The brand kit id to delete.")
     },
     async (a) => {
       await client.brandKits.delete(a.id);
@@ -1406,63 +1524,65 @@ ${JSON.stringify(r, null, 2)}` : r;
     "save_preference",
     "Save or update the consent preferences for an end-user (by subjectId) within your organization. purposes is a map of purpose-name \u2192 boolean.",
     {
-      subjectId: import_zod4.z.string().describe("The end-user identifier (e.g. email or internal user id)."),
-      purposes: import_zod4.z.record(import_zod4.z.boolean()).describe('Map of purpose names to consent values, e.g. { "newsletter": true, "analytics": false }.')
+      subjectId: import_zod5.z.string().describe("The end-user identifier (e.g. email or internal user id)."),
+      purposes: import_zod5.z.record(import_zod5.z.boolean()).describe('Map of purpose names to consent values, e.g. { "newsletter": true, "analytics": false }.')
     },
     (a) => client.preferences.save(a.subjectId, a.purposes)
   );
   tool(
     "get_preference",
     "One end-user\u2019s saved preferences, by subjectId. Read-only.",
-    { subjectId: import_zod4.z.string() },
+    { subjectId: import_zod5.z.string() },
     (a) => client.preferences.get(a.subjectId)
   );
   tool(
     "issue_api_key",
     "Issue a new API key. The secret is returned once and never again. Prefer the least privilege the job needs: `scopes` limits what it can do, `cbids` locks it to specific sites (it then cannot reach anything org-wide), `expiresInDays` retires it. Omitting all three mints a full-access, org-wide, non-expiring key.",
     {
-      name: import_zod4.z.string().optional(),
-      scopes: import_zod4.z.array(import_zod4.z.string()).optional(),
-      cbids: import_zod4.z.array(import_zod4.z.string()).min(1).optional(),
-      expiresInDays: import_zod4.z.number().int().min(1).max(3650).optional()
+      name: import_zod5.z.string().optional(),
+      scopes: import_zod5.z.array(import_zod5.z.string()).optional(),
+      cbids: import_zod5.z.array(import_zod5.z.string()).min(1).optional(),
+      expiresInDays: import_zod5.z.number().int().min(1).max(3650).optional(),
+      expiresAt: import_zod5.z.string().optional().describe("Or the exact expiry, an ISO date-time (not with expiresInDays).")
     },
     (a) => client.keys.issue({
+      ...a.expiresAt ? { expiresAt: a.expiresAt } : {},
       ...a.name ? { name: a.name } : {},
       ...a.scopes ? { scopes: a.scopes } : {},
       ...a.cbids ? { cbids: a.cbids } : {},
       ...a.expiresInDays !== void 0 ? { expiresInDays: a.expiresInDays } : {}
     })
   );
-  tool("revoke_api_key", "Revoke an API key by its prefix. Takes effect immediately; anything using that key stops working.", { prefix: import_zod4.z.string() }, async (a) => {
+  tool("revoke_api_key", "Revoke an API key by its prefix. Takes effect immediately; anything using that key stops working.", { prefix: import_zod5.z.string() }, async (a) => {
     await client.keys.revoke(a.prefix);
     return { revoked: a.prefix };
   });
   tool(
     "import_cookie_declaration",
     "Read a cookie declaration exported from another CMP (OneTrust, Cookiebot, CookieYes, or any CSV/JSON with the same columns) and translate its categories into ours. Nothing is applied \u2014 it comes back for review, with the rows whose category could not be placed listed separately.",
-    { cbid: import_zod4.z.string(), data: import_zod4.z.string().describe("The exported file, as text (CSV or JSON).") },
+    { cbid: import_zod5.z.string(), data: import_zod5.z.string().describe("The exported file, as text (CSV or JSON).") },
     (a) => client.sites.importDeclaration(a.cbid, a.data)
   );
   tool(
     "apply_cookie_import",
     "Import a cookie declaration exported from another CMP AND declare it: every row whose category mapped to ours and that has a purpose becomes a site declaration; the rest come back in `skipped` with the reason. Cookies the site already declared are kept unless overwrite is true. Prefer import_cookie_declaration first to review.",
-    { cbid: import_zod4.z.string(), data: import_zod4.z.string().describe("The exported file, as text (CSV or JSON)."), overwrite: import_zod4.z.boolean().optional() },
+    { cbid: import_zod5.z.string(), data: import_zod5.z.string().describe("The exported file, as text (CSV or JSON)."), overwrite: import_zod5.z.boolean().optional() },
     (a) => client.sites.applyImport(a.cbid, a.data, a.overwrite ? { overwrite: true } : void 0)
   );
   const declarationShape = {
-    category: import_zod4.z.string().describe("necessary, preferences, statistics, marketing, or one of the site\u2019s categories.custom ids."),
-    purpose: import_zod4.z.string().describe("What the cookie does, as visitors will read it \u2014 and the fallback for any language purposes lacks."),
-    purposes: import_zod4.z.record(import_zod4.z.string(), import_zod4.z.string().max(1e3)).nullable().optional().describe('The purpose in other languages, keyed by BCP-47 tag: {"es": "\u2026", "pt-BR": "\u2026"}. The banner, data-cc="declaration" and cookie-declaration.js draw the visitor\u2019s language. null clears.'),
-    provider: import_zod4.z.string().optional(),
-    expiry: import_zod4.z.string().optional().describe('e.g. "Session", "30 days", "1 year" (the banner localises these forms).'),
-    domain: import_zod4.z.string().optional(),
-    pattern: import_zod4.z.boolean().optional().describe("Treat the name as a prefix wildcard (a trailing * does the same).")
+    category: import_zod5.z.string().describe("necessary, preferences, statistics, marketing, or one of the site\u2019s categories.custom ids."),
+    purpose: import_zod5.z.string().describe("What the cookie does, as visitors will read it \u2014 and the fallback for any language purposes lacks."),
+    purposes: import_zod5.z.record(import_zod5.z.string(), import_zod5.z.string().max(1e3)).nullable().optional().describe('The purpose in other languages, keyed by BCP-47 tag: {"es": "\u2026", "pt-BR": "\u2026"}. The banner, data-cc="declaration" and cookie-declaration.js draw the visitor\u2019s language. null clears.'),
+    provider: import_zod5.z.string().optional(),
+    expiry: import_zod5.z.string().optional().describe('e.g. "Session", "30 days", "1 year" (the banner localises these forms).'),
+    domain: import_zod5.z.string().optional(),
+    pattern: import_zod5.z.boolean().optional().describe("Treat the name as a prefix wildcard (a trailing * does the same).")
   };
-  const dryRunArg = import_zod4.z.boolean().optional().describe("Store nothing: answer with the would-be declarations and a diff (added / removed / changed) to check first.");
+  const dryRunArg = import_zod5.z.boolean().optional().describe("Store nothing: answer with the would-be declarations and a diff (added / removed / changed) to check first.");
   tool(
     "declare_cookie",
     'Declare what one of the site\u2019s cookies is. Overrides the scanner, observed visits and the cookie database everywhere the declaration is shown (API, preference modal, data-cc="declaration"). Use for the site\u2019s own cookies the database cannot know. A name ending in * covers every cookie with that prefix.',
-    { cbid: import_zod4.z.string(), name: import_zod4.z.string(), ...declarationShape, dryRun: dryRunArg },
+    { cbid: import_zod5.z.string(), name: import_zod5.z.string(), ...declarationShape, dryRun: dryRunArg },
     (a) => {
       const { cbid: cbid2, name, dryRun, ...rest } = a;
       return client.sites.declareCookie(cbid2, name, rest, dryRun ? { dryRun: true } : void 0);
@@ -1471,7 +1591,7 @@ ${JSON.stringify(r, null, 2)}` : r;
   tool(
     "declare_cookies",
     "Declare many cookies at once. All-or-nothing: one invalid item refuses the whole request and nothing is saved. replace: true also removes every declaration the list does not name.",
-    { cbid: import_zod4.z.string(), cookies: import_zod4.z.array(import_zod4.z.object({ name: import_zod4.z.string(), ...declarationShape })).max(500), replace: import_zod4.z.boolean().optional(), dryRun: dryRunArg },
+    { cbid: import_zod5.z.string(), cookies: import_zod5.z.array(import_zod5.z.object({ name: import_zod5.z.string(), ...declarationShape })).max(500), replace: import_zod5.z.boolean().optional(), dryRun: dryRunArg },
     (a) => {
       const o = { ...a.replace ? { replace: true } : {}, ...a.dryRun ? { dryRun: true } : {} };
       return client.sites.declareCookies(a.cbid, a.cookies, Object.keys(o).length ? o : void 0);
@@ -1480,7 +1600,7 @@ ${JSON.stringify(r, null, 2)}` : r;
   tool(
     "undeclare_cookie",
     "Remove a cookie declaration; the scanned/observed classification applies again.",
-    { cbid: import_zod4.z.string(), name: import_zod4.z.string(), dryRun: dryRunArg },
+    { cbid: import_zod5.z.string(), name: import_zod5.z.string(), dryRun: dryRunArg },
     async (a) => {
       if (a.dryRun) return client.sites.undeclareCookie(a.cbid, a.name, { dryRun: true });
       await client.sites.undeclareCookie(a.cbid, a.name);
@@ -1491,11 +1611,11 @@ ${JSON.stringify(r, null, 2)}` : r;
     "retire_cookie",
     'Retire a cookie the site renamed or stopped setting: it leaves the banner\u2019s cookie list, data-cc="declaration" and the public feed, and stays listed for the owner with retired. A name ending in * retires every cookie with that prefix; the name must match a scanned, observed or declared cookie. If a crawl or a real visit sees it again afterwards, it is listed again with review: retired_but_seen.',
     {
-      cbid: import_zod4.z.string(),
-      name: import_zod4.z.string(),
-      renamedTo: import_zod4.z.string().max(256).optional().describe("The cookie\u2019s new name, if it was renamed."),
-      note: import_zod4.z.string().max(1e3).optional(),
-      dryRun: import_zod4.z.boolean().optional().describe("Store nothing: answer with the would-be retirement and list to check first.")
+      cbid: import_zod5.z.string(),
+      name: import_zod5.z.string(),
+      renamedTo: import_zod5.z.string().max(256).optional().describe("The cookie\u2019s new name, if it was renamed."),
+      note: import_zod5.z.string().max(1e3).optional(),
+      dryRun: import_zod5.z.boolean().optional().describe("Store nothing: answer with the would-be retirement and list to check first.")
     },
     (a) => {
       const input = { ...a.renamedTo ? { renamedTo: a.renamedTo } : {}, ...a.note ? { note: a.note } : {} };
@@ -1505,35 +1625,95 @@ ${JSON.stringify(r, null, 2)}` : r;
   tool(
     "unretire_cookie",
     "Un-retire a cookie: it is listed again everywhere.",
-    { cbid: import_zod4.z.string(), name: import_zod4.z.string(), dryRun: import_zod4.z.boolean().optional().describe("Store nothing: answer with what the list would be.") },
+    { cbid: import_zod5.z.string(), name: import_zod5.z.string(), dryRun: import_zod5.z.boolean().optional().describe("Store nothing: answer with what the list would be.") },
     async (a) => {
       if (a.dryRun) return client.sites.unretireCookie(a.cbid, a.name, { dryRun: true });
       await client.sites.unretireCookie(a.cbid, a.name);
       return { unretired: a.name };
     }
   );
+  tool(
+    "list_cookie_presets",
+    "Declaration presets for the platforms a site is built on (atlas, forumulate, chatly, cookiemunch, referally): each one\u2019s parameters, what it has declared on this site, and whether the vendor\u2019s live manifest can be imported yet. Read-only.",
+    { cbid: import_zod5.z.string() },
+    (a) => client.sites.cookiePresets(a.cbid)
+  );
+  tool(
+    "apply_cookie_preset",
+    "Apply (or re-sync) a vendor preset: declares exactly what that platform writes \u2014 cookies and browser storage, with domain and lifetime \u2014 marked as declared by that vendor. Re-applying removes keys the vendor no longer writes. Names the owner declared are kept (skipped). Atlas needs frontendApiHost (and crossSubdomainCookies, default true); Chatly needs publicId.",
+    {
+      cbid: import_zod5.z.string(),
+      vendor: import_zod5.z.enum(["atlas", "forumulate", "chatly", "cookiemunch", "referally"]),
+      frontendApiHost: import_zod5.z.string().optional().describe("Atlas: your frontend API host, e.g. auth.example.com."),
+      crossSubdomainCookies: import_zod5.z.boolean().optional().describe("Atlas: default true \u2014 the cookies live on the parent domain."),
+      publicId: import_zod5.z.string().optional().describe("Chatly: the channel public id (ch_web_\u2026)."),
+      dragging: import_zod5.z.boolean().optional().describe("Chatly: the launcher can be dragged (adds the drag-position key)."),
+      category: import_zod5.z.string().optional().describe("Chatly: the category for its keys (default necessary). Referally: default the site's referrals category, else marketing."),
+      cookieDomain: import_zod5.z.string().optional().describe("Referally: the domain aff.js sets referally_ctx on, e.g. .example.com. Default the site domain."),
+      cookieDays: import_zod5.z.number().int().min(1).max(400).optional().describe("Referally: how long the cookie lives, 1 to 400 days. Default 60."),
+      dryRun: dryRunArg
+    },
+    (a) => {
+      const params = {};
+      for (const k of ["frontendApiHost", "crossSubdomainCookies", "publicId", "dragging", "category", "cookieDomain", "cookieDays"]) if (a[k] !== void 0) params[k] = a[k];
+      return client.sites.applyCookiePreset(a.cbid, a.vendor, params, a.dryRun ? { dryRun: true } : void 0);
+    }
+  );
+  tool(
+    "remove_cookie_preset",
+    "Remove every declaration a vendor preset made on this site.",
+    { cbid: import_zod5.z.string(), vendor: import_zod5.z.enum(["atlas", "forumulate", "chatly", "cookiemunch", "referally"]), dryRun: dryRunArg },
+    (a) => client.sites.removeCookiePreset(a.cbid, a.vendor, a.dryRun ? { dryRun: true } : void 0)
+  );
+  tool(
+    "delete_observed_cookie",
+    "Remove every stored row of this name that crawls or real visits put in the site\u2019s cookie list (e.g. a name someone reported that the site never sets). A declaration of it stays. If real visits keep reporting it, it comes back quarantined.",
+    { cbid: import_zod5.z.string(), name: import_zod5.z.string(), dryRun: dryRunArg },
+    async (a) => {
+      if (a.dryRun) return client.sites.deleteObservedCookie(a.cbid, a.name, { dryRun: true });
+      await client.sites.deleteObservedCookie(a.cbid, a.name);
+      return { deleted: a.name };
+    }
+  );
+  tool(
+    "purge_observed_cookies",
+    "Purge observed since T: remove every row a real visit first reported at or after `since` (and before `until`). Crawled rows and declarations stay. Rows from before provenance was recorded use their last-seen time, so run with dryRun first.",
+    {
+      cbid: import_zod5.z.string(),
+      since: import_zod5.z.union([import_zod5.z.string(), import_zod5.z.number()]).describe("ISO-8601 time or epoch milliseconds."),
+      until: import_zod5.z.union([import_zod5.z.string(), import_zod5.z.number()]).optional().describe("Optional end of the window (exclusive)."),
+      dryRun: dryRunArg
+    },
+    (a) => client.sites.purgeObservedCookies(
+      a.cbid,
+      { since: a.since, ...a.until !== void 0 ? { until: a.until } : {} },
+      a.dryRun ? { dryRun: true } : void 0
+    )
+  );
   tool(
     "get_blocked_pages",
     "Pages where the embed could not load its banner renderer \u2014 the page\u2019s Content Security Policy or Trusted Types policy refused it, so nobody there can be asked for consent. An empty list is healthy. Read-only.",
-    { cbid: import_zod4.z.string() },
+    { cbid: import_zod5.z.string() },
     (a) => client.sites.blocked(a.cbid)
   );
   tool(
     "roll_api_key",
     "Rotate an API key: returns a new secret once, with the same name, scopes, property lock and expiry. The old secret stops working immediately \u2014 if it is the key this server runs with, this server stops working too until it is reconfigured.",
-    { prefix: import_zod4.z.string() },
+    { prefix: import_zod5.z.string() },
     (a) => client.keys.roll(a.prefix)
   );
   tool(
     "update_api_key",
-    "Rename an API key, or replace its scopes or the properties it is locked to. Only the fields given change; the secret does not.",
+    "Rename an API key, replace its scopes or the properties it is locked to, or set or remove its expiry. Only the fields given change; the secret does not.",
     {
-      prefix: import_zod4.z.string(),
-      name: import_zod4.z.string().optional(),
-      scopes: import_zod4.z.array(import_zod4.z.string()).optional(),
-      cbids: import_zod4.z.array(import_zod4.z.string()).min(1).optional()
+      prefix: import_zod5.z.string(),
+      name: import_zod5.z.string().optional(),
+      scopes: import_zod5.z.array(import_zod5.z.string()).optional(),
+      cbids: import_zod5.z.array(import_zod5.z.string()).min(1).optional(),
+      expiresAt: import_zod5.z.string().nullable().optional().describe("A new expiry (ISO date-time), or null to remove it.")
     },
     (a) => client.keys.update(a.prefix, {
+      ...a.expiresAt !== void 0 ? { expiresAt: a.expiresAt } : {},
       ...a.name !== void 0 ? { name: a.name } : {},
       ...a.scopes ? { scopes: a.scopes } : {},
       ...a.cbids ? { cbids: a.cbids } : {}
@@ -1543,7 +1723,7 @@ ${JSON.stringify(r, null, 2)}` : r;
   tool(
     "update_org",
     "Rename your organisation or set its logo. logoUrl: null removes the logo; upload an image with upload_asset to get a URL. Deleting the organisation is not possible here.",
-    { name: import_zod4.z.string().min(1).optional(), logoUrl: import_zod4.z.string().nullable().optional() },
+    { name: import_zod5.z.string().min(1).optional(), logoUrl: import_zod5.z.string().nullable().optional() },
     (a) => client.org.update({
       ...a.name !== void 0 ? { name: a.name } : {},
       ...a.logoUrl !== void 0 ? { logoUrl: a.logoUrl } : {}
@@ -1559,20 +1739,20 @@ ${JSON.stringify(r, null, 2)}` : r;
     "set_mail_provider",
     "Connect your own mail provider for rights-request mail \u2014 recommended, so codes come from your own domain. Replaces the stored one. It carries mail only after test_mail_provider succeeds; every save clears that. Omit secret to keep the stored one (same provider only).",
     {
-      provider: import_zod4.z.enum(["brevo", "sendgrid", "postmark", "resend", "ses", "smtp"]),
-      fromEmail: import_zod4.z.string().describe("An address on a domain your provider has verified."),
-      fromName: import_zod4.z.string().max(100).nullable().optional(),
-      replyTo: import_zod4.z.string().nullable().optional(),
-      secret: import_zod4.z.string().optional().describe("API key (Brevo, SendGrid, Resend), server token (Postmark), secret access key (SES) or SMTP password. Write-only."),
-      ses: import_zod4.z.object({ region: import_zod4.z.string(), accessKeyId: import_zod4.z.string() }).optional().describe("Required for ses."),
-      smtp: import_zod4.z.object({ host: import_zod4.z.string(), port: import_zod4.z.union([import_zod4.z.literal(25), import_zod4.z.literal(465), import_zod4.z.literal(587), import_zod4.z.literal(2525)]), security: import_zod4.z.enum(["tls", "starttls"]), username: import_zod4.z.string() }).optional().describe("Required for smtp. TLS is always required.")
+      provider: import_zod5.z.enum(["brevo", "sendgrid", "postmark", "resend", "ses", "smtp"]),
+      fromEmail: import_zod5.z.string().describe("An address on a domain your provider has verified."),
+      fromName: import_zod5.z.string().max(100).nullable().optional(),
+      replyTo: import_zod5.z.string().nullable().optional(),
+      secret: import_zod5.z.string().optional().describe("API key (Brevo, SendGrid, Resend), server token (Postmark), secret access key (SES) or SMTP password. Write-only."),
+      ses: import_zod5.z.object({ region: import_zod5.z.string(), accessKeyId: import_zod5.z.string() }).optional().describe("Required for ses."),
+      smtp: import_zod5.z.object({ host: import_zod5.z.string(), port: import_zod5.z.union([import_zod5.z.literal(25), import_zod5.z.literal(465), import_zod5.z.literal(587), import_zod5.z.literal(2525)]), security: import_zod5.z.enum(["tls", "starttls"]), username: import_zod5.z.string() }).optional().describe("Required for smtp. TLS is always required.")
     },
     (a) => client.org.mailProvider.set(a)
   );
   tool(
     "test_mail_provider",
     "Send a test message through your own mail provider (never Cookie Munch\u2019s) and report what it answered. Success marks the configuration verified, after which it carries all rights mail.",
-    { to: import_zod4.z.string().optional().describe("Recipient. Default: the reply-to, else the from address.") },
+    { to: import_zod5.z.string().optional().describe("Recipient. Default: the reply-to, else the from address.") },
     (a) => client.org.mailProvider.test(a.to)
   );
   tool(
@@ -1586,11 +1766,11 @@ ${JSON.stringify(r, null, 2)}` : r;
   );
   const CAPTCHA_OFF = "Off removes spam protection beyond the hidden spam-trap field, the rate limits and the email code: expect more spam requests. Own keys are recommended.";
   const captchaInput = {
-    mode: import_zod4.z.enum(["own", "off"]).describe(`own: your own captcha provider keys (recommended). off: no captcha. ${CAPTCHA_OFF}`),
-    provider: import_zod4.z.enum(["turnstile", "hcaptcha", "recaptcha_v2", "recaptcha_v3"]).optional().describe("Required for own."),
-    siteKey: import_zod4.z.string().optional().describe("Required for own: the public site key. List your rights-page hostnames on it at the provider."),
-    secret: import_zod4.z.string().optional().describe("The provider secret key. Write-only; never returned. Omit to keep the stored one (same provider)."),
-    minScore: import_zod4.z.number().min(0.1).max(0.9).optional().describe("reCAPTCHA v3 only. Default 0.5.")
+    mode: import_zod5.z.enum(["own", "off"]).describe(`own: your own captcha provider keys (recommended). off: no captcha. ${CAPTCHA_OFF}`),
+    provider: import_zod5.z.enum(["turnstile", "hcaptcha", "recaptcha_v2", "recaptcha_v3"]).optional().describe("Required for own."),
+    siteKey: import_zod5.z.string().optional().describe("Required for own: the public site key. List your rights-page hostnames on it at the provider."),
+    secret: import_zod5.z.string().optional().describe("The provider secret key. Write-only; never returned. Omit to keep the stored one (same provider)."),
+    minScore: import_zod5.z.number().min(0.1).max(0.9).optional().describe("reCAPTCHA v3 only. Default 0.5.")
   };
   const captchaBody = (a) => ({
     mode: a.mode,
@@ -1602,19 +1782,19 @@ ${JSON.stringify(r, null, 2)}` : r;
   tool(
     "get_rights_captcha",
     "The captcha on a site\u2019s hosted rights page: its own setting, else the organisation default, else off (`source` says which). Never returns the secret. Read-only.",
-    { cbid: import_zod4.z.string() },
+    { cbid: import_zod5.z.string() },
     (a) => client.rightsCaptcha.get(a.cbid)
   );
   tool(
     "set_rights_captcha",
     `Set a site\u2019s rights-page captcha: your own Turnstile, hCaptcha or reCAPTCHA keys (recommended; the provider must accept the secret before it is saved), or off. ${CAPTCHA_OFF} Audited with the old and new mode.`,
-    { cbid: import_zod4.z.string(), ...captchaInput },
+    { cbid: import_zod5.z.string(), ...captchaInput },
     (a) => client.rightsCaptcha.set(a.cbid, captchaBody(a))
   );
   tool(
     "remove_rights_captcha",
     "Remove a site\u2019s own captcha setting: it inherits the organisation default again (or off). Returns the setting now in force.",
-    { cbid: import_zod4.z.string() },
+    { cbid: import_zod5.z.string() },
     (a) => client.rightsCaptcha.remove(a.cbid)
   );
   tool(
@@ -1637,15 +1817,15 @@ ${JSON.stringify(r, null, 2)}` : r;
   );
   const IDENTITY_NOTE = "The JWKS is fetched and checked before anything is saved. The session token must carry the email and a verified-email claim (default email_verified) set to true (Clerk: add email: {{user.primary_email_address}} to the session token; Clerk documents no claim for whether that address is verified, so either add your own or set trustEmailClaim). oidc_jwt needs an audience or authorizedParties.";
   const identityInput = {
-    type: import_zod4.z.enum(["clerk", "atlas", "oidc_jwt"]).describe("clerk, atlas (Clerk-shaped), or oidc_jwt (any issuer that signs session JWTs with a published JWKS)."),
-    issuer: import_zod4.z.string().describe("https URL exactly as in the token\u2019s iss (Clerk: your Frontend API URL)."),
-    jwksUrl: import_zod4.z.string().optional().describe("Required for oidc_jwt; clerk/atlas default to <issuer>/.well-known/jwks.json."),
-    audience: import_zod4.z.string().optional().describe("Expected aud. For oidc_jwt an audience or authorizedParties is required (a shared issuer mints tokens for every app)."),
-    authorizedParties: import_zod4.z.array(import_zod4.z.string()).optional().describe("Your own origins (https://www.example.com) the token\u2019s azp must be one of. Required for clerk and atlas; for oidc_jwt when there is no audience."),
-    emailClaim: import_zod4.z.string().optional().describe("Default email."),
-    emailVerifiedClaim: import_zod4.z.string().optional().describe("Default email_verified; must be exactly true."),
-    sessionCookieName: import_zod4.z.string().optional().describe("Default __session: the cookie the hosted page on your custom domain reads."),
-    trustEmailClaim: import_zod4.z.boolean().optional().describe("clerk/atlas only, default false. True: a token without the verified claim is accepted, its email claim taken as verified. Set only if every address your provider puts in that claim is verified.")
+    type: import_zod5.z.enum(["clerk", "atlas", "oidc_jwt"]).describe("clerk, atlas (Clerk-shaped), or oidc_jwt (any issuer that signs session JWTs with a published JWKS)."),
+    issuer: import_zod5.z.string().describe("https URL exactly as in the token\u2019s iss (Clerk: your Frontend API URL)."),
+    jwksUrl: import_zod5.z.string().optional().describe("Required for oidc_jwt; clerk/atlas default to <issuer>/.well-known/jwks.json."),
+    audience: import_zod5.z.string().optional().describe("Expected aud. For oidc_jwt an audience or authorizedParties is required (a shared issuer mints tokens for every app)."),
+    authorizedParties: import_zod5.z.array(import_zod5.z.string()).optional().describe("Your own origins (https://www.example.com) the token\u2019s azp must be one of. Required for clerk and atlas; for oidc_jwt when there is no audience."),
+    emailClaim: import_zod5.z.string().optional().describe("Default email."),
+    emailVerifiedClaim: import_zod5.z.string().optional().describe("Default email_verified; must be exactly true."),
+    sessionCookieName: import_zod5.z.string().optional().describe("Default __session: the cookie the hosted page on your custom domain reads."),
+    trustEmailClaim: import_zod5.z.boolean().optional().describe("clerk/atlas only, default false. True: a token without the verified claim is accepted, its email claim taken as verified. Set only if every address your provider puts in that claim is verified.")
   };
   const identityBody = (a) => {
     const out = { type: a.type, issuer: a.issuer };
@@ -1655,19 +1835,19 @@ ${JSON.stringify(r, null, 2)}` : r;
   tool(
     "get_rights_identity",
     "The sign-in provider a site\u2019s rights requests are verified with: its own setting, else the organisation default, else none (`source` says which). Read-only.",
-    { cbid: import_zod4.z.string() },
+    { cbid: import_zod5.z.string() },
     (a) => client.rightsIdentity.get(a.cbid)
   );
   tool(
     "set_rights_identity",
     `Connect a site\u2019s sign-in provider so a visitor signed in to the site is verified by their session, with no code mail. ${IDENTITY_NOTE} Audited.`,
-    { cbid: import_zod4.z.string(), ...identityInput },
+    { cbid: import_zod5.z.string(), ...identityInput },
     (a) => client.rightsIdentity.set(a.cbid, identityBody(a))
   );
   tool(
     "remove_rights_identity",
     "Remove a site\u2019s own sign-in provider: it inherits the organisation default again (or none). Returns the setting now in force.",
-    { cbid: import_zod4.z.string() },
+    { cbid: import_zod5.z.string() },
     (a) => client.rightsIdentity.remove(a.cbid)
   );
   tool(
@@ -1691,22 +1871,22 @@ ${JSON.stringify(r, null, 2)}` : r;
   tool(
     "get_audit_log",
     "The organisation\u2019s audit log, newest first: administrative changes made in the dashboard or through the API, and who made them. Read-only.",
-    { limit: import_zod4.z.number().int().min(1).max(500).optional() },
+    { limit: import_zod5.z.number().int().min(1).max(500).optional() },
     (a) => client.audit(a.limit)
   );
   tool(
     "upload_asset",
     "Upload an image \u2014 a banner logo \u2014 and get its public URL. data is base64 (a data: URL also works); PNG, JPEG, WebP, GIF or SVG, up to 1,000,000 bytes.",
     {
-      data: import_zod4.z.string(),
-      contentType: import_zod4.z.enum(["image/png", "image/jpeg", "image/webp", "image/gif", "image/svg+xml"])
+      data: import_zod5.z.string(),
+      contentType: import_zod5.z.enum(["image/png", "image/jpeg", "image/webp", "image/gif", "image/svg+xml"])
     },
     (a) => client.assets.upload({ data: a.data, contentType: a.contentType })
   );
   tool(
     "delete_asset",
     "Delete a stored image by its URL (or file name). Only your own organisation\u2019s images can be named.",
-    { url: import_zod4.z.string().describe("The URL upload_asset returned, or just its file name.") },
+    { url: import_zod5.z.string().describe("The URL upload_asset returned, or just its file name.") },
     async (a) => {
       await client.assets.delete(a.url);
       return { deleted: a.url };
@@ -1721,18 +1901,18 @@ ${JSON.stringify(r, null, 2)}` : r;
   tool(
     "get_customer",
     "One child org: its controller details and usage. Read-only.",
-    { id: import_zod4.z.string() },
+    { id: import_zod5.z.string() },
     (a) => client.reseller.get(a.id)
   );
   tool(
     "provision_customer",
     "Create a new child org under this reseller. With `mintKey`, its first API key is returned once. Counts toward the reseller plan\u2019s pooled limits.",
     {
-      name: import_zod4.z.string(),
-      ownerEmail: import_zod4.z.string().optional(),
-      delegatedAccess: import_zod4.z.boolean().optional().describe("Whether this reseller may act inside the child."),
-      mintKey: import_zod4.z.boolean().optional(),
-      keyScopes: import_zod4.z.array(import_zod4.z.string()).optional()
+      name: import_zod5.z.string(),
+      ownerEmail: import_zod5.z.string().optional(),
+      delegatedAccess: import_zod5.z.boolean().optional().describe("Whether this reseller may act inside the child."),
+      mintKey: import_zod5.z.boolean().optional(),
+      keyScopes: import_zod5.z.array(import_zod5.z.string()).optional()
     },
     (a) => client.reseller.create({
       name: a.name,
@@ -1746,10 +1926,10 @@ ${JSON.stringify(r, null, 2)}` : r;
     "update_customer",
     "Change a child org\u2019s status, delegated access or DSAR routing. `dsarRouting: null` clears the override.",
     {
-      id: import_zod4.z.string(),
-      status: import_zod4.z.enum(["active", "suspended"]).optional(),
-      delegatedAccess: import_zod4.z.boolean().optional(),
-      dsarRouting: import_zod4.z.enum(["reseller", "child"]).nullable().optional()
+      id: import_zod5.z.string(),
+      status: import_zod5.z.enum(["active", "suspended"]).optional(),
+      delegatedAccess: import_zod5.z.boolean().optional(),
+      dsarRouting: import_zod5.z.enum(["reseller", "child"]).nullable().optional()
     },
     (a) => client.reseller.update(a.id, {
       ...a.status ? { status: a.status } : {},
@@ -1760,7 +1940,7 @@ ${JSON.stringify(r, null, 2)}` : r;
   tool(
     "suspend_customer",
     "Suspend a child org: it stops ingesting consent and its keys stop working, and it can be reactivated with update_customer. Its data is kept. (Permanent deletion is deliberately not available here.)",
-    { id: import_zod4.z.string() },
+    { id: import_zod5.z.string() },
     async (a) => {
       await client.reseller.deprovision(a.id);
       return { suspended: a.id };
@@ -1769,85 +1949,87 @@ ${JSON.stringify(r, null, 2)}` : r;
   tool(
     "list_customer_keys",
     "A child org's API key prefixes. Never the secrets. Read-only.",
-    { id: import_zod4.z.string() },
+    { id: import_zod5.z.string() },
     (a) => client.reseller.listKeys(a.id)
   );
   tool(
     "issue_customer_key",
     "Mint an API key for a child org. The secret is returned once. Prefer scopes and a property lock over a full-access key.",
-    { id: import_zod4.z.string(), name: import_zod4.z.string().optional(), scopes: import_zod4.z.array(import_zod4.z.string()).optional(), cbids: import_zod4.z.array(import_zod4.z.string()).min(1).optional() },
+    { id: import_zod5.z.string(), name: import_zod5.z.string().optional(), scopes: import_zod5.z.array(import_zod5.z.string()).optional(), cbids: import_zod5.z.array(import_zod5.z.string()).min(1).optional() },
     (a) => client.reseller.mintKey(a.id, {
       ...a.name ? { name: a.name } : {},
       ...a.scopes ? { scopes: a.scopes } : {},
       ...a.cbids ? { cbids: a.cbids } : {}
     })
   );
-  tool("revoke_customer_key", "Revoke a child org's API key by prefix. Takes effect immediately.", { id: import_zod4.z.string(), prefix: import_zod4.z.string() }, async (a) => {
+  tool("revoke_customer_key", "Revoke a child org's API key by prefix. Takes effect immediately.", { id: import_zod5.z.string(), prefix: import_zod5.z.string() }, async (a) => {
     await client.reseller.revokeKey(a.id, a.prefix);
     return { revoked: a.prefix };
   });
   tool(
     "erase_subject_data",
     "IRREVERSIBLY crypto-erase a data subject's consent records by their consent-receipt stamp (GDPR/CCPA deletion). Destroys the encryption key; the tamper-evident chain stays intact.",
-    { cbid: import_zod4.z.string(), stamp: import_zod4.z.string() },
+    { cbid: import_zod5.z.string(), stamp: import_zod5.z.string() },
     (a) => client.consent.eraseSubject(a.cbid, a.stamp)
   );
   tool(
     "export_subject_data",
     "Export a data subject's consent records (GDPR access/portability).",
-    { cbid: import_zod4.z.string(), stamp: import_zod4.z.string() },
+    { cbid: import_zod5.z.string(), stamp: import_zod5.z.string() },
     (a) => client.consent.exportSubject(a.cbid, a.stamp)
   );
   tool("list_banners", "List reusable banner designs in your org.", {}, () => client.banners.list());
   tool(
     "create_banner",
     "Create a reusable banner design.",
-    { name: import_zod4.z.string(), json: import_zod4.z.record(import_zod4.z.unknown()).describe("A v2 BannerConfig.") },
+    { name: import_zod5.z.string(), json: import_zod5.z.record(import_zod5.z.unknown()).describe("A v2 BannerConfig.") },
     (a) => client.banners.create({ name: a.name, json: a.json })
   );
-  tool("get_banner", "Get a banner design by id.", { id: import_zod4.z.string() }, (a) => client.banners.get(a.id));
+  tool("get_banner", "Get a banner design by id.", { id: import_zod5.z.string() }, (a) => client.banners.get(a.id));
   tool(
     "update_banner",
     "Update a banner design (name and/or config).",
-    { id: import_zod4.z.string(), name: import_zod4.z.string().optional(), json: import_zod4.z.record(import_zod4.z.unknown()).optional() },
+    { id: import_zod5.z.string(), name: import_zod5.z.string().optional(), json: import_zod5.z.record(import_zod5.z.unknown()).optional() },
     (a) => client.banners.update(a.id, {
       ...a.name !== void 0 ? { name: a.name } : {},
       ...a.json !== void 0 ? { json: a.json } : {}
     })
   );
-  tool("delete_banner", "Delete a banner design (fails if assigned to sites).", { id: import_zod4.z.string() }, async (a) => {
+  tool("delete_banner", "Delete a banner design (fails if assigned to sites).", { id: import_zod5.z.string() }, async (a) => {
     await client.banners.delete(a.id);
     return { ok: true };
   });
   tool(
     "get_banner_assignments",
     "The sites (cbids) a banner design is currently assigned to. Read-only.",
-    { id: import_zod4.z.string() },
+    { id: import_zod5.z.string() },
     (a) => client.banners.assignments(a.id)
   );
   tool(
     "assign_banner",
     "Set which sites (cbids) use a banner design.",
-    { id: import_zod4.z.string(), cbids: import_zod4.z.array(import_zod4.z.string()) },
+    { id: import_zod5.z.string(), cbids: import_zod5.z.array(import_zod5.z.string()) },
     (a) => client.banners.setAssignments(a.id, a.cbids)
   );
   tool(
     "publish_banner",
     "Publish a design live to all its assigned sites.",
-    { id: import_zod4.z.string() },
+    { id: import_zod5.z.string() },
     (a) => client.banners.publish(a.id)
   );
 }
 
 // src/index.ts
+var MCP_VERSION = "0.4.1";
 function createCookieMunchMcp(opts) {
-  const client = opts.client ?? (0, import_sdk.createCookieMunch)({ apiKey: opts.apiKey, baseUrl: opts.baseUrl });
+  const client = opts.client ?? (0, import_sdk.createCookieMunch)({ apiKey: opts.apiKey, baseUrl: opts.baseUrl, userAgent: opts.userAgent ?? `cookiemunch-mcp/${MCP_VERSION}` });
   const server = new import_mcp.McpServer({ name: "cookiemunch", version: "1.0.0" });
   registerTools(server, client);
   return server;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  MCP_VERSION,
   createCookieMunchMcp,
   registerTools
 });