Skip to main content
Glama
KunihiroS

PatSnap MCP Server

by KunihiroS
README.md
# PatSnap MCP Server

This MCP server is designed to collect patent-related information from PatSnap's API for trend analysis and reporting. It is not intended for individual patent investigations.

<a href="https://glama.ai/mcp/servers/@KunihiroS/patsnap-mcp">
  <img width="380" height="200" src="https://glama.ai/mcp/servers/@KunihiroS/patsnap-mcp/badge" alt="PatSnap Server MCP server" />
</a>

## Features

This server provides the following tools for interacting with the PatSnap Insights API:

- **get_patent_trends**: Analyze annual application and issued trends for patents. Understand the trends of patents related to specific technology fields or keywords. Either keywords or IPC classification must be specified.
- **get_word_cloud**: Obtain a snapshot of frequently occurring keywords/phrases from the most recent 5,000 published patents. Identify common terms for refining searches. Returns up to 100 keywords. Either keywords or IPC classification must be specified.
- **get_wheel_of_innovation**: Provides a two-tiered hierarchical view of keywords/phrases in a technology space. Identify common terms and their associations. Based on the most recent 5,000 publications. Either keywords or IPC classification must be specified.
- **get_most_cited_patents**: View the top patents cited most frequently by others, indicating influential or core technology. Returns at most Top 10 patents. Note: Search must contain either keywords or IPC. If both are provided, IPC is prioritized.
- **get_top_authorities_of_origin**: 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.
- **get_top_inventors**: Shows the top inventors in the technology field. Evaluate top performers or identify potential recruits. Returns up to the top 10 inventors. Note: Search must contain either keywords or IPC. If both are provided, IPC is prioritized.
- **get_top_assignees**: 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.
- **get_simple_legal_status**: Provides a breakdown of the simple legal status (e.g., Active, Inactive, Pending) for patents in the technology field. Understand the proportion of patents currently in effect. Note: Search must contain either keywords or IPC. If both are provided, IPC is prioritized.
- **get_most_litigated_patents**: Identify the patents involved in the most litigation cases, indicating potential risk in a technology space. Returns the Top 10 patents by litigation count. Note: Search must contain either keywords or IPC. If both are provided, IPC is prioritized.

## Setup

1. Clone the repository.
2. Install dependencies using `npm install`.
3. Build the project using `npm run build`.
4. Run the server using `npm start`.

## Usage

- Use the provided tools to interact with PatSnap's API.
- Ensure you have valid PatSnap API credentials (Client ID and Secret) set as environment variables (`PATSNAP_CLIENT_ID`, `PATSNAP_CLIENT_SECRET`).

## Configuration for MCP Host

To integrate this MCP server with your MCP Host, add the following configuration to your `cline_mcp_settings.json` file (path may vary based on your host setup):

```json
{
  "mcpServers": {
    "@kunihiros/patsnap-mcp": {
      "command": "npx",
      "args": ["@kunihiros/patsnap-mcp"],
      "env": {
        "PATSNAP_CLIENT_ID": "your_patsnap_client_id_here",
        "PATSNAP_CLIENT_SECRET": "your_patsnap_client_secret_here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
```

Ensure you replace `your_patsnap_client_id_here` and `your_patsnap_client_secret_here` with your actual PatSnap API credentials. This configuration allows the MCP Host to invoke the server using `npx @kunihiros/patsnap-mcp`.

## Service Access

For more information and get required tokens for the PatSnap service, please visit: [https://open.patsnap.com/home](https://open.patsnap.com/home)

## License

This project is licensed under the MIT License.

TDQS

A3.9/5.0

Scored across 10 tools

Disambiguation5/5

Each tool has a clearly distinct purpose focused on different patent analytics dimensions: citation analysis, litigation risk, trends, valuation, legal status, assignees, origins, inventors, keyword hierarchy, and keyword frequency. There is no functional overlap between tools, making selection unambiguous for an agent.

Naming Consistency5/5

All tools follow a consistent 'get_' prefix with descriptive snake_case names (e.g., get_most_cited_patents, get_top_assignees). This uniform pattern makes the tool set predictable and easy to navigate.

Tool Count5/5

With 10 tools, the server provides a well-scoped set for patent analytics, covering key aspects like trends, risks, players, and keyword analysis. Each tool serves a unique purpose without redundancy, making the count appropriate for the domain.

Completeness4/5

The tool set comprehensively covers analytical queries for patent data, including trends, risks, valuations, and key entities. A minor gap exists in direct patent retrieval or detailed patent-level operations (e.g., get_patent_by_id), but the provided tools support robust analysis workflows.

Maintenance

ActivityInactive
ResponsivenessNo issues