Patent Intelligence ZY

Patent Intelligence ZY: legal Status API

Patent Intelligence ZY: legal Status API.

MCP tool name

nexscope_data_zy_legal_status

MCP endpoint

https://api.nexscope.ai/mcp

JSON-RPC method

tools/call

Authentication

Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

If authentication fails, ask the user to open API Access and copy a valid key.

Call this MCP tool

Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.

{
  "jsonrpc": "2.0",
  "id": "data-zy-legal-status-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_data_zy_legal_status",
    "arguments": {
      "patentNumber": "CN115000000A"
    }
  }
}

MCP 2025-11-25 · Streamable HTTP

Progress is delivered on the original POST SSE response. GET SSE carries notifications; reconnecting must query existing asynchronous work rather than submit again.

Arguments

Name	Type	Required	Description
`patentId`	`string`	optional	Patent IDs, multiples separated by English commas, upper limit 100, maximum length 60,000 characters; priority is given when it exists together with `patentNumber`. Example: {}
`patentNumber`	`string`	optional	Public (announcement) numbers, multiple numbers separated by English commas, the upper limit is 100, and the maximum length is 60,000 characters. Example: {}

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`total`	`integer`	optional	Number of records. Example: {}
`data`	`array`	optional	List of patent legal statuses. Example: {}
`columns`	`array`	optional	Rendered column definitions. Example: {}
`costToken`	`integer`	optional	Consume token. Example: {}
`type`	`string`	optional	Rendering style. Example: {}
`patentId`	`string`	optional	Patent ID. Example: {}
`pn`	`string`	optional	Public (announcement) number. Example: {}
`simpleLegalStatus`	`array`	optional	Simple legal status: `Inactive` (expired), `Active` (valid), `Pending` (under review), `Undetermined` (unconfirmed), `PCT designated period` (within PCT designation period), `PCT designated expiration` (PCT designation expiry). Example: {}
`legalStatus`	`array`	optional	Legal status. Available options `Published` `Examining` `Granted` `Double` `Abandoned-Undetermined` `Abandoned-Voluntarily` `Abandoned-Deemed` `Withdrawn-Undetermined` `Withdrawn-Voluntarily` `Withdrawn-Deemed` `Rejected` `Revoked` `Expired` `Non-Payment` `Restoration` `Ceased` `P-Revoked` `Discontinuation` `PCT published` `PCT entering(designated period)` `PCT entering(designated expiration)` `PCT unentered`. Status names indicate publication `examination` `grant` `abandonment` `withdrawal` `invalidation` `expiry` `non-payment` `restoration` `PCT entry; retain the exact status spelling` Example: {}
`eventStatus`	`array`	optional	Legal events: `Transfer` (right transfer), `License` (license), `Pledge` (pledge/guarantee), `Trust` (trust), `Opposition` (objection), `Re-examination` (review), `Customs` (customs filing), `Litigation` (litigation), `Preservation` (preservation), `Invalid-procedure` (invalidation procedure), `Oral-procedure` (oral hearing), `Declassification` (defense declassification), `Double application` (one case, two applications). Example: {}
`legalDate`	`integer`	optional	Legal status update date (timestamp). Example: {}

Examples

Example arguments

{
  "patentNumber": "CN115000000A"
}

Example structuredContent

{
  "code": 0,
  "cost": "-1",
  "data": {},
  "msg": null,
  "time": "2026-01-01 00:00:00",
  "traceId": null,
  "ts": "0"
}