Trademark search

Trademark search MCP server

Check from your AI assistant whether a name is already a registered or pending trademark in the US (USPTO) and the EU (EUIPO), by Nice class and by the words of a mark's goods and services, before you buy the domain or draw the logo. Read one mark, and follow a US mark's file step by step, its documents saved as a PDF. Every tool only reads public registers: nothing is filed, and the one file written is that PDF, in the server's own outbox.

You need nothing to search the US: no account and no key. A US mark's history and documents need a free USPTO TSDR API key. EU marks need an EUIPO app's client id and secret with a Trademark Search subscription, which EUIPO approves by hand (allow a week or more). Romania's OSIM, WIPO and the other national offices are not searched, and every result says so.

What you can ask

• "Is Turnip already a trademark for software, in the US or the EU?"
• "Search Blue Night in classes 9 and 42, dead marks included, and show me what sounds alike."
• "Which live US marks contain the word talon and cover mobile applications?"
• "What happened in the file of the closest US match? Was it opposed?"
• "Save the office actions in that mark's file since January 2025 as one PDF."

Install

With Claude Code:

claude mcp add trademarks -- npx -y @foreverworks/mcp-trademarks

Claude Desktop (Settings, Developer, Edit Config) and most other clients read the same command as JSON:

{

"mcpServers": { "trademarks": { "command": "npx", "args": ["-y", "@foreverworks/mcp-trademarks"] } } }

Each runs the published package on Node 22.19 or newer. VS Code and the Claude Desktop bundle ask for each setting as they add the server; leave an optional one empty. Cursor reads each from your environment instead (${env:USPTO_TSDR_API_KEY_FILE} and so on), so set them before you start Cursor. Every setting is optional; Configuration says which ones you need for which tools.

From a clone

git clone https://github.com/foreverworks/mcps.git && cd mcps

npm ci && npm run build claude mcp add trademarks -- node "$PWD/servers/trademarks/dist/index.js"

In a JSON configuration, the command is node and its one argument the full path of servers/trademarks/dist/index.js. To share one running copy between several clients over HTTP, see docs/deploying.md.

Configuration

Every setting is optional. A missing credential never stops the server: its source shows as not_configured in health, a search marks its office as not searched, and the TSDR tools answer a config failure, each with the remedy.

What each tool needs:

Getting a USPTO TSDR API key

1. Create a USPTO.gov account at https://account.uspto.gov: free, with two-step sign-in and no identity verification (unlike the Open Data Portal's key, which needs ID.me).
2. Open the API key manager, https://account.uspto.gov/profile/api-manager, and request a key for the TSDR API. An Open Data Portal key is a different key, which TSDR refuses.
3. Write the key to a file only the server's user can read, and point USPTO_TSDR_API_KEY_FILE at it. A key expires after a year; the manager shows when, and renews it.

Getting EUIPO credentials

1. Create an EUIPO user account, and sign in at https://dev.euipo.europa.eu.
2. Under Apps, register an app. It gets a client id and a secret: write each to a file only the server's user can read.
3. Subscribe the app to the Trademark Search product (production, or sandbox for test data), accepting its terms of use. "Most subscription requests are subject to approval", and EUIPO emails the account when it approves. Until then, EUIPO issues a token but refuses the call, and health shows EM as pending.

The server reaches tmsearch.uspto.gov, tsdrapi.uspto.gov, api.euipo.europa.eu and euipo.europa.eu (the token endpoint), and, when the sandbox is used, api-sandbox.euipo.europa.eu and auth-sandbox.euipo.europa.eu; a deployment that sets MCP_EGRESS_ALLOW must allow them. The variables every server shares (transport, limits, egress) are in docs/configuration.md.

First run

1. Ask your assistant to run the trademark server's health check: each source's state, with what it needs. ok is true when at least one source searches and no configured source fails, so pending and not_configured do not fail a deployment's health check.
2. Search a name you know is taken, in its classes, to see what a hit looks like before you rely on a miss.

Tools

Every tool is read: it changes nothing anywhere, and download_mark_documents writes only into the server's own outbox.

search_marks takes the name as written (a name, not a pattern: no *); offices (EM, US, RO, WO, default all four, so those not searched say so); classes (Nice classes 1 to 45, default every class); goods, words that must appear together, in order, in a mark's goods and services; match: exact (the mark is the name), word (it contains the name) or similar (the default: also what sounds alike or is a letter off); status: live (the default: registered and pending) or all; and limit, the marks listed per office (1 to 100, default 20).

Troubleshooting

An office says `searched: false`. Read its reason or error. RO and WO are never searched here, and the reason says where a person can look; EM with a config error means no EUIPO credentials yet. An office not searched is not clear.

`config` from the TSDR tools. There is no TSDR key: get one (above), or read the mark's file by hand at tsdr.uspto.gov.

`auth`. From TSDR: check in the API key manager that the key is a TSDR API key (an Open Data Portal key is refused) and has not expired. From EUIPO: compare the client id and secret with the app's, under Apps at dev.euipo.europa.eu.

`subscription`, or EM `pending` in `health`. EUIPO accepted the app but not the call: its Trademark Search subscription is missing or still waiting for approval (step 3). Until then, search EU marks by hand at https://euipo.europa.eu/eSearch.

`not_found`. A USPTO serial number has 8 digits, an EUIPO application number 9, leading zeros included.

`unsupported`. That office has no source here, or EM was asked for a mark's file, which EUIPO's API does not give. The message says where to look.

`rate_limited`. The register was still throttling after three tries (TSDR allows 60 reads a minute and 4 document downloads): wait a minute and ask for less at a time.

`api`. A refusal, a server error that outlived its retries, or no connection (status 0). Retry in a minute; if it persists, run health. A 401 or 403 from USPTO's search may mean it now requires its page's browser challenge, which this server never answers.

`drift`. The register answered in a shape this server does not know, or re