patents-mcp-server 1.0.0

package/dist/tools/office-actions.tools.d.ts

@@ -0,0 +1,7 @@
+import { FastMCP } from "fastmcp";
+
+//#region src/tools/office-actions.tools.d.ts
+declare const registerOfficeActionsTools: (server: FastMCP) => void;
+//#endregion
+export { registerOfficeActionsTools };
+//# sourceMappingURL=office-actions.tools.d.ts.map

package/dist/tools/office-actions.tools.js

@@ -0,0 +1,2 @@
+import{config as e}from"../lib/config.js";import{handleApiError as t}from"../lib/errors.js";import"../base.client-zZnUjoIb.js";import{OdpClient as n}from"../clients/odp.client.js";import{z as r}from"zod";const i={readOnlyHint:!0,destructiveHint:!1,idempotentHint:!0,openWorldHint:!0},a=()=>new n({apiKey:e.usptoApiKey??(()=>{throw Error(`USPTO_API_KEY is required`)})(),timeout:e.requestTimeout}),o=e=>{e.addTool({name:`office-action-get-text`,description:`Get the full text of office actions for a patent application. Includes examiner rejections, objections, and requirements.`,parameters:r.object({applicationNumber:r.string().describe(`Application number (e.g., 16/123,456 or 16123456)`)}),annotations:i,execute:async e=>{try{let t=await a().getOfficeActionText(e.applicationNumber);return JSON.stringify(t)}catch(e){return t(e)}}}),e.addTool({name:`office-action-search`,description:`Search office actions across USPTO patent applications.`,parameters:r.object({query:r.string().describe(`Search query text`),limit:r.number().int().min(1).max(100).default(25).describe(`Number of results to return (1-100)`)}),annotations:i,execute:async e=>{try{let t=await a().searchOfficeActions(e.query,e.limit);return JSON.stringify(t)}catch(e){return t(e)}}}),e.addTool({name:`office-action-get-citations`,description:`Get prior art citations from office actions for a patent application. Shows references cited by the examiner.`,parameters:r.object({applicationNumber:r.string().describe(`Application number (e.g., 16/123,456 or 16123456)`)}),annotations:i,execute:async e=>{try{let t=await a().getOfficeActionCitations(e.applicationNumber);return JSON.stringify(t)}catch(e){return t(e)}}}),e.addTool({name:`office-action-get-rejections`,description:`Get rejection data from office actions for a patent application. Includes rejection types (35 USC 101, 102, 103, 112) and affected claims.`,parameters:r.object({applicationNumber:r.string().describe(`Application number (e.g., 16/123,456 or 16123456)`)}),annotations:i,execute:async e=>{try{let t=await a().getOfficeActionRejections(e.applicationNumber);return JSON.stringify(t)}catch(e){return t(e)}}})};export{o as registerOfficeActionsTools};
+//# sourceMappingURL=office-actions.tools.js.map

package/dist/tools/office-actions.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"office-actions.tools.js","names":[],"sources":["../../src/tools/office-actions.tools.ts"],"sourcesContent":["import type { FastMCP } from \"fastmcp\"\nimport { z } from \"zod\"\n\nimport { OdpClient } from \"../clients/odp.client\"\nimport { config } from \"../lib/config\"\nimport { handleApiError } from \"../lib/errors\"\n\nconst OA_ANNOTATIONS = {\n  readOnlyHint: true,\n  destructiveHint: false,\n  idempotentHint: true,\n  openWorldHint: true,\n} as const\n\nconst createClient = (): OdpClient => {\n  return new OdpClient({\n    apiKey:\n      config.usptoApiKey ??\n      (() => {\n        throw new Error(\"USPTO_API_KEY is required\")\n      })(),\n    timeout: config.requestTimeout,\n  })\n}\n\nexport const registerOfficeActionsTools = (server: FastMCP): void => {\n  server.addTool({\n    name: \"office-action-get-text\",\n    description:\n      \"Get the full text of office actions for a patent application. Includes examiner rejections, objections, and requirements.\",\n    parameters: z.object({\n      applicationNumber: z.string().describe(\"Application number (e.g., 16/123,456 or 16123456)\"),\n    }),\n    annotations: OA_ANNOTATIONS,\n    execute: async (args) => {\n      try {\n        const client = createClient()\n        const result = await client.getOfficeActionText(args.applicationNumber)\n        return JSON.stringify(result)\n      } catch (error) {\n        return handleApiError(error)\n      }\n    },\n  })\n\n  server.addTool({\n    name: \"office-action-search\",\n    description: \"Search office actions across USPTO patent applications.\",\n    parameters: z.object({\n      query: z.string().describe(\"Search query text\"),\n      limit: z.number().int().min(1).max(100).default(25).describe(\"Number of results to return (1-100)\"),\n    }),\n    annotations: OA_ANNOTATIONS,\n    execute: async (args) => {\n      try {\n        const client = createClient()\n        const result = await client.searchOfficeActions(args.query, args.limit)\n        return JSON.stringify(result)\n      } catch (error) {\n        return handleApiError(error)\n      }\n    },\n  })\n\n  server.addTool({\n    name: \"office-action-get-citations\",\n    description:\n      \"Get prior art citations from office actions for a patent application. Shows references cited by the examiner.\",\n    parameters: z.object({\n      applicationNumber: z.string().describe(\"Application number (e.g., 16/123,456 or 16123456)\"),\n    }),\n    annotations: OA_ANNOTATIONS,\n    execute: async (args) => {\n      try {\n        const client = createClient()\n        const result = await client.getOfficeActionCitations(args.applicationNumber)\n        return JSON.stringify(result)\n      } catch (error) {\n        return handleApiError(error)\n      }\n    },\n  })\n\n  server.addTool({\n    name: \"office-action-get-rejections\",\n    description:\n      \"Get rejection data from office actions for a patent application. Includes rejection types (35 USC 101, 102, 103, 112) and affected claims.\",\n    parameters: z.object({\n      applicationNumber: z.string().describe(\"Application number (e.g., 16/123,456 or 16123456)\"),\n    }),\n    annotations: OA_ANNOTATIONS,\n    execute: async (args) => {\n      try {\n        const client = createClient()\n        const result = await client.getOfficeActionRejections(args.applicationNumber)\n        return JSON.stringify(result)\n      } catch (error) {\n        return handleApiError(error)\n      }\n    },\n  })\n}\n"],"mappings":"4MAOA,MAAM,EAAiB,CACrB,aAAc,GACd,gBAAiB,GACjB,eAAgB,GAChB,cAAe,GAChB,CAEK,MACG,IAAI,EAAU,CACnB,OACE,EAAO,kBACA,CACL,MAAU,MAAM,4BAA4B,IAC1C,CACN,QAAS,EAAO,eACjB,CAAC,CAGS,EAA8B,GAA0B,CACnE,EAAO,QAAQ,CACb,KAAM,yBACN,YACE,4HACF,WAAY,EAAE,OAAO,CACnB,kBAAmB,EAAE,QAAQ,CAAC,SAAS,oDAAoD,CAC5F,CAAC,CACF,YAAa,EACb,QAAS,KAAO,IAAS,CACvB,GAAI,CAEF,IAAM,EAAS,MADA,GAAc,CACD,oBAAoB,EAAK,kBAAkB,CACvE,OAAO,KAAK,UAAU,EAAO,OACtB,EAAO,CACd,OAAO,EAAe,EAAM,GAGjC,CAAC,CAEF,EAAO,QAAQ,CACb,KAAM,uBACN,YAAa,0DACb,WAAY,EAAE,OAAO,CACnB,MAAO,EAAE,QAAQ,CAAC,SAAS,oBAAoB,CAC/C,MAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC,SAAS,sCAAsC,CACpG,CAAC,CACF,YAAa,EACb,QAAS,KAAO,IAAS,CACvB,GAAI,CAEF,IAAM,EAAS,MADA,GAAc,CACD,oBAAoB,EAAK,MAAO,EAAK,MAAM,CACvE,OAAO,KAAK,UAAU,EAAO,OACtB,EAAO,CACd,OAAO,EAAe,EAAM,GAGjC,CAAC,CAEF,EAAO,QAAQ,CACb,KAAM,8BACN,YACE,gHACF,WAAY,EAAE,OAAO,CACnB,kBAAmB,EAAE,QAAQ,CAAC,SAAS,oDAAoD,CAC5F,CAAC,CACF,YAAa,EACb,QAAS,KAAO,IAAS,CACvB,GAAI,CAEF,IAAM,EAAS,MADA,GAAc,CACD,yBAAyB,EAAK,kBAAkB,CAC5E,OAAO,KAAK,UAAU,EAAO,OACtB,EAAO,CACd,OAAO,EAAe,EAAM,GAGjC,CAAC,CAEF,EAAO,QAAQ,CACb,KAAM,+BACN,YACE,6IACF,WAAY,EAAE,OAAO,CACnB,kBAAmB,EAAE,QAAQ,CAAC,SAAS,oDAAoD,CAC5F,CAAC,CACF,YAAa,EACb,QAAS,KAAO,IAAS,CACvB,GAAI,CAEF,IAAM,EAAS,MADA,GAAc,CACD,0BAA0B,EAAK,kBAAkB,CAC7E,OAAO,KAAK,UAAU,EAAO,OACtB,EAAO,CACd,OAAO,EAAe,EAAM,GAGjC,CAAC"}

package/dist/tools/patentsview.tools.d.ts

@@ -0,0 +1,7 @@
+import { FastMCP } from "fastmcp";
+
+//#region src/tools/patentsview.tools.d.ts
+declare const registerPatentsViewTools: (server: FastMCP) => void;
+//#endregion
+export { registerPatentsViewTools };
+//# sourceMappingURL=patentsview.tools.d.ts.map

package/dist/tools/patentsview.tools.js

