Patsnap MCP

Operate Patsnap MCP through your OOMOL-connected account. This skill calls the patsnap_mcp connector with the 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 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:

oo connector schema "patsnap_mcp" --action "<action_name>"

2. Run the action with a JSON payload that matches the input schema:

oo connector run "patsnap_mcp" --action "<action_name>" --data '<json>' --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: https://cli.oomol.com/install-guide.md):

curl -fsSL https://cli.oomol.com/install.sh | bash    # macOS / Linux

irm https://cli.oomol.com/install.ps1 | iex           # Windows PowerShell

Not signed in / authentication error — sign in to your OOMOL account once:
```
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:
```
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