@radsoft/markbase-mcp 2026.11.3 → 2026.11.4

package/README.md

@@ -52,6 +52,16 @@ including duplicates. Invalid or rejected batches do not consume monthly quota.
 Accepted batches consume their full name count even if a search fails; the tool
 does not retry automatically.
 
+## Unreleased: opt-in phonetic clearance
+
+Both screening tools accept an optional `phonetic` boolean in the source server.
+The API mode is not enabled in production yet. Omit the parameter to keep current
+spelling-only behavior; an unavailable opt-in request returns 503 rather than
+silently downgrading. Successful opt-in responses preserve the API's separate
+matching metadata and exact, spelling, and phonetic evidence. Scores and risk
+thresholds keep their existing spelling meaning. See the
+[unreleased contract](../docs/phonetic-clearance.md) for limits and publication steps.
+
 ## Why the class matters
 
 Trademark rights are scoped to goods and services. DELTA coexists as an airline, a

package/dist/index.js

@@ -56,7 +56,7 @@ server.registerTool("search_trademarks", {
 });
 server.registerTool("check_trademark_availability", {
     title: "Screen a proposed name against existing trademarks",
-    description: "Screen a proposed brand or company name against the US register and get existing marks ranked by similarity, each with a risk level. Use this BEFORE suggesting a company, product, or brand name to a user. This is a first-pass screening signal, not legal advice.",
+    description: "Screen a proposed brand or company name against the US register and get ranked existing marks, each with a spelling similarity score and risk level. Use this BEFORE suggesting a company, product, or brand name to a user. This is a first-pass screening signal, not legal advice.",
     inputSchema: {
         name: z.string().describe("The proposed brand or company name to screen"),
         trademark_class: z
@@ -64,21 +64,26 @@ server.registerTool("check_trademark_availability", {
             .optional()
             .describe("Nice class 1-45 for the goods/services. Strongly recommended — trademark rights are class-scoped, so screening without one produces noise."),
         limit: z.number().int().min(1).max(25).optional().describe("Max conflicts to return, default 10"),
+        phonetic: z.boolean().optional().describe("Unreleased opt-in phonetic matching. Omit or use false for spelling-only results; true returns 503 while unavailable."),
     },
-}, async ({ name, trademark_class, limit }) => {
+}, async ({ name, trademark_class, limit, phonetic }) => {
     try {
         const p = new URLSearchParams({ mark: name, limit: String(limit ?? 10) });
         if (trademark_class)
             p.set("class", padClass(trademark_class));
+        if (phonetic !== undefined)
+            p.set("phonetic", String(phonetic));
         const data = await request(`/clearance?${p}`);
         return ok({
             proposed_name: data.mark,
             scoped_to_class: data.class ? String(parseInt(data.class, 10)) : null,
             highest_risk: data.highest_risk,
+            ...(data.matching ? { matching: data.matching } : {}),
             conflicts: data.matches.map((m) => ({
                 ...shapeMark(m),
                 similarity: m.similarity,
                 risk: m.risk,
+                ...(m.signals ? { signals: m.signals } : {}),
             })),
             disclaimer: "Screening signal only. Likelihood of confusion is a legal judgment and this does not cover state or common-law rights. Recommend a trademark attorney before adopting a name.",
         });
@@ -95,12 +100,13 @@ server.registerTool("screen_trademark_names", {
         trademark_class: z.string().regex(/^\d{1,3}$/).refine((value) => Number(value) >= 1 && Number(value) <= 45).optional()
             .describe("Shared Nice class 1–45 for the goods or services"),
         limit: z.number().int().min(1).max(50).optional().describe("Maximum matches per name; default 20"),
+        phonetic: z.boolean().optional().describe("Unreleased opt-in phonetic matching for every name. Omit or use false for spelling-only results; true returns 503 while unavailable."),
     },
-}, async ({ names, trademark_class, limit }) => {
+}, async ({ names, trademark_class, limit, phonetic }) => {
     try {
         const data = await request("/clearance/batch", {
             method: "POST",
-            body: JSON.stringify({ marks: names, class: trademark_class ? padClass(trademark_class) : undefined, limit }),
+            body: JSON.stringify({ marks: names, class: trademark_class ? padClass(trademark_class) : undefined, limit, phonetic }),
         });
         return ok({ ...data, disclaimer: "Screening signal only. Consult a trademark attorney before adopting a name." });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@radsoft/markbase-mcp",
-  "version": "2026.11.3",
+  "version": "2026.11.4",
   "description": "MCP server for the Markbase USPTO trademark API — search, screen, and look up US trademarks from any MCP client.",
   "license": "MIT",
   "type": "module",

package/server.json

@@ -9,12 +9,12 @@
     "source": "github",
     "subfolder": "mcp"
   },
-  "version": "2026.11.3",
+  "version": "2026.11.4",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@radsoft/markbase-mcp",
-      "version": "2026.11.3",
+      "version": "2026.11.4",
       "transport": {
         "type": "stdio"
       },