@@ -0,0 +1,2 @@
+import{config as e}from"../lib/config.js";import{handleApiError as t}from"../lib/errors.js";import"../base.client-zZnUjoIb.js";import{PatentsViewClient as n}from"../clients/patentsview.client.js";import{z as r}from"zod";const i={readOnlyHint:!0,destructiveHint:!1,idempotentHint:!0,openWorldHint:!0},a=()=>new n({apiKey:e.patentsViewApiKey,timeout:e.requestTimeout}),o=e=>{e.addTool({name:`patentsview-search-patents`,description:`Search for patents on PatentsView by text query, assignee name, or inventor name. Returns patent metadata including title, abstract, date, assignees, and inventors.`,parameters:r.object({query:r.string().describe(`Search query string (text, assignee name, or inventor name)`),search_type:r.enum([`text`,`assignee`,`inventor`]).default(`text`).describe(`Type of search: text (abstract search), assignee (organization), or inventor (name)`),limit:r.number().int().min(1).max(100).default(25).describe(`Number of results to return (1-100)`)}),annotations:i,execute:async e=>{try{let t=await a().searchPatents(e.query,e.search_type,e.limit);return JSON.stringify(t)}catch(e){return t(e)}}}),e.addTool({name:`patentsview-get-patent`,description:`Get detailed information about a specific patent by its patent ID (e.g., '11234567'). Returns full patent metadata.`,parameters:r.object({patent_id:r.string().describe(`The patent ID (e.g., '11234567')`)}),annotations:i,execute:async e=>{try{let t=await a().getPatent(e.patent_id);return JSON.stringify(t)}catch(e){return t(e)}}}),e.addTool({name:`patentsview-search-assignees`,description:`Search for patent assignees (organizations or individuals) by name. Returns assignee details and patent counts.`,parameters:r.object({name:r.string().describe(`Assignee name or organization to search for`),limit:r.number().int().min(1).max(100).default(25).describe(`Number of results to return (1-100)`)}),annotations:i,execute:async e=>{try{let t=await a().searchAssignees(e.name,e.limit);return JSON.stringify(t)}catch(e){return t(e)}}}),e.addTool({name:`patentsview-get-assignee`,description:`Get detailed information about a specific patent assignee by their assignee ID.`,parameters:r.object({assignee_id:r.string().describe(`The assignee ID`)}),annotations:i,execute:async e=>{try{let t=await a().getAssignee(e.assignee_id);return JSON.stringify(t)}catch(e){return t(e)}}}),e.addTool({name:`patentsview-search-inventors`,description:`Search for patent inventors by name. Returns inventor details and patent counts.`,parameters:r.object({name:r.string().describe(`Inventor name to search for`),limit:r.number().int().min(1).max(100).default(25).describe(`Number of results to return (1-100)`)}),annotations:i,execute:async e=>{try{let t=await a().searchInventors(e.name,e.limit);return JSON.stringify(t)}catch(e){return t(e)}}}),e.addTool({name:`patentsview-get-inventor`,description:`Get detailed information about a specific patent inventor by their inventor ID.`,parameters:r.object({inventor_id:r.string().describe(`The inventor ID`)}),annotations:i,execute:async e=>{try{let t=await a().getInventor(e.inventor_id);return JSON.stringify(t)}catch(e){return t(e)}}}),e.addTool({name:`patentsview-search-attorneys`,description:`Search for patent attorneys/agents by name or organization. Returns attorney details and patent counts.`,parameters:r.object({name:r.string().describe(`Attorney name or organization to search for`),limit:r.number().int().min(1).max(100).default(25).describe(`Number of results to return (1-100)`)}),annotations:i,execute:async e=>{try{let t=await a().searchAttorneys(e.name,e.limit);return JSON.stringify(t)}catch(e){return t(e)}}}),e.addTool({name:`patentsview-get-attorney`,description:`Get detailed information about a specific patent attorney by their attorney ID.`,parameters:r.object({attorney_id:r.string().describe(`The attorney ID`)}),annotations:i,execute:async e=>{try{let t=await a().getAttorney(e.attorney_id);return JSON.stringify(t)}catch(e){return t(e)}}}),e.addTool({name:`patentsview-get-claims`,description:`Get the claims text for a specific patent by its patent ID.`,parameters:r.object({patent_id:r.string().describe(`The patent ID to get claims for`)}),annotations:i,execute:async e=>{try{let t=await a().getClaims(e.patent_id);return JSON.stringify(t)}catch(e){return t(e)}}}),e.addTool({name:`patentsview-get-description`,description:`Get the description text for a specific patent by its patent ID. Includes brief summary, detailed description, and drawing descriptions.`,parameters:r.object({patent_id:r.string().describe(`The patent ID to get description for`)}),annotations:i,execute:async e=>{try{let t=await a().getDescription(e.patent_id);return JSON.stringify(t)}catch(e){return t(e)}}}),e.addTool({name:`patentsview-search-by-cpc`,description:`Search for patents by CPC (Cooperative Patent Classification) code. CPC codes classify patents by technology area.`,parameters:r.object({cpc_code:r.string().describe(`CPC subgroup code (e.g., 'A61K31/00' for medicinal preparations)`),limit:r.number().int().min(1).max(100).default(25).describe(`Number of results to return (1-100)`)}),annotations:i,execute:async e=>{try{let t=await a().searchByCpc(e.cpc_code,e.limit);return JSON.stringify(t)}catch(e){return t(e)}}}),e.addTool({name:`patentsview-lookup-cpc`,description:`Look up a CPC (Cooperative Patent Classification) subgroup code to get its title and classification details.`,parameters:r.object({cpc_code:r.string().describe(`CPC subgroup code to look up (e.g., 'A61K31/00')`)}),annotations:i,execute:async e=>{try{let t=await a().lookupCpc(e.cpc_code);return JSON.stringify(t)}catch(e){return t(e)}}}),e.addTool({name:`patentsview-search-by-ipc`,description:`Search for patents by IPC (International Patent Classification) code. IPC codes classify patents internationally.`,parameters:r.object({ipc_code:r.string().describe(`IPC class code (e.g., 'A61K')`),limit:r.number().int().min(1).max(100).default(25).describe(`Number of results to return (1-100)`)}),annotations:i,execute:async e=>{try{let t=await a().searchByIpc(e.ipc_code,e.limit);return JSON.stringify(t)}catch(e){return t(e)}}}),e.addTool({name:`patentsview-lookup-ipc`,description:`Look up an IPC (International Patent Classification) code to get its classification details.`,parameters:r.object({ipc_code:r.string().describe(`IPC class code to look up (e.g., 'A61K')`)}),annotations:i,execute:async e=>{try{let t=await a().lookupIpc(e.ipc_code);return JSON.stringify(t)}catch(e){return t(e)}}})};export{o as registerPatentsViewTools};
+//# sourceMappingURL=patentsview.tools.js.map

