[Integrations](https://spiral.ai/integrations) › [Claude Code](https://spiral.ai/integrations/claude-code) › [USPTO patent search](https://spiral.ai/integrations/claude-code/uspto-patent-search)

# How to Use USPTO patent search in Claude Code

Finds US patents and published applications with titles, assignees, filing dates, and classifications. Use it to discover documents by technology or company before reading individual patent records.

|  |  |
| --- | --- |
| Model | USPTO patent search |
| Available through | Alexandria |
| Category | Lead Gen |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with USPTO patent search in Claude Code

- Use USPTO patent search to find five US patent publications about solid-state batteries assigned to Toyota. Add their titles, publication numbers, filing dates, and classifications to research/toyota-patents.json.
- Use USPTO patent search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from USPTO patent search and tell me what changed since last week.
- Check USPTO patent search and summarize what you find in three bullet points.
- Pull the newest data from USPTO patent search and give me the result as a table.

## How to set up USPTO patent search in Claude Code

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the hosted server**: This adds Spiral to the current project. Add `--scope user` to use it in every project.

```bash
claude mcp add --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `claude`, type `/mcp`, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.

### Use the Spiral skill

1. **Send Claude Code this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run USPTO patent search**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "uspto-gov/intellectual-property/patent_search",
    "input": {
      "query": "<query>"
    }
  }'
```

Then paste one of the prompts above: Claude Code finds USPTO patent search on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/claude-code

## USPTO patent search tools and prices

- [USPTO patents, trademarks and assignments · Patent search](https://spiral.ai/tools/alexandria/uspto-gov/intellectual-property/patent_search) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| start | 0 to 900 | 0 | Zero-based offset of the first result; pass the previous page's `next_start` to continue. ppubs caps an anonymous query at 1000 documents. |
| databases |  | — | Collections to search: US-PGPUB (pre-grant publications), USPAT (granted patents), USOCR (OCR of pre-1976 patents). Default: all three. |
| page_size | 1 to 100 | 25 | page_size |

## What can you do with USPTO patent search in Claude Code?

Build a company IP research file from USPTO patent, trademark, or recorded assignment records. A coding agent can organize publication numbers, classifications, trademark status, and transaction references in your project.

### Acquisition research

Prepare a company's US IP inventory with patent titles and abstracts, trademark goods and services, application status, and recorded transfers for identified assets.

### Competitor portfolio briefing

Compare named companies using published inventions, patent classifications, federal trademark records, prosecution events, and recorded assignment transactions.

### Licensing candidate research

Build a research brief around a company's published technology and registered brands, including patent references, trademark goods and services, and recorded transaction parties.

### Company portfolio review

Review a named company's patent publications, detailed invention records, trademark applications, prosecution history, and recorded assignments in one research report.

### Engineering literature review

Find patent publications about a technical problem, then compare their abstracts, claims, classifications, and cited references.

### Published invention digest

Collect relevant patent search results, summarize individual inventions, and add recorded assignment history for selected publications.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Claude Code guides](https://spiral.ai/integrations/claude-code)

## USPTO patent search in other agents

- [Amp](https://spiral.ai/integrations/amp/uspto-patent-search)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/uspto-patent-search)
- [Claude](https://spiral.ai/integrations/claude-desktop/uspto-patent-search)
- [Cline](https://spiral.ai/integrations/cline/uspto-patent-search)
- [Codex](https://spiral.ai/integrations/codex/uspto-patent-search)
- [Cursor](https://spiral.ai/integrations/cursor/uspto-patent-search)
- [Devin](https://spiral.ai/integrations/devin/uspto-patent-search)
- [dots](https://spiral.ai/integrations/dots/uspto-patent-search)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/uspto-patent-search)
- [Gemini](https://spiral.ai/integrations/gemini/uspto-patent-search)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/uspto-patent-search)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/uspto-patent-search)
- [goose](https://spiral.ai/integrations/goose/uspto-patent-search)
- [Grok](https://spiral.ai/integrations/grok/uspto-patent-search)
- [Grok Build](https://spiral.ai/integrations/grok-build/uspto-patent-search)
- [Hermes](https://spiral.ai/integrations/hermes/uspto-patent-search)
- [Instinct](https://spiral.ai/integrations/instinct/uspto-patent-search)
- [Manus](https://spiral.ai/integrations/manus/uspto-patent-search)
- [Muse](https://spiral.ai/integrations/muse/uspto-patent-search)
- [Muse Code](https://spiral.ai/integrations/muse-code/uspto-patent-search)
- [n8n](https://spiral.ai/integrations/n8n/uspto-patent-search)
- [Notion](https://spiral.ai/integrations/notion/uspto-patent-search)
- [OpenClaw](https://spiral.ai/integrations/openclaw/uspto-patent-search)
- [opencode](https://spiral.ai/integrations/opencode/uspto-patent-search)
- [Perplexity](https://spiral.ai/integrations/perplexity/uspto-patent-search)
- [Raycast](https://spiral.ai/integrations/raycast/uspto-patent-search)
- [VS Code](https://spiral.ai/integrations/vscode/uspto-patent-search)
- [Windsurf](https://spiral.ai/integrations/windsurf/uspto-patent-search)
- [Zapier](https://spiral.ai/integrations/zapier/uspto-patent-search)

## More Claude Code guides

- [USPTO patent document](https://spiral.ai/integrations/claude-code/uspto-patent-document)
- [USPTO trademark search](https://spiral.ai/integrations/claude-code/uspto-trademark-search)
- [USPTO patent and trademark assignments](https://spiral.ai/integrations/claude-code/uspto-patent-and-trademark-assignments)
- [USPTO trademark status](https://spiral.ai/integrations/claude-code/uspto-trademark-status)
- [USAspending subawards](https://spiral.ai/integrations/claude-code/usaspending-subawards)
- [Ukraine EDR register XML schema](https://spiral.ai/integrations/claude-code/ukraine-edr-register-xml-schema)

## Questions about USPTO patent search in Claude Code

**Can Claude Code use USPTO patent search?**

Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run USPTO patent search like any built-in tool.

**How much does USPTO patent search cost in Claude Code?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Claude Code plan is separate.

**Do I need an Alexandria account to use USPTO patent search in Claude Code?**

No. Spiral runs USPTO patent search on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up USPTO patent search in Claude Code?**

About two minutes: add the hosted server, then sign in.

**Does Claude Code wait while USPTO patent search runs?**

USPTO patent search runs in the background. Claude Code starts the run, checks on it and gives you the json when it's ready.

**Does USPTO data cover intellectual property worldwide?**

These tools cover US patent, federal trademark, and recorded assignment records. They do not provide a worldwide patent or trademark register.

**Does a search include every trademark a company uses?**

No. The USPTO database includes federal trademark applications and registrations, but excludes marks protected only through unregistered common-law use.

**Are abandoned and inactive trademark records included?**

Yes. The USPTO trademark database contains active and inactive applications and registrations, so a result does not by itself mean a mark remains active.

**How far back do the patent records go?**

Patent Public Search has limited information back to 1790 and full text for most granted patents from 1971 onward. Its pre-grant publication collection starts in March 2001.

**What is the difference between a trademark record and an assignment record?**

TSDR provides a trademark application's or registration's status and prosecution history. Assignment Center provides recorded transactions, including the parties, conveyance description, dates, and reel/frame reference.

