Connect your assistant: Add the server to Claude Desktop, Claude Code, Cursor, VS Code, or Gemini CLI, and what ChatGPT and other remote clients need. # Connect your assistant > Add the server to Claude Desktop, Claude Code, Cursor, VS Code, or Gemini CLI, and what ChatGPT and other remote clients need. The server runs on your computer, and your assistant starts it. Before you connect: * Install [Node.js](https://nodejs.org/) 24.11 or later, or 26. * [Get your keys](/docs/keys/). ## Claude Desktop [Download the extension](https://github.com/blen-labs/uspto-mcp-server/releases/latest/download/uspto-mcp-server.mcpb) 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 ```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" } } } } ``` ## Claude Code Run this command with your keys in place of the two example values: ```bash 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 ``` ## Cursor [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=uspto\&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBibGVuL3VzcHRvLW1jcC1zZXJ2ZXIiXSwiZW52Ijp7IlVTUFRPX0FQSV9LRVkiOiIiLCJVU1BUT19UU0RSX0FQSV9LRVkiOiIifX0%3D) 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 ```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" } } } } ``` ## VS Code [Add to VS Code](vscode:mcp/install?%7B%22name%22%3A%22uspto%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40blen%2Fuspto-mcp-server%22%5D%2C%22env%22%3A%7B%22USPTO_API_KEY%22%3A%22%22%2C%22USPTO_TSDR_API_KEY%22%3A%22%22%7D%7D) 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](https://code.visualstudio.com/docs/copilot/reference/mcp-configuration) in the VS Code documentation. ## Gemini CLI Add the server to `~/.gemini/settings.json`, or to `.gemini/settings.json` in one project: settings.json ```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 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](https://uspto.mcp.blenlabs.com/account). 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](/docs/self-host/). ## 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](/docs/keys/). | | `Unauthorized` | USPTO refused the ODP key. | Check the key, and see [Keep a key working](/docs/keys/#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](https://docs.deno.com/runtime/getting_started/installation/). | Note The built-in sandbox needs no install on Node.js 24 and 26 on macOS (Apple silicon), Linux (x64 and arm64), and Windows (x64). On other systems the server uses Deno.