# Pokémon TCG API

> Pokémon TCG API is an MCP server for games and play. Read-only MCP server for English, Japanese and Chinese Pokemon cards and prices. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Platforms:** API, CLI
- **Website:** https://pokemontcgapi.com/mcp
- **Repository:** https://github.com/pokemontcgapi/mcp-server
- **MCP Registry name:** com.pokemontcgapi/mcp
- **Categories:** games and play
- **Listing updated:** 2026-11-14

## About

The server's thirteen tools are shaped like collector questions instead of one per endpoint, to keep tool descriptions short in the model's context. Search takes name, set, region, rarity, artist and a release window, so it can answer things like Charizard cards from Japanese sets or everything by one illustrator. Up to 100 card ids can be fetched in one call, and a reference tool returns the exact strings for types, supertypes and rarities so filters are not guessed.

Prices come with their source, printing, grade, sample size and date. The pricing page says Cardmarket and CardTrader quote in euro, TCGplayer and PriceCharting in US dollars, and eBay figures are asking prices rather than sales. A status tool states live counts per print region and what is not in the data. The site also describes photo-based card identification on paid plans.

It runs over stdio with `npx -y @pokemontcgapi/mcp` and needs a PTCG_API_KEY for all tools but the reference lookup. The project says it is unofficial and not affiliated with Nintendo or The Pokemon Company.

## Features

- **Multi-region catalogue:** International, Japanese and Simplified Chinese cards, with names in eight locales.
- **Sourced prices:** Each price names its source, grade, sample size and date.
- **Batch lookup:** Fetch up to 100 card ids in one call.
- **Illustrator listings:** Illustrators with card counts, deduplicated across printings.
- **Reference vocabulary:** Exact strings for types, supertypes and rarities.
- **Catalogue status:** Live counts and an explicit list of what is not covered.

## Good for

- Look up all Japanese sets released in 2024
- Find cards by one illustrator
- Check current prices for a card from several sources
- Build a collection tracker with agent help

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp --env PTCG_API_KEY='<PTCG_API_KEY>' -- npx -y @pokemontcgapi/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pokemontcgapi/mcp"
      ],
      "env": {
        "PTCG_API_KEY": "<PTCG_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pokemontcgapi/mcp"
      ],
      "env": {
        "PTCG_API_KEY": "<PTCG_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@pokemontcgapi/mcp"
      ],
      "env": {
        "PTCG_API_KEY": "<PTCG_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pokemontcgapi/mcp"
      ],
      "env": {
        "PTCG_API_KEY": "<PTCG_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pokemontcgapi/mcp"
      ],
      "env": {
        "PTCG_API_KEY": "<PTCG_API_KEY>"
      }
    }
  }
}
```

## Tools

- `ptcg_search_cards`: Search cards by name, set, region, rarity, artist and release window.
- `ptcg_get_cards`: Fetch up to 100 card ids in one call.
- `ptcg_get_card_prices`: Every current price observation for a card with grade, sample size and date.
- `ptcg_list_sets`: List sets by region, series, name and release dates.
- `ptcg_get_reference`: Exact strings for types, supertypes and rarities.
- `ptcg_list_artists`: Illustrators with a card count.
- `ptcg_get_catalogue_status`: Live counts per print region and what is not in the data.

## FAQ

### How do I get an API key?

POST /v1/accounts/free with an email and an Idempotency-Key; no dashboard or card is needed. The trial starts at 80 credits, rises to 800 after email verification and lasts 30 days.

### What do paid plans cost?

Developer is EUR 29/month, Growth EUR 79 and Professional EUR 149, excluding VAT.

### Are the tools read-only?

Yes, the site describes all thirteen as read-only.

### Does it need Node?

Yes, Node 20 or later.

### Is Pokémon TCG API free?

Pokémon TCG API is a paid product with a free trial.

### How do I add Pokémon TCG API to Claude Code?

Run this command in your terminal: claude mcp add mcp --env PTCG_API_KEY='<PTCG_API_KEY>' -- npx -y @pokemontcgapi/mcp

### What are the best alternatives to Pokémon TCG API?

The closest alternatives to Pokémon TCG API are AvatarSay — Fictional Character & Talking Video MCP, VfxSmith, Born Then, Haze City and Vectoroids.

## Alternatives

- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [Born Then](https://ai-powered.com/mcp/born-then): Born Then is a free MCP server for education and exams.
- [Haze City](https://ai-powered.com/mcp/haze-city): Haze City is an open-source MCP server for games and play.
- [Vectoroids](https://ai-powered.com/mcp/vectoroids): Vectoroids is a free MCP server for games and play.
- [Vector Abyss](https://ai-powered.com/mcp/vector-abyss): Vector Abyss is a free MCP server for knowledge and memory.
- [Vector Alienspace](https://ai-powered.com/mcp/vector-alienspace): Vector Alienspace is a free MCP server for knowledge and memory.
- [Vector Defence](https://ai-powered.com/mcp/vector-defence): Vector Defence is a free MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/pokemon-tcg-api
