Skip to content

Connect your assistant

The server runs on your computer, and your assistant starts it. Before you connect:

Download the extension

Open the downloaded .mcpb file, or drag it into the Claude Desktop window. Claude Desktop asks for your keys during the install.

To set it up by hand, open Settings → Developer → Edit Config, add the server, and restart Claude Desktop:

claude_desktop_config.json
{
"mcpServers": {
"uspto": {
"command": "npx",
"args": [
"-y",
"@blen/uspto-mcp-server"
],
"env": {
"USPTO_API_KEY": "your-odp-key",
"USPTO_TSDR_API_KEY": "your-tsdr-key"
}
}
}
}

Run this command with your keys in place of the two example values:

claude mcp add uspto \
-e USPTO_API_KEY=your-odp-key \
-e USPTO_TSDR_API_KEY=your-tsdr-key \
-- npx -y @blen/uspto-mcp-server
Add to Cursor

Cursor opens with the server filled in and the two key fields empty. Add your keys, then install.

To set it up by hand, add the server to ~/.cursor/mcp.json, or to .cursor/mcp.json in one project:

mcp.json
{
"mcpServers": {
"uspto": {
"command": "npx",
"args": [
"-y",
"@blen/uspto-mcp-server"
],
"env": {
"USPTO_API_KEY": "your-odp-key",
"USPTO_TSDR_API_KEY": "your-tsdr-key"
}
}
}
}
Add to VS Code

VS Code shows the server for review, with the two key fields empty. Add your keys, then install.

To set it up by hand, see MCP configuration in the VS Code documentation.

Add the server to ~/.gemini/settings.json, or to .gemini/settings.json in one project:

settings.json
{
"mcpServers": {
"uspto": {
"command": "npx",
"args": [
"-y",
"@blen/uspto-mcp-server"
],
"env": {
"USPTO_API_KEY": "your-odp-key",
"USPTO_TSDR_API_KEY": "your-tsdr-key"
}
}
}
}

ChatGPT, Claude custom connectors, and Gemini Enterprise connect to a remote server over HTTPS. They do not start a server on your computer.

BLEN hosts one at https://uspto.mcp.blenlabs.com/mcp/account. Add that URL as a custom connector and sign in with Google when your client asks. Then save your own ODP key, and your TSDR key if you have one, on the account page. Each key is stored encrypted and used only for your requests. Without signing in, https://uspto.mcp.blenlabs.com/mcp offers the search and schema tools but cannot run code.

To run your own instance instead, see Self-host.

Ask your assistant:

Has anyone challenged patent 10,169,987 at the PTAB?

The assistant calls search_api to find the right methods, then execute to run them.

Message Cause Fix
SourceUnavailable The key for that source is missing or blank. Add the key to your client’s configuration. See Get your keys.
Unauthorized USPTO refused the ODP key. Check the key, and see Keep a key working.
NotFound on every trademark call TSDR reports a key that it refuses as not found. Check the TSDR key.
SandboxUnavailable No sandbox runtime is available for execute. Install Deno.