npm - mcpscraper-cli - Versions diffs - 0.29.7 → 0.29.8 - Mend

mcpscraper-cli 0.29.7 → 0.29.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3) hide show

package/dist/bin/cli.js CHANGED Viewed

@@ -10,7 +10,7 @@ import { randomUUID } from "crypto";
 import { ScraperClient, ScraperApiError } from "mcpscraper-sdk";
 // src/version.ts
-var CLI_VERSION = "0.29.7";
+var CLI_VERSION = "0.29.8";
 // src/generated-tools.ts
 var MCP_TOOL_CATALOG = [
@@ -719,6 +719,41 @@ var MCP_TOOL_CATALOG = [
       "openWorldHint": false
     }
   },
+  {
+    "name": "analytics_archive_event_definition",
+    "category": "analytics",
+    "title": "Archive Browser Event Definition",
+    "description": "Idempotently archive a browser event definition so the Pixel no longer receives it.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "siteId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Analytics Site id returned by analytics_list_sites."
+        },
+        "definitionId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Event definition id returned by analytics_list_event_definitions."
+        }
+      },
+      "required": [
+        "siteId",
+        "definitionId"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Archive Browser Event Definition",
+      "readOnlyHint": false,
+      "destructiveHint": true,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
+  },
   {
     "name": "analytics_create_activation_destination",
     "category": "analytics",
@@ -750,20 +785,24 @@ var MCP_TOOL_CATALOG = [
           "description": "Human-readable name for the record being created or updated."
         },
         "connectionRef": {
-          "description": "Existing provider connection reference authorized for this analytics account.",
           "type": "string",
-          "maxLength": 240
+          "minLength": 1,
+          "maxLength": 240,
+          "description": "Existing provider connection reference authorized for this analytics account."
         },
         "externalDatasetId": {
-          "description": "Optional provider dataset identifier already owned by the connected account.",
           "type": "string",
-          "maxLength": 240
+          "minLength": 1,
+          "maxLength": 240,
+          "description": "Provider destination identifier already owned by the connected account."
         }
       },
       "required": [
         "siteId",
         "platform",
-        "name"
+        "name",
+        "connectionRef",
+        "externalDatasetId"
       ],
       "$schema": "https://json-schema.org/draft/2020-12/schema"
     },
