Skip to content
MCP server

Pokémon TCG API

Read-only MCP server for English, Japanese and Chinese Pokemon cards and prices

Runs locallyStatus and history
Pricing
Free trial
Platforms
API, CLI
Runs
Locally
Version
0.1.10
Listing updated
3 days ago

About Pokémon TCG API

Pokémon TCG API is an MCP server for games and play. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • PTCG_API_KEYAPI key for pokemontcgapi.com, needed by every tool but ptcg_get_reference. POST /v1/accounts/free returns one without a dashboard or a card.Required
  • PTCG_BASE_URLOverride the API base URL. Defaults to https://api.pokemontcgapi.com.

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Free trial

30-day trial; Developer EUR 29/mo, Growth EUR 79/mo, Professional EUR 149/mo (excl. VAT)

Prices change. Check pokemontcgapi.com before you buy.

Pokémon TCG API 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 to Pokémon TCG API

  1. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  2. Born Then

    MCP server

    Free MCP server that rolls random historical births weighted by real demographics

    • 2 tools
    • Remote
    • Free
    • Education and exams
  3. Haze City

    MCP server

    MCP server for agents to look around and build in a shared 3D world

    • 17 tools
    • Remote
    • Open source
    • Games and play
  4. Vectoroids

    MCP server

    A first-person 3D asteroids game with a scanner, playable by humans and agents

    • 6 tools
    • Remote
    • Free
    • Games and play
  5. Vector Abyss

    MCP server

    Play a Tempest-style 3D tube shooter, or let an AI agent play it turn by turn

    • 6 tools
    • Remote
    • Free
    • Knowledge and memory