simple-dynamsoft-mcp 7.2.8 → 7.3.0

package/src/server/tools/register-project-tools.js

@@ -1,6 +1,8 @@
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
 import { dirname, join, relative } from "node:path";
 import { z } from "zod";
+import { buildUnknownPublicProductResponse, isKnownPublicOffering } from "../public-offerings.js";
+import { buildUnsupportedPublicScopeResponse } from "./public-routing.js";
 
 export function registerProjectTools({
   server,
@@ -22,10 +24,46 @@ export function registerProjectTools({
   getDcvMobileSamplePath,
   getDcvServerSamplePath,
   getDcvWebSamplePath,
+  getMrzWebSamplePath,
+  getMdsWebSamplePath,
   getDwtSamplePath,
   getDdvSamplePath,
   getSampleSuggestions
 }) {
+  async function resolveDedicatedPublicWebSamplePath({
+    product,
+    platform,
+    sampleName,
+    getSamplePath,
+    getSuggestions
+  }) {
+    const directPath = getSamplePath(undefined, sampleName);
+    if (directPath && existsSync(directPath)) {
+      return directPath;
+    }
+
+    const suggestions = await getSuggestions({
+      query: sampleName,
+      product,
+      edition: "web",
+      platform,
+      limit: 10
+    });
+
+    const matchingEntry = suggestions.find((entry) => {
+      if (entry.type !== "sample") return false;
+      const parsed = parseSampleUri(entry.uri);
+      return parsed?.product === product && parsed?.edition === "web" && parsed?.sampleName === sampleName;
+    });
+
+    if (!matchingEntry) {
+      return directPath;
+    }
+
+    const parsed = parseSampleUri(matchingEntry.uri);
+    return getSamplePath(parsed?.category, sampleName);
+  }
+
   server.registerTool(
     "get_sample_files",
     {
@@ -43,12 +81,12 @@ export function registerProjectTools({
         "- If the user just wants a quick code snippet, use get_quickstart instead.",
         "",
         "PARAMETERS:",
-        "- product (required): dcv, dbr, dwt, or ddv.",
+        "- product (required): dbr, dwt, ddv, mrz, or mds.",
         "- edition: mobile, web, or server.",
         "- platform: android, ios, js, python, cpp, java, dotnet, nodejs, react, vue, angular, flutter, react-native, maui, etc.",
         "- version: Version constraint. Latest major is used by default.",
         "- sample_id: Sample identifier as returned by list_samples (e.g. 'hello-world', 'ScanSingleBarcode'). Requires product/edition.",
-        "- resource_uri: A sample:// URI as returned by search (e.g. 'sample://dbr/mobile/android/10/high-level/ScanSingleBarcode'). Preferred over sample_id when available.",
+        "- resource_uri: A sample:// URI as returned by search (e.g. 'sample://dbr/mobile/android/10/high-level/ScanSingleBarcode' or 'sample://mrz/server/python/3/mrz_scanner'). Preferred over sample_id when available.",
         "- api_level: 'high-level' or 'low-level' (DBR mobile only).",
         "",
         "RETURNS: A text block containing all project files inline, each under a heading with its relative path and wrapped in a fenced code block. Files larger than 50KB are excluded. No zip file is created.",
@@ -58,7 +96,7 @@ export function registerProjectTools({
         "RELATED TOOLS: list_samples (discover sample IDs), search (find samples by keyword), get_quickstart (quick single-file snippet)."
       ].join("\n"),
       inputSchema: {
-        product: z.string().trim().min(1, "Product is required.").describe("Product: dcv, dbr, dwt, or ddv"),
+        product: z.string().trim().min(1, "Product is required.").describe("Product: dbr, dwt, ddv, mrz, mds"),
         edition: z.string().optional().describe("Edition: mobile, web, server/desktop"),
         platform: z.string().optional().describe("Platform: android, ios, maui, react-native, flutter, js, python, cpp, java, dotnet, nodejs, angular, blazor, capacitor, electron, es6, native-ts, next, nuxt, pwa, react, requirejs, svelte, vue, webview"),
         version: z.string().optional().describe("Version constraint"),
@@ -74,29 +112,6 @@ export function registerProjectTools({
       }
     },
     async ({ product, edition, platform, version, sample_id, resource_uri, api_level }) => {
-      const normalizedProduct = normalizeProduct(product);
-      const normalizedPlatform = normalizePlatform(platform);
-      const normalizedEdition = normalizeEdition(edition, normalizedPlatform, normalizedProduct);
-
-      await ensureScopeHydrated({
-        product: normalizedProduct,
-        edition: normalizedEdition,
-        platform: normalizedPlatform,
-        type: "sample"
-      });
-
-      const policy = ensureLatestMajor({
-        product: normalizedProduct,
-        version,
-        query: sample_id,
-        edition: normalizedEdition,
-        platform: normalizedPlatform
-      });
-
-      if (!policy.ok) {
-        return { isError: true, content: [{ type: "text", text: policy.message }] };
-      }
-
       let sampleInfo = null;
       if (resource_uri) {
         const parsed = parseResourceUri(resource_uri);
@@ -130,6 +145,35 @@ export function registerProjectTools({
         }
       }
 
+      const normalizedProduct = normalizeProduct(sampleInfo?.product || product);
+      if ((sampleInfo?.product || product) && !isKnownPublicOffering(normalizedProduct)) {
+        return buildUnknownPublicProductResponse(sampleInfo?.product || product);
+      }
+
+      const normalizedPlatform = normalizePlatform(sampleInfo?.platform || platform);
+      const normalizedEdition = normalizeEdition(sampleInfo?.edition || edition, normalizedPlatform, normalizedProduct);
+      const unsupportedScopeResponse = buildUnsupportedPublicScopeResponse(normalizedProduct, normalizedEdition, normalizedPlatform);
+      if (unsupportedScopeResponse) return unsupportedScopeResponse;
+
+      await ensureScopeHydrated({
+        product: normalizedProduct,
+        edition: normalizedEdition,
+        platform: normalizedPlatform,
+        type: "sample"
+      });
+
+      const policy = ensureLatestMajor({
+        product: normalizedProduct,
+        version,
+        query: sample_id,
+        edition: normalizedEdition,
+        platform: normalizedPlatform
+      });
+
+      if (!policy.ok) {
+        return { isError: true, content: [{ type: "text", text: policy.message }] };
+      }
+
       let samplePath = null;
       let sampleLabel = "";
       let sampleQuery = "";
@@ -143,6 +187,14 @@ export function registerProjectTools({
           samplePath = getWebSamplePath(sampleInfo.category, sampleInfo.sampleName);
         } else if (sampleInfo.product === "dbr" && (sampleInfo.edition === "python" || sampleInfo.edition === "server")) {
           samplePath = getDbrServerSamplePath(sampleInfo.platform, sampleInfo.sampleName);
+        } else if ((sampleInfo.product === "mrz" || sampleInfo.product === "mds") && sampleInfo.edition === "mobile") {
+          samplePath = getDcvMobileSamplePath(sampleInfo.platform, sampleInfo.sampleName);
+        } else if ((sampleInfo.product === "mrz" || sampleInfo.product === "mds") && sampleInfo.edition === "server") {
+          samplePath = getDcvServerSamplePath(sampleInfo.platform, sampleInfo.sampleName);
+        } else if ((sampleInfo.product === "mrz" || sampleInfo.product === "mds") && sampleInfo.edition === "web") {
+          samplePath = sampleInfo.product === "mrz"
+            ? getMrzWebSamplePath(sampleInfo.category, sampleInfo.sampleName)
+            : getMdsWebSamplePath(sampleInfo.category, sampleInfo.sampleName);
         } else if (sampleInfo.product === "dcv" && sampleInfo.edition === "mobile") {
           samplePath = getDcvMobileSamplePath(sampleInfo.platform, sampleInfo.sampleName);
         } else if (sampleInfo.product === "dcv" && sampleInfo.edition === "server") {
@@ -176,6 +228,27 @@ export function registerProjectTools({
           const altLevel = level === "high-level" ? "low-level" : "high-level";
           const alternatePath = getMobileSamplePath(targetPlatform, altLevel, sampleName);
           samplePath = existsSync(primaryPath) ? primaryPath : (existsSync(alternatePath) ? alternatePath : null);
+        } else if ((normalizedProduct === "mrz" || normalizedProduct === "mds") && normalizedEdition === "mobile") {
+          const platformCandidates = normalizedPlatform
+            ? [normalizedPlatform]
+            : ["android", "ios", "react-native", "flutter", "maui", "spm"];
+          for (const platformCandidate of platformCandidates) {
+            const candidate = getDcvMobileSamplePath(platformCandidate, sampleName);
+            if (candidate && existsSync(candidate)) {
+              samplePath = candidate;
+              break;
+            }
+          }
+        } else if ((normalizedProduct === "mrz" || normalizedProduct === "mds") && normalizedEdition === "web") {
+          samplePath = await resolveDedicatedPublicWebSamplePath({
+            product: normalizedProduct,
+            platform: normalizedPlatform,
+            sampleName,
+            getSamplePath: normalizedProduct === "mrz" ? getMrzWebSamplePath : getMdsWebSamplePath,
+            getSuggestions: getSampleSuggestions
+          });
+        } else if ((normalizedProduct === "mrz" || normalizedProduct === "mds") && normalizedEdition === "server") {
+          samplePath = getDcvServerSamplePath(normalizedPlatform || "python", sampleName);
         } else if (normalizedProduct === "dcv" && normalizedEdition === "mobile") {
           const platformCandidates = normalizedPlatform
             ? [normalizedPlatform]
@@ -265,7 +338,7 @@ export function registerProjectTools({
       const textExtensions = [
         ".java", ".kt", ".swift", ".m", ".h", ".xml", ".gradle", ".properties",
         ".pro", ".json", ".plist", ".storyboard", ".xib", ".gitignore", ".md",
-        ".js", ".jsx", ".ts", ".tsx", ".vue", ".cjs", ".html", ".css"
+        ".js", ".jsx", ".ts", ".tsx", ".vue", ".cjs", ".html", ".css", ".py"
       ];
 
       const files = [];

package/src/server/tools/register-quickstart-tools.js

@@ -1,6 +1,8 @@
 import { existsSync, statSync } from "node:fs";
 import { extname, join } from "node:path";
 import { z } from "zod";
+import { buildUnknownPublicProductResponse, isKnownPublicOffering } from "../public-offerings.js";
+import { buildUnsupportedPublicScopeResponse } from "./public-routing.js";
 
 export function registerQuickstartTools({
   server,
@@ -25,6 +27,54 @@ export function registerQuickstartTools({
   getMainCodeFile,
   getWebSamplePath
 }) {
+  function getPublicWebQuickstartLinks(product) {
+    if (product === "mrz") {
+      return {
+        docsUrl: "https://www.dynamsoft.com/mrz-scanner/docs/web/",
+        samplesUrl: "https://github.com/Dynamsoft/mrz-scanner-javascript"
+      };
+    }
+
+    if (product === "mds") {
+      return {
+        docsUrl: "https://www.dynamsoft.com/mobile-document-scanner/docs/web/",
+        samplesUrl: "https://github.com/Dynamsoft/document-scanner-javascript"
+      };
+    }
+
+    return { docsUrl: "", samplesUrl: "" };
+  }
+
+  function getPublicProductLabel(product) {
+    if (product === "mrz") return "MRZ";
+    if (product === "mds") return "MDS";
+    if (product === "dbr") return "DBR";
+    if (product === "dwt") return "DWT";
+    if (product === "ddv") return "DDV";
+    return String(product || "").toUpperCase();
+  }
+
+  function buildPublicReferenceQuickstart({ product, edition, platform, docsUrl, samplesUrl }) {
+    const label = getPublicProductLabel(product);
+    const scopeParts = [];
+    for (const part of [edition, platform]) {
+      if (!part || scopeParts.includes(part)) continue;
+      scopeParts.push(part);
+    }
+    const scope = scopeParts.join(" / ") || "general";
+    const lines = [
+      `# Quick Start Redirect: ${label}`,
+      "",
+      `${label} is available as a public offering, but this ${scope} quickstart is currently served as reference links instead of an inline starter.`,
+      "",
+      "Reference links:",
+      docsUrl ? `- Docs: ${docsUrl}` : "",
+      samplesUrl ? `- Samples: ${samplesUrl}` : ""
+    ].filter(Boolean);
+
+    return { content: [{ type: "text", text: lines.join("\n") }] };
+  }
+
   server.registerTool(
     "get_quickstart",
     {
@@ -35,7 +85,7 @@ export function registerQuickstartTools({
         "WHEN TO USE:",
         "- When the user wants to get started quickly with a Dynamsoft SDK.",
         "- To generate a ready-to-run code snippet with install commands, license key, and SDK version.",
-        "- For scenario-specific starters: pass scenario='MRZ' for passport reading, 'VIN' for vehicle identification, 'document scan' for document normalization, etc.",
+        "- For scenario-specific starters: pass scenario='MRZ' for passport reading, 'document scan' for document normalization, or barcode/image hints for DBR.",
         "",
         "WHEN NOT TO USE:",
         "- If the user wants full project files (multiple source files, build configs), use get_sample_files instead.",
@@ -43,20 +93,20 @@ export function registerQuickstartTools({
         "- If the user only needs version info, use resolve_version.",
         "",
         "PARAMETERS:",
-        "- product (required): dcv, dbr, dwt, or ddv.",
+        "- product (required): dbr, dwt, ddv, mrz, or mds.",
         "- edition: core, mobile, web, or server. Inferred from platform if omitted.",
         "- platform: android, ios, js, python, cpp, java, dotnet, nodejs, react, vue, angular, flutter, react-native, maui, etc.",
         "- language: kotlin, java, swift, js, ts, python, cpp, csharp, react, vue, angular. Helps select the best sample variant.",
         "- version: Version constraint. Latest major is used by default.",
         "- api_level: 'high-level' or 'low-level' (mobile only). Controls API abstraction level in generated code.",
-        "- scenario: MRZ, VIN, document scan, driver license, camera, image, single, multiple, etc. DCV supports MRZ/VIN/document-normalization/driver-license workflows.",
+        "- scenario: MRZ, document scan, camera, image, single, multiple, react, vue, angular, etc. DBR web defaults to foundational guidance; MRZ and MDS return public workflow guidance where available.",
         "",
         "RETURNS: A formatted text block with SDK version, trial license key, install commands, and sample code. Ready to copy-paste.",
         "",
         "RELATED TOOLS: search (find specific docs or samples), get_sample_files (get full multi-file project), resolve_version (version numbers only)."
       ].join("\n"),
       inputSchema: {
-        product: z.string().trim().min(1, "Product is required.").describe("Product: dcv, dbr, dwt, or ddv"),
+        product: z.string().trim().min(1, "Product is required.").describe("Product: dbr, dwt, ddv, mrz, mds"),
         edition: z.string().optional().describe("Edition: core, mobile, web, server/desktop"),
         platform: z.string().optional().describe("Platform: android, ios, maui, react-native, flutter, js, python, cpp, java, dotnet, nodejs, angular, blazor, capacitor, electron, es6, native-ts, next, nuxt, pwa, react, requirejs, svelte, vue, webview, spm, core"),
         language: z.string().optional().describe("Language hint: kotlin, java, swift, js, ts, python, cpp, csharp, react, vue, angular"),
@@ -73,8 +123,18 @@ export function registerQuickstartTools({
     },
     async ({ product, edition, platform, language, version, api_level, scenario }) => {
       const normalizedProduct = normalizeProduct(product);
+      if (product && !isKnownPublicOffering(normalizedProduct)) {
+        return buildUnknownPublicProductResponse(product);
+      }
+
       const normalizedPlatform = normalizePlatform(platform);
       const normalizedEdition = normalizeEdition(edition, normalizedPlatform, normalizedProduct);
+      const unsupportedScopeResponse = buildUnsupportedPublicScopeResponse(normalizedProduct, normalizedEdition, normalizedPlatform);
+      if (unsupportedScopeResponse) return unsupportedScopeResponse;
+
+      const isPublicDcvProduct = normalizedProduct === "mrz" || normalizedProduct === "mds";
+      const effectiveProduct = isPublicDcvProduct ? "dcv" : normalizedProduct;
+      const publicProductLabel = getPublicProductLabel(normalizedProduct);
 
       await ensureScopeHydrated({
         product: normalizedProduct,
@@ -95,9 +155,12 @@ export function registerQuickstartTools({
         return { isError: true, content: [{ type: "text", text: policy.message }] };
       }
 
-      if (normalizedProduct === "dcv") {
-        const scenarioLower = `${scenario || ""} ${language || ""}`.toLowerCase();
-        const effectiveEdition = normalizedEdition || (normalizedPlatform ? normalizeEdition("", normalizedPlatform, "dcv") : "server");
+      if (effectiveProduct === "dcv") {
+        const seededScenario = isPublicDcvProduct
+          ? `${normalizedProduct === "mrz" ? "mrz" : "document scan"} ${scenario || ""} ${language || ""}`
+          : `${scenario || ""} ${language || ""}`;
+        const scenarioLower = seededScenario.toLowerCase();
+        const effectiveEdition = normalizedEdition || (isPublicDcvProduct ? "web" : (normalizedPlatform ? normalizeEdition("", normalizedPlatform, "dcv") : "server"));
 
         function selectDcvServerSample(platformHint, hint) {
           const platformName = normalizePlatform(platformHint) || "python";
@@ -173,6 +236,17 @@ export function registerQuickstartTools({
         if (effectiveEdition === "server") {
           const sdkEntry = registry.sdks["dcv-server"];
           const targetPlatform = normalizePlatform(normalizedPlatform || sdkEntry.default_platform || "python");
+
+          if (isPublicDcvProduct) {
+            return buildPublicReferenceQuickstart({
+              product: normalizedProduct,
+              edition: effectiveEdition,
+              platform: targetPlatform,
+              docsUrl: "https://www.dynamsoft.com/capture-vision/docs/server/",
+              samplesUrl: sdkEntry.platforms?.[targetPlatform]?.samples?.repo || sdkEntry.platforms?.python?.samples?.repo || ""
+            });
+          }
+
           const sampleName = selectDcvServerSample(targetPlatform, scenarioLower);
           const samplePath = getDcvServerSamplePath(targetPlatform, sampleName);
 
@@ -187,7 +261,7 @@ export function registerQuickstartTools({
             content: [{
               type: "text",
               text: [
-                `# Quick Start: DCV Server (${targetPlatform})`,
+                `# Quick Start: ${isPublicDcvProduct ? publicProductLabel : "DCV Server"} (${targetPlatform})`,
                 "",
                 `**SDK Version:** ${sdkEntry.version}`,
                 `**Trial License:** \`${registry.trial_license}\``,
@@ -210,8 +284,20 @@ export function registerQuickstartTools({
 
         if (effectiveEdition === "web") {
           const sdkEntry = registry.sdks["dcv-web"];
+          if (isPublicDcvProduct) {
+            const publicLinks = getPublicWebQuickstartLinks(normalizedProduct);
+            return buildPublicReferenceQuickstart({
+              product: normalizedProduct,
+              edition: effectiveEdition,
+              platform: "web",
+              docsUrl: publicLinks.docsUrl,
+              samplesUrl: publicLinks.samplesUrl
+            });
+          }
           const available = discoverDcvWebSamples();
-          const sampleName = scenarioLower.includes("vin") ? "VINScanner" : (available[0] || "VINScanner");
+          const sampleName = isPublicDcvProduct
+            ? (normalizedProduct === "mrz" ? "MRZScanner" : "DocumentScanner")
+            : (scenarioLower.includes("vin") ? "VINScanner" : (available[0] || "VINScanner"));
           const samplePath = getDcvWebSamplePath(sampleName);
           if (!samplePath || !existsSync(samplePath)) {
             return { isError: true, content: [{ type: "text", text: `Sample not found: ${sampleName}.` }] };
@@ -223,7 +309,7 @@ export function registerQuickstartTools({
             content: [{
               type: "text",
               text: [
-                "# Quick Start: DCV Web",
+                `# Quick Start: ${isPublicDcvProduct ? publicProductLabel : "DCV Web"}`,
                 "",
                 `**SDK Version:** ${sdkEntry.version}`,
                 `**Trial License:** \`${registry.trial_license}\``,
@@ -262,7 +348,7 @@ export function registerQuickstartTools({
             content: [{
               type: "text",
               text: [
-                `# Quick Start: DCV Mobile (${targetPlatform})`,
+                `# Quick Start: ${isPublicDcvProduct ? publicProductLabel : "DCV Mobile"} (${targetPlatform})`,
                 "",
                 `**SDK Version:** ${sdkEntry.version}`,
                 `**Trial License:** \`${registry.trial_license}\``,
@@ -289,7 +375,7 @@ export function registerQuickstartTools({
             content: [{
               type: "text",
               text: [
-                "# Quick Start: DCV Core",
+                `# Quick Start: ${isPublicDcvProduct ? publicProductLabel : "DCV Core"}`,
                 "",
                 `**SDK Version:** ${sdkEntry.version}`,
                 "",
@@ -341,7 +427,7 @@ export function registerQuickstartTools({
       if (normalizedProduct === "dbr" && normalizedEdition === "web") {
         const sdkEntry = registry.sdks["dbr-web"];
         const scenarioLower = (scenario || "").toLowerCase();
-        const sampleName = scenarioLower.includes("image") ? "read-an-image" : "hello-world";
+        const sampleName = scenarioLower.includes("hello") ? "hello-world" : "read-an-image";
         const samplePath = getWebSamplePath("root", sampleName);
 
         if (!samplePath || !existsSync(samplePath)) {
@@ -358,6 +444,9 @@ export function registerQuickstartTools({
               "",
               `**SDK Version:** ${sdkEntry.version}`,
               `**Trial License:** \`${registry.trial_license}\``,
+              "**Starter profile:** Foundational-first",
+              "",
+              "Use the foundational web flow first so capture and decoding remain explicit and easier to adapt.",
               "",
               "## Option 1: CDN",
               "```html",
@@ -369,7 +458,7 @@ export function registerQuickstartTools({
               sdkEntry.platforms.web.installation.npm,
               "```",
               "",
-              `## ${sampleName}.html`,
+              `## Foundational sample: ${sampleName}.html`,
               "```html",
               content,
               "```",

package/src/server/tools/register-sample-tools.js

@@ -1,7 +1,10 @@
 import { z } from "zod";
+import { buildUnknownPublicProductResponse, isKnownPublicOffering } from "../public-offerings.js";
+import { buildUnsupportedPublicScopeResponse } from "./public-routing.js";
 
 export function registerSampleTools({
   server,
+  registry,
   ensureScopeHydrated,
   ensureLatestMajor,
   normalizeProduct,
@@ -23,14 +26,14 @@ export function registerSampleTools({
         "- To browse the full catalog of samples available for a product/edition/platform.",
         "- To discover sample IDs before calling get_sample_files.",
         "- When the user wants to see what samples exist without a specific keyword.",
-        "- Use DCV scope for MRZ, VIN, document normalization, and driver license scenarios.",
+        "- Use MRZ for passport and machine-readable-zone workflows, and MDS for document scan and normalization workflows.",
         "",
         "WHEN NOT TO USE:",
         "- If you have a specific keyword or topic, use search instead (it ranks results by relevance).",
         "- If you already have a sample ID or URI, go directly to get_sample_files.",
         "",
         "PARAMETERS:",
-        "- product: dcv, dbr, dwt, or ddv. Omit to list across all products.",
+        "- product: dbr, dwt, ddv, mrz, or mds. Omit to list across all public offerings.",
         "- edition: core, mobile, web, or server. Omit to list across all editions.",
         "- platform: android, ios, js, python, cpp, java, dotnet, nodejs, react, vue, angular, flutter, react-native, maui, etc.",
         "- limit: 1-200 (default 50). Max number of results.",
@@ -42,7 +45,7 @@ export function registerSampleTools({
         "RELATED TOOLS: search (keyword-based discovery), get_sample_files (retrieve full project files for a sample), get_index (discover valid product/edition/platform combinations)."
       ].join("\n"),
       inputSchema: {
-        product: z.string().optional().describe("Product: dcv, dbr, dwt, ddv"),
+        product: z.string().optional().describe("Product: dbr, dwt, ddv, mrz, mds"),
         edition: z.string().optional().describe("Edition: core, mobile, web, server/desktop"),
         platform: z.string().optional().describe("Platform: android, ios, maui, react-native, flutter, js, python, cpp, java, dotnet, nodejs, angular, blazor, capacitor, electron, es6, native-ts, next, nuxt, pwa, react, requirejs, svelte, vue, webview, spm, core"),
         limit: z.number().int().min(1).max(200).optional().describe("Max results (default 50)")
@@ -56,8 +59,14 @@ export function registerSampleTools({
     },
     async ({ product, edition, platform, limit }) => {
       const normalizedProduct = normalizeProduct(product);
+      if (product && !isKnownPublicOffering(normalizedProduct)) {
+        return buildUnknownPublicProductResponse(product);
+      }
+
       const normalizedPlatform = normalizePlatform(platform);
       const normalizedEdition = normalizeEdition(edition, normalizedPlatform, normalizedProduct);
+      const unsupportedScopeResponse = buildUnsupportedPublicScopeResponse(normalizedProduct, normalizedEdition, normalizedPlatform);
+      if (unsupportedScopeResponse) return unsupportedScopeResponse;
 
       await ensureScopeHydrated({
         product: normalizedProduct,

package/src/server/tools/register-version-tools.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { buildUnknownPublicProductResponse, isKnownPublicOffering } from "../public-offerings.js";
 
 export function registerVersionTools({
   server,
@@ -9,6 +10,47 @@ export function registerVersionTools({
   LATEST_MAJOR,
   LATEST_VERSIONS
 }) {
+  function buildPublicDcvVersionResponse(product, edition, platform) {
+    const label = product === "mrz" ? "MRZ" : "MDS";
+    const supportedEditions = product === "mrz"
+      ? [
+          { key: "web", name: "Web", version: LATEST_VERSIONS.dcv.web },
+          { key: "mobile", name: "Mobile", version: LATEST_VERSIONS.dcv.mobile }
+        ]
+      : [{ key: "web", name: "Web", version: LATEST_VERSIONS.dcv.web }];
+    const supportedEditionKeys = supportedEditions.map((entry) => entry.key).join(", ");
+
+    if (!edition) {
+      const lines = [
+        `# ${label} Version Resolution`,
+        `- Latest major: v${LATEST_MAJOR.dcv}`,
+        ...supportedEditions.map((entry) => `- ${entry.name}: ${entry.version}`),
+        "",
+        "Specify edition/platform to resolve a single version."
+      ];
+      return { content: [{ type: "text", text: lines.join("\n") }] };
+    }
+
+    const supportedEdition = supportedEditions.find((entry) => entry.key === edition);
+    if (!supportedEdition) {
+      return {
+        isError: true,
+        content: [{ type: "text", text: `Edition "${edition}" is not hosted by this MCP server. Supported editions: ${supportedEditionKeys}.` }]
+      };
+    }
+
+    const displayPlatform = platform === "web" ? "js" : platform;
+    const lines = [
+      `# ${label} Version Resolution`,
+      `- Edition: ${edition}`,
+      displayPlatform ? `- Platform: ${displayPlatform}` : "",
+      `- Latest major: v${LATEST_MAJOR.dcv}`,
+      `- Resolved version: ${supportedEdition.version}`
+    ].filter(Boolean);
+
+    return { content: [{ type: "text", text: lines.join("\n") }] };
+  }
+
   server.registerTool(
     "resolve_version",
     {
@@ -26,20 +68,20 @@ export function registerVersionTools({
         "- For browsing docs or samples, use search or list_samples (they already scope to latest major).",
         "",
         "PARAMETERS:",
-        "- product (required): dcv, dbr, dwt, or ddv.",
+        "- product (required): dbr, dwt, ddv, mrz, or mds.",
         "- edition: core, mobile, web, or server. Omit to see all editions for the product.",
         "- platform: android, ios, js, python, cpp, java, dotnet, nodejs, etc. Helps narrow edition when ambiguous.",
         "- constraint: Version constraint like 'latest', '11.x', '10'. Only latest major version is served; legacy versions (e.g. DBR v9) return an error with migration guidance.",
         "- feature: Optional feature hint for version policy checks.",
         "",
-        "RETURNS: A text block showing the resolved version. For DCV/DBR without an edition, returns all edition versions. For DWT/DDV, returns the single web version.",
+        "RETURNS: A text block showing the resolved version. For MRZ/MDS without an edition, returns the backed public version matrix. For DBR without an edition, returns all edition versions. For DWT/DDV, returns the single web version.",
         "",
         "EXAMPLE: resolve_version with product='dbr', edition='web' returns the latest DBR web SDK version string.",
         "",
         "RELATED TOOLS: get_quickstart (includes version in starter code), get_index (shows version overview)."
       ].join("\n"),
       inputSchema: {
-        product: z.string().trim().min(1, "Product is required.").describe("Product: dcv, dbr, dwt, or ddv"),
+        product: z.string().trim().min(1, "Product is required.").describe("Product: dbr, dwt, ddv, mrz, mds"),
         edition: z.string().optional().describe("Edition: core, mobile, web, server/desktop"),
         platform: z.string().optional().describe("Platform: android, ios, maui, react-native, flutter, js, python, cpp, java, dotnet, nodejs, angular, blazor, capacitor, electron, es6, native-ts, next, nuxt, pwa, react, requirejs, svelte, vue, webview, spm, core"),
         constraint: z.string().optional().describe("Version constraint, e.g., latest, 11.x, 10"),
@@ -54,16 +96,13 @@ export function registerVersionTools({
     },
     async ({ product, edition, platform, constraint, feature }) => {
       const normalizedProduct = normalizeProduct(product);
+      if (product && !isKnownPublicOffering(normalizedProduct)) {
+        return buildUnknownPublicProductResponse(product);
+      }
+
       const normalizedPlatform = normalizePlatform(platform);
       const normalizedEdition = normalizeEdition(edition, normalizedPlatform, normalizedProduct);
 
-      if (!["dcv", "dbr", "dwt", "ddv"].includes(normalizedProduct)) {
-        return {
-          isError: true,
-          content: [{ type: "text", text: `Unknown product "${product}". Use dcv, dbr, dwt, or ddv.` }]
-        };
-      }
-
       const policy = ensureLatestMajor({
         product: normalizedProduct,
         version: constraint,
@@ -76,39 +115,8 @@ export function registerVersionTools({
         return { isError: true, content: [{ type: "text", text: policy.message }] };
       }
 
-      if (normalizedProduct === "dcv") {
-        if (!normalizedEdition) {
-          const lines = [
-            "# DCV Version Resolution",
-            `- Latest major: v${LATEST_MAJOR.dcv}`,
-            `- Core: ${LATEST_VERSIONS.dcv.core}`,
-            `- Web: ${LATEST_VERSIONS.dcv.web}`,
-            `- Mobile: ${LATEST_VERSIONS.dcv.mobile}`,
-            `- Server/Desktop: ${LATEST_VERSIONS.dcv.server}`,
-            "",
-            "Specify edition/platform to resolve a single version."
-          ];
-          return { content: [{ type: "text", text: lines.join("\n") }] };
-        }
-
-        const resolved = LATEST_VERSIONS.dcv[normalizedEdition];
-        if (!resolved) {
-          return {
-            isError: true,
-            content: [{ type: "text", text: `Edition "${normalizedEdition}" is not hosted by this MCP server.` }]
-          };
-        }
-
-        const displayPlatform = normalizedPlatform === "web" ? "js" : normalizedPlatform;
-        const lines = [
-          "# DCV Version Resolution",
-          `- Edition: ${normalizedEdition}`,
-          displayPlatform ? `- Platform: ${displayPlatform}` : "",
-          `- Latest major: v${LATEST_MAJOR.dcv}`,
-          `- Resolved version: ${resolved}`
-        ].filter(Boolean);
-
-        return { content: [{ type: "text", text: lines.join("\n") }] };
+      if (normalizedProduct === "mrz" || normalizedProduct === "mds") {
+        return buildPublicDcvVersionResponse(normalizedProduct, normalizedEdition, normalizedPlatform);
       }
 
       if (normalizedProduct === "dbr") {