@@ -870,10 +909,10 @@ var MCP_TOOL_CATALOG = [
     }
   },
   {
-    "name": "analytics_create_export",
+    "name": "analytics_create_connection",
     "category": "analytics",
-    "title": "Create Analytics Export",
-    "description": "Create a persisted, versioned CSV, JSON, or Markdown analytics artifact. Supply a caller-owned idempotencyKey and reuse it only when retrying the same logical export.",
+    "title": "Create X-Ray Connection",
+    "description": "Create a CallRail, CallTrackingMetrics, Twilio, HubSpot, HighLevel, or generic CRM connection. Creation is configured-unverified until a signed receipt succeeds.",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -883,176 +922,71 @@ var MCP_TOOL_CATALOG = [
           "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
           "description": "Analytics Site id returned by analytics_list_sites."
         },
-        "start": {
-          "description": "Inclusive ISO 8601 report start. Omit with end to use the last 30 days.",
-          "type": "string",
-          "format": "date-time",
-          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
-        },
-        "end": {
-          "description": "Exclusive ISO 8601 report end. Omit with start to use now.",
-          "type": "string",
-          "format": "date-time",
-          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
-        },
-        "pixelIds": {
-          "description": "Optional Pixel ids belonging to this Site. Omit for every active Pixel.",
-          "maxItems": 20,
-          "type": "array",
-          "items": {
-            "type": "string",
-            "format": "uuid",
-            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
-          }
-        },
-        "hostnames": {
-          "description": "Optional approved detected hostnames within the selected Pixels.",
-          "maxItems": 20,
-          "type": "array",
-          "items": {
-            "type": "string",
-            "minLength": 1,
-            "maxLength": 253
-          }
-        },
-        "source": {
-          "description": "Optional source or provenance constraint appropriate to this tool; omit when no source restriction is intended.",
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 180
-        },
-        "medium": {
-          "description": "Exact normalized campaign medium used to filter or label analytics data.",
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 180
-        },
-        "campaign": {
-          "description": "Exact normalized campaign value used to filter or label analytics data.",
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 240
-        },
-        "eventName": {
-          "description": "Optional normalized analytics event-name filter.",
-          "type": "string",
-          "pattern": "^[a-z][a-z0-9_]{1,79}$"
-        },
-        "attributionModel": {
-          "default": "first_touch",
-          "description": "Attribution model applied to the report; defaults to first touch.",
-          "type": "string",
-          "enum": [
-            "first_touch",
-            "last_touch"
-          ]
-        },
-        "channelFamily": {
-          "description": "Optional normalized acquisition-channel family filter.",
+        "provider": {
           "type": "string",
           "enum": [
-            "llm",
-            "social",
-            "review",
-            "search",
-            "email",
-            "referral",
-            "direct",
-            "other"
-          ]
-        },
-        "platform": {
-          "description": "Normalized external platform selected for this operation.",
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 180
+            "callrail",
+            "calltrackingmetrics",
+            "twilio",
+            "hubspot",
+            "highlevel",
+            "generic_crm"
+          ],
+          "description": "Supported phone, CRM, or advertising provider for this governed connection."
         },
-        "referrer": {
-          "description": "Optional exact or normalized referrer filter for analytics rows.",
+        "name": {
           "type": "string",
           "minLength": 1,
-          "maxLength": 500
-        },
-        "path": {
-          "description": "Exact path value used by this tool; preserve its leading slash or vault-relative form as required.",
-          "type": "string",
-          "maxLength": 2e3,
-          "pattern": "^\\/.*"
-        },
-        "deviceClass": {
-          "description": "Optional normalized device-class filter.",
-          "type": "string",
-          "enum": [
-            "desktop",
-            "tablet",
-            "mobile",
-            "unknown"
-          ]
-        },
-        "countryCode": {
-          "description": "Two-letter country code used to filter analytics rows.",
-          "type": "string",
-          "minLength": 2,
-          "maxLength": 2
+          "maxLength": 120,
+          "description": "Human-readable name for the record being created or updated."
         },
-        "regionCode": {
-          "description": "Optional regional subdivision code filter.",
+        "sourceAccountRef": {
           "type": "string",
           "minLength": 1,
-          "maxLength": 8
-        },
-        "conversionKind": {
-          "description": "Optional normalized conversion event kind filter.",
-          "type": "string",
-          "pattern": "^[a-z][a-z0-9_]{1,79}$"
-        },
-        "report": {
-          "default": "overview",
-          "description": "Analytics report family to render into the exported artifact.",
-          "type": "string",
-          "enum": [
-            "overview",
-            "acquisition",
-            "content",
-            "conversions"
-          ]
+          "maxLength": 240,
+          "description": "Stable non-secret account identifier at the phone, CRM, or event source."
         },
-        "format": {
-          "default": "markdown",
-          "description": "Artifact serialization format to generate.",
+        "serviceConnectionRef": {
+          "description": "Optional MCP Scraper connected-service identifier used for governed provider actions.",
           "type": "string",
-          "enum": [
-            "csv",
-            "json",
-            "markdown"
-          ]
+          "maxLength": 240
         },
-        "idempotencyKey": {
+        "webhookSecret": {
+          "description": "Provider webhook validation secret; it is encrypted at rest and never returned.",
           "type": "string",
           "minLength": 8,
-          "maxLength": 160,
-          "description": "Caller-owned opaque key for this intended operation; reuse only when retrying the same operation."
+          "maxLength": 1e3
+        },
+        "config": {
+          "description": "Validated renderer configuration for the new immutable template version; arbitrary code is rejected.",
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {}
         }
       },
       "required": [
         "siteId",
-        "idempotencyKey"
+        "provider",
+        "name",
+        "sourceAccountRef"
       ],
       "$schema": "https://json-schema.org/draft/2020-12/schema"
     },
     "annotations": {
-      "title": "Create Analytics Export",
+      "title": "Create X-Ray Connection",
       "readOnlyHint": false,
       "destructiveHint": false,
-      "idempotentHint": true,
+      "idempotentHint": false,
       "openWorldHint": false
     }
   },
   {
-    "name": "analytics_create_form",
+    "name": "analytics_create_conversion_rule",
     "category": "analytics",
-    "title": "Create Pixel-linked Form",
-    "description": "Create and optionally publish a branded form that inherits the parent Pixel identity and session.",
+    "title": "Create Conversion Rule",
+    "description": "Create a versioned declarative conversion rule. This is a safe event-routing layer, not arbitrary JavaScript like Google Tag Manager.",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -1062,141 +996,253 @@ var MCP_TOOL_CATALOG = [
           "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
           "description": "Analytics Site id returned by analytics_list_sites."
         },
-        "pixelId": {
-          "type": "string",
-          "format": "uuid",
-          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
-          "description": "Analytics Pixel id belonging to the selected Site."
-        },
         "name": {
           "type": "string",
           "minLength": 1,
           "maxLength": 120,
           "description": "Human-readable name for the record being created or updated."
         },
-        "fields": {
-          "minItems": 1,
-          "maxItems": 30,
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "id": {
+        "conversionKind": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9_]{1,79}$",
+          "description": "Optional normalized conversion event kind filter."
+        },
+        "condition": {
+          "type": "object",
+          "properties": {
+            "eventName": {
+              "description": "Optional normalized analytics event-name filter.",
+              "type": "string",
+              "pattern": "^[a-z][a-z0-9_]{1,79}$"
+            },
+            "eventKind": {
+              "description": "Canonical event family used for journey storage and conversion-rule evaluation.",
+              "type": "string",
+              "enum": [
+                "browser",
+                "form",
+                "call",
+                "crm",
+                "transaction",
+                "custom_server",
+                "conversion",
+                "delivery"
+              ]
+            },
+            "source": {
+              "description": "Optional source or provenance constraint appropriate to this tool; omit when no source restriction is intended.",
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 80
+            },
+            "stageId": {
+              "description": "Exact CRM stage identifier required for the conversion rule to match.",
+              "type": "string",
+              "maxLength": 240
+            },
+            "status": {
+              "description": "Lifecycle status used to filter or update the selected records.",
+              "type": "string",
+              "enum": [
+                "open",
+                "won",
+                "lost",
+                "spam",
+                "unknown"
+              ]
+            },
+            "answered": {
+              "description": "Optional call-answer state required for this conversion rule to match.",
+              "type": "boolean"
+            },
+            "minimumCallDurationSeconds": {
+              "description": "Minimum connected call duration required for the conversion rule to match.",
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 86400
+            },
+            "excludedTags": {
+              "default": [],
+              "description": "Event tags that prevent this conversion rule from matching, such as spam.",
+              "maxItems": 30,
+              "type": "array",
+              "items": {
                 "type": "string",
-                "pattern": "^[a-z][a-z0-9_]{0,47}$",
-                "description": "Stable identifier for this nested record."
-              },
-              "type": {
+                "maxLength": 80
+              }
+            },
+            "requiredTags": {
+              "default": [],
+              "description": "Event tags that must all be present before this conversion rule matches.",
+              "maxItems": 30,
+              "type": "array",
+              "items": {
                 "type": "string",
-                "enum": [
-                  "text",
-                  "email",
-                  "tel",
-                  "textarea",
-                  "select",
-                  "checkbox",
-                  "radio",
-                  "number"
-                ],
-                "description": "Governed content or record type used for routing and validation."
-              },
-              "label": {
-                "type": "string",
-                "minLength": 1,
-                "maxLength": 120,
-                "description": "Human-readable label displayed for this field, link, or section."
-              },
-              "required": {
-                "type": "boolean",
-                "description": "Whether the form field must be completed before submission."
-              },
-              "options": {
-                "description": "Allowed selectable values for this form field.",
-                "maxItems": 30,
-                "type": "array",
-                "items": {
-                  "type": "string",
-                  "minLength": 1,
-                  "maxLength": 120
-                }
+                "maxLength": 80
               }
-            },
-            "required": [
-              "id",
-              "type",
-              "label",
-              "required"
-            ]
+            }
           },
-          "description": "Ordered form-field definitions to render and validate for submissions."
+          "description": "Declarative event conditions that must match before X-Ray creates a conversion."
         },
-        "brand": {
+        "defaultValueMinor": {
+          "description": "Optional default conversion value in the currency minor unit.",
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "defaultCurrency": {
+          "default": "USD",
+          "description": "Three-letter default currency code used when a matched event has no value currency.",
+          "type": "string",
+          "minLength": 3,
+          "maxLength": 3
+        },
+        "enabled": {
+          "default": true,
+          "description": "Whether the new rule should begin evaluating events immediately.",
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "siteId",
+        "name",
+        "conversionKind",
+        "condition"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Create Conversion Rule",
+      "readOnlyHint": false,
+      "destructiveHint": false,
+      "idempotentHint": false,
+      "openWorldHint": false
+    }
+  },
+  {
+    "name": "analytics_create_event_definition",
+    "category": "analytics",
+    "title": "Create Browser Event Definition",
+    "description": "Create a declarative page, click, or third-party form-submit event tag without injecting arbitrary JavaScript or capturing form fields.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "siteId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Analytics Site id returned by analytics_list_sites."
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 120,
+          "description": "Human-readable definition name unique within the Site."
+        },
+        "eventName": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9_]{1,79}$",
+          "description": "Canonical event name emitted when this definition matches."
+        },
+        "triggerKind": {
+          "type": "string",
+          "enum": [
+            "page",
+            "click",
+            "form",
+            "semantic"
+          ],
+          "description": "Declarative browser trigger. Semantic uses a data-xray-event tag."
+        },
+        "path": {
+          "description": "URL path required for page triggers.",
+          "type": "string",
+          "maxLength": 2e3,
+          "pattern": "^\\/.*"
+        },
+        "pathMatch": {
+          "default": "exact",
+          "description": "Whether the page path must equal or begin with path.",
+          "type": "string",
+          "enum": [
+            "exact",
+            "prefix"
+          ]
+        },
+        "selector": {
+          "description": "CSS selector evaluated only by the first-party Pixel for click or form triggers.",
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 500
+        },
+        "hostnames": {
+          "default": [],
+          "description": "Optional approved bare hostnames. Empty applies across the Site Pixel hosts.",
+          "maxItems": 25,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 253
+          }
+        },
+        "metadata": {
+          "description": "Safe fixed event metadata; never form field values or arbitrary code.",
           "type": "object",
           "properties": {
-            "primaryColor": {
+            "value": {
+              "description": "Optional non-negative conversion value in major currency units.",
+              "type": "number",
+              "minimum": 0,
+              "maximum": 1e12
+            },
+            "currency": {
+              "description": "ISO 4217 currency code for value.",
               "type": "string",
-              "pattern": "^#[0-9a-f]{6}$",
-              "description": "Six-digit hexadecimal primary action color for the rendered form."
+              "pattern": "^[A-Za-z]{3}$"
             },
-            "backgroundColor": {
+            "orderId": {
+              "description": "Optional stable order identifier.",
               "type": "string",
-              "pattern": "^#[0-9a-f]{6}$",
-              "description": "Six-digit hexadecimal background color for the rendered form."
+              "minLength": 1,
+              "maxLength": 200
             },
-            "textColor": {
+            "contentId": {
+              "description": "Optional product or content identifier.",
               "type": "string",
-              "pattern": "^#[0-9a-f]{6}$",
-              "description": "Six-digit hexadecimal text color for the rendered form."
+              "minLength": 1,
+              "maxLength": 200
             },
-            "radius": {
-              "type": "integer",
-              "minimum": 0,
-              "maximum": 32,
-              "description": "Corner radius in pixels for rendered form controls."
+            "contentType": {
+              "description": "Optional bounded content category.",
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 80
             }
           },
-          "required": [
-            "primaryColor",
-            "backgroundColor",
-            "textColor",
-            "radius"
-          ],
-          "description": "Validated visual-brand settings applied to the generated form."
-        },
-        "submitLabel": {
-          "description": "Optional text displayed on the form submission button.",
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 80
-        },
-        "successMessage": {
-          "description": "Optional confirmation shown after a successful form submission.",
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 500
+          "additionalProperties": false
         },
-        "consentText": {
-          "description": "Optional consent disclosure displayed with the form submission control.",
-          "type": "string",
-          "maxLength": 1e3
+        "oncePerSession": {
+          "default": false,
+          "description": "Emit at most once per browser session when true.",
+          "type": "boolean"
         },
-        "publish": {
+        "enabled": {
           "default": true,
-          "description": "When true, publish the created form immediately; set false to keep it unpublished.",
+          "description": "Whether the Pixel may emit this definition.",
           "type": "boolean"
         }
       },
       "required": [
         "siteId",
-        "pixelId",
         "name",
-        "fields",
-        "brand"
+        "eventName",
+        "triggerKind"
       ],
       "$schema": "https://json-schema.org/draft/2020-12/schema"
     },
     "annotations": {
-      "title": "Create Pixel-linked Form",
+      "title": "Create Browser Event Definition",
       "readOnlyHint": false,
       "destructiveHint": false,
       "idempotentHint": false,
@@ -1204,10 +1250,10 @@ var MCP_TOOL_CATALOG = [
     }
   },
   {
-    "name": "analytics_get_acquisition",
+    "name": "analytics_create_export",
     "category": "analytics",
-    "title": "Analytics Acquisition",
-    "description": "Read the acquisition report for one analytics Business. Use analytics_list_sites first. Filters use the same normalized Site, Pixel, hostname, date, source, medium, campaign, and event contract as the dashboard, REST API, and exports.",
+    "title": "Create Analytics Export",
+    "description": "Create a persisted, versioned CSV, JSON, or Markdown analytics artifact. Supply a caller-owned idempotencyKey and reuse it only when retrying the same logical export.",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -1339,26 +1385,54 @@ var MCP_TOOL_CATALOG = [
           "description": "Optional normalized conversion event kind filter.",
           "type": "string",
           "pattern": "^[a-z][a-z0-9_]{1,79}$"
+        },
+        "report": {
+          "default": "overview",
+          "description": "Analytics report family to render into the exported artifact.",
+          "type": "string",
+          "enum": [
+            "overview",
+            "acquisition",
+            "content",
+            "conversions"
+          ]
+        },
+        "format": {
+          "default": "markdown",
+          "description": "Artifact serialization format to generate.",
+          "type": "string",
+          "enum": [
+            "csv",
+            "json",
+            "markdown"
+          ]
+        },
+        "idempotencyKey": {
+          "type": "string",
+          "minLength": 8,
+          "maxLength": 160,
+          "description": "Caller-owned opaque key for this intended operation; reuse only when retrying the same operation."
         }
       },
       "required": [
-        "siteId"
+        "siteId",
+        "idempotencyKey"
       ],
       "$schema": "https://json-schema.org/draft/2020-12/schema"
     },
     "annotations": {
-      "title": "Analytics Acquisition",
-      "readOnlyHint": true,
+      "title": "Create Analytics Export",
+      "readOnlyHint": false,
       "destructiveHint": false,
       "idempotentHint": true,
       "openWorldHint": false
     }
   },
   {
-    "name": "analytics_get_business_metrics",
+    "name": "analytics_create_form",
     "category": "analytics",
-    "title": "Analytics Business Metrics",
-    "description": "Read the configured lead-generation, SaaS, or e-commerce metric pack with explicit missing-input signals.",
+    "title": "Create Pixel-linked Form",
+    "description": "Create and optionally publish a branded form that inherits the parent Pixel identity and session.",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -1368,41 +1442,196 @@ var MCP_TOOL_CATALOG = [
           "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
           "description": "Analytics Site id returned by analytics_list_sites."
         },
-        "start": {
-          "description": "Inclusive ISO 8601 report start. Omit with end to use the last 30 days.",
+        "pixelId": {
           "type": "string",
-          "format": "date-time",
-          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Analytics Pixel id belonging to the selected Site."
         },
-        "end": {
-          "description": "Exclusive ISO 8601 report end. Omit with start to use now.",
+        "name": {
           "type": "string",
-          "format": "date-time",
-          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
-        },
-        "pixelIds": {
-          "description": "Optional Pixel ids belonging to this Site. Omit for every active Pixel.",
-          "maxItems": 20,
-          "type": "array",
-          "items": {
-            "type": "string",
-            "format": "uuid",
-            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
-          }
+          "minLength": 1,
+          "maxLength": 120,
+          "description": "Human-readable name for the record being created or updated."
         },
-        "hostnames": {
-          "description": "Optional approved detected hostnames within the selected Pixels.",
-          "maxItems": 20,
+        "fields": {
+          "minItems": 1,
+          "maxItems": 30,
           "type": "array",
           "items": {
-            "type": "string",
-            "minLength": 1,
-            "maxLength": 253
-          }
-        },
-        "source": {
-          "description": "Optional source or provenance constraint appropriate to this tool; omit when no source restriction is intended.",
-          "type": "string",
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "pattern": "^[a-z][a-z0-9_]{0,47}$",
+                "description": "Stable identifier for this nested record."
+              },
+              "type": {
+                "type": "string",
+                "enum": [
+                  "text",
+                  "email",
+                  "tel",
+                  "textarea",
+                  "select",
+                  "checkbox",
+                  "radio",
+                  "number"
+                ],
+                "description": "Governed content or record type used for routing and validation."
+              },
+              "label": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 120,
+                "description": "Human-readable label displayed for this field, link, or section."
+              },
+              "required": {
+                "type": "boolean",
+                "description": "Whether the form field must be completed before submission."
+              },
+              "options": {
+                "description": "Allowed selectable values for this form field.",
+                "maxItems": 30,
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 120
+                }
+              }
+            },
+            "required": [
+              "id",
+              "type",
+              "label",
+              "required"
+            ]
+          },
+          "description": "Ordered form-field definitions to render and validate for submissions."
+        },
+        "brand": {
+          "type": "object",
+          "properties": {
+            "primaryColor": {
+              "type": "string",
+              "pattern": "^#[0-9a-f]{6}$",
+              "description": "Six-digit hexadecimal primary action color for the rendered form."
+            },
+            "backgroundColor": {
+              "type": "string",
+              "pattern": "^#[0-9a-f]{6}$",
+              "description": "Six-digit hexadecimal background color for the rendered form."
+            },
+            "textColor": {
+              "type": "string",
+              "pattern": "^#[0-9a-f]{6}$",
+              "description": "Six-digit hexadecimal text color for the rendered form."
+            },
+            "radius": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 32,
+              "description": "Corner radius in pixels for rendered form controls."
+            }
+          },
+          "required": [
+            "primaryColor",
+            "backgroundColor",
+            "textColor",
+            "radius"
+          ],
+          "description": "Validated visual-brand settings applied to the generated form."
+        },
+        "submitLabel": {
+          "description": "Optional text displayed on the form submission button.",
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 80
+        },
+        "successMessage": {
+          "description": "Optional confirmation shown after a successful form submission.",
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 500
+        },
+        "consentText": {
+          "description": "Optional consent disclosure displayed with the form submission control.",
+          "type": "string",
+          "maxLength": 1e3
+        },
+        "publish": {
+          "default": true,
+          "description": "When true, publish the created form immediately; set false to keep it unpublished.",
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "siteId",
+        "pixelId",
+        "name",
+        "fields",
+        "brand"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Create Pixel-linked Form",
+      "readOnlyHint": false,
+      "destructiveHint": false,
+      "idempotentHint": false,
+      "openWorldHint": false
+    }
+  },
+  {
+    "name": "analytics_get_acquisition",
+    "category": "analytics",
+    "title": "Analytics Acquisition",
+    "description": "Read the acquisition report for one analytics Business. Use analytics_list_sites first. Filters use the same normalized Site, Pixel, hostname, date, source, medium, campaign, and event contract as the dashboard, REST API, and exports.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "siteId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Analytics Site id returned by analytics_list_sites."
+        },
+        "start": {
+          "description": "Inclusive ISO 8601 report start. Omit with end to use the last 30 days.",
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
+        },
+        "end": {
+          "description": "Exclusive ISO 8601 report end. Omit with start to use now.",
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
+        },
+        "pixelIds": {
+          "description": "Optional Pixel ids belonging to this Site. Omit for every active Pixel.",
+          "maxItems": 20,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "format": "uuid",
+            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+          }
+        },
+        "hostnames": {
+          "description": "Optional approved detected hostnames within the selected Pixels.",
+          "maxItems": 20,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 253
+          }
+        },
+        "source": {
+          "description": "Optional source or provenance constraint appropriate to this tool; omit when no source restriction is intended.",
+          "type": "string",
           "minLength": 1,
           "maxLength": 180
         },
