@radsoft/markbase-mcp
v2026.11.5
Published
MCP server for the Markbase USPTO trademark API — search, screen, and look up US trademarks from any MCP client.
Maintainers
Readme
Markbase MCP
An MCP server for the Markbase USPTO trademark API. Gives an assistant the ability to search US trademarks, screen a proposed brand name for conflicts, and pull registration records — grounded in the actual federal register instead of guessed from training data.
Covers the USPTO only (14M+ US marks). If you need EUIPO, WIPO, or UKIPO, a multi-office platform is a better fit.
Setup
You need a free API key — get one at markbase.co. 5,000 requests a month, no card.
Add to your MCP client config:
{
"mcpServers": {
"markbase": {
"command": "npx",
"args": ["-y", "@radsoft/markbase-mcp"],
"env": {
"MARKBASE_API_KEY": "mb_your_key_here"
}
}
}
}For Claude Code:
claude mcp add markbase --env MARKBASE_API_KEY=mb_your_key -- npx -y @radsoft/markbase-mcpTools
| 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.
Opt-in phonetic clearance
Starting with MCP server 2026.11.4, set phonetic: true on
check_trademark_availability or screen_trademark_names to add whole-name ASCII
phonetic matching. Omit it or use false for spelling-only behavior. Quota remains
one monthly request per name; bulk screening still requires Launch or Scale.
Successful opt-in responses include matching metadata and separate exact,
spelling, and phonetic signals on conflicts. Scores and risk thresholds keep
their spelling meaning. Display not_evaluated as an unsupported comparison and
matching.truncated as a bounded-search limitation. An untruncated result is not
proof of exhaustive coverage or legal availability.
An unavailable opt-in request returns 503 rather than silently downgrading. Admission failures do not consume monthly quota; accepted batches count even if a search fails and are never retried automatically. See the phonetic contract for token, input, and ranking limits.
Why the class matters
Trademark rights are scoped to goods and services. DELTA coexists as an airline, a
faucet maker, and dental insurance. Screening a name without a class produces noise —
pass trademark_class and you get only marks that could actually block you.
check_trademark_availability({ name: "Acme", trademark_class: "9" })Not legal advice
These tools return a first-pass screening signal over the federal register. They do not cover state trademarks, common-law rights, or the legal analysis of likelihood of confusion. Treat a clean result as "worth pursuing", not "cleared", and recommend a trademark attorney for any name a user intends to actually adopt.
Environment
| Variable | Required | Default |
|----------|----------|---------|
| 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.
License
MIT — a product of Rad Soft.
