Patent & IP Risk

Patent Legal Status Data MCP Tool

Query patent legal status information from the Zhihuiya (PatSnap) database.

MCP tool name

nexscope_patent_legal_status_data

Equivalent REST API path

https://claw-callback.nexscope.ai/api/skill-api/v1/skills/patent-legal-status-data/run

JSON-RPC method

tools/call

Authentication

Send the user API key as a bearer token on every MCP JSON-RPC request.

Authorization: Bearer nk_xxxxxxxxxxxxxxxxx

If authentication is missing or invalid, ask the user to open API Access and copy a valid key before calling this tool.

Call this MCP tool

Use tools/call with the MCP tool name below. The arguments object should match the table on this page.

{
  "jsonrpc": "2.0",
  "id": "patent-legal-status-data-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_patent_legal_status_data",
    "arguments": {
      "patentNumber": "US11299876B2"
    }
  }
}

REST API equivalent

POST /api/skill-api/v1/runhttps://claw-callback.nexscope.ai/api/skill-api/v1/skills/patent-legal-status-data/run

Canonical detail URL

https://www.nexscope.ai/mcp-map/patent-legal-status-data

Arguments

Name	Type	Required	Meaning
`patentId`	`string`	optional	Patent ID. At least one of patentId and patentNumber must be provided; if both are present, patentId takes priority. Only a single value is supported; multiple values separated by commas are not allowed. Max length: 60000 characters. Example: {}
`patentNumber`	`string`	optional	Publication (grant) number. At least one of patentId and patentNumber must be provided; if both are present, patentId takes priority. Only a single value is supported; multiple values separated by commas are not allowed. Max length: 60000 characters. Example: US11299876B2

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Meaning
`total`	`integer`	optional	Number of records Example: 1
`data`	`array`	optional	Patent legal status list Example: []
`data[].patentId`	`string`	optional	Patent ID Example: example-id
`data[].pn`	`string`	optional	Publication (grant) number Example: {}
`data[].simpleLegalStatus`	`array`	optional	Simple legal status. Options: Inactive, Active, Pending, Undetermined, PCT designated period, PCT designated expiration Example: []
`data[].legalStatus`	`array`	optional	Legal status. 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 Example: []
`data[].eventStatus`	`array`	optional	Legal events. Options: Transfer, License, Pledge, Trust, Opposition, Re-examination, Customs, Litigation, Preservation, Invalid-procedure, Oral-procedure, Declassification, Double application Example: []
`data[].legalDate`	`integer`	optional	Legal status update date (timestamp) Example: 1
`columns`	`array`	optional	Column definitions for rendering Example: []
`costToken`	`integer`	optional	Tokens consumed Example: 1
`type`	`string`	optional	Render style Example: {}
`errcode`	`integer`	optional	Upstream status code returned by the provider. Example: {}
`errmsg`	`string`	optional	Upstream status message returned by the provider. Example: {}
`code`	`string`	optional	Provider-specific status code. Example: {}
`msg`	`string`	optional	Provider-specific status message. Example: {}
`message`	`string`	optional	Provider-specific message. Example: {}
`title`	`string`	optional	Provider-specific response title. Example: {}
`sourceType`	`string`	optional	Provider-specific source platform type. Example: {}
`sourceTool`	`string`	optional	Provider-specific source tool name. Example: {}
`costTime`	`integer`	optional	Execution time reported by the upstream provider. Example: {}
`page`	`integer`	optional	Current page returned by the upstream provider. Example: {}
`pageSize`	`integer`	optional	Page size returned by the upstream provider. Example: {}
`pageItemCount`	`integer`	optional	Item count on the current page returned by the upstream provider. Example: {}
`totalPage`	`integer`	optional	Total page count returned by the upstream provider. Example: {}
`dataSnapshotMonth`	`string`	optional	Data snapshot month returned by the upstream provider. Example: {}

Examples

Example arguments

{
  "patentNumber": "US11299876B2"
}

Example structuredContent

{
  "total": 1,
  "data": [
    {
      "patentId": "example-id",
      "simpleLegalStatus": [],
      "legalStatus": [],
      "eventStatus": [],
      "legalDate": 1
    }
  ],
  "columns": [],
  "costToken": 1
}