mcpscraper-cli 0.36.0 → 0.38.0

package/README.md

@@ -2,7 +2,9 @@
 
 Command-line interface for [mcpscraper.dev](https://mcpscraper.dev) and [memory.mcpscraper.dev](https://memory.mcpscraper.dev).
 
-The CLI provides friendly shortcuts for common operations plus universal discovery and invocation for every one of the 363 unified MCP tools, including the governed personal-assistant tools.
+[Release history](https://github.com/VilovietaSEO/mcpscraper-sdk/blob/main/CHANGELOG.md)
+
+The CLI provides friendly shortcuts for common operations plus universal discovery and invocation for every one of the 369 unified MCP tools, including provider-neutral X-Ray surveys, attribution-impact reporting, and truthful evidence-status operations.
 
 ## Install
 
@@ -39,7 +41,7 @@ mcpscraper tools call gmail_prepare_selection --args '{"connectionId":"gmail_con
 mcpscraper tools call gmail_import_status --args '{"ingestId":"opaque_ingest_id"}' --json
 ```
 
-`tools list` contains exactly 356 manifest-backed names. `tools call` accepts any one of them. Tools marked destructive require `--yes`.
+`tools list` contains exactly 369 manifest-backed names. `tools call` accepts any one of them. Tools marked destructive require `--yes`.
 
 Integration connections are included with an active Starter plan or higher and have no extra connection-operation debit in this release. Scheduled occurrences cost 75 Credits; agent-mode runs also add 1.5 times OpenRouter's actual reported cost. Inspect the live policy with `mcpscraper tools call get-schedule-status --args '{}'`.
 

package/dist/bin/cli.js

@@ -10,7 +10,7 @@ import { randomUUID } from "crypto";
 import { ScraperClient, ScraperApiError } from "mcpscraper-sdk";
 
 // src/version.ts
-var CLI_VERSION = "0.36.0";
+var CLI_VERSION = "0.38.0";
 
 // src/generated-tools.ts
 var MCP_TOOL_CATALOG = [
@@ -737,10 +737,8 @@ var MCP_TOOL_CATALOG = [
           "type": "string",
           "enum": [
             "hubspot",
-            "salesforce",
             "highlevel",
             "zoho",
-            "pipedrive",
             "keap"
           ],
           "description": "Supported CRM provider."
@@ -959,10 +957,8 @@ var MCP_TOOL_CATALOG = [
               "type": "string",
               "enum": [
                 "hubspot",
-                "salesforce",
                 "highlevel",
                 "zoho",
-                "pipedrive",
                 "keap"
               ],
               "description": "Supported phone, CRM, or advertising provider for this governed connection."
@@ -3564,10 +3560,8 @@ var MCP_TOOL_CATALOG = [
           "type": "string",
           "enum": [
             "hubspot",
-            "salesforce",
             "highlevel",
             "zoho",
-            "pipedrive",
             "keap"
           ],
           "description": "Supported CRM provider."
@@ -3612,10 +3606,8 @@ var MCP_TOOL_CATALOG = [
           "type": "string",
           "enum": [
             "hubspot",
-            "salesforce",
             "highlevel",
             "zoho",
-            "pipedrive",
             "keap"
           ],
           "description": "Supported CRM provider."
@@ -7520,7 +7512,7 @@ var MCP_TOOL_CATALOG = [
     "name": "analytics_list_crm_capabilities",
     "category": "analytics",
     "title": "List CRM Capabilities",
-    "description": "List source-controlled capabilities and honest fallback states for all six supported CRMs.",
+    "description": "List source-controlled capabilities and honest fallback states for every publicly registered CRM.",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -8691,10 +8683,8 @@ var MCP_TOOL_CATALOG = [
           "type": "string",
           "enum": [
             "hubspot",
-            "salesforce",
             "highlevel",
             "zoho",
-            "pipedrive",
             "keap"
           ],
           "description": "Supported CRM provider."
@@ -9403,10 +9393,8 @@ var MCP_TOOL_CATALOG = [
           "type": "string",
           "enum": [
             "hubspot",
-            "salesforce",
             "highlevel",
             "zoho",
-            "pipedrive",
             "keap"
           ],
           "description": "Supported CRM provider; tenant evidence may narrow this provider to webhook or manual mode."
@@ -9536,10 +9524,8 @@ var MCP_TOOL_CATALOG = [
           "type": "string",
           "enum": [
             "hubspot",
-            "salesforce",
             "highlevel",
             "zoho",
-            "pipedrive",
             "keap"
           ],
           "description": "Supported CRM provider."
@@ -9810,10 +9796,8 @@ var MCP_TOOL_CATALOG = [
               "type": "string",
               "enum": [
                 "hubspot",
-                "salesforce",
                 "highlevel",
                 "zoho",
-                "pipedrive",
                 "keap"
               ],
               "description": "Supported phone, CRM, or advertising provider for this governed connection."
@@ -9970,10 +9954,8 @@ var MCP_TOOL_CATALOG = [
           "type": "string",
           "enum": [
             "hubspot",
-            "salesforce",
             "highlevel",
             "zoho",
-            "pipedrive",
             "keap"
           ],
           "description": "Supported CRM provider."
@@ -10453,10 +10435,8 @@ var MCP_TOOL_CATALOG = [
           "type": "string",
           "enum": [
             "hubspot",
-            "salesforce",
             "highlevel",
             "zoho",
-            "pipedrive",
             "keap"
           ],
           "description": "Supported CRM provider; scheduling fails closed unless effective capability permits polling."
@@ -10758,10 +10738,8 @@ var MCP_TOOL_CATALOG = [
           "type": "string",
           "enum": [
             "hubspot",
-            "salesforce",
             "highlevel",
             "zoho",
-            "pipedrive",
             "keap"
           ],
           "description": "Supported CRM provider."
@@ -29002,6 +28980,452 @@ var MCP_TOOL_CATALOG = [
       "idempotentHint": true,
       "openWorldHint": true
     }
+  },
+  {
+    "name": "analytics_create_post_purchase_survey",
+    "category": "analytics",
+    "title": "Create Post-Purchase Survey Draft",
+    "description": "Create an idempotent, structured, contact-free post-purchase survey draft. Customer answers remain reported influence and cannot establish identity, mutate CRM, qualify activation, or change observed touches.",
+    "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": "Authorized Analytics Site id."
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 160,
+          "description": "Owner-facing survey name."
+        },
+        "question": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 500,
+          "description": "Customer-visible structured influence question; do not request contact data or free text."
+        },
+        "selectionMode": {
+          "type": "string",
+          "enum": [
+            "single",
+            "multiple"
+          ],
+          "description": "Whether a respondent may select one influence or several."
+        },
+        "eligibleOutcomeFamilies": {
+          "minItems": 1,
+          "maxItems": 20,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 80
+          },
+          "description": "Authoritative outcome families eligible to receive an invitation."
+        },
+        "exchangeTtlSeconds": {
+          "type": "integer",
+          "minimum": 60,
+          "maximum": 86400,
+          "description": "Short-lived merchant exchange-code lifetime."
+        },
+        "sessionTtlSeconds": {
+          "type": "integer",
+          "minimum": 60,
+          "maximum": 86400,
+          "description": "Hosted survey session lifetime after one-time exchange."
+        },
+        "approvedCopyId": {
+          "description": "Versioned privacy disclosure approval. A draft may omit it; production publication may not.",
+          "anyOf": [
+            {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 200
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "options": {
+          "minItems": 2,
+          "maxItems": 20,
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "optionId": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 80,
+                "description": "Stable opaque option id; changing a label never changes this id."
+              },
+              "label": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 160,
+                "description": "Bounded owner-authored influence label. Free-text customer testimony is not accepted."
+              }
+            },
+            "required": [
+              "optionId",
+              "label"
+            ],
+            "additionalProperties": false
+          },
+          "description": "Two to twenty stable structured influences."
+        },
+        "idempotencyKey": {
+          "type": "string",
+          "minLength": 8,
+          "maxLength": 160,
+          "description": "Retry key; reuse only for this exact mutation."
+        }
+      },
+      "required": [
+        "siteId",
+        "name",
+        "question",
+        "selectionMode",
+        "eligibleOutcomeFamilies",
+        "exchangeTtlSeconds",
+        "sessionTtlSeconds",
+        "options",
+        "idempotencyKey"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Create Post-Purchase Survey Draft",
+      "readOnlyHint": false,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
+  },
+  {
+    "name": "analytics_get_attribution_methodology",
+    "category": "analytics",
+    "title": "Get X-Ray Attribution Methodology",
+    "description": "Read the seven observed models, default position weights, explicit observed-plus-reported methodology, and evidence boundaries. Use before requesting combined impact; this never turns survey testimony or aggregate impressions into deterministic touches.",
+    "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": "Authorized Analytics Site id."
+        }
+      },
+      "required": [
+        "siteId"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Get X-Ray Attribution Methodology",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
+  },
+  {
+    "name": "analytics_get_impact_report",
+    "category": "analytics",
+    "title": "Get Observed and Reported Impact",
+    "description": "Read an opt-in impact projection that keeps observed attribution and customer-reported influence in separate ledgers. Requires a published survey, one existing observed model, an immutable methodology version, and explicit weights totaling 1,000,000 micros.",
+    "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": "Authorized Analytics Site id."
+        },
+        "surveyId": {
+          "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": "Published or paused post-purchase survey whose immutable responses supply the reported ledger."
+        },
+        "baseModel": {
+          "type": "string",
+          "enum": [
+            "first_touch",
+            "last_touch",
+            "last_non_direct",
+            "linear",
+            "time_decay",
+            "position_based",
+            "custom_weighted"
+          ],
+          "description": "Existing observed attribution model; observed_plus_reported is deliberately not an observed model."
+        },
+        "observedWeightMicros": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 1e6,
+          "description": "Observed share in micros. It must total exactly 1,000,000 with reportedWeightMicros."
+        },
+        "reportedWeightMicros": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 1e6,
+          "description": "Customer-reported share in micros. It must total exactly 1,000,000 with observedWeightMicros."
+        },
+        "methodologyVersion": {
+          "type": "string",
+          "const": "xray_observed_plus_reported_equal_selected_v1",
+          "description": "Immutable methodology selected after reading analytics_get_attribution_methodology."
+        },
+        "from": {
+          "description": "Inclusive observed-evidence start. Omit with to for 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))$"
+        },
+        "to": {
+          "description": "Exclusive observed-evidence end. Omit 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))$"
+        },
+        "clickWindow": {
+          "default": 90,
+          "description": "Independent observed click window.",
+          "anyOf": [
+            {
+              "type": "number",
+              "const": 7
+            },
+            {
+              "type": "number",
+              "const": 14
+            },
+            {
+              "type": "number",
+              "const": 30
+            },
+            {
+              "type": "number",
+              "const": 60
+            },
+            {
+              "type": "number",
+              "const": 90
+            },
+            {
+              "type": "number",
+              "const": 180
+            },
+            {
+              "type": "number",
+              "const": 365
+            },
+            {
+              "type": "string",
+              "const": "lifetime"
+            }
+          ]
+        },
+        "viewWindow": {
+          "default": 90,
+          "description": "Independent view window; provider-unavailable state never manufactures view touches.",
+          "anyOf": [
+            {
+              "type": "number",
+              "const": 7
+            },
+            {
+              "type": "number",
+              "const": 14
+            },
+            {
+              "type": "number",
+              "const": 30
+            },
+            {
+              "type": "number",
+              "const": 60
+            },
+            {
+              "type": "number",
+              "const": 90
+            },
+            {
+              "type": "number",
+              "const": 180
+            },
+            {
+              "type": "number",
+              "const": 365
+            },
+            {
+              "type": "string",
+              "const": "lifetime"
+            }
+          ]
+        }
+      },
+      "required": [
+        "siteId",
+        "surveyId",
+        "baseModel",
+        "observedWeightMicros",
+        "reportedWeightMicros",
+        "methodologyVersion"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Get Observed and Reported Impact",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
+  },
+  {
+    "name": "analytics_get_post_purchase_survey_report",
+    "category": "analytics",
+    "title": "Get Post-Purchase Survey Report",
+    "description": "Read aggregate response coverage, option counts, and separately labeled reported-influence evidence for one survey. The output excludes contact fields, raw invitation tokens, and deterministic touch claims.",
+    "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": "Authorized Analytics Site id."
+        },
+        "surveyId": {
+          "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": "Owner-bound survey id."
+        }
+      },
+      "required": [
+        "siteId",
+        "surveyId"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Get Post-Purchase Survey Report",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
+  },
+  {
+    "name": "analytics_get_view_evidence_status",
+    "category": "analytics",
+    "title": "Get Provider View Evidence Status",
+    "description": "Read provider-by-provider availability for event-level view evidence. Unavailable or unproven is an honest result; aggregate campaign impressions can never create person-level attribution touches.",
+    "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": "Authorized Analytics Site id."
+        }
+      },
+      "required": [
+        "siteId"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Get Provider View Evidence Status",
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
+  },
+  {
+    "name": "analytics_set_post_purchase_survey_state",
+    "category": "analytics",
+    "title": "Set Post-Purchase Survey State",
+    "description": "Publish, pause, or irreversibly archive one exact survey revision. Production publication requires approved privacy disclosure evidence. Reuse the same idempotency key only for the identical transition; archive cannot be undone.",
+    "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": "Authorized Analytics Site id."
+        },
+        "surveyId": {
+          "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": "Owner-bound survey id."
+        },
+        "revision": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991,
+          "description": "Exact survey revision being changed."
+        },
+        "state": {
+          "type": "string",
+          "enum": [
+            "published",
+            "paused",
+            "archived"
+          ],
+          "description": "Publish or pause this revision. Archive is irreversible."
+        },
+        "approvedCopyId": {
+          "description": "Approved privacy disclosure identifier required for production publication; it is not legal approval by itself.",
+          "anyOf": [
+            {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 200
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "idempotencyKey": {
+          "type": "string",
+          "minLength": 8,
+          "maxLength": 160,
+          "description": "Retry key; reuse only for this exact mutation."
+        }
+      },
+      "required": [
+        "siteId",
+        "surveyId",
+        "revision",
+        "state",
+        "idempotencyKey"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Set Post-Purchase Survey State",
+      "readOnlyHint": false,
+      "destructiveHint": true,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
   }
 ];
 var MCP_TOOL_NAMES = MCP_TOOL_CATALOG.map((tool) => tool.name);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcpscraper-cli",
-  "version": "0.36.0",
+  "version": "0.38.0",
   "description": "Command-line interface for mcpscraper.dev and memory.mcpscraper.dev",
   "license": "MIT",
   "type": "module",
@@ -19,7 +19,7 @@
   },
   "dependencies": {
     "commander": "^12.0.0",
-    "mcpscraper-sdk": "^0.37.0"
+    "mcpscraper-sdk": "^0.39.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0"