@radsoft/markbase-mcp 2026.11.2 → 2026.11.3

package/README.md

@@ -40,12 +40,18 @@ 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.
+
 ## Why the class matters
 
 Trademark rights are scoped to goods and services. DELTA coexists as an airline, a

package/dist/index.js

@@ -87,6 +87,27 @@ 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"),
+    },
+}, async ({ names, trademark_class, limit }) => {
+    try {
+        const data = await request("/clearance/batch", {
+            method: "POST",
+            body: JSON.stringify({ marks: names, class: trademark_class ? padClass(trademark_class) : undefined, limit }),
+        });
+        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.3",
   "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.3",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@radsoft/markbase-mcp",
-      "version": "2026.11.2",
+      "version": "2026.11.3",
       "transport": {
         "type": "stdio"
       },