npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@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.

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-mcp

Tools

| 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.