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

mcpscraper-cli 0.29.6 → 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.6";
+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",
@@ -3029,31 +3484,678 @@ var MCP_TOOL_CATALOG = [
               "type": "string"
             }
           },
-          "description": "CSV-column mapping used to identify and protect supported CRM fields."
+          "description": "CSV-column mapping used to identify and protect supported CRM fields."
+        }
+      },
+      "required": [
+        "siteId",
+        "sourceSystem",
+        "filename",
+        "csv",
+        "mapping"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Import CRM CSV",
+      "readOnlyHint": false,
+      "destructiveHint": false,
+      "idempotentHint": false,
+      "openWorldHint": false
+    }
+  },
+  {
+    "name": "analytics_list_activation_destinations",
+    "category": "analytics",
+    "title": "List Ad Activation Destinations",
+    "description": "List Meta, Google, TikTok, and Reddit destinations with pending, delivered, and failed conversion 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 Ad Activation Destinations",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
+  },
+  {
+    "name": "analytics_list_activation_receipts",
+    "category": "analytics",
+    "title": "List Ad Activation Receipts",
+    "description": "List bounded provider delivery receipts for one activation destination.",
+    "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."
+        },
+        "limit": {
+          "default": 50,
+          "description": "Maximum receipt rows to return.",
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 250
+        },
+        "cursor": {
+          "description": "Opaque pagination cursor from the prior receipt page.",
+          "type": "string",
+          "maxLength": 1e3
+        }
+      },
+      "required": [
+        "siteId",
+        "destinationId"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "List Ad Activation Receipts",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
+  },
+  {
+    "name": "analytics_list_campaign_links",
+    "category": "analytics",
+    "title": "List Campaign Links",
+    "description": "List paginated tracked links and canonical UTM and ad hierarchy 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."
+        },
+        "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 Campaign Links",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
+  },
+  {
+    "name": "analytics_list_connections",
+    "category": "analytics",
+    "title": "List X-Ray Connections",
+    "description": "List phone, CRM, and webhook connections with honest readiness, receipt, and error state.",
+    "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 X-Ray Connections",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
+  },
+  {
+    "name": "analytics_list_conversion_rules",
+    "category": "analytics",
+    "title": "List Conversion Rules",
+    "description": "List deterministic versioned rules that turn canonical phone, CRM, transaction, and server events into conversions.",
+    "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 Conversion Rules",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
+  },
+  {
+    "name": "analytics_list_crm_imports",
+    "category": "analytics",
+    "title": "List CRM Imports",
+    "description": "List paginated encrypted CSV import receipts without exposing contact PII in analytics.",
+    "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 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",
-        "sourceSystem",
-        "filename",
-        "csv",
-        "mapping"
+        "eventId",
+        "source",
+        "sourceAccountRef",
+        "sourceEventId",
+        "eventKind",
+        "eventName",
+        "occurredAt"
       ],
       "$schema": "https://json-schema.org/draft/2020-12/schema"
     },
     "annotations": {
-      "title": "Import CRM CSV",
+      "title": "Record Server Event",
       "readOnlyHint": false,
       "destructiveHint": false,
-      "idempotentHint": false,
+      "idempotentHint": true,
       "openWorldHint": false
     }
   },
   {
-    "name": "analytics_list_activation_destinations",
+    "name": "analytics_retry_activation_delivery",
     "category": "analytics",
-    "title": "List Ad Activation Destinations",
-    "description": "List Meta, Google, TikTok, and Reddit destinations with pending, delivered, and failed conversion counts.",
+    "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": {
@@ -3063,37 +4165,32 @@ 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."
         },
-        "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.",
+        "jobId": {
           "type": "string",
-          "maxLength": 1e3
+          "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"
+        "siteId",
+        "jobId"
       ],
       "$schema": "https://json-schema.org/draft/2020-12/schema"
     },
     "annotations": {
-      "title": "List Ad Activation Destinations",
-      "readOnlyHint": true,
+      "title": "Retry Ad Activation Delivery",
+      "readOnlyHint": false,
       "destructiveHint": false,
-      "idempotentHint": true,
-      "openWorldHint": false
+      "idempotentHint": false,
+      "openWorldHint": true
     }
   },
   {
-    "name": "analytics_list_campaign_links",
+    "name": "analytics_test_activation_destination",
     "category": "analytics",
-    "title": "List Campaign Links",
-    "description": "List paginated tracked links and canonical UTM and ad hierarchy fields.",
+    "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": {
@@ -3103,37 +4200,32 @@ 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."
         },
-        "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.",
+        "destinationId": {
           "type": "string",
-          "maxLength": 1e3
+          "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"
+        "siteId",
+        "destinationId"
       ],
       "$schema": "https://json-schema.org/draft/2020-12/schema"
     },
     "annotations": {
-      "title": "List Campaign Links",
-      "readOnlyHint": true,
+      "title": "Test Ad Activation Destination",
+      "readOnlyHint": false,
       "destructiveHint": false,
-      "idempotentHint": true,
-      "openWorldHint": false
+      "idempotentHint": false,
+      "openWorldHint": true
     }
   },
   {
-    "name": "analytics_list_crm_imports",
+    "name": "analytics_test_event_definition",
     "category": "analytics",
-    "title": "List CRM Imports",
-    "description": "List paginated encrypted CSV import receipts without exposing contact PII in 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": {
@@ -3143,66 +4235,55 @@ 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."
         },
-        "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_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": {
+        "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": "Analytics Site id returned by analytics_list_sites."
+          "description": "Event definition id returned by analytics_list_event_definitions."
         },
-        "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
+        "hostname": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 253,
+          "description": "Bare hostname observed by the browser."
         },
