mcp-scraper 0.66.2 → 0.66.3

package/CHANGELOG.md

@@ -4,6 +4,16 @@ All notable changes to MCP Scraper are documented here. The format is based on [
 
 ## [Unreleased]
 
+## [0.66.3] - 2026-08-25
+
+### Changed
+
+- Runtime MCP discovery now omits output schemas across hosted OAuth, API-key, npm stdio, and MCPB clients, while the complete generated developer contract continues to supply typed Node and Python SDK outputs.
+
+### Fixed
+
+- Restored compatibility for strict MCP clients that could connect successfully but silently register zero tools when the complete output-schema catalog was advertised; tool calls retain both readable content and structured results.
+
 ## [0.66.2] - 2026-08-24
 
 ### Changed
@@ -1088,7 +1098,8 @@ All notable changes to MCP Scraper are documented here. The format is based on [
 - Write actions remain unavailable until the account owner explicitly enables them.
 - Provider-specific connection data is normalized into one agent-facing contract.
 
-[Unreleased]: https://github.com/VilovietaSEO/mcp-scraper/compare/v0.66.2...HEAD
+[Unreleased]: https://github.com/VilovietaSEO/mcp-scraper/compare/v0.66.3...HEAD
+[0.66.3]: https://github.com/VilovietaSEO/mcp-scraper/compare/v0.66.2...v0.66.3
 [0.66.2]: https://github.com/VilovietaSEO/mcp-scraper/compare/v0.66.1...v0.66.2
 [0.66.1]: https://github.com/VilovietaSEO/mcp-scraper/compare/v0.66.0...v0.66.1
 [0.66.0]: https://github.com/VilovietaSEO/mcp-scraper/compare/v0.65.1...v0.66.0

package/README.md

@@ -159,7 +159,7 @@ Build the branded one-click bundle:
 npm run build:mcpb
 ```
 
-The generated bundle is written to `build/mcpb/mcp-scraper-<version>.mcpb` and copied to `public/downloads/` for the hosted download. The current public bundle is `https://mcpscraper.dev/downloads/mcp-scraper.mcpb` (`0.66.2`, SHA-256 `0ed9a49cc80f3d8b2da41039e9a9baeeb77b3f626cd9f98a4e2c84e566e1a79d`). Install it by opening or dragging it into Claude Desktop. Claude displays the `MCP Scraper` install card, icon, API-key configuration field, and manually curated current-release message from the bundle manifest.
+The generated bundle is written to `build/mcpb/mcp-scraper-<version>.mcpb` and copied to `public/downloads/` for the hosted download. The current public bundle is `https://mcpscraper.dev/downloads/mcp-scraper.mcpb` (`0.66.3`, SHA-256 `353b034b878340971fc1e07ca2ccf11578d6fd2e2ff894c8da1fa7df2c2bbd2d`). Install it by opening or dragging it into Claude Desktop. Claude displays the `MCP Scraper` install card, icon, API-key configuration field, and manually curated current-release message from the bundle manifest.
 
 The MCPB install exposes every tool — web-intelligence plus all `browser_*` tools — through the one `mcp-scraper` server.
 
@@ -315,7 +315,7 @@ For Google SERP and Maps tools, callers provide the query, two-letter country co
 
 The `mcp-scraper` server (and the MCPB bundle, which runs it) exposes both sections through one MCP server.
 
-All MCP tools expose output schemas and return `structuredContent` with the IDs, URLs, CSV paths, transcripts, browser session handles, replay paths, artifacts, recipe fields, or blueprint fields needed by the next step. Browser Agent tools keep a JSON text block for older clients, but structured data is the primary contract. All tools carry MCP annotations; file-writing tools such as replay downloads and annotations state their filesystem side effects.
+All MCP tools return `structuredContent` with the IDs, URLs, CSV paths, transcripts, browser session handles, replay paths, artifacts, recipe fields, or blueprint fields needed by the next step, plus readable text content for compatibility. Runtime `tools/list` omits output schemas so strict clients can register the complete catalog; the generated developer manifest retains every canonical output schema for validation and typed SDK generation. All tools carry MCP annotations; file-writing tools such as replay downloads and annotations state their filesystem side effects.
 
 The canonical tool inventory is generated at `docs/mcp-tool-manifest.generated.json`. The unified server exposes 259 tools: 158 scraper, browser, workflow, billing, and connected-service tools plus 101 durable-memory tools. The scraper-side inventory includes rendered site-content similarity, governed Local Sourcebook tools, Transparent Commons entity, linkset, and publication tools, direct site-export text and image readers, the searchable News Publisher and Editorial Reading Room template workflow, and 24 X-Ray tools for pixel administration, reporting, attribution journeys, campaign links, exports, and scheduled reports. Successful evidence-compiled Local Sourcebook revisions publish automatically to their canonical `localsourcebook.com` category profile and review URLs; administrator controls handle exceptional rejection or unpublishing. Release verification compares the exact local and hosted tool-name sets, not only the count.
 

package/dist/bin/api-server.cjs

@@ -49679,7 +49679,7 @@ var PACKAGE_VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    PACKAGE_VERSION = "0.66.2";
+    PACKAGE_VERSION = "0.66.3";
   }
 });
 
