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-mcpKeep 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"