-        "cursor": {
-          "description": "Opaque continuation cursor returned by the previous page; omit for the first page.",
+        "path": {
           "type": "string",
-          "maxLength": 1e3
+          "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"
+        "siteId",
+        "definitionId",
+        "hostname",
+        "path",
+        "triggerKind"
       ],
       "$schema": "https://json-schema.org/draft/2020-12/schema"
     },
     "annotations": {
-      "title": "List Analytics Forms",
+      "title": "Test Browser Event Definition",
       "readOnlyHint": true,
       "destructiveHint": false,
       "idempotentHint": true,
@@ -3210,10 +4291,10 @@ var MCP_TOOL_CATALOG = [
     }
   },
   {
-    "name": "analytics_list_pixels",
+    "name": "analytics_update_event_definition",
     "category": "analytics",
-    "title": "List Analytics Pixels",
-    "description": "List Site Pixels, installation snippets, detected domains, approval states, and health.",
+    "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": {
@@ -3223,47 +4304,140 @@ 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."
         },
-        "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
+        "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."
         },
-        "cursor": {
-          "description": "Opaque continuation cursor returned by the previous page; omit for the first page.",
+        "name": {
           "type": "string",
-          "maxLength": 1e3
+          "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"
+        "siteId",
+        "definitionId"
       ],
       "$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,
+      "title": "Update Browser Event Definition",
+      "readOnlyHint": false,
       "destructiveHint": false,
-      "idempotentHint": true,
+      "idempotentHint": false,
       "openWorldHint": false
     }
   },