@@ -50109,14 +50109,30 @@ var init_server_instructions = __esm({
 });
 
 // src/mcp/output-schema-registry.ts
+function resolveOutputSchemaMode(env = process.env) {
+  const requested = env.MCP_SCRAPER_OUTPUT_SCHEMA_MODE?.trim().toLowerCase();
+  if (requested) {
+    if (requested === "contract" || requested === "all") return "contract";
+    if (requested === "runtime" || requested === "none" || requested === "essential") return "runtime";
+    throw new Error(`Unsupported MCP_SCRAPER_OUTPUT_SCHEMA_MODE: ${requested}`);
+  }
+  const legacyAdvertisement = env.MCP_SCRAPER_ADVERTISE_OUTPUT_SCHEMAS?.trim().toLowerCase();
+  if (legacyAdvertisement === "true") return "contract";
+  if (legacyAdvertisement === void 0 || legacyAdvertisement === "" || legacyAdvertisement === "false") {
+    return "runtime";
+  }
+  throw new Error(`Unsupported MCP_SCRAPER_ADVERTISE_OUTPUT_SCHEMAS value: ${legacyAdvertisement}`);
+}
 function recordOutputSchema(name, schema) {
   OUTPUT_SCHEMAS[name] = schema;
-  return schema;
+  return ADVERTISE_OUTPUT_SCHEMAS ? schema : void 0;
 }
-var OUTPUT_SCHEMAS;
+var OUTPUT_SCHEMA_MODE, ADVERTISE_OUTPUT_SCHEMAS, OUTPUT_SCHEMAS;
 var init_output_schema_registry = __esm({
   "src/mcp/output-schema-registry.ts"() {
     "use strict";
+    OUTPUT_SCHEMA_MODE = resolveOutputSchemaMode();
+    ADVERTISE_OUTPUT_SCHEMAS = OUTPUT_SCHEMA_MODE === "contract";
     OUTPUT_SCHEMAS = {};
   }
 });

package/dist/bin/api-server.js

@@ -17,7 +17,7 @@ loadDotEnv();
 async function main() {
   const [{ serve }, { app }, { startWorker }, { migrate }] = await Promise.all([
     import("@hono/node-server"),
-    import("../server-Q7VYGSGQ.js"),
+    import("../server-D47PNEXR.js"),
     import("../worker-UTBUWEXQ.js"),
     import("../db-4RVZ3NYZ.js")
   ]);

package/dist/bin/mcp-scraper-cli.cjs

@@ -30,7 +30,7 @@ var import_promises5 = require("fs/promises");
 var import_node_path3 = require("path");
 
 // src/version.ts
-var PACKAGE_VERSION = "0.66.2";
+var PACKAGE_VERSION = "0.66.3";
 
 // src/cli/agent-config.ts
 function apiKeyValue(options) {

package/dist/bin/mcp-scraper-cli.js

@@ -13,7 +13,7 @@ import "../chunk-VXLU74YZ.js";
 import "../chunk-GGZEC22A.js";
 import {
   PACKAGE_VERSION
-} from "../chunk-ALEBMPOW.js";
+} from "../chunk-JBFLOJGM.js";
 
 // src/cli/human-cli.ts
 import { Command } from "commander";

package/dist/bin/mcp-scraper-install.cjs

@@ -3,7 +3,7 @@
 
 // release-message.json
 var release_message_default = {
-  message: "PAA work now starts immediately on the direct runtime, and every MCP Scraper install exposes the same complete typed tool contract."
+  message: "Strict MCP clients now discover all 259 tools through a compact runtime catalog, while generated SDKs retain complete output types."
 };
 
 // src/install-terminal.ts
@@ -112,7 +112,7 @@ function renderInstallTerminal(options) {
 }
 
 // src/version.ts
-var PACKAGE_VERSION = "0.66.2";
+var PACKAGE_VERSION = "0.66.3";
 
 // bin/mcp-scraper-install.ts
 var noColor = process.argv.includes("--no-color") || process.env.NO_COLOR !== void 0 || process.env.FORCE_COLOR === "0" || !process.stdout.isTTY;

package/dist/bin/mcp-scraper-install.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   renderInstallTerminal
-} from "../chunk-OZDCTNUV.js";
+} from "../chunk-2XVDLF6H.js";
 import {
   PACKAGE_VERSION
-} from "../chunk-ALEBMPOW.js";
+} from "../chunk-JBFLOJGM.js";
 
 // bin/mcp-scraper-install.ts
 var noColor = process.argv.includes("--no-color") || process.env.NO_COLOR !== void 0 || process.env.FORCE_COLOR === "0" || !process.stdout.isTTY;

