Open source Apache 2.0 Python and MCP

The public record of invention, ready for agents.

Patent Client Agents turns official and public patent, trademark, design, copyright, fee, and case-law sources into typed tools. Try the curated public service, run the full MCP server privately, or call the Python clients directly.

Try the hosted demo Install locally View on GitHub

Research workflows

Research questions become inspectable tool calls.

The calling agent decides which tools to combine. Each tool returns typed data with source URLs and retrieval details, so the path from question to record remains visible.

Search and compare

Find the relevant patent record, then move through its family.

"Find recent U.S. patents on transformer inference acceleration and compare the independent claims."

Global patent indexes, USPTO Patent Public Search, USPTO Open Data Portal, EPO OPS

Reconstruct prosecution

Read the application, office actions, cited art, and file history together.

"What changed between the first rejection and allowance of this application?"

USPTO Open Data Portal, office-action data, Patent Center documents, PTAB

Track rights and ownership

Check status, assignments, and prosecution documents for patents and marks.

"Who owns this portfolio now, and which recorded transfers explain the chain?"

USPTO assignments, TSDR, EPO legal events, national and regional registers

Read law and proceedings

Connect agency guidance, statutes, fees, and published decisions.

"Find the governing examination guidance and the recent decisions that apply it."

MPEP, TMEP, EPO Guidelines, WIPO Lex, CAFC, UPC, national IP courts

Coverage with boundaries

The catalog records what works, what needs credentials, and what cannot be automated.

The atlas covers offices, courts, legal references, fee schedules, and public data products. A green rating means a usable programmatic path exists. Yellow identifies a credential or paid-access condition. Red records the legal or technical reason a connector is not shipped.

Explore the atlas Read the source catalog

116: offices and institutions researched
120: canonical source records
114: data products projected into the atlas
7: IP rights represented

Selected shipped coverage, not an exhaustive source list.

United States

USPTO patents, applications, assignments, office actions, PTAB, petitions, trademarks, examiner manuals, Federal Circuit opinions, copyright records, and public ITC data.

Europe

EPO bibliographic and family data, the EP Register, examination guidance, Boards of Appeal, the EPC, EUIPO registers, UPC law and decisions, and national sources.

Asia and the Pacific

Japan, Korea, China, Taiwan, Singapore, Australia, New Zealand, India, Thailand, and other national sources, with credentials required where an office imposes them.

Law, litigation, and cost

Published decisions from IP courts and tribunals, WIPO Lex statutes and treaties, classification systems, and normalized patent, trademark, and design fee schedules.

Choose the operating model

Start public. Move private when the research requires it.

All three surfaces use the same typed clients. The difference is how much of the source catalog you can expose and which credentials you control.

Curated public service

Hosted MCP

Connect an MCP client and sign in. The hosted service exposes a deliberately smaller set of sources that are reliable and suitable for a shared public endpoint.

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

Open the demo

Full local surface

Agent plugins

Install the same package in Claude Code, Codex CLI, or Antigravity CLI. It exposes 136 tools by default; private credentials can register up to 234 tools for sources that do not belong on a shared service.

Claude Code
OpenAI Codex CLI
Google Antigravity CLI

Plugin install guide

Application integration

Async Python library

Import only the clients your application needs. Pydantic models, async context managers, caching, retries, and source-specific exceptions work without an MCP runtime.

pip install patent-client-agents

async with UsptoOdpClient() as c:
    app = await c.applications.get("17/000,000")
    print(app.title)

Library quickstart

One path to the source

The server stays thin. The evidence stays attached.

MCP supplies discovery and schemas. The Python client handles the upstream protocol. The response identifies the source and retrieval path rather than hiding them behind a generic answer.

1Agent or applicationChooses a tool based on the research task.
2MCP toolValidates typed inputs and presents a stable contract.
3Source clientHandles the office API, public page, workbook, or corpus.
4Typed resultReturns normalized fields, provenance, and source links.

Designed for inspection

A research result should tell you where it came from.

The project favors source-specific behavior over a lowest-common-denominator abstraction. That makes failures easier to diagnose and records easier to verify.

Source provenance Responses preserve source URLs, retrieval times, query details, and source-specific identifiers where available.
Typed models Pydantic models expose the shape of a record before an agent or application depends on it.
Source-aware clients Caching, retry policy, authentication, and error handling reflect the behavior of each upstream system.
Repeatable validation Thousands of tests exercise parsing, routing, schemas, recorded HTTP interactions, and documentation contracts across supported Python versions.