Connect your assistant
The server runs on your computer, and your assistant starts it. Before you connect:
- Install Node.js 24.11 or later, or 26.
- Get your keys.
Claude Desktop
Section titled “Claude Desktop”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:
{ "mcpServers": { "uspto": { "command": "npx", "args": [ "-y", "@blen/uspto-mcp-server" ], "env": { "USPTO_API_KEY": "your-odp-key", "USPTO_TSDR_API_KEY": "your-tsdr-key" } } }}Claude Code
Section titled “Claude Code”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-serverCursor
Section titled “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:
{ "mcpServers": { "uspto": { "command": "npx", "args": [ "-y", "@blen/uspto-mcp-server" ], "env": { "USPTO_API_KEY": "your-odp-key", "USPTO_TSDR_API_KEY": "your-tsdr-key" } } }}VS Code
Section titled “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.
Gemini CLI
Section titled “Gemini CLI”Add the server to ~/.gemini/settings.json, or to .gemini/settings.json in one project:
{ "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 and other remote clients
Section titled “ChatGPT and other remote clients”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.
Check that it works
Section titled “Check that it works”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. |