package/dist/bin/mcp-stdio-server.cjs

@@ -1232,7 +1232,7 @@ render();
 }
 
 // src/version.ts
-var PACKAGE_VERSION = "0.66.2";
+var PACKAGE_VERSION = "0.66.3";
 
 // src/mcp/input-field-descriptions.ts
 var import_zod = require("zod");
@@ -2237,10 +2237,26 @@ async function annotateReplayVideo(inputFilePath, outputFilePath, options) {
 }
 
 // src/mcp/output-schema-registry.ts
+function resolveOutputSchemaMode(env = process.env) {
+  const requested = env.MCP_SCRAPER_OUTPUT_SCHEMA_MODE?.trim().toLowerCase();
+  if (requested) {
+    if (requested === "contract" || requested === "all") return "contract";
+    if (requested === "runtime" || requested === "none" || requested === "essential") return "runtime";
+    throw new Error(`Unsupported MCP_SCRAPER_OUTPUT_SCHEMA_MODE: ${requested}`);
+  }
+  const legacyAdvertisement = env.MCP_SCRAPER_ADVERTISE_OUTPUT_SCHEMAS?.trim().toLowerCase();
+  if (legacyAdvertisement === "true") return "contract";
+  if (legacyAdvertisement === void 0 || legacyAdvertisement === "" || legacyAdvertisement === "false") {
+    return "runtime";
+  }
+  throw new Error(`Unsupported MCP_SCRAPER_ADVERTISE_OUTPUT_SCHEMAS value: ${legacyAdvertisement}`);
+}
+var OUTPUT_SCHEMA_MODE = resolveOutputSchemaMode();
+var ADVERTISE_OUTPUT_SCHEMAS = OUTPUT_SCHEMA_MODE === "contract";
 var OUTPUT_SCHEMAS = {};
 function recordOutputSchema(name, schema) {
   OUTPUT_SCHEMAS[name] = schema;
-  return schema;
+  return ADVERTISE_OUTPUT_SCHEMAS ? schema : void 0;
 }
 
 // src/mcp/browser-agent-mcp-server.ts
@@ -18639,7 +18655,7 @@ var HostedMemoryMcpToolExecutor = class {
 
 // release-message.json
 var release_message_default = {
-  message: "PAA work now starts immediately on the direct runtime, and every MCP Scraper install exposes the same complete typed tool contract."
+  message: "Strict MCP clients now discover all 259 tools through a compact runtime catalog, while generated SDKs retain complete output types."
 };
 
 // src/install-terminal.ts

package/dist/bin/mcp-stdio-server.js

@@ -13,18 +13,18 @@ import {
   registerScheduledResultsMcpTools,
   registerSerpIntelligenceCaptureTools,
   resolveDeploymentProfile
-} from "../chunk-YKL3O7IU.js";
+} from "../chunk-LNLMOBP6.js";
 import "../chunk-PGJQDMC2.js";
 import "../chunk-3EYALCYK.js";
 import "../chunk-3TKKJQB4.js";
 import {
   renderInstallTerminal
-} from "../chunk-OZDCTNUV.js";
+} from "../chunk-2XVDLF6H.js";
 import "../chunk-VXLU74YZ.js";
 import "../chunk-GGZEC22A.js";
 import {
   PACKAGE_VERSION
-} from "../chunk-ALEBMPOW.js";
+} from "../chunk-JBFLOJGM.js";
 import "../chunk-DNM65UCK.js";
 import "../chunk-AYJHI2FK.js";
 import "../chunk-55B3T5L2.js";

package/dist/{chunk-OZDCTNUV.js → chunk-2XVDLF6H.js}

@@ -1,6 +1,6 @@
 // release-message.json
 var release_message_default = {
-  message: "PAA work now starts immediately on the direct runtime, and every MCP Scraper install exposes the same complete typed tool contract."
+  message: "Strict MCP clients now discover all 259 tools through a compact runtime catalog, while generated SDKs retain complete output types."
 };
 
 // src/install-terminal.ts

package/dist/{chunk-ALEBMPOW.js → chunk-JBFLOJGM.js}

@@ -1,5 +1,5 @@
 // src/version.ts