package/dist/tools/patentsview.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patentsview.tools.js","names":[],"sources":["../../src/tools/patentsview.tools.ts"],"sourcesContent":["import type { FastMCP } from \"fastmcp\"\nimport { z } from \"zod\"\n\nimport { PatentsViewClient } from \"../clients/patentsview.client\"\nimport { config } from \"../lib/config\"\nimport { handleApiError } from \"../lib/errors\"\n\nconst TOOL_ANNOTATIONS = {\n  readOnlyHint: true,\n  destructiveHint: false,\n  idempotentHint: true,\n  openWorldHint: true,\n} as const\n\nconst createClient = (): PatentsViewClient => {\n  return new PatentsViewClient({\n    apiKey: config.patentsViewApiKey,\n    timeout: config.requestTimeout,\n  })\n}\n\nexport const registerPatentsViewTools = (server: FastMCP): void => {\n  server.addTool({\n    name: \"patentsview-search-patents\",\n    description:\n      \"Search for patents on PatentsView by text query, assignee name, or inventor name. Returns patent metadata including title, abstract, date, assignees, and inventors.\",\n    parameters: z.object({\n      query: z.string().describe(\"Search query string (text, assignee name, or inventor name)\"),\n      search_type: z\n        .enum([\"text\", \"assignee\", \"inventor\"])\n        .default(\"text\")\n        .describe(\"Type of search: text (abstract search), assignee (organization), or inventor (name)\"),\n      limit: z.number().int().min(1).max(100).default(25).describe(\"Number of results to return (1-100)\"),\n    }),\n    annotations: TOOL_ANNOTATIONS,\n    execute: async (args) => {\n      try {\n        const client = createClient()\n        const result = await client.searchPatents(args.query, args.search_type, args.limit)\n        return JSON.stringify(result)\n      } catch (error) {\n        return handleApiError(error)\n      }\n    },\n  })\n\n  server.addTool({\n    name: \"patentsview-get-patent\",\n    description:\n      \"Get detailed information about a specific patent by its patent ID (e.g., '11234567'). Returns full patent metadata.\",\n    parameters: z.object({\n      patent_id: z.string().describe(\"The patent ID (e.g., '11234567')\"),\n    }),\n    annotations: TOOL_ANNOTATIONS,\n    execute: async (args) => {\n      try {\n        const client = createClient()\n        const result = await client.getPatent(args.patent_id)\n        return JSON.stringify(result)\n      } catch (error) {\n        return handleApiError(error)\n      }\n    },\n  })\n\n  server.addTool({\n    name: \"patentsview-search-assignees\",\n    description:\n      \"Search for patent assignees (organizations or individuals) by name. Returns assignee details and patent counts.\",\n    parameters: z.object({\n      name: z.string().describe(\"Assignee name or organization to search for\"),\n      limit: z.number().int().min(1).max(100).default(25).describe(\"Number of results to return (1-100)\"),\n    }),\n    annotations: TOOL_ANNOTATIONS,\n    execute: async (args) => {\n      try {\n        const client = createClient()\n        const result = await client.searchAssignees(args.name, args.limit)\n        return JSON.stringify(result)\n      } catch (error) {\n        return handleApiError(error)\n      }\n    },\n  })\n\n  server.addTool({\n    name: \"patentsview-get-assignee\",\n    description: \"Get detailed information about a specific patent assignee by their assignee ID.\",\n    parameters: z.object({\n      assignee_id: z.string().describe(\"The assignee ID\"),\n    }),\n    annotations: TOOL_ANNOTATIONS,\n    execute: async (args) => {\n      try {\n        const client = createClient()\n        const result = await client.getAssignee(args.assignee_id)\n        return JSON.stringify(result)\n      } catch (error) {\n        return handleApiError(error)\n      }\n    },\n  })\n\n  server.addTool({\n    name: \"patentsview-search-inventors\",\n    description: \"Search for patent inventors by name. Returns inventor details and patent counts.\",\n    parameters: z.object({\n      name: z.string().describe(\"Inventor name to search for\"),\n      limit: z.number().int().min(1).max(100).default(25).describe(\"Number of results to return (1-100)\"),\n    }),\n    annotations: TOOL_ANNOTATIONS,\n    execute: async (args) => {\n      try {\n        const client = createClient()\n        const result = await client.searchInventors(args.name, args.limit)\n        return JSON.stringify(result)\n      } catch (error) {\n        return handleApiError(error)\n      }\n    },\n  })\n\n  server.addTool({\n    name: \"patentsview-get-inventor\",\n    description: \"Get detailed information about a specific patent inventor by their inventor ID.\",\n    parameters: z.object({\n      inventor_id: z.string().describe(\"The inventor ID\"),\n    }),\n    annotations: TOOL_ANNOTATIONS,\n    execute: async (args) => {\n      try {\n        const client = createClient()\n        const result = await client.getInventor(args.inventor_id)\n        return JSON.stringify(result)\n      } catch (error) {\n        return handleApiError(error)\n      }\n    },\n  })\n\n  server.addTool({\n    name: \"patentsview-search-attorneys\",\n    description:\n      \"Search for patent attorneys/agents by name or organization. Returns attorney details and patent counts.\",\n    parameters: z.object({\n      name: z.string().describe(\"Attorney name or organization to search for\"),\n      limit: z.number().int().min(1).max(100).default(25).describe(\"Number of results to return (1-100)\"),\n    }),\n    annotations: TOOL_ANNOTATIONS,\n    execute: async (args) => {\n      try {\n        const client = createClient()\n        const result = await client.searchAttorneys(args.name, args.limit)\n        return JSON.stringify(result)\n      } catch (error) {\n        return handleApiError(error)\n      }\n    },\n  })\n\n  server.addTool({\n    name: \"patentsview-get-attorney\",\n    description: \"Get detailed information about a specific patent attorney by their attorney ID.\",\n    parameters: z.object({\n      attorney_id: z.string().describe(\"The attorney ID\"),\n    }),\n    annotations: TOOL_ANNOTATIONS,\n    execute: async (args) => {\n      try {\n        const client = createClient()\n        const result = await client.getAttorney(args.attorney_id)\n        return JSON.stringify(result)\n      } catch (error) {\n        return handleApiError(error)\n      }\n    },\n  })\n\n  server.addTool({\n    name: \"patentsview-get-claims\",\n    description: \"Get the claims text for a specific patent by its patent ID.\",\n    parameters: z.object({\n      patent_id: z.string().describe(\"The patent ID to get claims for\"),\n    }),\n    annotations: TOOL_ANNOTATIONS,\n    execute: async (args) => {\n      try {\n        const client = createClient()\n        const result = await client.getClaims(args.patent_id)\n        return JSON.stringify(result)\n      } catch (error) {\n        return handleApiError(error)\n      }\n    },\n  })\n\n  server.addTool({\n    name: \"patentsview-get-description\",\n    description:\n      \"Get the description text for a specific patent by its patent ID. Includes brief summary, detailed description, and drawing descriptions.\",\n    parameters: z.object({\n      patent_id: z.string().describe(\"The patent ID to get description for\"),\n    }),\n    annotations: TOOL_ANNOTATIONS,\n    execute: async (args) => {\n      try {\n        const client = createClient()\n        const result = await client.getDescription(args.patent_id)\n        return JSON.stringify(result)\n      } catch (error) {\n        return handleApiError(error)\n      }\n    },\n  })\n\n  server.addTool({\n    name: \"patentsview-search-by-cpc\",\n    description:\n      \"Search for patents by CPC (Cooperative Patent Classification) code. CPC codes classify patents by technology area.\",\n    parameters: z.object({\n      cpc_code: z.string().describe(\"CPC subgroup code (e.g., 'A61K31/00' for medicinal preparations)\"),\n      limit: z.number().int().min(1).max(100).default(25).describe(\"Number of results to return (1-100)\"),\n    }),\n    annotations: TOOL_ANNOTATIONS,\n    execute: async (args) => {\n      try {\n        const client = createClient()\n        const result = await client.searchByCpc(args.cpc_code, args.limit)\n        return JSON.stringify(result)\n      } catch (error) {\n        return handleApiError(error)\n      }\n    },\n  })\n\n  server.addTool({\n    name: \"patentsview-lookup-cpc\",\n    description:\n      \"Look up a CPC (Cooperative Patent Classification) subgroup code to get its title and classification details.\",\n    parameters: z.object({\n      cpc_code: z.string().describe(\"CPC subgroup code to look up (e.g., 'A61K31/00')\"),\n    }),\n    annotations: TOOL_ANNOTATIONS,\n    execute: async (args) => {\n      try {\n        const client = createClient()\n        const result = await client.lookupCpc(args.cpc_code)\n        return JSON.stringify(result)\n      } catch (error) {\n        return handleApiError(error)\n      }\n    },\n  })\n\n  server.addTool({\n    name: \"patentsview-search-by-ipc\",\n    description:\n      \"Search for patents by IPC (International Patent Classification) code. IPC codes classify patents internationally.\",\n    parameters: z.object({\n      ipc_code: z.string().describe(\"IPC class code (e.g., 'A61K')\"),\n      limit: z.number().int().min(1).max(100).default(25).describe(\"Number of results to return (1-100)\"),\n    }),\n    annotations: TOOL_ANNOTATIONS,\n    execute: async (args) => {\n      try {\n        const client = createClient()\n        const result = await client.searchByIpc(args.ipc_code, args.limit)\n        return JSON.stringify(result)\n      } catch (error) {\n        return handleApiError(error)\n      }\n    },\n  })\n\n  server.addTool({\n    name: \"patentsview-lookup-ipc\",\n    description: \"Look up an IPC (International Patent Classification) code to get its classification details.\",\n    parameters: z.object({\n      ipc_code: z.string().describe(\"IPC class code to look up (e.g., 'A61K')\"),\n    }),\n    annotations: TOOL_ANNOTATIONS,\n    execute: async (args) => {\n      try {\n        const client = createClient()\n        const result = await client.lookupIpc(args.ipc_code)\n        return JSON.stringify(result)\n      } catch (error) {\n        return handleApiError(error)\n      }\n    },\n  })\n}\n"],"mappings":"4NAOA,MAAM,EAAmB,CACvB,aAAc,GACd,gBAAiB,GACjB,eAAgB,GAChB,cAAe,GAChB,CAEK,MACG,IAAI,EAAkB,CAC3B,OAAQ,EAAO,kBACf,QAAS,EAAO,eACjB,CAAC,CAGS,EAA4B,GAA0B,CACjE,EAAO,QAAQ,CACb,KAAM,6BACN,YACE,uKACF,WAAY,EAAE,OAAO,CACnB,MAAO,EAAE,QAAQ,CAAC,SAAS,8DAA8D,CACzF,YAAa,EACV,KAAK,CAAC,OAAQ,WAAY,WAAW,CAAC,CACtC,QAAQ,OAAO,CACf,SAAS,sFAAsF,CAClG,MAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC,SAAS,sCAAsC,CACpG,CAAC,CACF,YAAa,EACb,QAAS,KAAO,IAAS,CACvB,GAAI,CAEF,IAAM,EAAS,MADA,GAAc,CACD,cAAc,EAAK,MAAO,EAAK,YAAa,EAAK,MAAM,CACnF,OAAO,KAAK,UAAU,EAAO,OACtB,EAAO,CACd,OAAO,EAAe,EAAM,GAGjC,CAAC,CAEF,EAAO,QAAQ,CACb,KAAM,yBACN,YACE,sHACF,WAAY,EAAE,OAAO,CACnB,UAAW,EAAE,QAAQ,CAAC,SAAS,mCAAmC,CACnE,CAAC,CACF,YAAa,EACb,QAAS,KAAO,IAAS,CACvB,GAAI,CAEF,IAAM,EAAS,MADA,GAAc,CACD,UAAU,EAAK,UAAU,CACrD,OAAO,KAAK,UAAU,EAAO,OACtB,EAAO,CACd,OAAO,EAAe,EAAM,GAGjC,CAAC,CAEF,EAAO,QAAQ,CACb,KAAM,+BACN,YACE,kHACF,WAAY,EAAE,OAAO,CACnB,KAAM,EAAE,QAAQ,CAAC,SAAS,8CAA8C,CACxE,MAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC,SAAS,sCAAsC,CACpG,CAAC,CACF,YAAa,EACb,QAAS,KAAO,IAAS,CACvB,GAAI,CAEF,IAAM,EAAS,MADA,GAAc,CACD,gBAAgB,EAAK,KAAM,EAAK,MAAM,CAClE,OAAO,KAAK,UAAU,EAAO,OACtB,EAAO,CACd,OAAO,EAAe,EAAM,GAGjC,CAAC,CAEF,EAAO,QAAQ,CACb,KAAM,2BACN,YAAa,kFACb,WAAY,EAAE,OAAO,CACnB,YAAa,EAAE,QAAQ,CAAC,SAAS,kBAAkB,CACpD,CAAC,CACF,YAAa,EACb,QAAS,KAAO,IAAS,CACvB,GAAI,CAEF,IAAM,EAAS,MADA,GAAc,CACD,YAAY,EAAK,YAAY,CACzD,OAAO,KAAK,UAAU,EAAO,OACtB,EAAO,CACd,OAAO,EAAe,EAAM,GAGjC,CAAC,CAEF,EAAO,QAAQ,CACb,KAAM,+BACN,YAAa,mFACb,WAAY,EAAE,OAAO,CACnB,KAAM,EAAE,QAAQ,CAAC,SAAS,8BAA8B,CACxD,MAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC,SAAS,sCAAsC,CACpG,CAAC,CACF,YAAa,EACb,QAAS,KAAO,IAAS,CACvB,GAAI,CAEF,IAAM,EAAS,MADA,GAAc,CACD,gBAAgB,EAAK,KAAM,EAAK,MAAM,CAClE,OAAO,KAAK,UAAU,EAAO,OACtB,EAAO,CACd,OAAO,EAAe,EAAM,GAGjC,CAAC,CAEF,EAAO,QAAQ,CACb,KAAM,2BACN,YAAa,kFACb,WAAY,EAAE,OAAO,CACnB,YAAa,EAAE,QAAQ,CAAC,SAAS,kBAAkB,CACpD,CAAC,CACF,YAAa,EACb,QAAS,KAAO,IAAS,CACvB,GAAI,CAEF,IAAM,EAAS,MADA,GAAc,CACD,YAAY,EAAK,YAAY,CACzD,OAAO,KAAK,UAAU,EAAO,OACtB,EAAO,CACd,OAAO,EAAe,EAAM,GAGjC,CAAC,CAEF,EAAO,QAAQ,CACb,KAAM,+BACN,YACE,0GACF,WAAY,EAAE,OAAO,CACnB,KAAM,EAAE,QAAQ,CAAC,SAAS,8CAA8C,CACxE,MAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC,SAAS,sCAAsC,CACpG,CAAC,CACF,YAAa,EACb,QAAS,KAAO,IAAS,CACvB,GAAI,CAEF,IAAM,EAAS,MADA,GAAc,CACD,gBAAgB,EAAK,KAAM,EAAK,MAAM,CAClE,OAAO,KAAK,UAAU,EAAO,OACtB,EAAO,CACd,OAAO,EAAe,EAAM,GAGjC,CAAC,CAEF,EAAO,QAAQ,CACb,KAAM,2BACN,YAAa,kFACb,WAAY,EAAE,OAAO,CACnB,YAAa,EAAE,QAAQ,CAAC,SAAS,kBAAkB,CACpD,CAAC,CACF,YAAa,EACb,QAAS,KAAO,IAAS,CACvB,GAAI,CAEF,IAAM,EAAS,MADA,GAAc,CACD,YAAY,EAAK,YAAY,CACzD,OAAO,KAAK,UAAU,EAAO,OACtB,EAAO,CACd,OAAO,EAAe,EAAM,GAGjC,CAAC,CAEF,EAAO,QAAQ,CACb,KAAM,yBACN,YAAa,8DACb,WAAY,EAAE,OAAO,CACnB,UAAW,EAAE,QAAQ,CAAC,SAAS,kCAAkC,CAClE,CAAC,CACF,YAAa,EACb,QAAS,KAAO,IAAS,CACvB,GAAI,CAEF,IAAM,EAAS,MADA,GAAc,CACD,UAAU,EAAK,UAAU,CACrD,OAAO,KAAK,UAAU,EAAO,OACtB,EAAO,CACd,OAAO,EAAe,EAAM,GAGjC,CAAC,CAEF,EAAO,QAAQ,CACb,KAAM,8BACN,YACE,2IACF,WAAY,EAAE,OAAO,CACnB,UAAW,EAAE,QAAQ,CAAC,SAAS,uCAAuC,CACvE,CAAC,CACF,YAAa,EACb,QAAS,KAAO,IAAS,CACvB,GAAI,CAEF,IAAM,EAAS,MADA,GAAc,CACD,eAAe,EAAK,UAAU,CAC1D,OAAO,KAAK,UAAU,EAAO,OACtB,EAAO,CACd,OAAO,EAAe,EAAM,GAGjC,CAAC,CAEF,EAAO,QAAQ,CACb,KAAM,4BACN,YACE,qHACF,WAAY,EAAE,OAAO,CACnB,SAAU,EAAE,QAAQ,CAAC,SAAS,mEAAmE,CACjG,MAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC,SAAS,sCAAsC,CACpG,CAAC,CACF,YAAa,EACb,QAAS,KAAO,IAAS,CACvB,GAAI,CAEF,IAAM,EAAS,MADA,GAAc,CACD,YAAY,EAAK,SAAU,EAAK,MAAM,CAClE,OAAO,KAAK,UAAU,EAAO,OACtB,EAAO,CACd,OAAO,EAAe,EAAM,GAGjC,CAAC,CAEF,EAAO,QAAQ,CACb,KAAM,yBACN,YACE,+GACF,WAAY,EAAE,OAAO,CACnB,SAAU,EAAE,QAAQ,CAAC,SAAS,mDAAmD,CAClF,CAAC,CACF,YAAa,EACb,QAAS,KAAO,IAAS,CACvB,GAAI,CAEF,IAAM,EAAS,MADA,GAAc,CACD,UAAU,EAAK,SAAS,CACpD,OAAO,KAAK,UAAU,EAAO,OACtB,EAAO,CACd,OAAO,EAAe,EAAM,GAGjC,CAAC,CAEF,EAAO,QAAQ,CACb,KAAM,4BACN,YACE,oHACF,WAAY,EAAE,OAAO,CACnB,SAAU,EAAE,QAAQ,CAAC,SAAS,gCAAgC,CAC9D,MAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC,SAAS,sCAAsC,CACpG,CAAC,CACF,YAAa,EACb,QAAS,KAAO,IAAS,CACvB,GAAI,CAEF,IAAM,EAAS,MADA,GAAc,CACD,YAAY,EAAK,SAAU,EAAK,MAAM,CAClE,OAAO,KAAK,UAAU,EAAO,OACtB,EAAO,CACd,OAAO,EAAe,EAAM,GAGjC,CAAC,CAEF,EAAO,QAAQ,CACb,KAAM,yBACN,YAAa,+FACb,WAAY,EAAE,OAAO,CACnB,SAAU,EAAE,QAAQ,CAAC,SAAS,2CAA2C,CAC1E,CAAC,CACF,YAAa,EACb,QAAS,KAAO,IAAS,CACvB,GAAI,CAEF,IAAM,EAAS,MADA,GAAc,CACD,UAAU,EAAK,SAAS,CACpD,OAAO,KAAK,UAAU,EAAO,OACtB,EAAO,CACd,OAAO,EAAe,EAAM,GAGjC,CAAC"}