@@ -1498,7 +1727,7 @@ var MCP_TOOL_CATALOG = [
       "$schema": "https://json-schema.org/draft/2020-12/schema"
     },
     "annotations": {
-      "title": "Analytics Business Metrics",
+      "title": "Analytics Acquisition",
       "readOnlyHint": true,
       "destructiveHint": false,
       "idempotentHint": true,
@@ -1506,10 +1735,10 @@ var MCP_TOOL_CATALOG = [
     }
   },
   {
-    "name": "analytics_get_channel_breakdown",
+    "name": "analytics_get_business_metrics",
     "category": "analytics",
-    "title": "Analytics Channel Breakdowns",
-    "description": "Read the LLM, social, and review-site channel breakdowns with campaign-to-creative drill-down report for one analytics Business. Use analytics_list_sites first. Filters use the same normalized Site, Pixel, hostname, date, source, medium, campaign, and event contract as the dashboard, REST API, and exports.",
+    "title": "Analytics Business Metrics",
+    "description": "Read the configured lead-generation, SaaS, or e-commerce metric pack with explicit missing-input signals.",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -1649,7 +1878,7 @@ var MCP_TOOL_CATALOG = [
       "$schema": "https://json-schema.org/draft/2020-12/schema"
     },
     "annotations": {
-      "title": "Analytics Channel Breakdowns",
+      "title": "Analytics Business Metrics",
       "readOnlyHint": true,
       "destructiveHint": false,
       "idempotentHint": true,
@@ -1657,10 +1886,10 @@ var MCP_TOOL_CATALOG = [
     }
   },
   {
-    "name": "analytics_get_content",
+    "name": "analytics_get_channel_breakdown",
     "category": "analytics",
-    "title": "Analytics Content",
-    "description": "Read the content report for one analytics Business. Use analytics_list_sites first. Filters use the same normalized Site, Pixel, hostname, date, source, medium, campaign, and event contract as the dashboard, REST API, and exports.",
+    "title": "Analytics Channel Breakdowns",
+    "description": "Read the LLM, social, and review-site channel breakdowns with campaign-to-creative drill-down report for one analytics Business. Use analytics_list_sites first. Filters use the same normalized Site, Pixel, hostname, date, source, medium, campaign, and event contract as the dashboard, REST API, and exports.",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -1800,7 +2029,7 @@ var MCP_TOOL_CATALOG = [
       "$schema": "https://json-schema.org/draft/2020-12/schema"
     },
     "annotations": {
-      "title": "Analytics Content",
+      "title": "Analytics Channel Breakdowns",
       "readOnlyHint": true,
       "destructiveHint": false,
       "idempotentHint": true,
@@ -1808,10 +2037,10 @@ var MCP_TOOL_CATALOG = [
     }
   },
   {
-    "name": "analytics_get_conversions",
+    "name": "analytics_get_content",
     "category": "analytics",
-    "title": "Analytics Conversions",
-    "description": "Read the conversions report for one analytics Business. Use analytics_list_sites first. Filters use the same normalized Site, Pixel, hostname, date, source, medium, campaign, and event contract as the dashboard, REST API, and exports.",
+    "title": "Analytics Content",
+    "description": "Read the content report for one analytics Business. Use analytics_list_sites first. Filters use the same normalized Site, Pixel, hostname, date, source, medium, campaign, and event contract as the dashboard, REST API, and exports.",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -1951,7 +2180,7 @@ var MCP_TOOL_CATALOG = [
       "$schema": "https://json-schema.org/draft/2020-12/schema"
     },
     "annotations": {
-      "title": "Analytics Conversions",
+      "title": "Analytics Content",
       "readOnlyHint": true,
       "destructiveHint": false,
       "idempotentHint": true,
@@ -1959,10 +2188,10 @@ var MCP_TOOL_CATALOG = [
     }
   },
   {
-    "name": "analytics_get_dimensions",
+    "name": "analytics_get_conversions",
     "category": "analytics",
-    "title": "Analytics Dimensions",
-    "description": "Read visualization-ready device, source, country, region, or weekday-hour rows. Chart recommendations are advisory.",
+    "title": "Analytics Conversions",
+    "description": "Read the conversions report for one analytics Business. Use analytics_list_sites first. Filters use the same normalized Site, Pixel, hostname, date, source, medium, campaign, and event contract as the dashboard, REST API, and exports.",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -2094,6 +2323,34 @@ var MCP_TOOL_CATALOG = [
           "description": "Optional normalized conversion event kind filter.",
           "type": "string",
           "pattern": "^[a-z][a-z0-9_]{1,79}$"
+        }
+      },
+      "required": [
+        "siteId"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Analytics Conversions",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
+  },
+  {
+    "name": "analytics_get_coverage",
+    "category": "analytics",
+    "title": "Get Attribution Coverage",
+    "description": "Measure click-ID coverage and call/CRM journey join rates. Null rates mean there is not yet a denominator.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "siteId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Analytics Site id returned by analytics_list_sites."
         },
         "limit": {
           "default": 50,
@@ -2106,27 +2363,15 @@ var MCP_TOOL_CATALOG = [
           "description": "Opaque continuation cursor returned by the previous page; omit for the first page.",
           "type": "string",
           "maxLength": 1e3
-        },
-        "dimension": {
-          "type": "string",
-          "enum": [
-            "device",
-            "source",
-            "country",
-            "region",
-            "weekday_hour"
-          ],
-          "description": "Dimension used to group returned analytics rows."
         }
       },
       "required": [
-        "siteId",
-        "dimension"
+        "siteId"
       ],
       "$schema": "https://json-schema.org/draft/2020-12/schema"
     },
     "annotations": {
-      "title": "Analytics Dimensions",
+      "title": "Get Attribution Coverage",
       "readOnlyHint": true,
       "destructiveHint": false,
       "idempotentHint": true,
@@ -2134,17 +2379,192 @@ var MCP_TOOL_CATALOG = [
     }
   },
   {
-    "name": "analytics_get_entitlement",
+    "name": "analytics_get_dimensions",
     "category": "analytics",
-    "title": "Get X-Ray Pixel Access",
-    "description": "Check whether Thorbit X-Ray Pixel is connected and entitled for this MCP Scraper account. X-Ray Pixel is owned and billed by Thorbit, requires an active $50+ Thorbit subscription after its 30-day trial, and does not consume MCP Scraper Credits. Call this before analytics_list_sites when access may not be configured. Account linking must be completed in the MCP Scraper dashboard; never ask a user to paste a Thorbit API key into an AI conversation.",
+    "title": "Analytics Dimensions",
+    "description": "Read visualization-ready device, source, country, region, or weekday-hour rows. Chart recommendations are advisory.",
     "inputSchema": {
       "type": "object",
-      "properties": {},
-      "$schema": "https://json-schema.org/draft/2020-12/schema"
-    },
-    "annotations": {
-      "title": "Get X-Ray Pixel Access",
+      "properties": {
+        "siteId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Analytics Site id returned by analytics_list_sites."
+        },
+        "start": {
+          "description": "Inclusive ISO 8601 report start. Omit with end to use the last 30 days.",
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
+        },
+        "end": {
+          "description": "Exclusive ISO 8601 report end. Omit with start to use now.",
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
+        },
+        "pixelIds": {
+          "description": "Optional Pixel ids belonging to this Site. Omit for every active Pixel.",
+          "maxItems": 20,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "format": "uuid",
+            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+          }
+        },
+        "hostnames": {
+          "description": "Optional approved detected hostnames within the selected Pixels.",
+          "maxItems": 20,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 253
+          }
+        },
+        "source": {
+          "description": "Optional source or provenance constraint appropriate to this tool; omit when no source restriction is intended.",
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 180
+        },
+        "medium": {
+          "description": "Exact normalized campaign medium used to filter or label analytics data.",
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 180
+        },
+        "campaign": {
+          "description": "Exact normalized campaign value used to filter or label analytics data.",
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 240
+        },
+        "eventName": {
+          "description": "Optional normalized analytics event-name filter.",
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9_]{1,79}$"
+        },
+        "attributionModel": {
+          "default": "first_touch",
+          "description": "Attribution model applied to the report; defaults to first touch.",
+          "type": "string",
+          "enum": [
+            "first_touch",
+            "last_touch"
+          ]
+        },
+        "channelFamily": {
+          "description": "Optional normalized acquisition-channel family filter.",
+          "type": "string",
+          "enum": [
+            "llm",
+            "social",
+            "review",
+            "search",
+            "email",
+            "referral",
+            "direct",
+            "other"
+          ]
+        },
+        "platform": {
+          "description": "Normalized external platform selected for this operation.",
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 180
+        },
+        "referrer": {
+          "description": "Optional exact or normalized referrer filter for analytics rows.",
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 500
+        },
+        "path": {
+          "description": "Exact path value used by this tool; preserve its leading slash or vault-relative form as required.",
+          "type": "string",
+          "maxLength": 2e3,
+          "pattern": "^\\/.*"
+        },
+        "deviceClass": {
+          "description": "Optional normalized device-class filter.",
+          "type": "string",
+          "enum": [
+            "desktop",
+            "tablet",
+            "mobile",
+            "unknown"
+          ]
+        },
+        "countryCode": {
+          "description": "Two-letter country code used to filter analytics rows.",
+          "type": "string",
+          "minLength": 2,
+          "maxLength": 2
+        },
+        "regionCode": {
+          "description": "Optional regional subdivision code filter.",
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 8
+        },
+        "conversionKind": {
+          "description": "Optional normalized conversion event kind filter.",
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9_]{1,79}$"
+        },
+        "limit": {
+          "default": 50,
+          "description": "Maximum rows or records to return on this page; use the returned cursor for more.",
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 250
+        },
+        "cursor": {
+          "description": "Opaque continuation cursor returned by the previous page; omit for the first page.",
+          "type": "string",
+          "maxLength": 1e3
+        },
+        "dimension": {
+          "type": "string",
+          "enum": [
+            "device",
+            "source",
+            "country",
+            "region",
+            "weekday_hour"
+          ],
+          "description": "Dimension used to group returned analytics rows."
+        }
+      },
+      "required": [
+        "siteId",
+        "dimension"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Analytics Dimensions",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
+  },
+  {
+    "name": "analytics_get_entitlement",
+    "category": "analytics",
+    "title": "Get X-Ray Pixel Access",
+    "description": "Check whether Thorbit X-Ray Pixel is connected and entitled for this MCP Scraper account. X-Ray Pixel is owned and billed by Thorbit, requires an active $50+ Thorbit subscription after its 30-day trial, and does not consume MCP Scraper Credits. Call this before analytics_list_sites when access may not be configured. Account linking must be completed in the MCP Scraper dashboard; never ask a user to paste a Thorbit API key into an AI conversation.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {},
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Get X-Ray Pixel Access",
       "readOnlyHint": true,
       "destructiveHint": false,
       "idempotentHint": true,
@@ -2807,6 +3227,41 @@ var MCP_TOOL_CATALOG = [
       "openWorldHint": false
     }
   },
