README.md

Give your AI agent access to the world's patent and trademark data.

Project home: patentclient.com · Full documentation: docs.patentclient.com

Use the hosted demo

The fastest path — nothing to install. Point any MCP-speaking client (Claude Code, OpenAI Codex CLI, Google Antigravity CLI, Google Gemini CLI, Cursor, Windsurf, Cline, Zed, Continue.dev, VS Code Copilot Chat, JetBrains AI, Claude Desktop, ChatGPT Apps, Replit Agent, CoWork, …) at the public demo at mcp.patentclient.com:

{
  "mcpServers": {
    "patent-client-agents": {
      "url": "https://mcp.patentclient.com/mcp"
    }
  }
}

Most clients also expose a "custom connector" / "add MCP server" UI that takes just the URL https://mcp.patentclient.com/mcp — no tokens to paste. On first connect you'll be sent to Google sign-in; approve and you're in. Any verified Google account works.

The demo has per-account limits and a curated tool surface. Do not send confidential material through it. See the hosted-demo operations guide for limits, omissions, WAF behavior, and confidentiality guidance.

Or install locally

patent-client-agents is an MCP server, so it works with any MCP-speaking client. Claude Code, OpenAI Codex CLI, and Google Antigravity CLI are first-class deployment targets with native plugin packages. Cursor, Windsurf, Cline, Zed, Continue.dev, VS Code Copilot Chat, JetBrains AI Assistant, Claude Desktop, ChatGPT (remote URL), and Replit Agent (remote URL) can connect directly through MCP.

Path A — Native agent plugin

Each plugin launches the same pinned PyPI release through uvx and exposes 136 tools by default, or up to 234 when private credentials are configured. The three host packages are generated from satchel.yaml; that manifest is the source of truth for their shared identity, version, and MCP component.

Claude Code

/plugin marketplace add parkerhancock/patent-client-agents
/plugin install patent-client-agents@patent-client-agents
/reload-plugins

OpenAI Codex CLI

codex plugin marketplace add parkerhancock/patent-client-agents
codex plugin add patent-client-agents@patent-client-agents

Google Antigravity CLI

git clone --depth 1 https://github.com/parkerhancock/patent-client-agents.git
agy plugin install ./patent-client-agents/plugins/patent-client-agents

Start a new agent session after installing. See the installation guide for updates, removal, verification, and credential setup.

Path B — Direct MCP connection

pip install 'patent-client-agents[mcp]'

This puts patent-client-agents-mcp on PATH. Point your client's MCP config at it:

[mcp_servers.patent-client-agents]
command = "patent-client-agents-mcp"
env = { USPTO_ODP_API_KEY = "…" }