package/dist/tools/ptab.tools.d.ts

@@ -0,0 +1,7 @@
+import { FastMCP } from "fastmcp";
+
+//#region src/tools/ptab.tools.d.ts
+declare const registerPtabTools: (server: FastMCP) => void;
+//#endregion
+export { registerPtabTools };
+//# sourceMappingURL=ptab.tools.d.ts.map

package/dist/tools/ptab.tools.js

@@ -0,0 +1,2 @@
+import{config as e}from"../lib/config.js";import{handleApiError as t}from"../lib/errors.js";import"../base.client-zZnUjoIb.js";import{OdpClient as n}from"../clients/odp.client.js";import{z as r}from"zod";const i={readOnlyHint:!0,destructiveHint:!1,idempotentHint:!0,openWorldHint:!0},a=()=>new n({apiKey:e.usptoApiKey??(()=>{throw Error(`USPTO_API_KEY is required`)})(),timeout:e.requestTimeout}),o=e=>{e.addTool({name:`ptab-search-proceedings`,description:`Search PTAB (Patent Trial and Appeal Board) proceedings including IPR, PGR, and CBM trials. Returns trial metadata, parties, and status.`,parameters:r.object({query:r.string().describe(`Search query text`),type:r.enum([`IPR`,`PGR`,`CBM`]).optional().describe(`Proceeding type filter`),limit:r.number().int().min(1).max(100).default(25).describe(`Number of results to return (1-100)`)}),annotations:i,execute:async e=>{try{let t=await a().searchProceedings(e.query,e.type,e.limit);return JSON.stringify(t)}catch(e){return t(e)}}}),e.addTool({name:`ptab-get-proceeding`,description:`Get detailed information about a specific PTAB proceeding by trial number.`,parameters:r.object({trialNumber:r.string().describe(`PTAB trial number (e.g., IPR2020-01234)`)}),annotations:i,execute:async e=>{try{let t=await a().getProceeding(e.trialNumber);return JSON.stringify(t)}catch(e){return t(e)}}}),e.addTool({name:`ptab-get-documents`,description:`Get documents filed in a PTAB proceeding.`,parameters:r.object({trialNumber:r.string().describe(`PTAB trial number (e.g., IPR2020-01234)`)}),annotations:i,execute:async e=>{try{let t=await a().getProceedingDocuments(e.trialNumber);return JSON.stringify(t)}catch(e){return t(e)}}}),e.addTool({name:`ptab-search-decisions`,description:`Search PTAB decisions across all proceeding types.`,parameters:r.object({query:r.string().describe(`Search query text`),limit:r.number().int().min(1).max(100).default(25).describe(`Number of results to return (1-100)`)}),annotations:i,execute:async e=>{try{let t=await a().searchDecisions(e.query,e.limit);return JSON.stringify(t)}catch(e){return t(e)}}}),e.addTool({name:`ptab-get-decision`,description:`Get a specific PTAB decision by ID.`,parameters:r.object({decisionId:r.string().describe(`Decision identifier`)}),annotations:i,execute:async e=>{try{let t=await a().getDecision(e.decisionId);return JSON.stringify(t)}catch(e){return t(e)}}}),e.addTool({name:`ptab-search-appeals`,description:`Search ex parte appeals to the PTAB.`,parameters:r.object({query:r.string().describe(`Search query text`),limit:r.number().int().min(1).max(100).default(25).describe(`Number of results to return (1-100)`)}),annotations:i,execute:async e=>{try{let t=await a().searchAppeals(e.query,e.limit);return JSON.stringify(t)}catch(e){return t(e)}}}),e.addTool({name:`ptab-get-appeal`,description:`Get details about a specific ex parte appeal.`,parameters:r.object({appealId:r.string().describe(`Appeal identifier`)}),annotations:i,execute:async e=>{try{let t=await a().getAppeal(e.appealId);return JSON.stringify(t)}catch(e){return t(e)}}})};export{o as registerPtabTools};
+//# sourceMappingURL=ptab.tools.js.map

