Skip to content
MCP server

PatentRef

US patent search, claim trees and lapse status through a PatentsView-compatible API

Runs locallyStatus and history
Pricing
Freemium
Platforms
API, CLI
Runs
Locally
Version
0.4.1
Listing updated
3 days ago

About PatentRef

PatentRef is a freemium MCP server for legal and government. It runs locally on your machine and is started by your AI client.

PatentRef fills a gap left when PatentsView's PatentSearch API paused on 2026-03-20. It answers the same v1 grammar, with the same paths, q/f/s/o parameters, response shape and error codes, from its own snapshot of USPTO bulk data. Existing clients work by changing the base URL and sending a PatentRef key in X-Api-Key.

The MCP server adds task-shaped tools. check_patent_status returns expiry and maintenance-fee state for one granted patent with its basis and next steps, described as record facts and not a legal opinion. search_patents queries by title, date, CPC class, assignee or inventor, similar_patents ranks by closeness to a passage, and patent briefs bundle claims with status. Grants run from 1976 to now.

A free key allows 1,000 requests a month and 45 a minute. Every answer carries an X-Data-Version header, and the data is also published as SQLite files on Zenodo.

Install

Run in a terminal

claude mcp add patentref-mcp --env PATENTREF_API_KEY='<PATENTREF_API_KEY>' -- uvx patentref-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "patentref-mcp": {
      "command": "uvx",
      "args": [
        "patentref-mcp"
      ],
      "env": {
        "PATENTREF_API_KEY": "<PATENTREF_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "patentref-mcp": {
      "command": "uvx",
      "args": [
        "patentref-mcp"
      ],
      "env": {
        "PATENTREF_API_KEY": "<PATENTREF_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "patentref-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "patentref-mcp"
      ],
      "env": {
        "PATENTREF_API_KEY": "<PATENTREF_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "patentref-mcp": {
      "command": "uvx",
      "args": [
        "patentref-mcp"
      ],
      "env": {
        "PATENTREF_API_KEY": "<PATENTREF_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "patentref-mcp": {
      "command": "uvx",
      "args": [
        "patentref-mcp"
      ],
      "env": {
        "PATENTREF_API_KEY": "<PATENTREF_API_KEY>"
      }
    }
  }
}

Configuration

  • PATENTREF_API_KEYA PatentRef API key (a free key at https://patentref.io/api/v1/meta/signup/)Required
  • PATENTREF_BASEThe API's scheme and host (default https://patentref.io)

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

check_patent_status
Expiry and maintenance-fee status for one granted US patent.
search_patents
Search granted US patents with the PatentSearch v1 grammar.
similar_patents
Rank patents by closeness to a passage of text.
get_patent_brief
Claims together with status for a patent.
search_disclosures
Search PatentRef registry records.

What it does

Drop-in grammar
Same PatentSearch v1 parameters, shapes and errors.
Lapse status
Expiry and maintenance-fee status with reinstatement basis.
Field search
Query by title, dates, CPC, assignee or inventor.
Similarity ranking
Rank patents against a passage of text.
Versioned data
Every answer carries its data build.
Open snapshot
SQLite files are published on Zenodo.

Good for

  • Check whether a patent has lapsed for fees
  • Move a PatentsView client to a working endpoint
  • Find patents by assignee and CPC class
  • Rank prior art against a draft passage

Pricing

Freemium

Free key: 1,000 requests a month

Prices change. Check patentref.io before you buy.

PatentRef FAQ

Do I need a key?

Yes, a free PatentRef key; a PatentsView key does not work.

What are the free limits?

1,000 requests a month and 45 a minute.

Is status a legal opinion?

No. The tool returns record facts, not legal advice.

What years are covered?

Granted US patents from 1976 to now.

Is PatentRef free?

PatentRef has a free plan, with paid plans for more usage or features.

How do I add PatentRef to Claude Code?

Run this command in your terminal: claude mcp add patentref-mcp --env PATENTREF_API_KEY='<PATENTREF_API_KEY>' -- uvx patentref-mcp

What are the best alternatives to PatentRef?

The closest alternatives to PatentRef are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and CompanyData.

Alternatives to PatentRef

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  5. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data
  6. New York LLC publication rules, deadline, county prices, clerks and notice text

    • 8 tools
    • Remote
    • Free
    • Legal and government