{
  "mcpServers": {
    "patent-client-agents": {
      "command": "patent-client-agents-mcp",
      "env": { "USPTO_ODP_API_KEY": "$USPTO_ODP_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "patent-client-agents": {
      "command": "patent-client-agents-mcp",
      "env": { "USPTO_ODP_API_KEY": "$USPTO_ODP_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "patent-client-agents": {
      "command": "patent-client-agents-mcp",
      "env": { "USPTO_ODP_API_KEY": "…" }
    }
  }
}

{
  "servers": {
    "patent-client-agents": {
      "type": "stdio",
      "command": "patent-client-agents-mcp",
      "env": { "USPTO_ODP_API_KEY": "${input:uspto-odp-key}" }
    }
  },
  "inputs": [
    { "id": "uspto-odp-key", "type": "promptString", "description": "USPTO ODP API key", "password": true }
  ]
}

{
  "context_servers": {
    "patent-client-agents": {
      "source": "custom",
      "command": "patent-client-agents-mcp",
      "env": { "USPTO_ODP_API_KEY": "…" }
    }
  }
}

mcpServers:
  - name: patent-client-agents
    command: patent-client-agents-mcp
    env:
      USPTO_ODP_API_KEY: ${{ secrets.USPTO_ODP_API_KEY }}

https://mcp.patentclient.com/mcp

Path C — Python library

pip install patent-client-agents

Direct async use from your own Python — no MCP runtime needed.

See docs.patentclient.com/installation for the full per-client reference, remote-MCP setup, and corpus-build steps.

What You Can Do

Ask your agent to research patents and trademarks in natural language:

"Find [Company]'s recent battery patents and summarize the key innovations"

"What's the prosecution history for US Patent 11,234,567?"

"Compare [Company A] and [Company B]'s patent portfolios in mobile display technology"

"Track the legal status of EP3456789 across all designated states"

"What's the current status of trademark serial 97123456, and who filed it?"

"Search the TMEP for guidance on Section 2(d) likelihood-of-confusion refusals"

patent-client-agents covers the major patent and trademark offices worldwide — see the full map at patentclient.com/atlas.

• Americas — USPTO (patents, trademarks, assignments, office actions), US Copyright Office, Federal Circuit (CAFC), US International Trade Commission (Section 337), CanLII Canada
• Europe — EPO OPS, EUIPO (EU trademarks + designs), Unified Patent Court (decisions + statutes), DPMA Germany (registers + statutes), INPI France (TM + designs), Légifrance (French IP code + trade secrets)
• Asia — China SPC IP Court hearing notices, Japan IP High Court patent and utility-model case lists, JPO Japan, KIPO Korea, TIPO Taiwan, IPO India (Acts + MPPP), Taiwan Trade Secrets Act
• Oceania — IP Australia (patents, trade marks, designs, bulk catalog)
• Multilateral — Google Patents (global search), WIPO Lex (~50k IP statutes across ~200 jurisdictions)
• Examiner & classification corpora — MPEP, TMEP, EPC + four EPO Guidelines families, Case Law of the Boards of Appeal, CPC (with IPC mapping)

JPO, CanLII, EUIPO, IP Australia, KIPO, TIPO, and INPI MCP tools register on the local stdio server and native agent plugins only when their credentials are set in the environment; the hosted demo at mcp.patentclient.com does not carry those credentials, so those tool families don't appear there.

Coverage

The canonical, human-readable inventory is the catalog/. It includes shipped data products and known sources that are restricted, blocked, commercial, or not yet connected.

All sources include automatic caching (hishel + SQLite with WAL), rate limiting, and retry logic via mcp-data-core.

API keys

136 patent + IP MCP tools are exposed by default. Credentialed families register when their environment variables are present, bringing the local/private surface up to 234 tools when every env-gated family is configured.

No API key needed: Google Patents, USPTO Publications (PPUBS), USPTO Assignments, USPTO Trademark Assignments, MPEP, TMEP, CPC, WIPO Lex, Federal Circuit (CAFC), Canada Federal Court case files, China SPC IP Court hearing notices, Japan IP High Court patent and utility-model case lists, USITC HTS, USITC IDS, US Copyright Office.

tmsearch extra (Playwright + curl_cffi)

USPTO TESS sits behind AWS WAF. To mint the WAF token in-process, install the optional extra and bootstrap Chromium once:

pip install 'patent-client-agents[tmsearch]'
playwright install chromium

On headless server deployments where Playwright isn't installed, set PCA_WAF_TOKEN_JSON to a token JSON payload (Secret Manager mount) or PCA_WAF_TOKEN_PATH to a path on disk — the client will reuse the cached token until it expires (~4 days).

Quickstart — Python library

pip install patent-client-agents

from patent_client_agents.google_patents import GooglePatentsClient

async with GooglePatentsClient() as client:
    patent = await client.get_patent_data("US10123456B2")
    print(patent.title)
    print(patent.abstract)

    results = await client.search_patents(keywords=["machine learning neural network"])
    for r in results.results:
        print(f"{r.publication_number}: {r.title}")

Detailed Coverage

Architecture

┌──────────────────────────────────────────────────────────────────────┐
│  Any MCP-speaking agent — Claude Code, Codex CLI, Antigravity CLI,  │
│     Cursor, Windsurf, Cline, Zed, Continue, Copilot Chat, JetBrains, │
│     Claude Desktop, ChatGPT (remote), Replit Agent (remote)          │
├──────────────────────────────────────────────────────────────────────┤
│                   patent-client-agents MCP Server                     │
│                  (Natural language → API calls)                       │
├──────────────────────────────────────────────────────────────────────┤
│                  patent_client_agents Python library                  │
│                                                                       │
│  Multilateral  · Google Patents · WIPO Lex                            │
│  Americas      · USPTO (patents · trademarks · assignments ·          │
│                  office actions) · US Copyright Office · CAFC ·       │
│                  USITC (EDIS/DataWeb/HTS/IDS) · CanLII Canada*        │
│  Europe        · EPO OPS · EUIPO* · UPC (decisions + statutes) ·      │
│                  DPMA Germany · INPI France* · Légifrance (CPI)       │
│  Asia          · JPO Japan* · KIPO Korea* · TIPO Taiwan* ·            │
│                  IPO India (Acts + MPPP) · Taiwan Trade Secrets       │
│  Oceania       · IP Australia* (patents · TM · designs · bulk)        │
│                                                                       │
│  Statutes & manuals · MPEP · TMEP · EPC · EPO Guidelines (Exam +      │
│                       PCT-EPO + Unitary Patent) · Case Law (white     │
│                       book) · UPC Agreement & Rules                   │
│  Classification     · CPC (with IPC mapping)                          │
└──────────────────────────────────────────────────────────────────────┘
* MCP tools register only when the corresponding credentials are set
  on the server (JPO_API_*, CANLII_API_KEY, EUIPO_CLIENT_ID/SECRET,
  IPAUSTRALIA_CLIENT_ID/SECRET, KIPO_KIPRIS_API_KEY,
  KIPO_KIPRIS_BASE_URL, TIPO_API_KEY,
  INPI_USERNAME/PASSWORD); the hosted demo does not carry these
  credentials.

Development

git clone https://github.com/parkerhancock/patent-client-agents.git
cd patent-client-agents
uv sync --frozen --all-extras --group dev
uv run pytest                       # Replay VCR cassettes and offline fixtures
uv run ruff check .
uv run ruff format --check .

Tests use vcrpy to replay recorded HTTP interactions without hitting live APIs. Record modes:

uv run pytest --vcr-record=once     # Record missing cassettes
uv run pytest --vcr-record=all      # Re-record everything
uv run pytest --run-live-uspto --vcr-record=once  # Allow missing USPTO cassettes to record
uv run pytest --run-live-jpo --vcr-record=once    # Allow missing JPO cassettes to record
uv run pytest --run-live-euipo --vcr-record=once  # Allow missing EUIPO cassettes to record

API errors follow a log-first pattern — concise messages with a path to ~/.cache/patent_client_agents/patent_client_agents.log for full stacktraces.

The shared HTTP scaffolding (BaseAsyncClient, cache, exceptions, retry, logging, response envelopes, and MCP server helpers) now lives in the separate mcp-data-core package.

See the contribution guide for the complete validation, cassette, and release workflow. Report security issues privately as described in the security policy.

Related

• patent_client - The original patent data library this project builds on

License

Apache-2.0