PatentRef
US patent search, claim trees and lapse status through a PatentsView-compatible API
- 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-mcpAdd 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/)RequiredPATENTREF_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

Agent-Native Analytics
MCP serverOpen-source analytics app where an AI agent builds charts and dashboards from your data
- Remote
- Open source
- 7.7K GitHub stars
- Analytics and data

Google Ads + Meta Ads + SEO/GEO MCP
MCP serverHosted 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

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments

World Monitor
MCP serverLive geopolitical intelligence dashboard with an API and MCP server for agents
- Remote
- Freemium
- Analytics and data

CompanyData
MCP serverSearch and enrich company records from official registers via the CompanyData API
- 3 tools
- Remote
- Paid
- 3 GitHub stars
- Analytics and data

NY LLC Publication (FileMyPublication)
MCP serverNew York LLC publication rules, deadline, county prices, clerks and notice text
- 8 tools
- Remote
- Free
- Legal and government