package/dist/tools/ptab.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ptab.tools.js","names":[],"sources":["../../src/tools/ptab.tools.ts"],"sourcesContent":["import type { FastMCP } from \"fastmcp\"\nimport { z } from \"zod\"\n\nimport { OdpClient } from \"../clients/odp.client\"\nimport { config } from \"../lib/config\"\nimport { handleApiError } from \"../lib/errors\"\n\nconst PTAB_ANNOTATIONS = {\n  readOnlyHint: true,\n  destructiveHint: false,\n  idempotentHint: true,\n  openWorldHint: true,\n} as const\n\nconst createClient = (): OdpClient => {\n  return new OdpClient({\n    apiKey:\n      config.usptoApiKey ??\n      (() => {\n        throw new Error(\"USPTO_API_KEY is required\")\n      })(),\n    timeout: config.requestTimeout,\n  })\n}\n\nexport const registerPtabTools = (server: FastMCP): void => {\n  server.addTool({\n    name: \"ptab-search-proceedings\",\n    description:\n      \"Search PTAB (Patent Trial and Appeal Board) proceedings including IPR, PGR, and CBM trials. Returns trial metadata, parties, and status.\",\n    parameters: z.object({\n      query: z.string().describe(\"Search query text\"),\n      type: z.enum([\"IPR\", \"PGR\", \"CBM\"]).optional().describe(\"Proceeding type filter\"),\n      limit: z.number().int().min(1).max(100).default(25).describe(\"Number of results to return (1-100)\"),\n    }),\n    annotations: PTAB_ANNOTATIONS,\n    execute: async (args) => {\n      try {\n        const client = createClient()\n        const result = await client.searchProceedings(args.query, args.type, args.limit)\n        return JSON.stringify(result)\n      } catch (error) {\n        return handleApiError(error)\n      }\n    },\n  })\n\n  server.addTool({\n    name: \"ptab-get-proceeding\",\n    description: \"Get detailed information about a specific PTAB proceeding by trial number.\",\n    parameters: z.object({\n      trialNumber: z.string().describe(\"PTAB trial number (e.g., IPR2020-01234)\"),\n    }),\n    annotations: PTAB_ANNOTATIONS,\n    execute: async (args) => {\n      try {\n        const client = createClient()\n        const result = await client.getProceeding(args.trialNumber)\n        return JSON.stringify(result)\n      } catch (error) {\n        return handleApiError(error)\n      }\n    },\n  })\n\n  server.addTool({\n    name: \"ptab-get-documents\",\n    description: \"Get documents filed in a PTAB proceeding.\",\n    parameters: z.object({\n      trialNumber: z.string().describe(\"PTAB trial number (e.g., IPR2020-01234)\"),\n    }),\n    annotations: PTAB_ANNOTATIONS,\n    execute: async (args) => {\n      try {\n        const client = createClient()\n        const result = await client.getProceedingDocuments(args.trialNumber)\n        return JSON.stringify(result)\n      } catch (error) {\n        return handleApiError(error)\n      }\n    },\n  })\n\n  server.addTool({\n    name: \"ptab-search-decisions\",\n    description: \"Search PTAB decisions across all proceeding types.\",\n    parameters: z.object({\n      query: z.string().describe(\"Search query text\"),\n      limit: z.number().int().min(1).max(100).default(25).describe(\"Number of results to return (1-100)\"),\n    }),\n    annotations: PTAB_ANNOTATIONS,\n    execute: async (args) => {\n      try {\n        const client = createClient()\n        const result = await client.searchDecisions(args.query, args.limit)\n        return JSON.stringify(result)\n      } catch (error) {\n        return handleApiError(error)\n      }\n    },\n  })\n\n  server.addTool({\n    name: \"ptab-get-decision\",\n    description: \"Get a specific PTAB decision by ID.\",\n    parameters: z.object({\n      decisionId: z.string().describe(\"Decision identifier\"),\n    }),\n    annotations: PTAB_ANNOTATIONS,\n    execute: async (args) => {\n      try {\n        const client = createClient()\n        const result = await client.getDecision(args.decisionId)\n        return JSON.stringify(result)\n      } catch (error) {\n        return handleApiError(error)\n      }\n    },\n  })\n\n  server.addTool({\n    name: \"ptab-search-appeals\",\n    description: \"Search ex parte appeals to the PTAB.\",\n    parameters: z.object({\n      query: z.string().describe(\"Search query text\"),\n      limit: z.number().int().min(1).max(100).default(25).describe(\"Number of results to return (1-100)\"),\n    }),\n    annotations: PTAB_ANNOTATIONS,\n    execute: async (args) => {\n      try {\n        const client = createClient()\n        const result = await client.searchAppeals(args.query, args.limit)\n        return JSON.stringify(result)\n      } catch (error) {\n        return handleApiError(error)\n      }\n    },\n  })\n\n  server.addTool({\n    name: \"ptab-get-appeal\",\n    description: \"Get details about a specific ex parte appeal.\",\n    parameters: z.object({\n      appealId: z.string().describe(\"Appeal identifier\"),\n    }),\n    annotations: PTAB_ANNOTATIONS,\n    execute: async (args) => {\n      try {\n        const client = createClient()\n        const result = await client.getAppeal(args.appealId)\n        return JSON.stringify(result)\n      } catch (error) {\n        return handleApiError(error)\n      }\n    },\n  })\n}\n"],"mappings":"4MAOA,MAAM,EAAmB,CACvB,aAAc,GACd,gBAAiB,GACjB,eAAgB,GAChB,cAAe,GAChB,CAEK,MACG,IAAI,EAAU,CACnB,OACE,EAAO,kBACA,CACL,MAAU,MAAM,4BAA4B,IAC1C,CACN,QAAS,EAAO,eACjB,CAAC,CAGS,EAAqB,GAA0B,CAC1D,EAAO,QAAQ,CACb,KAAM,0BACN,YACE,2IACF,WAAY,EAAE,OAAO,CACnB,MAAO,EAAE,QAAQ,CAAC,SAAS,oBAAoB,CAC/C,KAAM,EAAE,KAAK,CAAC,MAAO,MAAO,MAAM,CAAC,CAAC,UAAU,CAAC,SAAS,yBAAyB,CACjF,MAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC,SAAS,sCAAsC,CACpG,CAAC,CACF,YAAa,EACb,QAAS,KAAO,IAAS,CACvB,GAAI,CAEF,IAAM,EAAS,MADA,GAAc,CACD,kBAAkB,EAAK,MAAO,EAAK,KAAM,EAAK,MAAM,CAChF,OAAO,KAAK,UAAU,EAAO,OACtB,EAAO,CACd,OAAO,EAAe,EAAM,GAGjC,CAAC,CAEF,EAAO,QAAQ,CACb,KAAM,sBACN,YAAa,6EACb,WAAY,EAAE,OAAO,CACnB,YAAa,EAAE,QAAQ,CAAC,SAAS,0CAA0C,CAC5E,CAAC,CACF,YAAa,EACb,QAAS,KAAO,IAAS,CACvB,GAAI,CAEF,IAAM,EAAS,MADA,GAAc,CACD,cAAc,EAAK,YAAY,CAC3D,OAAO,KAAK,UAAU,EAAO,OACtB,EAAO,CACd,OAAO,EAAe,EAAM,GAGjC,CAAC,CAEF,EAAO,QAAQ,CACb,KAAM,qBACN,YAAa,4CACb,WAAY,EAAE,OAAO,CACnB,YAAa,EAAE,QAAQ,CAAC,SAAS,0CAA0C,CAC5E,CAAC,CACF,YAAa,EACb,QAAS,KAAO,IAAS,CACvB,GAAI,CAEF,IAAM,EAAS,MADA,GAAc,CACD,uBAAuB,EAAK,YAAY,CACpE,OAAO,KAAK,UAAU,EAAO,OACtB,EAAO,CACd,OAAO,EAAe,EAAM,GAGjC,CAAC,CAEF,EAAO,QAAQ,CACb,KAAM,wBACN,YAAa,qDACb,WAAY,EAAE,OAAO,CACnB,MAAO,EAAE,QAAQ,CAAC,SAAS,oBAAoB,CAC/C,MAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC,SAAS,sCAAsC,CACpG,CAAC,CACF,YAAa,EACb,QAAS,KAAO,IAAS,CACvB,GAAI,CAEF,IAAM,EAAS,MADA,GAAc,CACD,gBAAgB,EAAK,MAAO,EAAK,MAAM,CACnE,OAAO,KAAK,UAAU,EAAO,OACtB,EAAO,CACd,OAAO,EAAe,EAAM,GAGjC,CAAC,CAEF,EAAO,QAAQ,CACb,KAAM,oBACN,YAAa,sCACb,WAAY,EAAE,OAAO,CACnB,WAAY,EAAE,QAAQ,CAAC,SAAS,sBAAsB,CACvD,CAAC,CACF,YAAa,EACb,QAAS,KAAO,IAAS,CACvB,GAAI,CAEF,IAAM,EAAS,MADA,GAAc,CACD,YAAY,EAAK,WAAW,CACxD,OAAO,KAAK,UAAU,EAAO,OACtB,EAAO,CACd,OAAO,EAAe,EAAM,GAGjC,CAAC,CAEF,EAAO,QAAQ,CACb,KAAM,sBACN,YAAa,uCACb,WAAY,EAAE,OAAO,CACnB,MAAO,EAAE,QAAQ,CAAC,SAAS,oBAAoB,CAC/C,MAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC,SAAS,sCAAsC,CACpG,CAAC,CACF,YAAa,EACb,QAAS,KAAO,IAAS,CACvB,GAAI,CAEF,IAAM,EAAS,MADA,GAAc,CACD,cAAc,EAAK,MAAO,EAAK,MAAM,CACjE,OAAO,KAAK,UAAU,EAAO,OACtB,EAAO,CACd,OAAO,EAAe,EAAM,GAGjC,CAAC,CAEF,EAAO,QAAQ,CACb,KAAM,kBACN,YAAa,gDACb,WAAY,EAAE,OAAO,CACnB,SAAU,EAAE,QAAQ,CAAC,SAAS,oBAAoB,CACnD,CAAC,CACF,YAAa,EACb,QAAS,KAAO,IAAS,CACvB,GAAI,CAEF,IAAM,EAAS,MADA,GAAc,CACD,UAAU,EAAK,SAAS,CACpD,OAAO,KAAK,UAAU,EAAO,OACtB,EAAO,CACd,OAAO,EAAe,EAAM,GAGjC,CAAC"}

package/dist/tools/utility.tools.d.ts

@@ -0,0 +1,7 @@
+import { FastMCP } from "fastmcp";
+
+//#region src/tools/utility.tools.d.ts
+declare const registerUtilityTools: (server: FastMCP) => void;
+//#endregion
+export { registerUtilityTools };
+//# sourceMappingURL=utility.tools.d.ts.map

package/dist/tools/utility.tools.js

