{
  "markdown": "# @patentprecheck/mcp — Patent PreCheck CLI + MCP server\n\n[![npm version](https://img.shields.io/npm/v/@patentprecheck/mcp.svg)](https://www.npmjs.com/package/@patentprecheck/mcp)\n[![npm downloads](https://img.shields.io/npm/dm/@patentprecheck/mcp.svg)](https://www.npmjs.com/package/@patentprecheck/mcp)\n[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-listed-1f6feb.svg)](https://registry.modelcontextprotocol.io)\n[![license](https://img.shields.io/npm/l/@patentprecheck/mcp.svg)](./LICENSE)\n[![node](https://img.shields.io/node/v/@patentprecheck/mcp.svg)](https://nodejs.org)\n\n[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=patent-precheck&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBwYXRlbnRwcmVjaGVjay9tY3AiLCJtY3AiXX0=)\n\n[![Patent-PreCheck/patent-precheck-mcp MCP server](https://glama.ai/mcp/servers/Patent-PreCheck/patent-precheck-mcp/badges/card.svg)](https://glama.ai/mcp/servers/Patent-PreCheck/patent-precheck-mcp)\n[![Patent-PreCheck/patent-precheck-mcp MCP server](https://glama.ai/mcp/servers/Patent-PreCheck/patent-precheck-mcp/badges/score.svg)](https://glama.ai/mcp/servers/Patent-PreCheck/patent-precheck-mcp)\n\nRun a patentability pre-check on your code from inside your terminal or your AI\ncoding agent (Cursor, Claude Code, Codex, Antigravity). It wraps the hosted\n[Patent PreCheck](https://patentprecheck.com) engine, so **no API keys are\nrequired** — the scoring engine and prior-art corpus stay server-side.\n\n> Informational only — not legal advice and not a substitute for a licensed patent attorney.\n\n## What it does\n\n- Scores code or an invention description across the four USPTO statutory pillars\n  (§101 eligibility, §102 novelty, §103 non-obviousness, §101 utility) plus a\n  separate §112 filing-readiness signal.\n- Reports the band (Not Ready → File Ready), the pillar holding the band back,\n  top opportunities to strengthen, and how much prior art was consulted.\n- Exposes MCP tools so an agent can score the code it just wrote, inline.\n\n## Install\n\n```sh\n# Run directly (no install)\nnpx -y @patentprecheck/mcp score ./src/widget.ts\n\n# Or install globally\nnpm i -g @patentprecheck/mcp\nprecheck score ./src/widget.ts\n```\n\n## CLI\n\n```sh\nprecheck score ./path/to/file.ts          # human-readable report\nprecheck score ./file.ts --format json    # raw JSON\ncat invention.md | precheck score -        # read from stdin\nprecheck score ./file.ts --min-score 60    # exit 4 if below threshold (CI gate)\nprecheck pillars                           # scoring reference (no network)\nprecheck review                            # Interactive Code Review signup URL\nprecheck mcp                               # run as an MCP server over stdio\n```\n\nExit codes: `0` ok · `1` usage · `2` request error · `3` §101 gate not passed ·\n`4` below `--min-score`. stdout is clean data; progress/errors go to stderr.\n\n## Use in an AI coding agent\n\nSee [`config-examples/`](./config-examples/). Quickest paths:\n\n```sh\n# Claude Code\nclaude mcp add patent-precheck -- npx -y @patentprecheck/mcp mcp\n```\n\n```json\n// Cursor — .cursor/mcp.json\n{ \"mcpServers\": { \"patent-precheck\": { \"command\": \"npx\", \"args\": [\"-y\", \"@patentprecheck/mcp\", \"mcp\"] } } }\n```\n\nMCP tools: `precheck_score`, `precheck_prior_art`, `precheck_rejection_patterns`, `precheck_legal_context`, `precheck_pillars`, `precheck_start_review`, `precheck_search_corpus`, `precheck_cpc_suggest`, `precheck_session_status`, `precheck_deliverables`, `precheck_lookup_patent`, `precheck_compare_to_patent`.\n\nCursor users can skip the JSON and use the **Add to Cursor** button at the top.\nThe server is published to the [official MCP Registry](https://registry.modelcontextprotocol.io)\n(`io.github.Patent-PreCheck/patent-precheck`), so MCP-aware clients can discover it directly.\n\n### Hosted endpoint (no install)\n\nThere's also a hosted, keyless **Streamable HTTP** MCP server, so remote-capable\nclients can connect without `npx` or a local Node install:\n\n```\nhttps://patentprecheck.com/mcp\n```\n\n```json\n// Cursor — remote server, no command needed\n{ \"mcpServers\": { \"patent-precheck\": { \"url\": \"https://patentprecheck.com/mcp\" } } }\n```\n\nSame **12 tools** and the same scoring engine. The hosted variant takes invention\ntext inline via `code` (it never reads files from your machine — use the local\n`npx` server above if you want the `path` argument).\n\n**Quick try in Cursor (no install):** copy `config-examples/cursor-mcp-hosted.json` into `.cursor/mcp.json`.\n\n## Why Patent PreCheck vs. other patent MCPs?\n\nUSPTO lookup MCPs (50+ tools) answer *\"what does patent X say?\"* Patent PreCheck answers *\"can **this code** be patented?\"* — pillar scores, prior-art similarity, rejection patterns, and a path to strengthen before filing. **No USPTO API key**; corpus and keys stay server-side.\n\n## Develop from source\n\n```sh\ngit clone https://github.com/Patent-PreCheck/patent-precheck-mcp.git\ncd patent-precheck-mcp\nnpm install\nnode bin/precheck.js pillars\necho \"a novel rate limiter that ...\" | node bin/precheck.js score - --format text\nnode bin/precheck.js mcp   # stdio server; blocks waiting for an MCP client\n```\n",
  "bytes": 5153,
  "sha": "138e1e38b1a80e8b73deeab8705a52910f49f7ef23a9253a68db15095ea7e5a6",
  "repo_slug": "patent-precheck/patent-precheck-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_patent_precheck_patent_prechec_d120fc8d/readme"
}