Pokémon TCG API
Read-only MCP server for English, Japanese and Chinese Pokemon cards and prices
- 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/mcpAdd 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.RequiredPTCG_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

Generate fictional character portraits and lip-synced talking videos from text over MCP
- 10 tools
- Remote
- Freemium
- Design and media

VfxSmith
MCP serverSearch, generate, refine and export pixel art game effects from Claude Code or Codex
Not checked yet- Remote
- Freemium
- Design and media
Born Then
MCP serverFree MCP server that rolls random historical births weighted by real demographics
- 2 tools
- Remote
- Free
- Education and exams
Haze City
MCP serverMCP server for agents to look around and build in a shared 3D world
- 17 tools
- Remote
- Open source
- Games and play

Vectoroids
MCP serverA first-person 3D asteroids game with a scanner, playable by humans and agents
- 6 tools
- Remote
- Free
- Games and play

Vector Abyss
MCP serverPlay a Tempest-style 3D tube shooter, or let an AI agent play it turn by turn
- 6 tools
- Remote
- Free
- Knowledge and memory