@@ -0,0 +1,2 @@
+import{config as e,getAvailableSources as t}from"../lib/config.js";import{handleApiError as n}from"../lib/errors.js";import{z as r}from"zod";const i={readOnlyHint:!0,destructiveHint:!1,idempotentHint:!0,openWorldHint:!0},a={0:`Unknown`,1:`Abandoned -- Failure to Respond to an Office Action`,2:`Abandoned -- Failure to Pay Issue Fee`,3:`Abandoned -- After Examiner's Answer or Board Decision`,5:`Abandoned -- Expressly Abandoned`,17:`Docketed New Case - Ready for Examination`,19:`Application Dispatched from Preexam, Not Yet Docketed`,20:`Awaiting TC Resp., Issue Fee Not Paid`,30:`Patented Case`,41:`Non Final Action Mailed`,44:`Advisory Action Mailed`,47:`Final Rejection Mailed`,60:`Response to Non-Final Office Action Entered and Forwarded to Examiner`,62:`Response after Non-Final Action Forwarded to Examiner`,63:`Response after Final Action Forwarded to Examiner`,70:`Notice of Allowance Mailed -- Application Received in Office of Publications`,71:`Issue Fee Payment Received`,80:`Sent to Classification Contractor`,85:`Response to Election/Restriction Filed`,90:`Application Undergoing Preexam Processing`,93:`Notice of Appeal Filed`,95:`Appeal Brief (or Coverage) Filed`,97:`On Appeal -- Awaiting Decision by the Board of Appeals`,100:`IDS Considered`,150:`Patent Expired Due to NonPayment of Maintenance Fees Under 37 CFR 1.362`,156:`Provisional Application Expired`,160:`RCE Filed`,161:`Application Ser No. Filing Date Fixed`,250:`Certificate of Correction Filed`,500:`Abandoned -- Incomplete Application`},o={A:`Human Necessities`,B:`Performing Operations; Transporting`,C:`Chemistry; Metallurgy`,D:`Textiles; Paper`,E:`Fixed Constructions`,F:`Mechanical Engineering; Lighting; Heating; Weapons; Blasting`,G:`Physics`,H:`Electricity`,Y:`General Tagging of New Technological Developments`},s={A01:`Agriculture; Forestry; Animal Husbandry; Hunting; Trapping; Fishing`,A23:`Foods or Foodstuffs; Treatment Thereof`,A61:`Medical or Veterinary Science; Hygiene`,A63:`Sports; Games; Amusements`,B01:`Physical or Chemical Processes or Apparatus in General`,B25:`Hand Tools; Portable Power-Driven Tools; Manipulators`,B29:`Working of Plastics; Working of Substances in a Plastic State in General`,B60:`Vehicles in General`,B65:`Conveying; Packing; Storing; Handling Thin or Filamentary Material`,C07:`Organic Chemistry`,C08:`Organic Macromolecular Compounds`,C12:`Biochemistry; Beer; Spirits; Wine; Vinegar; Microbiology; Enzymology; Mutation or Genetic Engineering`,E04:`Building`,F16:`Engineering Elements and Units`,G01:`Measuring; Testing`,G02:`Optics`,G05:`Controlling; Regulating`,G06:`Computing; Calculating or Counting`,G06F:`Electric Digital Data Processing`,G06N:`Computing Arrangements Based on Specific Computational Models (AI/ML)`,G06Q:`Information and Communication Technology for Administrative, Commercial, Financial, or Management Purposes`,G06T:`Image Data Processing or Generation`,G06V:`Image or Video Recognition or Understanding`,G08:`Signalling`,G09:`Educating; Cryptography; Display; Advertising; Seals`,G10:`Musical Instruments; Acoustics`,G11:`Information Storage`,G16:`Information and Communication Technology Specially Adapted for Specific Application Fields`,H01:`Electric Elements`,H02:`Generation; Conversion; or Distribution of Electric Power`,H03:`Electronic Circuitry`,H04:`Electric Communication Technique`,H04L:`Transmission of Digital Information`,H04N:`Pictorial Communication (Television)`,H04W:`Wireless Communication Networks`,H05:`Electric Techniques Not Otherwise Provided For`,H10:`Semiconductor Devices; Electric Solid-State Devices Not Otherwise Provided For`,Y02:`Technologies or Applications for Mitigation or Adaptation Against Climate Change`,Y10:`Technical Subjects Covered by Former USPC`},c=async(e,t,n)=>{try{let e=await fetch(t,{headers:n,signal:AbortSignal.timeout(1e4)});return e.ok?{healthy:!0}:{healthy:!1,error:`HTTP ${e.status}`}}catch(e){return{healthy:!1,error:e instanceof Error?e.message:String(e)}}},l=l=>{l.addTool({name:`check-api-status`,description:`Check the health and configuration status of all patent data APIs (PatentsView, ODP, EPO, BigQuery).`,parameters:r.object({}),annotations:i,execute:async()=>{try{let n=t(e),r=[],i={name:`PatentsView`,configured:n.find(e=>e.name===`PatentsView`)?.configured??!1,healthy:!1};{let t=e.patentsViewApiKey,n=await c(`PatentsView`,`https://search.patentsview.org/api/v1/patent/?q=%7B%7D&f=%5B%22patent_id%22%5D&o=%7B%22size%22%3A1%7D`,t?{"X-Api-Key":t}:void 0);i.healthy=n.healthy,i.error=n.error}r.push(i);let a={name:`ODP (USPTO Open Data Portal)`,configured:n.find(e=>e.name===`USPTO ODP`)?.configured??!1,healthy:!1};if(a.configured){let t=e.usptoApiKey,n=await c(`ODP`,`https://api.uspto.gov/api/v1/patent/applications/14412875`,t?{"X-API-KEY":t}:void 0);a.healthy=n.healthy,a.error=n.error}else a.error=`USPTO_API_KEY not set`;r.push(a);let o={name:`EPO (European Patent Office)`,configured:n.find(e=>e.name===`EPO OPS`)?.configured??!1,healthy:!1};o.configured||(o.error=`EPO_CONSUMER_KEY / EPO_CONSUMER_SECRET not set`),r.push(o);let s={name:`Google BigQuery (Patents Public Data)`,configured:n.find(e=>e.name===`Google BigQuery`)?.configured??!1,healthy:!1};return s.configured?s.healthy=!!e.googleApplicationCredentials:s.error=`GOOGLE_CLOUD_PROJECT / GOOGLE_APPLICATION_CREDENTIALS not set`,r.push(s),JSON.stringify({statuses:r})}catch(e){return n(e)}}}),l.addTool({name:`get-cpc-info`,description:`Look up CPC (Cooperative Patent Classification) code information. Returns the description for a given CPC section, class, or subclass code.`,parameters:r.object({code:r.string().describe(`CPC classification code (e.g., G06, H04L, A61)`)}),annotations:i,execute:async e=>{try{let t=e.code.toUpperCase().trim();if(s[t])return JSON.stringify({code:t,description:s[t],level:t.length<=3?`class`:`subclass`});if(t.length===1&&o[t])return JSON.stringify({code:t,description:o[t],level:`section`});let n=t.slice(0,3),r=t.slice(0,1),i={code:t,description:null,level:`unknown`};return s[n]&&(i.parentClass={code:n,description:s[n]}),o[r]&&(i.parentSection={code:r,description:o[r]}),!i.parentClass&&!i.parentSection&&(i.error=`No CPC data found for code: ${t}`),JSON.stringify(i)}catch(e){return n(e)}}}),l.addTool({name:`get-status-code`,description:`Look up the meaning of a USPTO application status code. Returns a human-readable description of what the status code indicates about the application's current state.`,parameters:r.object({code:r.string().describe(`USPTO application status code (numeric string)`)}),annotations:i,execute:async e=>{try{let t=e.code.trim(),n=a[t];return n?JSON.stringify({code:t,description:n}):JSON.stringify({code:t,description:null,error:`Unknown status code: ${t}. Common codes include: ${Object.keys(a).slice(0,10).join(`, `)}...`,availableCodes:Object.entries(a).map(([e,t])=>({code:e,description:t}))})}catch(e){return n(e)}}})};export{l as registerUtilityTools};
+//# sourceMappingURL=utility.tools.js.map

