@radsoft/markbase-mcp 2026.11.1 → 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
@@ -70,6 +76,23 @@ a trademark attorney for any name a user intends to actually adopt.
 | `MARKBASE_API_KEY` | yes | — |
 | `MARKBASE_API_URL` | no | `https://api.markbase.co` |
 
+## Registry publishing
+
+The official MCP registry name is `io.github.Rad-Soft/markbase`. Its metadata is in
+`server.json`; the npm package declares the same name in `mcpName` to prove package
+ownership. The release workflow keeps both versions aligned and publishes the
+registry entry after npm and the release tag succeed. Both publishers use GitHub
+OIDC, so no registry token needs to be configured.
+
+After changing `package.json`'s version, run `bun run registry:sync`. The build
+checks that the npm and registry names and versions agree. Validate the complete
+manifest with the official CLI: `mcp-publisher validate server.json`.
+
+If registry publishing fails after npm succeeds, manually run **Publish MCP** on
+`main` with `registry_version` set to that published version. It checks out the
+existing `mcp-v` tag and retries only the registry job. Confirm the listing at the
+[official registry API](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.Rad-Soft%2Fmarkbase).
+
 ## License
 
 MIT — a product of [Rad Soft](https://radsoftinc.com).

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.1",
+  "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",
@@ -8,7 +8,8 @@
     "markbase-mcp": "dist/index.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "server.json"
   ],
   "keywords": [
     "mcp",
@@ -26,9 +27,11 @@
     "directory": "mcp"
   },
   "scripts": {
-    "build": "tsc",
+    "build": "bun run registry:check && tsc",
     "dev": "tsc --watch",
-    "prepublishOnly": "bun run build"
+    "prepublishOnly": "bun run build",
+    "registry:check": "node scripts/registry-metadata.mjs",
+    "registry:sync": "node scripts/registry-metadata.mjs --write"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.22.0",
@@ -40,5 +43,6 @@
   },
   "publishConfig": {
     "access": "public"
-  }
+  },
+  "mcpName": "io.github.Rad-Soft/markbase"
 }

package/server.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.Rad-Soft/markbase",
+  "title": "Markbase Trademark Search",
+  "description": "Search US trademarks, screen proposed names for conflicts, and look up USPTO registration records.",
+  "websiteUrl": "https://markbase.co",
+  "repository": {
+    "url": "https://github.com/Rad-Soft/marked-api",
+    "source": "github",
+    "subfolder": "mcp"
+  },
+  "version": "2026.11.3",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "@radsoft/markbase-mcp",
+      "version": "2026.11.3",
+      "transport": {
+        "type": "stdio"
+      },
+      "environmentVariables": [
+        {
+          "name": "MARKBASE_API_KEY",
+          "description": "Free Markbase API key from https://markbase.co/login (5,000 requests per month).",
+          "isRequired": true,
+          "isSecret": true
+        }
+      ]
+    }
+  ]
+}