USPTO Patent MCP Server

A FastMCP server for accessing United States Patent and Trademark Office (USPTO) patent and patent application data through multiple APIs including the Patent Public Search API, the Open Data Portal (ODP) API, PTAB API v3, and Patent Litigation APIs. Using this server, Claude Desktop can pull data from USPTO APIs, search through PTAB proceedings and decisions, analyze patent litigation, research prosecution history, and more:

For an introduction to MCP servers see Introducing the Model Context Protocol.

Special thanks to Parker Hancock, author of the amazing Patent Client project, for blazing the trail to understanding of the string of requests and responses needed to pull data through the Public Search API.

Features

This server provides 52 tools across 6 USPTO data sources (31 active, 21 temporarily unavailable pending API migrations):

1. Patent Search - Full-text search of granted patents and published applications via PPUBS
2. Full Text Documents - Get complete text of patents including claims, description, and specification
3. PDF Downloads - Download patents as PDF files (Claude Desktop doesn't support this as a client currently)
4. Prosecution History - Access transactions and file wrapper data via ODP
5. PTAB Proceedings - Search and retrieve Patent Trial and Appeal Board proceedings (IPR, PGR, CBM), decisions, and appeals
6. Patent Litigation - Search 74,000+ district court patent cases
7. Patent Family Data - Continuity information, foreign priority, and related applications
8. Bulk Datasets - Search and access USPTO bulk data products including PatentsView disambiguated data

Note on unavailable APIs: The PatentsView API (search.patentsview.org) was shut down on March 20, 2026, with its data migrated to ODP bulk datasets. The Office Action and Enriched Citation APIs (developer.uspto.gov) were decommissioned in early 2026, with ODP migration pending. All 21 affected tools remain registered and return helpful workaround guidance pointing to alternative tools.

API Sources

Prerequisites

• Python 3.10-3.13 (3.12 recommended)
• Claude Desktop (for integration). Other models and MCP clients have not been tested.
• UV for Python version and dependency management

If you're a Python developer but still unfamiliar with uv, you're in for a treat. It's faster and easier than having a separate Python version manager (like pyenv) and setting up, activating, and maintaining virtual environments with venv and pip.

If you don't already have uv installed:

curl -LsSf https://astral.sh/uv/install.sh | sh

Installation

1. Clone this repository:

   git clone https://github.com/riemannzeta/patent_mcp_server
   cd patent_mcp_server

2. Install dependencies with uv:

   uv sync

3. Verify installation:

   uv run patent-mcp-server

   Should output:

   INFO     Starting USPTO Patent MCP server with stdio transport

API Key Setup

USPTO ODP API Key (Required for most tools)

To use the api.uspto.gov tools (ODP, PTAB, Litigation), you need an Open Data Portal API key. Without it, these endpoints return 403 Forbidden.

1. Create a USPTO.gov account at data.uspto.gov (requires ID.me verification)

2. Once signed in, visit "My ODP" in the site navigation to get your API key

3. See the Getting Started guide for detailed instructions

4. Create a .env file in the patent_mcp_server directory:

   USPTO_API_KEY=your_actual_key_here

   Note: The PPUBS tools will work without this API key.

Configuration

The server can be configured using environment variables in your .env file. All settings are optional with sensible defaults:

# API Keys
USPTO_API_KEY=your_key_here

# Logging
LOG_LEVEL=INFO  # Options: DEBUG, INFO, WARNING, ERROR, CRITICAL

# HTTP Settings
REQUEST_TIMEOUT=30.0  # Request timeout in seconds
MAX_RETRIES=3         # Maximum number of retry attempts
RETRY_MIN_WAIT=2      # Minimum wait time between retries (seconds)
RETRY_MAX_WAIT=10     # Maximum wait time between retries (seconds)

# Session Management
SESSION_EXPIRY_MINUTES=30  # How long to cache ppubs sessions
ENABLE_CACHING=true        # Enable/disable session caching

# API Endpoints (usually don't need to change)
PPUBS_BASE_URL=https://ppubs.uspto.gov
API_BASE_URL=https://api.uspto.gov          # ODP API endpoint (NOT data.uspto.gov)

Claude Desktop Configuration

To integrate this MCP server with Claude Desktop:

1. Update your Claude Desktop configuration file (claude_desktop_config.json):

   {
     "mcpServers": {
       "patents": {
         "command": "uv",
         "args": [
           "--directory",
           "/Users/username/patent_mcp_server",
           "run",
           "patent-mcp-server"
         ]
       }
     }
   }

   You can find claude_desktop_config.json on a Mac by opening the Claude Desktop app, opening Settings (from the Claude menu or by Command + ' on the keyboard), clicking "Developer" in the sidebar, and "Edit Config."

2. Replace /Users/username/patent_mcp_server with the actual path to your patent_mcp_server directory.

When integrated with Claude Desktop, the server will be automatically started when needed and doesn't need to be run separately.

Claude Code Configuration

To integrate this MCP server with Claude Code for a particular project, from the project root:

claude mcp add-json patents '{"command": "uv", "args": ["--directory", "/path/to/patent_mcp_server", "run", "patent-mcp-server"]}'

If you're already running Claude Code, you'll have to /exit and restart. Then /mcp to verify that it's configured.

Available Tools

Utility Tools

Patent Public Search (ppubs.uspto.gov)

Open Data Portal (api.uspto.gov)

PTAB API v3 (Patent Trial and Appeal Board)

Patent Litigation API

PatentsView API (Unavailable — shut down March 2026)

All 14 PatentsView tools return API_UNAVAILABLE with workaround guidance. PatentsView data has been migrated to the USPTO Open Data Portal as bulk downloadable datasets. Use ppubs_search_patents for patent search, odp_search_datasets to find bulk datasets.

Office Action APIs (Unavailable — decommissioned early 2026)

All 4 Office Action tools return API_UNAVAILABLE. Use odp_get_documents to access office action documents from the file wrapper.

Enriched Citation APIs (Unavailable — decommissioned early 2026)

All 3 Enriched Citation tools return API_UNAVAILABLE. Use odp_get_documents or ppubs tools as workarounds.

Resources and Prompts

The server also provides MCP Resources (accessible via @ mentions):

• patents://cpc/{code} - CPC classification information
• patents://status-codes - USPTO status code definitions
• patents://sources - Data source information
• patents://search-syntax - Query syntax guide

And MCP Prompts (workflow templates):

• prior_art_search - Comprehensive prior art search guide
• patent_validity - Patent validity analysis workflow
• competitor_portfolio - Competitor portfolio analysis
• ptab_research - PTAB proceeding research guide
• freedom_to_operate - FTO analysis workflow
• patent_landscape - Technology landscape mapping

Testing

The project includes comprehensive test suites:

# Run unit tests (default - skips integration tests)
uv run pytest

# Run with verbose output
uv run pytest -v

# Run integration tests (requires network access)
uv run pytest -m integration

# Run all tests including integration
uv run pytest -m ""

# Run with coverage report
uv run pytest --cov=patent_mcp_server

Test results are stored in /test/test_results/.

Development

To install development dependencies:

uv sync --dev

Publishing to PyPI

# Build distribution packages
rm -rf dist/ && uv run python -m build

# Upload to PyPI
uv run twine upload dist/*

Version History

v0.8.0 (Current)

• Handle decommissioned PatentsView API (shut down March 20, 2026)
• All 14 patentsview_* tools return API_UNAVAILABLE with workaround guidance
• Fixed circular references in office_actions resources that pointed to unavailable PatentsView tools
• Updated API Sources table, configuration, and documentation

v0.7.0

• Handle decommissioned Office Action and Enriched Citation APIs (developer.uspto.gov)
• All 7 affected tools return API_UNAVAILABLE with workaround guidance
• Added test/unit/test_unavailable_tools.py for decommissioned tool testing
• Code cleanup: removed dead code, improved docstrings

v0.6.2

• Updated API key registration instructions: keys are now obtained from data.uspto.gov ("My ODP")
• Clarified that api.uspto.gov is the correct API endpoint (not data.uspto.gov which is the web portal)
• Noted PTAB API v3 migration to ODP and Office Action API migration (early 2026)

v0.6.1

• Added PatentsView attorney search tools (patentsview_search_attorneys, patentsview_get_attorney)
• Added PatentsView IPC classification tools (patentsview_lookup_ipc, patentsview_search_by_ipc)
• Fixed bug in search_publications method (pagination options not being passed)

v0.6.0

• PyPI release preparation

v0.5.0

• Focused on USPTO-only data sources
• Renamed ODP tools with odp_ prefix for clarity
• Improved function signatures (using query instead of q)

v0.3.0

• Added 33 new tools (PTAB, PatentsView, Office Actions, Citations, Litigation)
• Rate limiting support for PatentsView API
• Comprehensive async client architecture

v0.2.2

• Centralized configuration with environment variables
• Standardized error handling
• Input validation with Pydantic
• Retry logic with exponential backoff
• Session caching for PPUBS

License

MIT