PatSnap MCP Server

Instructions

Implementation Reference

• src/index.ts:281-285 (handler)

  The main handler function for the 'get_portfolio_value_distribution' tool. It builds URL search parameters from the input arguments and delegates to the shared 'callPatsnapApi' helper to fetch data from PatSnap API endpoint 'portfolio-value'.
  async function getPortfolioValueDistribution(args: BasePatentArgs): Promise<ServerResult> { const params = buildCommonSearchParams(args); // No 'lang' parameter for this endpoint return callPatsnapApi('portfolio-value', params, 'get portfolio value distribution'); }
• src/index.ts:303-316 (schema)

  Type and JSON schema definition for the input arguments accepted by the 'get_portfolio_value_distribution' tool (shared across similar patent search tools). Defines optional properties for keywords, IPC, date ranges, and authority.
  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:383-386 (registration)

  Tool registration in the ListToolsRequestHandler response. Specifies the tool name, description, and references the input schema.
  name: 'get_portfolio_value_distribution', description: 'Assess the lucrativeness of a technology space based on the spread of estimated patent valuation (simple families). Higher value buckets indicate more lucrative technologies. Design patents are excluded. Note: Search must contain either keywords or IPC. If both are provided, IPC is prioritized.', inputSchema: basePatentInputSchema // Uses base schema as 'lang' is not applicable }
• src/index.ts:403-403 (registration)

  Registration of the tool name mapped to its handler function in the dispatch object used by CallToolRequestHandler.
  'get_portfolio_value_distribution': getPortfolioValueDistribution, // Add new tool here
• src/index.ts:213-213 (schema)

  TypeScript type definition for the input arguments of the handler function.
  type BasePatentArgs = { keywords?: string; ipc?: string; apply_start_time?: string; apply_end_time?: string; public_start_time?: string; public_end_time?: string; authority?: string };