1. Add the server to your client

The server needs an API key. A Free account includes 5,000 requests a month. Your client starts the server with npx, so Node.js has to be installed on the same machine.

For clients configured with an mcpServers file:

{
  "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_here \
  -- npx -y @radsoft/markbase-mcp

Keep the key out of version control, since this configuration holds it in plain text. Then ask your assistant to screen a name for your goods or services.

2. See what the assistant can call

check_trademark_availability
Screen a proposed name against the register. Returns ranked marks with a similarity score and risk level.
screen_trademark_names
Screen 1 to 25 names in input order, with an optional shared class. Requires a Launch or Scale key.
search_trademarks
Typo-tolerant search across US trademark records, filterable by class and status.
get_trademark
The full record for one mark, by serial number.
get_trademark_timeline
Prosecution history for one mark: filing, publication, office actions, and registration.
search_by_owner
Marks held by a company or person.
list_trademark_classes
All 45 Nice classes, so the assistant can pick the right one before screening.

3. Screen with a class

Trademark rights are scoped to goods and services, so the same word can belong to different owners in different classes. Screening without a class returns marks that may not be relevant. Passing a class limits the results to marks in that class:

check_trademark_availability({ name: "Acme", trademark_class: "9" })

A class narrows the search but does not settle questions about related goods or services. In search_trademarks, live_only returns status 800 only, which leaves out pending applications and other live statuses.

4. Plan for quota

Each tool call uses one request from your key's plan, except screen_trademark_names, where every submitted name counts toward monthly and per-minute limits, including duplicates. Invalid or rejected batches do not use monthly quota. Accepted batches use their full name count even if a search fails, so the tool does not retry automatically.

search_trademarks, search_by_owner, and check_trademark_availability return 10 results by default and up to 25 per call.

5. Environment variables

MARKBASE_API_KEY
Required. Your Markbase API key.
MARKBASE_API_URL
Optional. Defaults to https://api.markbase.co.

6. Treat results as a screening signal

These tools cover the US federal register only. They do not cover state trademarks, common-law rights, or other countries, and they do not provide the legal analysis of likelihood of confusion. A clean result is worth pursuing, not cleared. Ask a trademark attorney to review any name you intend to adopt.

Get a key for your assistant

A Free account includes 5,000 monthly requests, and the dashboard shows usage so you can confirm the server is connected.

curl "https://api.markbase.co/search?q=your-brand"

Keep reading