Skip to main content
Glama

Patent Intelligence ZY: patent Image Search API

nexscope_data_zy_patent_image_search
Read-only

Patent Intelligence ZY: patent Image Search API.

Input Schema

NameRequiredDescriptionDefault
locNoLOC classification, multiple classification numbers can be connected using `AND`/`OR`/`NOT`.
urlYesImage URL, maximum 1,000 characters.
langNoTitle language: `original` (original text), `cn` (Chinese translation), `en` (English translation).original
fieldNoSorting fields: `SCORE` (relevance), `APD` (application date), `PBD` (publication date), `ISD` (authorization date).SCORE
limitNoReturns the number of patents, 1–100.
modelYesAppearance patents: `1` (intelligent Lenovo, recommended), `2` (search this picture); utility models: `3` (matching shape), `4` (matching shape/pattern/color, recommended).
orderNoValid when `field` is a date field: `desc` or `asc`.desc
offsetNoOffset, 0–1000.
countryNoThe country/organization/region code of the patent acceptance office. Multiple ones are separated by English commas; if not passed, it means all the acceptance offices.
isHttpsNoImage domain name protocol: `1` returns HTTPS, `0` returns HTTP.
stemmingNoWhether to turn on truncation: `1` is on, `0` is off.
assigneesNoApplicant (patent rights), maximum 1,000 characters.
mainFieldNoMain patent fields, including title, abstract, claims, specification, publication number, application number, applicant, inventor, and IPC/UPC/LOC classification number, maximum 1,000 characters.
preFilterNoWhether to enable prefix country/LOC filtering: `1` is on, `0` is off.
patentTypeYesPatent type: `D` (appearance patent) or `U` (utility model patent); the utility model skill uses `U` permanently.
legalStatusNoDetailed legal status codes, multiple separated by English commas: `1` public, `2` substantive review, `3` authorized, `8` avoid repeated authorization, `11` withdrawn, `12` withdrawn-unspecified type, `17` Withdrawal - deemed withdrawal, `18` withdrawal - active withdrawal, `13` rejection, `14` all withdrawal, `15` expiration of term, `16` unpaid annual fee, `21` rights restoration, `22` rights termination, `23` Partially invalid, `24` application terminated, `30` abandoned, `19` abandoned - deemed abandoned, `20` abandoned - voluntary abandoned, `25` abandoned - unspecified type, `222` PCT did not enter the designated country - within the designated period, `223` PCT Entering the designated country - within the designation period, `224` PCT entering the designated country - the designation period expires, `225` PCT not entering the designated country - the designation period expires.
returnImgIdNoWhether to return `imgId`.
applyEndTimeNoApplication deadline, format `yyyyMMdd`.
publicEndTimeNoPublic deadline, format `yyyyMMdd`.
applyStartTimeNoApplication start date, format `yyyyMMdd`.
scoreExpansionNoWhether to perform score expansion.
publicStartTimeNoPublication start date, format `yyyyMMdd`.
simpleLegalStatusNoSimple legal status: `0` expired, `1` valid, `2` under review, `220` PCT designated expiration, `221` PCT designated period, `999` unconfirmed.
includeMachineTranslationNoWhether the search includes machine translation data.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

C2.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true, destructiveHint=false and openWorldHint=true, so the safety profile is covered. The description adds nothing beyond that — notably it does not mention that a URL must be publicly reachable, how results are ranked or paginated, or what happens with the 24 optional filters. No contradiction with annotations, but no added behavioral context either.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

It is short, but brevity here is under-specification rather than conciseness: a single sentence that duplicates the title and is not front-loaded with any actionable information. Nothing in it earns a place because nothing in it adds information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

This is a high-complexity tool: 24 parameters, 3 required (url, patentType, model), enumerated model codes, and no output schema to explain return values. A title-only description leaves the agent without the scope, prerequisites, or result shape needed to invoke it confidently, especially with multiple near-duplicate patent image search siblings available.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% across all 24 parameters, so the schema itself carries full semantics (model codes, date formats, legal status codes). The description contributes zero parameter meaning, so per the coverage rule the baseline of 3 applies rather than higher.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose2/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description is a restatement of the tool name and title: 'Patent Intelligence ZY: patent Image Search API.' It signals an image-based patent search but gives no verb-level detail on what is actually searched or returned, and it does not distinguish this from close siblings such as nexscope_zhihuiya_patent_image_search, nexscope_zhihuiya_utility_patent_image_search, nexscope_design_similarity_search, or nexscope_data_zy_fulltext_image.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No indication of when to use this tool, when not to, or which sibling to prefer. The agent is left to infer from the name that it does image similarity lookup over patent records, and cannot tell from the text whether this differs meaningfully from the Zhihuiya-branded or design-similarity image search tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.