mcpscraper-cli 0.55.0 → 0.56.0

package/README.md

@@ -2,7 +2,7 @@
 
 Command-line interface for the unified [mcpscraper.dev](https://mcpscraper.dev) MCP and REST APIs.
 
-[Release history](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.57.0)
+[Release history](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.58.0)
 
 The CLI provides friendly shortcuts for common operations plus universal discovery and invocation for every unified MCP tool, including retained-file readers, provider-neutral X-Ray surveys, attribution-impact reporting, and truthful evidence-status operations.
 
@@ -191,3 +191,7 @@ shows both paths.
 ## Saved Maps reviews
 
 Server 0.100.1 improves Maps discovery, review text and list collection through the existing interfaces. Use the exact name and location returned by discovery. Read the saved run and its review pages before considering a new acquisition. An explicit resume uses a fresh browser and reopens the profile and reviews; it retains saved review IDs. A new resume key authorizes a separately billed attempt, while repeating that key reads the same run.
+
+## Consistent hosted MCP protocol
+
+This release targets MCP Scraper 0.102.0 with 349 tools. Calls use protocol `2026-07-28` with matching routing headers and request metadata. Poll the returned job/run ID through its dedicated status tool; MCP Task handles are no longer supported. Lead enrichment cancellation uses `lead_list_enrich_cancel`. Update the SDK packages together.

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.55.0";
+var CLI_VERSION = "0.56.0";
 
 // src/generated-tools.ts
 var MCP_TOOL_CATALOG = [
@@ -10387,8 +10387,8 @@ var MCP_TOOL_CATALOG = [
         "templateId",
         "archived"
       ],
-      "$schema": "https://json-schema.org/draft/2020-12/schema",
-      "additionalProperties": false
+      "additionalProperties": false,
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
     },
     "annotations": {
       "title": "Archive Template",
@@ -15526,7 +15526,6 @@ var MCP_TOOL_CATALOG = [
     "description": "Save a user-owned template version 1 from a registered preset after inspecting search results and, when useful, get_artifact_template_example. Customize supported flags and presentation guidance; arbitrary HTML, CSS, JavaScript, executable code, and tool-selecting prompts are not accepted.",
     "inputSchema": {
       "type": "object",
-      "$schema": "https://json-schema.org/draft/2020-12/schema",
       "oneOf": [
         {
           "type": "object",
@@ -16119,7 +16118,8 @@ var MCP_TOOL_CATALOG = [
           ],
           "additionalProperties": false
         }
-      ]
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
     },
     "annotations": {
       "title": "Save Template",
@@ -19705,8 +19705,8 @@ var MCP_TOOL_CATALOG = [
       "required": [
         "templateId"
       ],
-      "$schema": "https://json-schema.org/draft/2020-12/schema",
-      "additionalProperties": false
+      "additionalProperties": false,
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
     },
     "annotations": {
       "title": "Get Template",
@@ -19739,8 +19739,8 @@ var MCP_TOOL_CATALOG = [
       "required": [
         "presetKey"
       ],
-      "$schema": "https://json-schema.org/draft/2020-12/schema",
-      "additionalProperties": false
+      "additionalProperties": false,
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
     },
     "annotations": {
       "title": "Preview Template Example",
@@ -20875,7 +20875,7 @@ var MCP_TOOL_CATALOG = [
     "name": "harvest_paa",
     "category": "search",
     "title": "Google PAA + SERP Harvest",
-    "description": "Expand one Google People Also Ask SERP into full captured answers, every source with available titles/descriptions, organic snippets, AI Overview evidence, ranking URLs, and entity IDs. Unfinished answer expansion is partial. Set pages to 2 for a second organic page when available; PAA expands once on page one, and pagination reports captured coverage. maxQuestions is a target count, not traversal depth. Results distinguish target_reached, proven frontier_exhausted, interruption, and recovery_exhausted; failed clicks and timeouts never prove exhaustion. This tool waits; use harvest_paa_start and harvest_paa_status for long runs. Wait at least 20 seconds before the first durable job or Task check and each later check. Optional SERP modules require include flags. Use gl and location for regional context. Costs 400 Credits per harvest plus 10 Credits per question actually returned; unused hold is refunded. After a timeout or unknown response, reuse the same idempotencyKey. Call credits_info for current pricing and balance.",
+    "description": "Expand one Google People Also Ask SERP into full captured answers, every source with available titles/descriptions, organic snippets, AI Overview evidence, ranking URLs, and entity IDs. Unfinished answer expansion is partial. Set pages to 2 for a second organic page when available; PAA expands once on page one, and pagination reports captured coverage. maxQuestions is a target count, not traversal depth. Results distinguish target_reached, proven frontier_exhausted, interruption, and recovery_exhausted; failed clicks and timeouts never prove exhaustion. This tool waits; use harvest_paa_start and harvest_paa_status for long runs. Wait at least 20 seconds before the first durable job check and each later check. Optional SERP modules require include flags. Use gl and location for regional context. Costs 400 Credits per harvest plus 10 Credits per question actually returned; unused hold is refunded. After a timeout or unknown response, reuse the same idempotencyKey. Call credits_info for current pricing and balance.",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -21895,7 +21895,7 @@ var MCP_TOOL_CATALOG = [
     "name": "lead_list_enrich",
     "category": "leads",
     "title": "Enrich a Lead List",
-    "description": "Enrich 1\u2013250 mapped business or person rows, supplied inline or by leadListId, with matched public website, phone, email, social, contact-form, and optional associated-person evidence. Use when the list already exists; to inspect a file first use lead_list_import, to discover businesses from a niche plus city use workflow_run with get-leads, and for candidate-only Maps discovery use maps_search. Starts an owner-scoped durable Task, bills underlying Maps/page/SERP attempts with unused hold refunded, and retains requested CSV/XLSX results seven days. Opt-in email snippet recovery costs at most one SERP search per unresolved row. For peopleDiscovery, author one-to-three focused peopleQueryTemplates with one role intent per query; each role query reads AI Overview plus organic results, then at most maxPeoplePerLead company-matched LinkedIn result searches run without opening LinkedIn pages. Public email occurrence is not deliverability or consent verification and is not permission to contact. A public role or LinkedIn occurrence is not verified current employment. Reuse idempotencyKey only to retry the same intended job.",
+    "description": "Enrich 1\u2013250 mapped business or person rows, supplied inline or by leadListId, with matched public website, phone, email, social, contact-form, and optional associated-person evidence. Use when the list already exists; to inspect a file first use lead_list_import, to discover businesses from a niche plus city use workflow_run with get-leads, and for candidate-only Maps discovery use maps_search. Starts an owner-scoped durable job. Poll lead_list_enrich_status with its jobId. Underlying Maps/page/SERP attempts are billed with unused hold refunded; requested CSV/XLSX results are retained seven days. Opt-in email snippet recovery costs at most one SERP search per unresolved row. For peopleDiscovery, author one-to-three focused peopleQueryTemplates with one role intent per query; each role query reads AI Overview plus organic results, then at most maxPeoplePerLead company-matched LinkedIn result searches run without opening LinkedIn pages. Public email occurrence is not deliverability or consent verification and is not permission to contact. A public role or LinkedIn occurrence is not verified current employment. Reuse idempotencyKey only to retry the same intended job.",
     "inputSchema": {
       "type": "object",
       "properties": {
@@ -22142,6 +22142,33 @@ var MCP_TOOL_CATALOG = [
       "openWorldHint": true
     }
   },
+  {
+    "name": "lead_list_enrich_cancel",
+    "category": "leadLists",
+    "title": "Cancel Lead List Enrichment",
+    "description": "Request cancellation of the original jobId returned by lead_list_enrich. Stops rows that have not started; an in-flight acquisition may finish and retain its cost. Returns current progress and billing; use lead_list_enrich_status to confirm the terminal state. Repeating cancellation does not start or bill another enrichment.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "jobId": {
+          "type": "string",
+          "minLength": 1,
+          "description": "The jobId returned by lead_list_enrich. Poll until status is complete, partial, empty, failed, or cancelled."
+        }
+      },
+      "required": [
+        "jobId"
+      ],
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
+    },
+    "annotations": {
+      "title": "Cancel Lead List Enrichment",
+      "readOnlyHint": false,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    }
+  },
   {
     "name": "lead_list_enrich_status",
     "category": "leads",
@@ -22455,8 +22482,8 @@ var MCP_TOOL_CATALOG = [
           ]
         }
       },
-      "$schema": "https://json-schema.org/draft/2020-12/schema",
-      "additionalProperties": false
+      "additionalProperties": false,
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
     },
     "annotations": {
       "title": "Search Templates",
@@ -27451,8 +27478,8 @@ var MCP_TOOL_CATALOG = [
       "required": [
         "templateId"
       ],
-      "$schema": "https://json-schema.org/draft/2020-12/schema",
-      "additionalProperties": false
+      "additionalProperties": false,
+      "$schema": "https://json-schema.org/draft/2020-12/schema"
     },
     "annotations": {
       "title": "Update Template",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcpscraper-cli",
-  "version": "0.55.0",
+  "version": "0.56.0",
   "description": "Command-line interface for the unified mcpscraper.dev MCP and REST APIs",
   "license": "MIT",
   "type": "module",
@@ -19,7 +19,7 @@
   },
   "dependencies": {
     "commander": "^12.0.0",
-    "mcpscraper-sdk": "^0.57.0"
+    "mcpscraper-sdk": "^0.58.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0"