--- name: oo-patsnap-mcp description: "Patsnap MCP (open.patsnap.com). Use this skill for ANY Patsnap MCP request — reading, creating, and updating data. Whenever a task involves Patsnap MCP, use this skill instead of calling the API directly." allowed-tools: [Bash(oo *)] metadata: title: "Patsnap MCP" author: "OOMOL" version: "1.0.0" services: ["patsnap_mcp"] icon: "https://static.oomol.com/logo/third-party/patsnap_mcp.svg" --- # Patsnap MCP Operate **Patsnap MCP** through your OOMOL-connected account. This skill calls the `patsnap_mcp` connector with the [oo CLI](https://github.com/oomol-lab/oo-cli); OOMOL injects credentials server-side, so you never handle raw tokens. ## Running an action Assume the user has already installed the oo CLI, signed in, and connected Patsnap MCP. **Do not run `oo auth login` or open the connection URL proactively — just run the action.** Fall back to [First-time setup](#first-time-setup) only when a command actually fails with an auth or connection error. **1. Inspect the contract** to get the authoritative input/output schema before building a payload: ```bash oo connector schema "patsnap_mcp" --action "" ``` **2. Run the action** with a JSON payload that matches the input schema: ```bash oo connector run "patsnap_mcp" --action "" --data '' --json ``` - `--data` takes a JSON object string or `@path/to/file.json`; omit it to send `{}`. - The response is `{ "data": ..., "meta": { "executionId": "..." } }`; the execution id lives under `meta.executionId`. Each action is listed below with a one-line description; actions that change state carry a `[write]` or `[destructive]` tag. Before constructing `--data`, fetch the action's live schema with `oo connector schema` to get its authoritative input fields. ## Available actions - `abstract_image` — Retrieves Valuation Patent Abstract Image data so users can review the key information and continue with downstream analysis. - `abstract_translated` — Retrieves Patent Abstract Translated data so users can review the key information and continue with downstream analysis. - `award_data` — Retrieves Patent Awards to review honors, awards, and external recognition for a company or patent. - `bibliography` — Retrieves detailed Bibliography for verification, full-text review, and deeper analysis. - `claim_translated` — Retrieves detailed Translated Claims for verification, full-text review, and deeper analysis. - `claims` — Retrieves detailed Claims for verification, full-text review, and deeper analysis. - `customs_data` — Retrieves Customs Recordation to assess status changes, patent stability, and potential legal risk. - `description` — Retrieves detailed Description for verification, full-text review, and deeper analysis. - `description_translated` — Retrieves detailed Translated Description for verification, full-text review, and deeper analysis. - `design_create_image_upload_url` — Returns a temporary PUT upload URL. Upload the image binary to this URL using HTTP PUT, then pass the returned image URL to design_submit_workflow. This tool only creates the upload URL and does not accept image binaries or large base64 payloads. [write] - `design_get_stage_result` — Get execution result of a specific stage — returns the full business data (result_data) of a stage, which may be large. To get final results, typically use stage='feature_comparison' or 'generate_report' - `design_get_task_status` — Query workflow task status — returns lightweight task overview and per-stage summaries (status/duration/retry count/error message) without large result_data, suitable for high-frequency polling - `design_submit_workflow` — Submit FTO workflow task — triggers the full pipeline (lineart conversion → search → rerank → RRF fusion → feature comparison → report generation) in one shot. Returns a task_id for polling via design_get_task_status and fetching results via design_get_stage_result [write] - `family` — Retrieves Patent Family to review family relationships, jurisdictional coverage, and family breadth. - `forward_citation` — Retrieves Valuation Patent Forward Citation data so users can review the key information and continue with downstream analysis. [write] - `fulltext_image` — Retrieves detailed Full-text Images for verification, full-text review, and deeper analysis. - `get_patent_legal_status` — Retrieves Simple Legal Status to assess status changes, patent stability, and potential legal risk. - `landscape_applicant_rank` — Analyzes Applicant Ranking to show activity changes, leading entities, and directional signals. - `landscape_applicant_technology_analysis` — Retrieves Applicant Technology Analysis data so users can review the key information and continue with downstream analysis. - `landscape_applicant_trend` — Analyzes Leading Applicant Filing Trend to show activity changes, leading entities, and directional signals. - `landscape_cooperation_applicant_analysis` — Retrieves Cooperation Applicant Analysis data so users can review the key information and continue with downstream analysis. - `landscape_detail` — Retrieves detailed Patent Details for verification, full-text review, and deeper analysis. - `landscape_detail_aggregation` — Retrieves detailed Patent Detail Aggregation for verification, full-text review, and deeper analysis. - `landscape_detail_text` — Retrieves detailed Patent Detail Text for verification, full-text review, and deeper analysis. - `landscape_domain_map` — Analyzes Domain Map to show structure, distribution, hotspots, and the overall landscape. - `landscape_famn_rank` — Analyzes Patent Family Ranking to show activity changes, leading entities, and directional signals. - `landscape_get_patent_pdf` — Retrieves Patent PDF data so users can review the key information and continue with downstream analysis. - `landscape_get_rec_office_year` — Analyzes Receiving Office Statistics By Year to show activity changes, leading entities, and directional signals. - `landscape_info` — Retrieves detailed Patent Field Details for verification, full-text review, and deeper analysis. - `landscape_list` — Retrieves a Patent List for batch review, filtering, and further processing. - `landscape_map_3d` — Analyzes 3D Map Analysis to show structure, distribution, hotspots, and the overall landscape. - `landscape_rec_office` — Analyzes Receiving Office Statistics to show activity changes, leading entities, and directional signals. - `landscape_refered_rank` — Analyzes Citation Count Ranking to show activity changes, leading entities, and directional signals. - `landscape_search_patents_facet` — Searches Patent Search Facets based on input criteria and returns matching results for screening, comparison, and follow-up analysis. - `landscape_search_patents_statistics` — Analyzes Patent Statistics to show activity changes, leading entities, and directional signals. - `landscape_search_patents_v3` — Searches Patent Search based on input criteria and returns matching results for screening, comparison, and follow-up analysis. - `landscape_search_patents_with_detail` — Searches Patent Search With Details based on input criteria and returns matching results for screening, comparison, and follow-up analysis. - `landscape_tech_applicant_dist` — Analyzes Key Technology Branch Applicant Distribution to show structure, distribution, hotspots, and the overall landscape. - `landscape_technology_constitute` — Analyzes Technology Composition to show structure, distribution, hotspots, and the overall landscape. - `landscape_technology_life_cycle` — Analyzes Technology Life Cycle to show structure, distribution, hotspots, and the overall landscape. - `landscape_trend` — Analyzes Patent Trend to show activity changes, leading entities, and directional signals. - `legal_data` — Retrieves detailed Legal Details for verification, full-text review, and deeper analysis. - `license_data` — Retrieves Valuation Patent License Data data so users can review the key information and continue with downstream analysis. - `list_tools` — Discover current tools and live input schemas for one Patsnap MCP service. Defaults to core_patents. - `pdf` — Retrieves detailed Full-text PDF for verification, full-text review, and deeper analysis. - `pledge_data` — Retrieves Valuation Patent Pledge Data data so users can review the key information and continue with downstream analysis. - `reexamination_invalidation` — Retrieves Reexamination And Invalidation to assess status changes, patent stability, and potential legal risk. - `search_patents` — Searches Patent Search By Query based on input criteria and returns matching results for screening, comparison, and follow-up analysis. - `transfer_data` — Retrieves Valuation Patent Transfer Data data so users can review the key information and continue with downstream analysis. [write] ## Safety - Untagged actions are reads (get / list / search) — safe to run directly. - **Actions tagged `[write]` change Patsnap MCP state — confirm the exact payload and effect with the user before running.** - **Actions tagged `[destructive]` remove or overwrite data — always confirm the target and get explicit approval first.** ## First-time setup These are **one-time** steps — do not repeat them on every call. Run a step only when a command fails for the matching reason. - **`oo: command not found`** — install the oo CLI (other platforms: ): ```bash curl -fsSL https://cli.oomol.com/install.sh | bash # macOS / Linux ``` ```powershell irm https://cli.oomol.com/install.ps1 | iex # Windows PowerShell ``` - **Not signed in / authentication error** — sign in to your OOMOL account once: ```bash oo auth login ``` - **`scope_missing` / `credential_expired` / `app_not_ready` / `app_not_found`** — Patsnap MCP is not connected, or the connection expired or lacks a scope. Connect once (auth type: API key) at: ```text https://console.oomol.com/app-connections?provider=patsnap_mcp ``` - **HTTP 402 / `OOMOL_INSUFFICIENT_CREDIT`** — billing stop. Recharge at `https://console.oomol.com/billing/token-recharge` before retrying. ## Resources - Patsnap MCP homepage: https://open.patsnap.com/marketplace/mcp-servers