# Taiwan Patent MCP

> Taiwan Patent MCP is a free MCP server for legal and government. Search Taiwan IPO and EPO patent data: legal status, families, full text and PDFs. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI
- **Website:** https://dr-legal.com.tw
- **Repository:** https://github.com/aa0101181514/tw-patent-mcp
- **MCP Registry name:** io.github.aa0101181514/tw-patent-mcp
- **Categories:** legal and government
- **Listing updated:** 2026-11-15

## About

The server wraps two patent data sources with your own free credentials: Taiwan's GPSS API, which searches 23 databases covering Taiwan, US, Japan, Europe, Korea, China and WIPO, and EPO Open Patent Services for worldwide bibliographic data. The README says it calls no language model and only queries, reformats and guards against errors. The README is in Chinese with an English version.

GPSS tools cover codes, search, single-record lookup and URL building. EPO tools cover CQL search, bibliographic data, INPADOC legal status and families, EP and WO full text, the European register, image listings and per-page PDF download that merges pages. Compact summaries are returned by default, with raw=true for full fields.

It protects your access: after an invalid GPSS code it writes a lock file and stops further calls, and it adjusts the call rate to EPO throttling signals. The licence is Elastic License 2.0, which is source-available rather than open source.

## Features

- **GPSS search:** Searches 23 patent databases through Taiwan's IPO.
- **EPO bibliographic data:** Search, biblio, family and legal status through OPS.
- **Full text and registers:** EP and WO full text and the European register.
- **PDF download:** Downloads original gazette pages and merges them.
- **Credential safeguards:** Locks after invalid codes and respects EPO throttling.

## Good for

- Check the legal status of a patent family
- Find Taiwan and foreign patents on one topic
- Retrieve full text claims for an EP patent
- Download the original publication PDF
- Compare bibliographic data across patent offices

## Install

### Claude Code (Terminal)

```sh
claude mcp add tw-patent-mcp --env GPSS_USER_CODE='<GPSS_USER_CODE>' --env EPO_OPS_KEY='<EPO_OPS_KEY>' --env EPO_OPS_SECRET='<EPO_OPS_SECRET>' -- uvx tw-patent-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "tw-patent-mcp": {
      "command": "uvx",
      "args": [
        "tw-patent-mcp"
      ],
      "env": {
        "GPSS_USER_CODE": "<GPSS_USER_CODE>",
        "EPO_OPS_KEY": "<EPO_OPS_KEY>",
        "EPO_OPS_SECRET": "<EPO_OPS_SECRET>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "tw-patent-mcp": {
      "command": "uvx",
      "args": [
        "tw-patent-mcp"
      ],
      "env": {
        "GPSS_USER_CODE": "<GPSS_USER_CODE>",
        "EPO_OPS_KEY": "<EPO_OPS_KEY>",
        "EPO_OPS_SECRET": "<EPO_OPS_SECRET>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "tw-patent-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "tw-patent-mcp"
      ],
      "env": {
        "GPSS_USER_CODE": "<GPSS_USER_CODE>",
        "EPO_OPS_KEY": "<EPO_OPS_KEY>",
        "EPO_OPS_SECRET": "<EPO_OPS_SECRET>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "tw-patent-mcp": {
      "command": "uvx",
      "args": [
        "tw-patent-mcp"
      ],
      "env": {
        "GPSS_USER_CODE": "<GPSS_USER_CODE>",
        "EPO_OPS_KEY": "<EPO_OPS_KEY>",
        "EPO_OPS_SECRET": "<EPO_OPS_SECRET>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "tw-patent-mcp": {
      "command": "uvx",
      "args": [
        "tw-patent-mcp"
      ],
      "env": {
        "GPSS_USER_CODE": "<GPSS_USER_CODE>",
        "EPO_OPS_KEY": "<EPO_OPS_KEY>",
        "EPO_OPS_SECRET": "<EPO_OPS_SECRET>"
      }
    }
  }
}
```

## Tools

- `gpss_codes`: Lists databases, search fields and output field codes.
- `gpss_search`: Searches bibliographic data, abstracts and claims across 23 databases.
- `gpss_get`: Gets a single record by publication or application number.
- `gpss_build_url`: Builds the request URL for checking search conditions.
- `ops_search`: CQL worldwide bibliographic search.
- `ops_biblio`: Returns bibliographic data.
- `ops_legal_status`: Returns INPADOC legal status by family member.
- `ops_family`: Lists INPADOC family members.
- `ops_fulltext`: Returns claims, description and abstract for EP and WO.
- `ops_register`: Returns the European patent register.
- `ops_images`: Lists publication image documents and page counts.
- `ops_download_pdf`: Downloads and merges publication PDF pages.

## FAQ

### Do I need credentials?

Yes. You apply for a free GPSS code and EPO key and secret yourself; none are shared.

### Can I use only one source?

Yes. Setting only one set makes only the matching tools work.

### What are the EPO limits?

The README cites a free quota of 4 GB a week and per-minute call limits.

### What licence is it?

Elastic License 2.0, which is public source but not open source.

### Is Taiwan Patent MCP free?

Yes. Taiwan Patent MCP is free to use.

### How do I add Taiwan Patent MCP to Claude Code?

Run this command in your terminal: claude mcp add tw-patent-mcp --env GPSS_USER_CODE='<GPSS_USER_CODE>' --env EPO_OPS_KEY='<EPO_OPS_KEY>' --env EPO_OPS_SECRET='<EPO_OPS_SECRET>' -- uvx tw-patent-mcp

### What are the best alternatives to Taiwan Patent MCP?

The closest alternatives to Taiwan Patent MCP are NY LLC Publication (FileMyPublication), TribuJus, SupplyClub Catalog, SynomosAI Governance MCP and MedXpert 标准检索连接器.

## Alternatives

- [NY LLC Publication (FileMyPublication)](https://ai-powered.com/mcp/ny-llc-publication-filemypublication): NY LLC Publication (FileMyPublication) is a free MCP server for legal and government.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [SupplyClub Catalog](https://ai-powered.com/mcp/supplyclub-catalog): SupplyClub Catalog is a free MCP server for legal and government.
- [SynomosAI Governance MCP](https://ai-powered.com/mcp/synomosai-governance-mcp-2): SynomosAI Governance MCP is an open-source MCP server for security.
- [MedXpert 标准检索连接器](https://ai-powered.com/mcp/medxpert-2): MedXpert 标准检索连接器 is a free MCP server for legal and government.
- [SigPen](https://ai-powered.com/mcp/sigpen): SigPen is a freemium MCP server for files and documents.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.
- [MedXpert 全球法规连接器 (reg-connector)](https://ai-powered.com/mcp/medxpert-reg-connector): MedXpert 全球法规连接器 (reg-connector) is a free MCP server for legal and government.

---
Source: https://ai-powered.com/mcp/taiwan-patent-mcp
