@radsoft/markbase-mcp 2026.11.2 → 2026.11.4

package/README.md

@@ -40,12 +40,28 @@ claude mcp add markbase --env MARKBASE_API_KEY=mb_your_key -- npx -y @radsoft/ma
 | Tool | What it does |
 |------|--------------|
 | `check_trademark_availability` | Screen a proposed name against the register, ranked by similarity with a risk level |
+| `screen_trademark_names` | Screen 1–25 names in input order, with a shared optional class; Launch or Scale required |
 | `search_trademarks` | Typo-tolerant search across 14M+ marks, filterable by class and status |
 | `get_trademark` | Full record for one mark by serial number |
 | `get_trademark_timeline` | Prosecution history — filing, publication, office actions, registration |
 | `search_by_owner` | Every mark held by a company or person |
 | `list_trademark_classes` | All 45 Nice classes, so the model can pick the right one before screening |
 
+Bulk screening counts every submitted name toward monthly and per-minute limits,
+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.",
         });
@@ -87,6 +92,28 @@ server.registerTool("check_trademark_availability", {
         return fail(err);
     }
 });
+server.registerTool("screen_trademark_names", {
+    title: "Screen a batch of proposed names",
+    description: "Screen 1–25 proposed names against the US register using a Launch or Scale key. Each submitted name consumes one monthly request, including duplicate names. An admitted batch consumes quota even if a search fails; do not retry automatically. Results keep input order. This is preliminary screening, not legal advice or a registration guarantee.",
+    inputSchema: {
+        names: z.array(z.string().trim().min(1).max(200)).min(1).max(25).describe("Proposed names in the order to screen"),
+        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, phonetic }) => {
+    try {
+        const data = await request("/clearance/batch", {
+            method: "POST",
+            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." });
+    }
+    catch (error) {
+        return fail(error);
+    }
+});
 server.registerTool("get_trademark", {
     title: "Get a trademark by serial number",
     description: "Fetch the complete record for one US trademark by its USPTO serial number, including owner, status, classes, and goods/services.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@radsoft/markbase-mcp",
-  "version": "2026.11.2",
+  "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.2",
+  "version": "2026.11.4",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@radsoft/markbase-mcp",
-      "version": "2026.11.2",
+      "version": "2026.11.4",
       "transport": {
         "type": "stdio"
       },