PatSnap MCP Server

Instructions

Implementation Reference

• src/index.ts:259-264 (handler)

  The handler function for 'get_top_assignees' tool. It builds URL search parameters from input args, defaults 'lang' to 'en' if not provided, and delegates to the shared callPatsnapApi helper to fetch data from PatSnap's 'applicant-ranking' endpoint.
  async function getTopAssignees(args: LangPatentArgs): Promise<ServerResult> { const params = buildCommonSearchParams(args); if (!args.lang) { // Add default lang if not provided params.append('lang', 'en'); } return callPatsnapApi('applicant-ranking', params, 'get top assignees');
• src/index.ts:366-370 (registration)

  Registration of the 'get_top_assignees' tool in the ListToolsRequestSchema handler. Includes tool name, detailed description, and reference to the input schema (langRequiredPatentInputSchema).
  { name: 'get_top_assignees', description: 'Shows the top companies (assignees) with the largest patent portfolios. Identify largest players and competitive threats. Returns up to the top 10 assignees. Note: Search must contain either keywords or IPC. If both are provided, IPC is prioritized.', inputSchema: langRequiredPatentInputSchema },
• src/index.ts:400-400 (registration)

  Mapping of the tool name 'get_top_assignees' to its handler function (getTopAssignees) in the central toolImplementations dispatch object used by CallToolRequestSchema handler.
  'get_top_assignees': getTopAssignees,
• src/index.ts:326-329 (schema)

  Definition of the input schema specifically for tools requiring 'lang', including it in the required fields. This schema is used by 'get_top_assignees'.
  const langRequiredPatentInputSchema = { ...langPatentInputSchema, required: ['lang'] };
• src/index.ts:303-316 (schema)

  Base input schema for patent-related tools, defining properties like keywords, ipc, time filters, and authority. Forms the foundation for the 'get_top_assignees' input schema.
  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." };