PatSnap MCP Server

Instructions

Implementation Reference

• src/index.ts:240-246 (handler)

  The handler function that executes the core logic for the 'get_top_authorities_of_origin' tool. It builds URL search parameters from input args, defaults language to 'en', and calls the shared PatSnap API helper with the specific endpoint 'priority-country'.
  async function getTopAuthoritiesOfOrigin(args: LangPatentArgs): Promise<ServerResult> { const params = buildCommonSearchParams(args); if (!args.lang) { // Add default lang if not provided params.append('lang', 'en'); } return callPatsnapApi('priority-country', params, 'get top authorities of origin'); }
• src/index.ts:303-316 (schema)

  basePatentInputSchema defines the core input properties (keywords, ipc, date filters, authority) used by the tool's inputSchema.
  const basePatentInputSchema = { type: 'object' as const, // Use 'as const' for stricter type checking properties: { keywords: { type: 'string', description: 'Keywords to search within patent title and abstract/summary. Supports AND, OR, NOT logic. Example: "mobile phone AND (screen OR battery)"' }, ipc: { type: 'string', description: 'Patent IPC classification code. Used to specify a particular technology field.' }, apply_start_time: { type: 'string', description: 'Patent application start year (yyyy format). Filters by application filing date.' }, apply_end_time: { type: 'string', description: 'Patent application end year (yyyy format). Filters by application filing date.' }, public_start_time: { type: 'string', description: 'Patent publication start year (yyyy format). Filters by publication date.' }, public_end_time: { type: 'string', description: 'Patent publication end year (yyyy format). Filters by publication date.' }, authority: { type: 'string', description: 'Patent authority code (e.g., CN, US, EP, JP). Filters by patent office. Use OR for multiple, e.g., "US OR EP".' } }, // Add a note about requiring keywords or IPC for most tools description: "Requires either 'keywords' or 'ipc' to be specified for a meaningful search. If both are provided, IPC is prioritized by the API." };
• src/index.ts:318-324 (schema)

  langPatentInputSchema extends basePatentInputSchema with optional 'lang' property. This is the inputSchema referenced for the 'get_top_authorities_of_origin' tool.
  const langPatentInputSchema = { ...basePatentInputSchema, properties: { ...basePatentInputSchema.properties, lang: { type: 'string', description: 'Language setting. Default is "en" (English). Choose "cn" (Chinese) or "en".' } } };
• src/index.ts:357-360 (registration)

  Tool registration in the ListToolsRequestHandler response, including name, description, and inputSchema.
  name: 'get_top_authorities_of_origin', description: 'Returns the top authorities (priority countries) of origin for patents matching the criteria. Analyze main sources of priority filings. Either keywords or IPC classification must be specified.', inputSchema: langPatentInputSchema },
• src/index.ts:397-397 (registration)

  Maps the tool name to its handler function in the toolImplementations Record used for dispatching in CallToolRequestHandler.
  'get_top_authorities_of_origin': getTopAuthoritiesOfOrigin,