patentorney-mcp

An MCP server for managing patent application drafts. Built with FastMCP and designed for use with AI coding assistants (Windsurf, Claude Desktop, etc.).

Installation

pip install patentorney-mcp

Or with uvx (no install needed):

uvx patentorney-mcp

MCP Client Configuration

For Windsurf / Claude Desktop, add to your MCP config:

{
  "mcpServers": {
    "patentorney-mcp": {
      "command": "uvx",
      "args": ["patentorney-mcp"]
    }
  }
}

On first use, call set_root(path='/absolute/path/to/project') to point the server at the directory containing patent.yaml. All other tools will prompt for this if it hasn't been set.

Tools (8)

Tool	Purpose
`set_root(path)`	Point at a patent project directory. Must be called first.
`guide(topic?)`	Usage guides. No args → index.
`claim(action, ...)`	Claims: add\|get\|update\|remove\|move\|rename\|tree
`figure(action, ...)`	Figures: add\|get\|update\|remove\|move\|rename\|list
`numeral(action, ...)`	Numerals: add\|get\|update\|remove\|lookup\|rename\|renumber\|list
`prior_art(action, ...)`	Prior art & IDS: add\|get\|update\|remove\|list\|ids_add\|ids_list\|ids_check
`glossary(action, ...)`	Glossary: add\|get\|update\|remove\|list
`export(target, ...)`	Status, validation & export: status\|check\|claims\|drawings_description\|claims_latex\|drawings_latex\|latex

Any tool called before set_root() returns an error with a hint to call it. All errors include LLM-actionable hints.

Architecture

patent.yaml — single source of truth for structured data (claims, numerals, figures, glossary, prior art)
sections/*.tex — prose sections edited directly; claims.tex and drawings-description.tex are generated
Stable slug IDs — all entities use kebab-case slugs; presentation numbers computed from list order
Dual addressing — tools accept slug or current number (e.g., claim("get", id="3") or claim("get", id="mof-synthesis-method"))
File locking — fcntl.flock for safe concurrent access from multiple server instances
Structured claims — preamble + transitional + elements (each with numeral associations)

Project Layout

my-patent/
├── patent.yaml                         # structured data (MCP-managed)
├── sections/
│   ├── field.tex                       # prose (edit in IDE)
│   ├── background.tex                  # prose
│   ├── detailed-description.tex        # prose
│   ├── abstract.tex                    # prose
│   ├── claims.tex                      # GENERATED
│   └── drawings-description.tex        # GENERATED
├── figures/
│   └── *.pdf
├── main.tex                            # document root
└── tome/                               # prior art library (optional)

Testing

uv run pytest

License

MIT