-var PACKAGE_VERSION = "0.66.2";
+var PACKAGE_VERSION = "0.66.3";
 
 export {
   PACKAGE_VERSION

package/dist/{chunk-YKL3O7IU.js → chunk-LNLMOBP6.js}

@@ -25,7 +25,7 @@ import {
 } from "./chunk-VXLU74YZ.js";
 import {
   PACKAGE_VERSION
-} from "./chunk-ALEBMPOW.js";
+} from "./chunk-JBFLOJGM.js";
 import {
   createPrivateArtifact,
   privateArtifactOwnerId,
@@ -5006,10 +5006,26 @@ ${rows}` : ""
 }
 
 // src/mcp/output-schema-registry.ts
+function resolveOutputSchemaMode(env = process.env) {
+  const requested = env.MCP_SCRAPER_OUTPUT_SCHEMA_MODE?.trim().toLowerCase();
+  if (requested) {
+    if (requested === "contract" || requested === "all") return "contract";
+    if (requested === "runtime" || requested === "none" || requested === "essential") return "runtime";
+    throw new Error(`Unsupported MCP_SCRAPER_OUTPUT_SCHEMA_MODE: ${requested}`);
+  }
+  const legacyAdvertisement = env.MCP_SCRAPER_ADVERTISE_OUTPUT_SCHEMAS?.trim().toLowerCase();
+  if (legacyAdvertisement === "true") return "contract";
+  if (legacyAdvertisement === void 0 || legacyAdvertisement === "" || legacyAdvertisement === "false") {
+    return "runtime";
+  }
+  throw new Error(`Unsupported MCP_SCRAPER_ADVERTISE_OUTPUT_SCHEMAS value: ${legacyAdvertisement}`);
+}
+var OUTPUT_SCHEMA_MODE = resolveOutputSchemaMode();
+var ADVERTISE_OUTPUT_SCHEMAS = OUTPUT_SCHEMA_MODE === "contract";
 var OUTPUT_SCHEMAS = {};
 function recordOutputSchema(name, schema) {
   OUTPUT_SCHEMAS[name] = schema;
-  return schema;
+  return ADVERTISE_OUTPUT_SCHEMAS ? schema : void 0;
 }
 
 // src/mcp/meta-ad-creative-media.ts

package/dist/{server-Q7VYGSGQ.js → server-D47PNEXR.js}

@@ -199,7 +199,7 @@ import {
   resolveDeploymentProfile,
   resolveLocalSourcebookSchemaType,
   transcribeMediaUrl
-} from "./chunk-YKL3O7IU.js";
+} from "./chunk-LNLMOBP6.js";
 import {
   auditImageUrls,
   auditImages,
@@ -256,7 +256,7 @@ import {
 } from "./chunk-GGZEC22A.js";
 import {
   PACKAGE_VERSION
-} from "./chunk-ALEBMPOW.js";
+} from "./chunk-JBFLOJGM.js";
 import {
   SITE_EXTRACT_ARTIFACT_PREFIX,
   abandonExtractSettlement,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-scraper",
-  "version": "0.66.2",
+  "version": "0.66.3",
   "description": "MCP server for MCP Scraper web intelligence tools",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -37,6 +37,7 @@
     "build": "tsup",
     "build:md": "node scripts/build-md-mirror.mjs",
     "build:mcpb": "npm run build && node scripts/build-mcpb.mjs",
+    "build:mcpb:candidate": "npm run build && node scripts/build-mcpb.mjs --candidate",
     "build:rates": "node --import tsx scripts/gen-rates.ts",
     "build:geotargets": "node --import tsx scripts/gen-geotargets.ts",
     "build:blog": "node scripts/run-ts-sandbox-safe.mjs scripts/build-blog.ts",
@@ -79,7 +80,8 @@
     "db:migrate": "node --import tsx scripts/run-core-migration.ts",
     "analytics:migrate": "node --import tsx scripts/run-analytics-migration.ts",
     "analytics:rollups": "node --import tsx scripts/run-analytics-rollups.ts",
-    "mcp:verify": "npm run build && npm run mcp:manifest && npm run build:rates && npm run mcp:measure-catalog && npm run mcp:lint-tools && npm run typecheck && npm test && npm run package:verify-entrypoints",
+    "test:mcp-output-contract": "vitest run --config vitest.mcp-output-contract.config.ts tests/unit/golden-payloads.test.ts tests/unit/mcp-formatter-structured.test.ts tests/unit/mcp-2026-stdio.test.ts",
+    "mcp:verify": "npm run build && npm run mcp:manifest && npm run build:rates && npm run mcp:measure-catalog && npm run mcp:lint-tools && npm run test:mcp-output-contract && npm run typecheck && npm test && npm run package:verify-entrypoints",
     "prepack": "npm run mcp:verify",
     "package:verify-entrypoints": "node scripts/verify-package-entrypoints.mjs"
   },