Pokémon TCG Pocket MCP Server

Pokémon TCG Pocket MCP Server is an open-source Model Context Protocol (MCP) server that lets AI assistants like Claude search every Pokémon TCG Pocket card by name, type, rarity, set, evolution stage, ability effect and attack, in six languages.

Ask your AI assistant questions like "Which Water Pokémon can heal?" or "Show me all Crown rare cards from Genetic Apex", and it looks the answer up in a local, always up-to-date card database instead of guessing.

Key features

• One search tool for all cards. Pokémon, Items, Supporters, Tools and Stadiums from every Pokémon TCG Pocket set (Genetic Apex, Mythical Island, Space-Time Smackdown and all later sets).

• Search by meaning. Describe an ability or attack in your own words ("discard energy for big damage") and get the cards that do that, not just keyword matches.

• Typo-tolerant names. "charizrd" still finds Charizard. Set names work the same way.

• Exact filters. Type (Grass, Fire, Water, ...), rarity (One Diamond to Crown), evolution stage (Basic, Stage 1, Stage 2), card category and set.

• Six languages. English, French, German, Spanish, Italian and Brazilian Portuguese card texts. Cards not yet translated fall back to English.

• Always up to date. Downloads new sets and card fixes automatically every 24 hours from TCGdex.

• Runs locally. Card data and search stay on your machine. Works with a free local embedding model through Ollama, or with OpenAI.

• Works with any MCP client. Claude Desktop, Claude Code, Cursor, VS Code and other MCP-compatible apps, over stdio or HTTP.

Related MCP server: PokeAPI MCP Server

Example questions

Once connected, ask your assistant things like:

• "Find Pokémon TCG Pocket cards that heal damage from all your Pokémon."

• "Which Stage 2 Water Pokémon are there?"

• "Show me the Crown rare cards from Genetic Apex."

• "What does Glurak-ex do?" (German card names work too)

• "Which Supporter cards let me draw cards?"

• "Find Fire Pokémon whose attacks discard energy."

How to install

You need either Docker or Node.js 24+ with pnpm.

Option 1: Docker Compose (recommended)

This runs the server, its database and a local embedding model together.

git clone https://github.com/janthoXO/pokemon-tcg-pocket-mcp.git
cd pokemon-tcg-pocket-mcp
docker compose up -d

The server is then available at http://127.0.0.1:3000/mcp. The first start downloads the embedding model (about 1 GB) and all card data, which takes a few minutes.

Option 2: Node.js

git clone https://github.com/janthoXO/pokemon-tcg-pocket-mcp.git
cd pokemon-tcg-pocket-mcp
pnpm install
pnpm build
ollama pull bge-m3   # free local embedding model, requires Ollama

Your MCP client then starts the server itself (see below).

How to connect your AI assistant

Claude Code

With Docker Compose running:

claude mcp add --transport http pokemon-tcg-pocket http://127.0.0.1:3000/mcp

Claude Desktop, Cursor and other MCP clients

Add this to your client's MCP configuration (for Claude Desktop: claude_desktop_config.json). Replace the path with your checkout:

{
  "mcpServers": {
    "pokemon-tcg-pocket": {
      "command": "node",
      "args": ["/path/to/pokemon-tcg-pocket-mcp/dist/index.js"],
      "env": {
        "LANGUAGES": "en,de",
        "DATABASE_URL": "file:/path/to/pokemon-tcg-pocket-mcp/data/cards.db"
      }
    }
  }
}

Set LANGUAGES to the languages you want (en, fr, de, es, it, pt-br). Use an absolute DATABASE_URL path, because MCP clients often start the server from a different working directory. All settings are listed in the developer guide.

How to use the search

The server gives your assistant one tool, search_cards. Your assistant fills in the fields for you; you just ask in normal language. Every field except language is optional, and empty fields match all cards.

Each result includes the card's name, type, stage, rarity, HP, set, ability or effect text, attacks with energy cost and damage, and a card image link. The response also reports total matching cards and, when more remain, a nextOffset to pass as offset for the next page.

How it works

flowchart LR
    A[Your AI assistant] -- "search_cards" --> S[Pokémon TCG Pocket<br/>MCP server]
    S --> D[(Local card database)]
    T[(TCGdex card API)] -- "daily update" --> S
    E[Embedding model<br/>Ollama or OpenAI] -. "understands effect<br/>and attack texts" .- S

1. Daily update. The server downloads all Pokémon TCG Pocket cards from the free TCGdex API and stores them in a local database. After the first download, it only fetches sets that changed.

2. Understanding card texts. An embedding model turns every ability and attack text into a vector, so the server can find cards by meaning, not only by exact words.

3. Search. Your assistant calls search_cards. The server filters by exact fields (type, rarity, stage, set), matches names with typo tolerance, and ranks the rest by how close the ability or attack text is to your description.

Technical details are in the developer guide.

Comparison

Frequently asked questions

What is an MCP server?

The Model Context Protocol is an open standard that lets AI assistants use external tools. This MCP server adds a Pokémon TCG Pocket card search tool to any assistant that supports MCP.

Which Pokémon TCG Pocket sets are included?

All sets that TCGdex lists for Pokémon TCG Pocket, including promo sets. New sets appear automatically after the next daily update.

Which languages are supported?

English (en), French (fr), German (de), Spanish (es), Italian (it) and Brazilian Portuguese (pt-br). If a card is not yet available in your language, you get the English text and the result is marked with fallbackLanguage: "en".

Does it cost anything?

No. The server, TCGdex and the default Ollama embedding model are free. If you choose an OpenAI embedding model instead, OpenAI charges for embeddings (well under one US dollar for the first full download).

Does it include deck building, prices or meta statistics?

No. It is a card search. Card data comes from TCGdex, which has no prices or tournament data for Pokémon TCG Pocket.

Limitations and security

This server is built for personal use on your own computer or a trusted network:

• The HTTP endpoint has no login. Keep it on 127.0.0.1 (the default) and do not expose it to the internet.

• Run one server per database.

Details and hardening options are in the developer guide.

Credits and disclaimer

Card data from TCGdex. Pokémon and Pokémon TCG Pocket are trademarks of Nintendo, Creatures and GAME FREAK. This project is not affiliated with or endorsed by The Pokémon Company, Nintendo, Creatures, GAME FREAK or DeNA.

License

MIT. Free to use, modify and share, including commercially.