+  {
+    "name": "analytics_get_person_journey",
+    "category": "analytics",
+    "title": "Get Person Journey",
+    "description": "Read one identified person timeline across sessions, immutable touches, calls, CRM stages, conversions, and ad-delivery receipts.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "siteId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Analytics Site id returned by analytics_list_sites."
+        },
+        "personId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Opaque X-Ray person identifier returned by an attributed-people or journey result."
+        }
+      },
+      "required": [
+        "siteId",
+        "personId"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Get Person Journey",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
+  },
   {
     "name": "analytics_get_timeseries",
     "category": "analytics",
@@ -3090,10 +3545,10 @@ var MCP_TOOL_CATALOG = [
     }
   },
   {
-    "name": "analytics_list_campaign_links",
+    "name": "analytics_list_activation_receipts",
     "category": "analytics",
-    "title": "List Campaign Links",
-    "description": "List paginated tracked links and canonical UTM and ad hierarchy fields.",
+    "title": "List Ad Activation Receipts",
+    "description": "List bounded provider delivery receipts for one activation destination.",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -3103,26 +3558,33 @@ var MCP_TOOL_CATALOG = [
           "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
           "description": "Analytics Site id returned by analytics_list_sites."
         },
+        "destinationId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Activation destination id returned by analytics_list_activation_destinations."
+        },
         "limit": {
           "default": 50,
-          "description": "Maximum rows or records to return on this page; use the returned cursor for more.",
+          "description": "Maximum receipt rows to return.",
           "type": "integer",
           "minimum": 1,
           "maximum": 250
         },
         "cursor": {
-          "description": "Opaque continuation cursor returned by the previous page; omit for the first page.",
+          "description": "Opaque pagination cursor from the prior receipt page.",
           "type": "string",
           "maxLength": 1e3
         }
       },
       "required": [
-        "siteId"
+        "siteId",
+        "destinationId"
       ],
       "$schema": "https://json-schema.org/draft/2020-12/schema"
     },
     "annotations": {
-      "title": "List Campaign Links",
+      "title": "List Ad Activation Receipts",
       "readOnlyHint": true,
       "destructiveHint": false,
       "idempotentHint": true,
@@ -3130,10 +3592,10 @@ var MCP_TOOL_CATALOG = [
     }
   },
   {
-    "name": "analytics_list_crm_imports",
+    "name": "analytics_list_campaign_links",
     "category": "analytics",
-    "title": "List CRM Imports",
-    "description": "List paginated encrypted CSV import receipts without exposing contact PII in analytics.",
+    "title": "List Campaign Links",
+    "description": "List paginated tracked links and canonical UTM and ad hierarchy fields.",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -3162,7 +3624,7 @@ var MCP_TOOL_CATALOG = [
       "$schema": "https://json-schema.org/draft/2020-12/schema"
     },
     "annotations": {
-      "title": "List CRM Imports",
+      "title": "List Campaign Links",
       "readOnlyHint": true,
       "destructiveHint": false,
       "idempotentHint": true,
@@ -3170,10 +3632,10 @@ var MCP_TOOL_CATALOG = [
     }
   },
   {
-    "name": "analytics_list_forms",
+    "name": "analytics_list_connections",
     "category": "analytics",
-    "title": "List Analytics Forms",
-    "description": "List paginated Pixel-linked forms, embed snippets, fields, versions, and submission counts.",
+    "title": "List X-Ray Connections",
+    "description": "List phone, CRM, and webhook connections with honest readiness, receipt, and error state.",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -3202,7 +3664,7 @@ var MCP_TOOL_CATALOG = [
       "$schema": "https://json-schema.org/draft/2020-12/schema"
     },
     "annotations": {
-      "title": "List Analytics Forms",
+      "title": "List X-Ray Connections",
       "readOnlyHint": true,
       "destructiveHint": false,
       "idempotentHint": true,
@@ -3210,10 +3672,10 @@ var MCP_TOOL_CATALOG = [
     }
   },
   {
-    "name": "analytics_list_pixels",
+    "name": "analytics_list_conversion_rules",
     "category": "analytics",
-    "title": "List Analytics Pixels",
-    "description": "List Site Pixels, installation snippets, detected domains, approval states, and health.",
+    "title": "List Conversion Rules",
+    "description": "List deterministic versioned rules that turn canonical phone, CRM, transaction, and server events into conversions.",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -3242,7 +3704,7 @@ var MCP_TOOL_CATALOG = [
       "$schema": "https://json-schema.org/draft/2020-12/schema"
     },
     "annotations": {
-      "title": "List Analytics Pixels",
+      "title": "List Conversion Rules",
       "readOnlyHint": true,
       "destructiveHint": false,
       "idempotentHint": true,
@@ -3250,20 +3712,732 @@ var MCP_TOOL_CATALOG = [
     }
   },
   {
-    "name": "analytics_list_sites",
+    "name": "analytics_list_crm_imports",
     "category": "analytics",
-    "title": "List Analytics Businesses",
-    "description": "List the authenticated account's analytics Businesses, roles, Pixel counts, and latest activity. Call this first to obtain the siteId used by every analytics report tool. Tenant access is enforced by the analytics API.",
+    "title": "List CRM Imports",
+    "description": "List paginated encrypted CSV import receipts without exposing contact PII in analytics.",
     "inputSchema": {
       "type": "object",
-      "properties": {},
-      "$schema": "https://json-schema.org/draft/2020-12/schema"
-    },
-    "annotations": {
-      "title": "List Analytics Businesses",
-      "readOnlyHint": true,
-      "destructiveHint": false,
-      "idempotentHint": true,
+      "properties": {
+        "siteId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Analytics Site id returned by analytics_list_sites."
+        },
+        "limit": {
+          "default": 50,
+          "description": "Maximum rows or records to return on this page; use the returned cursor for more.",
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 250
+        },
+        "cursor": {
+          "description": "Opaque continuation cursor returned by the previous page; omit for the first page.",
+          "type": "string",
+          "maxLength": 1e3
+        }
+      },
+      "required": [
+        "siteId"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "List CRM Imports",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
+  },
+  {
+    "name": "analytics_list_event_definitions",
+    "category": "analytics",
+    "title": "List Browser Event Definitions",
+    "description": "List declarative page, click, and form-submit tags applied by the first-party X-Ray Pixel.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "siteId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Analytics Site id returned by analytics_list_sites."
+        },
+        "limit": {
+          "default": 50,
+          "description": "Maximum rows or records to return on this page; use the returned cursor for more.",
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 250
+        },
+        "cursor": {
+          "description": "Opaque continuation cursor returned by the previous page; omit for the first page.",
+          "type": "string",
+          "maxLength": 1e3
+        }
+      },
+      "required": [
+        "siteId"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "List Browser Event Definitions",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
+  },
+  {
+    "name": "analytics_list_forms",
+    "category": "analytics",
+    "title": "List Analytics Forms",
+    "description": "List paginated Pixel-linked forms, embed snippets, fields, versions, and submission counts.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "siteId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Analytics Site id returned by analytics_list_sites."
+        },
+        "limit": {
+          "default": 50,
+          "description": "Maximum rows or records to return on this page; use the returned cursor for more.",
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 250
+        },
+        "cursor": {
+          "description": "Opaque continuation cursor returned by the previous page; omit for the first page.",
+          "type": "string",
+          "maxLength": 1e3
+        }
+      },
+      "required": [
+        "siteId"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "List Analytics Forms",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
+  },
+  {
+    "name": "analytics_list_pixels",
+    "category": "analytics",
+    "title": "List Analytics Pixels",
+    "description": "List Site Pixels, installation snippets, detected domains, approval states, and health.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "siteId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Analytics Site id returned by analytics_list_sites."
+        },
+        "limit": {
+          "default": 50,
+          "description": "Maximum rows or records to return on this page; use the returned cursor for more.",
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 250
+        },
+        "cursor": {
+          "description": "Opaque continuation cursor returned by the previous page; omit for the first page.",
+          "type": "string",
+          "maxLength": 1e3
+        }
+      },
+      "required": [
+        "siteId"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "List Analytics Pixels",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
+  },
+  {
+    "name": "analytics_list_sites",
+    "category": "analytics",
+    "title": "List Analytics Businesses",
+    "description": "List the authenticated account's analytics Businesses, roles, Pixel counts, and latest activity. Call this first to obtain the siteId used by every analytics report tool. Tenant access is enforced by the analytics API.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {},
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "List Analytics Businesses",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
+  },
+  {
+    "name": "analytics_reconcile_connection",
+    "category": "analytics",
+    "title": "Reconcile X-Ray Connection",
+    "description": "Reconcile one phone or CRM connection through its configured provider API and return readiness and checkpoint evidence.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "siteId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Analytics Site id returned by analytics_list_sites."
+        },
+        "connectionId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Phone or CRM connection id returned by analytics_list_connections."
+        }
+      },
+      "required": [
+        "siteId",
+        "connectionId"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Reconcile X-Ray Connection",
+      "readOnlyHint": false,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": true
+    }
+  },
+  {
+    "name": "analytics_record_external_event",
+    "category": "analytics",
+    "title": "Record Server Event",
+    "description": "Idempotently record a canonical server-side call, CRM, transaction, or custom event and evaluate conversion rules.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "siteId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Analytics Site id returned by analytics_list_sites."
+        },
+        "schemaVersion": {
+          "default": 1,
+          "description": "Canonical X-Ray event schema version; use version 1.",
+          "type": "number",
+          "const": 1
+        },
+        "eventId": {
+          "type": "string",
+          "minLength": 8,
+          "maxLength": 200,
+          "description": "Caller-owned canonical event identifier used for end-to-end deduplication."
+        },
+        "source": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 80,
+          "description": "Optional source or provenance constraint appropriate to this tool; omit when no source restriction is intended."
+        },
+        "sourceAccountRef": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 240,
+          "description": "Stable non-secret account identifier at the phone, CRM, or event source."
+        },
+        "sourceEventId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 300,
+          "description": "Stable identifier assigned by the source system for idempotent ingestion."
+        },
+        "eventKind": {
+          "type": "string",
+          "enum": [
+            "browser",
+            "form",
+            "call",
+            "crm",
+            "transaction",
+            "custom_server",
+            "conversion",
+            "delivery"
+          ],
+          "description": "Canonical event family used for journey storage and conversion-rule evaluation."
+        },
+        "eventName": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9_]{1,79}$",
+          "description": "Optional normalized analytics event-name filter."
+        },
+        "occurredAt": {
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
+          "description": "ISO 8601 timestamp when the source event actually occurred."
+        },
+        "visitorId": {
+          "description": "Consented first-party visitor identifier used for deterministic journey linking.",
+          "type": "string",
+          "maxLength": 160
+        },
+        "sessionId": {
+          "description": "First-party session identifier used for deterministic journey linking.",
+          "type": "string",
+          "maxLength": 160
+        },
+        "callId": {
+          "description": "Stable call identifier assigned by the phone provider.",
+          "type": "string",
+          "maxLength": 240
+        },
+        "dealId": {
+          "description": "Stable CRM deal or opportunity identifier.",
+          "type": "string",
+          "maxLength": 240
+        },
+        "orderId": {
+          "description": "Stable order identifier used for conversion deduplication and reconciliation.",
+          "type": "string",
+          "maxLength": 240
+        },
+        "personRef": {
+          "description": "Opaque source-system person reference; do not place raw contact data here.",
+          "type": "string",
+          "maxLength": 240
+        },
+        "path": {
+          "description": "Exact path value used by this tool; preserve its leading slash or vault-relative form as required.",
+          "type": "string",
+          "maxLength": 2e3
+        },
+        "canonicalUrl": {
+          "description": "Canonical public page URL associated with the event.",
+          "type": "string",
+          "maxLength": 3e3,
+          "format": "uri"
+        },
+        "sourceName": {
+          "description": "Normalized acquisition-source name associated with the event.",
+          "type": "string",
+          "maxLength": 180
+        },
+        "medium": {
+          "description": "Exact normalized campaign medium used to filter or label analytics data.",
+          "type": "string",
+          "maxLength": 180
+        },
+        "campaign": {
+          "description": "Exact normalized campaign value used to filter or label analytics data.",
+          "type": "string",
+          "maxLength": 240
+        },
+        "valueMinor": {
+          "description": "Monetary event value in the smallest unit of the supplied currency.",
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 2147483647
+        },
+        "currency": {
+          "description": "Three-letter ISO currency code for the event value.",
+          "type": "string",
+          "minLength": 3,
+          "maxLength": 3
+        },
+        "clickIds": {
+          "description": "Native advertising click identifiers preserved for deterministic offline conversion matching.",
+          "type": "object",
+          "properties": {
+            "gclid": {
+              "description": "Google Click ID captured from the attributed landing URL.",
+              "type": "string",
+              "maxLength": 500
+            },
+            "gbraid": {
+              "description": "Google app-to-web click identifier captured from the attributed landing URL.",
+              "type": "string",
+              "maxLength": 500
+            },
+            "wbraid": {
+              "description": "Google web-to-app click identifier captured from the attributed landing URL.",
+              "type": "string",
+              "maxLength": 500
+            },
+            "fbclid": {
+              "description": "Meta click identifier captured from the attributed landing URL.",
+              "type": "string",
+              "maxLength": 500
+            },
+            "fbp": {
+              "description": "Meta first-party browser identifier captured with consent.",
+              "type": "string",
+              "maxLength": 500
+            },
+            "fbc": {
+              "description": "Meta click cookie value captured or derived from fbclid with consent.",
+              "type": "string",
+              "maxLength": 500
+            },
+            "ttclid": {
+              "description": "TikTok click identifier captured from the attributed landing URL.",
+              "type": "string",
+              "maxLength": 500
+            },
+            "rdt_cid": {
+              "description": "Reddit click identifier captured from the attributed landing URL.",
+              "type": "string",
+              "maxLength": 500
+            },
+            "msclkid": {
+              "description": "Microsoft Advertising click identifier captured from the attributed landing URL.",
+              "type": "string",
+              "maxLength": 500
+            },
+            "li_fat_id": {
+              "description": "LinkedIn first-party attribution identifier captured from the landing URL.",
+              "type": "string",
+              "maxLength": 500
+            },
+            "snapclid": {
+              "description": "Snapchat click identifier captured from the attributed landing URL.",
+              "type": "string",
+              "maxLength": 500
+            }
+          }
+        },
+        "properties": {
+          "description": "Bounded non-secret event properties used for reporting and declarative rule evaluation.",
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {}
+        }
+      },
+      "required": [
+        "siteId",
+        "eventId",
+        "source",
+        "sourceAccountRef",
+        "sourceEventId",
+        "eventKind",
+        "eventName",
+        "occurredAt"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Record Server Event",
+      "readOnlyHint": false,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
+  },
+  {
+    "name": "analytics_retry_activation_delivery",
+    "category": "analytics",
+    "title": "Retry Ad Activation Delivery",
+    "description": "Requeue one failed or dead-lettered activation job. This may cause an external provider delivery.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "siteId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Analytics Site id returned by analytics_list_sites."
+        },
+        "jobId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Failed activation job id returned by analytics_list_activation_receipts."
+        }
+      },
+      "required": [
+        "siteId",
+        "jobId"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Retry Ad Activation Delivery",
+      "readOnlyHint": false,
+      "destructiveHint": false,
+      "idempotentHint": false,
+      "openWorldHint": true
+    }
+  },
+  {
+    "name": "analytics_test_activation_destination",
+    "category": "analytics",
+    "title": "Test Ad Activation Destination",
+    "description": "Send the provider-specific verification test for a configured activation destination and return its safe receipt.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "siteId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Analytics Site id returned by analytics_list_sites."
+        },
+        "destinationId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Activation destination id returned by analytics_list_activation_destinations."
+        }
+      },
+      "required": [
+        "siteId",
+        "destinationId"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Test Ad Activation Destination",
+      "readOnlyHint": false,
+      "destructiveHint": false,
+      "idempotentHint": false,
+      "openWorldHint": true
+    }
+  },
+  {
+    "name": "analytics_test_event_definition",
+    "category": "analytics",
+    "title": "Test Browser Event Definition",
+    "description": "Preview a definition against validated hostname, path, trigger, tag, and browser-reported selector-match facts. This never accepts HTML or executes selectors server-side.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "siteId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Analytics Site id returned by analytics_list_sites."
+        },
+        "definitionId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Event definition id returned by analytics_list_event_definitions."
+        },
+        "hostname": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 253,
+          "description": "Bare hostname observed by the browser."
+        },
+        "path": {
+          "type": "string",
+          "maxLength": 2e3,
+          "pattern": "^\\/.*",
+          "description": "URL path observed by the browser."
+        },
+        "triggerKind": {
+          "type": "string",
+          "enum": [
+            "page",
+            "click",
+            "form",
+            "semantic"
+          ],
+          "description": "Trigger interaction being previewed."
+        },
+        "tagEventName": {
+          "description": "Validated data-xray-event name observed by the browser.",
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9_]{1,79}$"
+        },
+        "selectorMatched": {
+          "description": "The browser-reported match result. The server never receives HTML or evaluates a selector.",
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "siteId",
+        "definitionId",
+        "hostname",
+        "path",
+        "triggerKind"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Test Browser Event Definition",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
+  },
+  {
+    "name": "analytics_update_event_definition",
+    "category": "analytics",
+    "title": "Update Browser Event Definition",
+    "description": "Update a versioned declarative browser event definition. Null path, selector, or metadata clears that optional field.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "siteId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Analytics Site id returned by analytics_list_sites."
+        },
+        "definitionId": {
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+          "description": "Event definition id returned by analytics_list_event_definitions."
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 120,
+          "description": "Human-readable definition name unique within the Site."
+        },
+        "eventName": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9_]{1,79}$",
+          "description": "Canonical event name emitted when this definition matches."
+        },
+        "triggerKind": {
+          "type": "string",
+          "enum": [
+            "page",
+            "click",
+            "form",
+            "semantic"
+          ],
+          "description": "Declarative browser trigger. Semantic uses a data-xray-event tag."
+        },
+        "path": {
+          "description": "Replacement page path; null clears it.",
+          "anyOf": [
+            {
+              "type": "string",
+              "maxLength": 2e3,
+              "pattern": "^\\/.*"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "pathMatch": {
+          "description": "Replacement page path match mode.",
+          "type": "string",
+          "enum": [
+            "exact",
+            "prefix"
+          ]
+        },
+        "selector": {
+          "description": "Replacement browser-only selector; null clears it.",
+          "anyOf": [
+            {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 500
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "hostnames": {
+          "description": "Replacement approved bare-hostname scope.",
+          "maxItems": 25,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 253
+          }
+        },
+        "metadata": {
+          "description": "Replacement safe metadata; null clears it.",
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "value": {
+                  "description": "Optional non-negative conversion value in major currency units.",
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 1e12
+                },
+                "currency": {
+                  "description": "ISO 4217 currency code for value.",
+                  "type": "string",
+                  "pattern": "^[A-Za-z]{3}$"
+                },
+                "orderId": {
+                  "description": "Optional stable order identifier.",
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 200
+                },
+                "contentId": {
+                  "description": "Optional product or content identifier.",
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 200
+                },
+                "contentType": {
+                  "description": "Optional bounded content category.",
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 80
+                }
+              },
+              "additionalProperties": false
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "oncePerSession": {
+          "description": "Replacement once-per-browser-session behavior.",
+          "type": "boolean"
+        },
+        "enabled": {
+          "description": "Replacement enabled state.",
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "siteId",
+        "definitionId"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Update Browser Event Definition",
+      "readOnlyHint": false,
+      "destructiveHint": false,
+      "idempotentHint": false,
       "openWorldHint": false
     }
   },
@@ -6787,7 +7961,7 @@ var MCP_TOOL_CATALOG = [
           "type": "object",
           "properties": {
             "canonicalUrl": {
-              "description": "Canonical public URL for this article or entity.",
+              "description": "Canonical public page URL associated with the event.",
               "type": "string",
               "format": "uri"
             },
@@ -7712,7 +8886,7 @@ var MCP_TOOL_CATALOG = [
           "type": "object",
           "properties": {
             "canonicalUrl": {
-              "description": "Canonical public URL for this article or entity.",
+              "description": "Canonical public page URL associated with the event.",
               "type": "string",
               "format": "uri"
             },