package/dist/tools/utility.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility.tools.js","names":[],"sources":["../../src/tools/utility.tools.ts"],"sourcesContent":["import type { FastMCP } from \"fastmcp\"\nimport { z } from \"zod\"\n\nimport { config, getAvailableSources } from \"../lib/config\"\nimport { handleApiError } from \"../lib/errors\"\nimport type { ApiStatus } from \"../lib/types\"\n\nconst UTILITY_ANNOTATIONS = {\n  readOnlyHint: true,\n  destructiveHint: false,\n  idempotentHint: true,\n  openWorldHint: true,\n} as const\n\nconst STATUS_CODE_MAP: Record<string, string> = {\n  \"0\": \"Unknown\",\n  \"1\": \"Abandoned -- Failure to Respond to an Office Action\",\n  \"2\": \"Abandoned -- Failure to Pay Issue Fee\",\n  \"3\": \"Abandoned -- After Examiner's Answer or Board Decision\",\n  \"5\": \"Abandoned -- Expressly Abandoned\",\n  \"17\": \"Docketed New Case - Ready for Examination\",\n  \"19\": \"Application Dispatched from Preexam, Not Yet Docketed\",\n  \"20\": \"Awaiting TC Resp., Issue Fee Not Paid\",\n  \"30\": \"Patented Case\",\n  \"41\": \"Non Final Action Mailed\",\n  \"44\": \"Advisory Action Mailed\",\n  \"47\": \"Final Rejection Mailed\",\n  \"60\": \"Response to Non-Final Office Action Entered and Forwarded to Examiner\",\n  \"62\": \"Response after Non-Final Action Forwarded to Examiner\",\n  \"63\": \"Response after Final Action Forwarded to Examiner\",\n  \"70\": \"Notice of Allowance Mailed -- Application Received in Office of Publications\",\n  \"71\": \"Issue Fee Payment Received\",\n  \"80\": \"Sent to Classification Contractor\",\n  \"85\": \"Response to Election/Restriction Filed\",\n  \"90\": \"Application Undergoing Preexam Processing\",\n  \"93\": \"Notice of Appeal Filed\",\n  \"95\": \"Appeal Brief (or Coverage) Filed\",\n  \"97\": \"On Appeal -- Awaiting Decision by the Board of Appeals\",\n  \"100\": \"IDS Considered\",\n  \"150\": \"Patent Expired Due to NonPayment of Maintenance Fees Under 37 CFR 1.362\",\n  \"156\": \"Provisional Application Expired\",\n  \"160\": \"RCE Filed\",\n  \"161\": \"Application Ser No. Filing Date Fixed\",\n  \"250\": \"Certificate of Correction Filed\",\n  \"500\": \"Abandoned -- Incomplete Application\",\n}\n\nconst CPC_SECTION_MAP: Record<string, string> = {\n  A: \"Human Necessities\",\n  B: \"Performing Operations; Transporting\",\n  C: \"Chemistry; Metallurgy\",\n  D: \"Textiles; Paper\",\n  E: \"Fixed Constructions\",\n  F: \"Mechanical Engineering; Lighting; Heating; Weapons; Blasting\",\n  G: \"Physics\",\n  H: \"Electricity\",\n  Y: \"General Tagging of New Technological Developments\",\n}\n\nconst CPC_CLASS_MAP: Record<string, string> = {\n  A01: \"Agriculture; Forestry; Animal Husbandry; Hunting; Trapping; Fishing\",\n  A23: \"Foods or Foodstuffs; Treatment Thereof\",\n  A61: \"Medical or Veterinary Science; Hygiene\",\n  A63: \"Sports; Games; Amusements\",\n  B01: \"Physical or Chemical Processes or Apparatus in General\",\n  B25: \"Hand Tools; Portable Power-Driven Tools; Manipulators\",\n  B29: \"Working of Plastics; Working of Substances in a Plastic State in General\",\n  B60: \"Vehicles in General\",\n  B65: \"Conveying; Packing; Storing; Handling Thin or Filamentary Material\",\n  C07: \"Organic Chemistry\",\n  C08: \"Organic Macromolecular Compounds\",\n  C12: \"Biochemistry; Beer; Spirits; Wine; Vinegar; Microbiology; Enzymology; Mutation or Genetic Engineering\",\n  E04: \"Building\",\n  F16: \"Engineering Elements and Units\",\n  G01: \"Measuring; Testing\",\n  G02: \"Optics\",\n  G05: \"Controlling; Regulating\",\n  G06: \"Computing; Calculating or Counting\",\n  G06F: \"Electric Digital Data Processing\",\n  G06N: \"Computing Arrangements Based on Specific Computational Models (AI/ML)\",\n  G06Q: \"Information and Communication Technology for Administrative, Commercial, Financial, or Management Purposes\",\n  G06T: \"Image Data Processing or Generation\",\n  G06V: \"Image or Video Recognition or Understanding\",\n  G08: \"Signalling\",\n  G09: \"Educating; Cryptography; Display; Advertising; Seals\",\n  G10: \"Musical Instruments; Acoustics\",\n  G11: \"Information Storage\",\n  G16: \"Information and Communication Technology Specially Adapted for Specific Application Fields\",\n  H01: \"Electric Elements\",\n  H02: \"Generation; Conversion; or Distribution of Electric Power\",\n  H03: \"Electronic Circuitry\",\n  H04: \"Electric Communication Technique\",\n  H04L: \"Transmission of Digital Information\",\n  H04N: \"Pictorial Communication (Television)\",\n  H04W: \"Wireless Communication Networks\",\n  H05: \"Electric Techniques Not Otherwise Provided For\",\n  H10: \"Semiconductor Devices; Electric Solid-State Devices Not Otherwise Provided For\",\n  Y02: \"Technologies or Applications for Mitigation or Adaptation Against Climate Change\",\n  Y10: \"Technical Subjects Covered by Former USPC\",\n}\n\nconst checkApiHealth = async (\n  name: string,\n  url: string,\n  headers?: Record<string, string>,\n): Promise<{ healthy: boolean; error?: string }> => {\n  try {\n    const response = await fetch(url, {\n      headers,\n      signal: AbortSignal.timeout(10000),\n    })\n    if (response.ok) return { healthy: true }\n    return { healthy: false, error: `HTTP ${response.status}` }\n  } catch (e) {\n    return { healthy: false, error: e instanceof Error ? e.message : String(e) }\n  }\n}\n\nexport const registerUtilityTools = (server: FastMCP): void => {\n  server.addTool({\n    name: \"check-api-status\",\n    description: \"Check the health and configuration status of all patent data APIs (PatentsView, ODP, EPO, BigQuery).\",\n    parameters: z.object({}),\n    annotations: UTILITY_ANNOTATIONS,\n    execute: async () => {\n      try {\n        const sources = getAvailableSources(config)\n        const statuses: ApiStatus[] = []\n\n        // PatentsView\n        const pvSource = sources.find((s) => s.name === \"PatentsView\")\n        const pvStatus: ApiStatus = {\n          name: \"PatentsView\",\n          configured: pvSource?.configured ?? false,\n          healthy: false,\n        }\n        {\n          const apiKey = config.patentsViewApiKey\n          const healthResult = await checkApiHealth(\n            \"PatentsView\",\n            \"https://search.patentsview.org/api/v1/patent/?q=%7B%7D&f=%5B%22patent_id%22%5D&o=%7B%22size%22%3A1%7D\",\n            apiKey ? { \"X-Api-Key\": apiKey } : undefined,\n          )\n          pvStatus.healthy = healthResult.healthy\n          pvStatus.error = healthResult.error\n        }\n        statuses.push(pvStatus)\n\n        // ODP (USPTO Open Data Portal)\n        const odpSource = sources.find((s) => s.name === \"USPTO ODP\")\n        const odpStatus: ApiStatus = {\n          name: \"ODP (USPTO Open Data Portal)\",\n          configured: odpSource?.configured ?? false,\n          healthy: false,\n        }\n        if (odpStatus.configured) {\n          const apiKey = config.usptoApiKey\n          const healthResult = await checkApiHealth(\n            \"ODP\",\n            \"https://api.uspto.gov/api/v1/patent/applications/14412875\",\n            apiKey ? { \"X-API-KEY\": apiKey } : undefined,\n          )\n          odpStatus.healthy = healthResult.healthy\n          odpStatus.error = healthResult.error\n        } else {\n          odpStatus.error = \"USPTO_API_KEY not set\"\n        }\n        statuses.push(odpStatus)\n\n        // EPO\n        const epoSource = sources.find((s) => s.name === \"EPO OPS\")\n        const epoStatus: ApiStatus = {\n          name: \"EPO (European Patent Office)\",\n          configured: epoSource?.configured ?? false,\n          healthy: false,\n        }\n        if (!epoStatus.configured) {\n          epoStatus.error = \"EPO_CONSUMER_KEY / EPO_CONSUMER_SECRET not set\"\n        }\n        statuses.push(epoStatus)\n\n        // BigQuery\n        const bqSource = sources.find((s) => s.name === \"Google BigQuery\")\n        const bqStatus: ApiStatus = {\n          name: \"Google BigQuery (Patents Public Data)\",\n          configured: bqSource?.configured ?? false,\n          healthy: false,\n        }\n        if (bqStatus.configured) {\n          bqStatus.healthy = !!config.googleApplicationCredentials\n        } else {\n          bqStatus.error = \"GOOGLE_CLOUD_PROJECT / GOOGLE_APPLICATION_CREDENTIALS not set\"\n        }\n        statuses.push(bqStatus)\n\n        return JSON.stringify({ statuses })\n      } catch (error) {\n        return handleApiError(error)\n      }\n    },\n  })\n\n  server.addTool({\n    name: \"get-cpc-info\",\n    description:\n      \"Look up CPC (Cooperative Patent Classification) code information. Returns the description for a given CPC section, class, or subclass code.\",\n    parameters: z.object({\n      code: z.string().describe(\"CPC classification code (e.g., G06, H04L, A61)\"),\n    }),\n    annotations: UTILITY_ANNOTATIONS,\n    execute: async (args) => {\n      try {\n        const code = args.code.toUpperCase().trim()\n\n        if (CPC_CLASS_MAP[code]) {\n          return JSON.stringify({\n            code,\n            description: CPC_CLASS_MAP[code],\n            level: code.length <= 3 ? \"class\" : \"subclass\",\n          })\n        }\n\n        if (code.length === 1 && CPC_SECTION_MAP[code]) {\n          return JSON.stringify({\n            code,\n            description: CPC_SECTION_MAP[code],\n            level: \"section\",\n          })\n        }\n\n        const parentClass = code.slice(0, 3)\n        const parentSection = code.slice(0, 1)\n\n        const result: Record<string, unknown> = {\n          code,\n          description: null,\n          level: \"unknown\",\n        }\n\n        if (CPC_CLASS_MAP[parentClass]) {\n          result.parentClass = { code: parentClass, description: CPC_CLASS_MAP[parentClass] }\n        }\n\n        if (CPC_SECTION_MAP[parentSection]) {\n          result.parentSection = { code: parentSection, description: CPC_SECTION_MAP[parentSection] }\n        }\n\n        if (!result.parentClass && !result.parentSection) {\n          result.error = `No CPC data found for code: ${code}`\n        }\n\n        return JSON.stringify(result)\n      } catch (error) {\n        return handleApiError(error)\n      }\n    },\n  })\n\n  server.addTool({\n    name: \"get-status-code\",\n    description:\n      \"Look up the meaning of a USPTO application status code. Returns a human-readable description of what the status code indicates about the application's current state.\",\n    parameters: z.object({\n      code: z.string().describe(\"USPTO application status code (numeric string)\"),\n    }),\n    annotations: UTILITY_ANNOTATIONS,\n    execute: async (args) => {\n      try {\n        const code = args.code.trim()\n        const description = STATUS_CODE_MAP[code]\n\n        if (description) {\n          return JSON.stringify({ code, description })\n        }\n\n        return JSON.stringify({\n          code,\n          description: null,\n          error: `Unknown status code: ${code}. Common codes include: ${Object.keys(STATUS_CODE_MAP).slice(0, 10).join(\", \")}...`,\n          availableCodes: Object.entries(STATUS_CODE_MAP).map(([c, d]) => ({ code: c, description: d })),\n        })\n      } catch (error) {\n        return handleApiError(error)\n      }\n    },\n  })\n}\n"],"mappings":"6IAOA,MAAM,EAAsB,CAC1B,aAAc,GACd,gBAAiB,GACjB,eAAgB,GAChB,cAAe,GAChB,CAEK,EAA0C,CAC9C,EAAK,UACL,EAAK,sDACL,EAAK,wCACL,EAAK,yDACL,EAAK,mCACL,GAAM,4CACN,GAAM,wDACN,GAAM,wCACN,GAAM,gBACN,GAAM,0BACN,GAAM,yBACN,GAAM,yBACN,GAAM,wEACN,GAAM,wDACN,GAAM,oDACN,GAAM,+EACN,GAAM,6BACN,GAAM,oCACN,GAAM,yCACN,GAAM,4CACN,GAAM,yBACN,GAAM,mCACN,GAAM,yDACN,IAAO,iBACP,IAAO,0EACP,IAAO,kCACP,IAAO,YACP,IAAO,wCACP,IAAO,kCACP,IAAO,sCACR,CAEK,EAA0C,CAC9C,EAAG,oBACH,EAAG,sCACH,EAAG,wBACH,EAAG,kBACH,EAAG,sBACH,EAAG,+DACH,EAAG,UACH,EAAG,cACH,EAAG,oDACJ,CAEK,EAAwC,CAC5C,IAAK,sEACL,IAAK,yCACL,IAAK,yCACL,IAAK,4BACL,IAAK,yDACL,IAAK,wDACL,IAAK,2EACL,IAAK,sBACL,IAAK,qEACL,IAAK,oBACL,IAAK,mCACL,IAAK,wGACL,IAAK,WACL,IAAK,iCACL,IAAK,qBACL,IAAK,SACL,IAAK,0BACL,IAAK,qCACL,KAAM,mCACN,KAAM,wEACN,KAAM,6GACN,KAAM,sCACN,KAAM,8CACN,IAAK,aACL,IAAK,uDACL,IAAK,iCACL,IAAK,sBACL,IAAK,6FACL,IAAK,oBACL,IAAK,4DACL,IAAK,uBACL,IAAK,mCACL,KAAM,sCACN,KAAM,uCACN,KAAM,kCACN,IAAK,iDACL,IAAK,iFACL,IAAK,mFACL,IAAK,4CACN,CAEK,EAAiB,MACrB,EACA,EACA,IACkD,CAClD,GAAI,CACF,IAAM,EAAW,MAAM,MAAM,EAAK,CAChC,UACA,OAAQ,YAAY,QAAQ,IAAM,CACnC,CAAC,CAEF,OADI,EAAS,GAAW,CAAE,QAAS,GAAM,CAClC,CAAE,QAAS,GAAO,MAAO,QAAQ,EAAS,SAAU,OACpD,EAAG,CACV,MAAO,CAAE,QAAS,GAAO,MAAO,aAAa,MAAQ,EAAE,QAAU,OAAO,EAAE,CAAE,GAInE,EAAwB,GAA0B,CAC7D,EAAO,QAAQ,CACb,KAAM,mBACN,YAAa,uGACb,WAAY,EAAE,OAAO,EAAE,CAAC,CACxB,YAAa,EACb,QAAS,SAAY,CACnB,GAAI,CACF,IAAM,EAAU,EAAoB,EAAO,CACrC,EAAwB,EAAE,CAI1B,EAAsB,CAC1B,KAAM,cACN,WAHe,EAAQ,KAAM,GAAM,EAAE,OAAS,cAAc,EAGtC,YAAc,GACpC,QAAS,GACV,CACD,CACE,IAAM,EAAS,EAAO,kBAChB,EAAe,MAAM,EACzB,cACA,wGACA,EAAS,CAAE,YAAa,EAAQ,CAAG,IAAA,GACpC,CACD,EAAS,QAAU,EAAa,QAChC,EAAS,MAAQ,EAAa,MAEhC,EAAS,KAAK,EAAS,CAIvB,IAAM,EAAuB,CAC3B,KAAM,+BACN,WAHgB,EAAQ,KAAM,GAAM,EAAE,OAAS,YAAY,EAGpC,YAAc,GACrC,QAAS,GACV,CACD,GAAI,EAAU,WAAY,CACxB,IAAM,EAAS,EAAO,YAChB,EAAe,MAAM,EACzB,MACA,4DACA,EAAS,CAAE,YAAa,EAAQ,CAAG,IAAA,GACpC,CACD,EAAU,QAAU,EAAa,QACjC,EAAU,MAAQ,EAAa,WAE/B,EAAU,MAAQ,wBAEpB,EAAS,KAAK,EAAU,CAIxB,IAAM,EAAuB,CAC3B,KAAM,+BACN,WAHgB,EAAQ,KAAM,GAAM,EAAE,OAAS,UAAU,EAGlC,YAAc,GACrC,QAAS,GACV,CACI,EAAU,aACb,EAAU,MAAQ,kDAEpB,EAAS,KAAK,EAAU,CAIxB,IAAM,EAAsB,CAC1B,KAAM,wCACN,WAHe,EAAQ,KAAM,GAAM,EAAE,OAAS,kBAAkB,EAG1C,YAAc,GACpC,QAAS,GACV,CAQD,OAPI,EAAS,WACX,EAAS,QAAU,CAAC,CAAC,EAAO,6BAE5B,EAAS,MAAQ,gEAEnB,EAAS,KAAK,EAAS,CAEhB,KAAK,UAAU,CAAE,WAAU,CAAC,OAC5B,EAAO,CACd,OAAO,EAAe,EAAM,GAGjC,CAAC,CAEF,EAAO,QAAQ,CACb,KAAM,eACN,YACE,8IACF,WAAY,EAAE,OAAO,CACnB,KAAM,EAAE,QAAQ,CAAC,SAAS,iDAAiD,CAC5E,CAAC,CACF,YAAa,EACb,QAAS,KAAO,IAAS,CACvB,GAAI,CACF,IAAM,EAAO,EAAK,KAAK,aAAa,CAAC,MAAM,CAE3C,GAAI,EAAc,GAChB,OAAO,KAAK,UAAU,CACpB,OACA,YAAa,EAAc,GAC3B,MAAO,EAAK,QAAU,EAAI,QAAU,WACrC,CAAC,CAGJ,GAAI,EAAK,SAAW,GAAK,EAAgB,GACvC,OAAO,KAAK,UAAU,CACpB,OACA,YAAa,EAAgB,GAC7B,MAAO,UACR,CAAC,CAGJ,IAAM,EAAc,EAAK,MAAM,EAAG,EAAE,CAC9B,EAAgB,EAAK,MAAM,EAAG,EAAE,CAEhC,EAAkC,CACtC,OACA,YAAa,KACb,MAAO,UACR,CAcD,OAZI,EAAc,KAChB,EAAO,YAAc,CAAE,KAAM,EAAa,YAAa,EAAc,GAAc,EAGjF,EAAgB,KAClB,EAAO,cAAgB,CAAE,KAAM,EAAe,YAAa,EAAgB,GAAgB,EAGzF,CAAC,EAAO,aAAe,CAAC,EAAO,gBACjC,EAAO,MAAQ,+BAA+B,KAGzC,KAAK,UAAU,EAAO,OACtB,EAAO,CACd,OAAO,EAAe,EAAM,GAGjC,CAAC,CAEF,EAAO,QAAQ,CACb,KAAM,kBACN,YACE,wKACF,WAAY,EAAE,OAAO,CACnB,KAAM,EAAE,QAAQ,CAAC,SAAS,iDAAiD,CAC5E,CAAC,CACF,YAAa,EACb,QAAS,KAAO,IAAS,CACvB,GAAI,CACF,IAAM,EAAO,EAAK,KAAK,MAAM,CACvB,EAAc,EAAgB,GAMpC,OAJI,EACK,KAAK,UAAU,CAAE,OAAM,cAAa,CAAC,CAGvC,KAAK,UAAU,CACpB,OACA,YAAa,KACb,MAAO,wBAAwB,EAAK,0BAA0B,OAAO,KAAK,EAAgB,CAAC,MAAM,EAAG,GAAG,CAAC,KAAK,KAAK,CAAC,KACnH,eAAgB,OAAO,QAAQ,EAAgB,CAAC,KAAK,CAAC,EAAG,MAAQ,CAAE,KAAM,EAAG,YAAa,EAAG,EAAE,CAC/F,CAAC,OACK,EAAO,CACd,OAAO,EAAe,EAAM,GAGjC,CAAC"}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "patents-mcp-server",
+  "version": "1.0.0",
+  "description": "FastMCP TypeScript patent intelligence MCP server — 55 tools across USPTO, EPO, and BigQuery",
+  "keywords": [
+    "mcp",
+    "patents",
+    "fastmcp",
+    "uspto",
+    "epo",
+    "patent-search"
+  ],
+  "author": "jordan.burke@gmail.com",
+  "license": "MIT",
+  "homepage": "https://github.com/sapientsai/patents-mcp-server",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sapientsai/patents-mcp-server"
+  },
+  "devDependencies": {
+    "@hey-api/openapi-ts": "^0.94.1",
+    "@types/node": "^24.12.0",
+    "ts-builds": "^2.5.2",
+    "tsdown": "^0.21.2"
+  },
+  "bin": {
+    "patents-mcp-server": "./dist/index.js"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "lib",
+    "dist"
+  ],
+  "prettier": "ts-builds/prettier",
+  "dependencies": {
+    "@google-cloud/bigquery": "^8.1.1",
+    "fast-xml-parser": "^5.5.5",
+    "fastmcp": "^3.34.0",
+    "functype": "^0.49.0",
+    "zod": "^4.3.6"
+  },
+  "scripts": {
+    "validate": "ts-builds validate",
+    "format": "ts-builds format",
+    "format:check": "ts-builds format:check",
+    "lint": "ts-builds lint",
+    "lint:check": "ts-builds lint:check",
+    "typecheck": "ts-builds typecheck",
+    "test": "ts-builds test",
+    "test:watch": "ts-builds test:watch",
+    "test:coverage": "ts-builds test:coverage",
+    "build": "ts-builds build",
+    "dev": "ts-builds dev",
+    "codegen": "openapi-ts",
+    "fetch-specs": "curl -s https://search.patentsview.org/static/openapi.json > src/specs/patentsview.json && gh api repos/patent-dev/uspto-odp/contents/swagger_fixed.yaml --jq '.content' | base64 -d > src/specs/uspto-odp.yaml"
+  }
+}