@@ -5006,20 +6180,34 @@ var MCP_TOOL_CATALOG = [
     "name": "commons_host_image",
     "category": "commons",
     "title": "Host a Transparent Commons Image",
-    "description": "Normal prerequisite for any featured image whose URL was not already returned by commons_host_image. Host image bytes from imageBase64 when you already have an attachment and the serialized request stays under about 3 MB, or from a stable direct public HTTPS image URL; do not pass a webpage, caller-local path, private URL, or temporary/signed attachment URL. Returns the permanent Commons URL to place in featuredImage.url before commons_validate_entity and commons_submit_entity. Submit can still auto-host a stable public source as a compatibility fallback. JPEG, PNG, GIF, and WebP are accepted up to 10 MB; SVG is rejected. Identical bytes are stored once.",
+    "description": "Turn one supplied image source into a permanent Transparent Commons image before validation and submission. Provide exactly one of imageBase64 for a pasted or AI-generated image, artifactId for an owner-scoped MCP Scraper image artifact, or sourceUrl for either a direct public HTTPS image or a webpage containing the desired image. Webpages are inspected in deterministic order for Open Graph, Twitter, JSON-LD, and meaningful content images; unusable candidates fall through to the next candidate. Returns the permanent URL for featuredImage.url plus source and selection provenance. JPEG, PNG, GIF, and WebP are accepted up to 10 MB; SVG is rejected. Identical bytes are stored once. Never pass a caller-local path or private/authenticated URL.",
     "inputSchema": {
       "type": "object",
       "properties": {
         "sourceUrl": {
-          "description": "Stable direct public HTTPS URL whose response is the image bytes to host. Do not pass an HTML webpage, chat attachment reference, caller-local path, temporary or signed URL, or private/authenticated URL.",
+          "description": "Public HTTPS direct image URL or webpage URL. A direct image is hosted as-is; an HTML page is inspected for Open Graph, Twitter, JSON-LD, and meaningful content images, then the first usable candidate is hosted. Temporary signed URLs are consumed immediately and query credentials are not retained as provenance.",
           "type": "string",
           "format": "uri"
         },
         "imageBase64": {
-          "description": "Base64 image bytes for an image you already hold, including forwarded chat attachment bytes. Prefer this over a temporary attachment URL when the serialized request remains under about 3 MB; larger files require a stable direct public HTTPS source URL.",
+          "description": "Base64 image bytes for an image already available to the caller, including a pasted attachment or AI-generated image. Use sourceType to preserve whether it was uploaded or generated. Keep the complete serialized request within the client transport limit.",
           "type": "string",
           "minLength": 16
         },
+        "artifactId": {
+          "description": "Owner-scoped image artifact returned by an MCP Scraper media or screenshot workflow. The server reauthorizes ownership and reads the bytes directly; do not construct an artifact ID.",
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 500
+        },
+        "sourceType": {
+          "description": "Provenance for imageBase64 or artifactId. Use ai_generated only when an image model created the supplied bytes; otherwise use uploaded or omit it.",
+          "type": "string",
+          "enum": [
+            "uploaded",
+            "ai_generated"
+          ]
+        },
         "alt": {
           "description": "Alt text describing the image for readers who cannot see it.",
           "type": "string",
@@ -6072,13 +7260,13 @@ var MCP_TOOL_CATALOG = [
           "maxLength": 240
         },
         "featuredImage": {
-          "description": "Required for auto-published public entities. First call commons_host_image and place its returned permanent URL here; validation does not fetch external images and reports unregistered URLs as not publishable. Submit retains a compatibility fallback that auto-hosts a stable direct public HTTPS image URL. The image is also added to the media manifest if absent.",
+          "description": "Required for auto-published public entities. First call commons_host_image with attachment bytes, an image artifact, a direct image URL, or a webpage URL, then place its returned permanent URL here. Validation does not fetch external images and reports unregistered URLs as not publishable. Submit retains a compatibility fallback for public URLs. The image is also added to the media manifest if absent.",
           "type": "object",
           "properties": {
             "url": {
               "type": "string",
               "format": "uri",
-              "description": "For a publish-ready entity, use the permanent URL returned by commons_host_image. Submit can auto-host a stable direct public HTTPS image URL as a compatibility fallback, but validation reports any unregistered external URL as not ready. Do not use a chat attachment reference, caller-local path, temporary or signed URL, private URL, or HTML page URL."
+              "description": "For a publish-ready entity, use the permanent URL returned by commons_host_image. Validation reports any unregistered external URL as not ready. Do not use a chat attachment reference, caller-local path, private URL, or HTML page URL here; pass the original image or webpage source to commons_host_image first."
             },
             "alt": {
               "description": "Accessible alternative text describing the image.",
@@ -6773,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"
             },
@@ -6997,13 +8185,13 @@ var MCP_TOOL_CATALOG = [
           "maxLength": 240
         },
         "featuredImage": {
-          "description": "Required for auto-published public entities. First call commons_host_image and place its returned permanent URL here; validation does not fetch external images and reports unregistered URLs as not publishable. Submit retains a compatibility fallback that auto-hosts a stable direct public HTTPS image URL. The image is also added to the media manifest if absent.",
+          "description": "Required for auto-published public entities. First call commons_host_image with attachment bytes, an image artifact, a direct image URL, or a webpage URL, then place its returned permanent URL here. Validation does not fetch external images and reports unregistered URLs as not publishable. Submit retains a compatibility fallback for public URLs. The image is also added to the media manifest if absent.",
           "type": "object",
           "properties": {
             "url": {
               "type": "string",
               "format": "uri",
-              "description": "For a publish-ready entity, use the permanent URL returned by commons_host_image. Submit can auto-host a stable direct public HTTPS image URL as a compatibility fallback, but validation reports any unregistered external URL as not ready. Do not use a chat attachment reference, caller-local path, temporary or signed URL, private URL, or HTML page URL."
+              "description": "For a publish-ready entity, use the permanent URL returned by commons_host_image. Validation reports any unregistered external URL as not ready. Do not use a chat attachment reference, caller-local path, private URL, or HTML page URL here; pass the original image or webpage source to commons_host_image first."
             },
             "alt": {
               "description": "Accessible alternative text describing the image.",
@@ -7698,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"
             },