pokemon-tcg-mcp
v1.0.2
Published
Use this MCP server to the Pokémon TCG, search cards, sets, rarities via TCGdex. Tools include search cards, get card, list sets
Maintainers
Readme
pokemon tcg mcp
The Pokémon TCG via TCGdex, open database, no key.
Tools
search_cards, search by name, filter by rarityget_card, full card: HP, types, abilities, attacks, weakness, market priceslist_sets, all sets, newest firstget_set, a set with its full card list
Run
npm install && npm run build && node dist/index.jsExample
"Show me Charizard's Vivid Voltage card"
search_cards("charizard")→get_card("swsh4-25")
Quick start
npm install
npm run build
node dist/index.jsThe server uses stdio, so it can be connected to Claude Desktop, Cursor, VS Code, MCP Inspector, or another compatible MCP client.
Tools at a glance
search_cards: Search Pokémon TCG cards by name, optionally filtered by rarity.get_card: Get a single cardlist_sets: List Pokémon TCG sets (newest first).get_set: Get a Pokémon TCG set and its card list.
Limits and privacy
This project is intentionally narrow. It should be treated as a practical helper, not a complete certification or security audit. Check the implementation and the returned data before using it with sensitive material. No credentials are required unless the project explicitly says otherwise.
Try it
After building, connect the server through your MCP client. The repository root also contains smoke-test.mjs for projects covered by the shared harness. A typical tool call starts with search_cards.
Premium tools
These tools need a licence key:
cards_by_rarity
The tool bodies run on our gateway, not inside this package, so the key is what buys access. Buy one at https://buy.polar.sh/polar_cl_mrO7rS5LZxpqM7oAFFEA10i9121J240U40IIj4JRZO4 and set it in your MCP client config:
"env": { "MCP_LICENSE_KEY": "polar_..." }The gateway checks the key against Polar and gives every key 1,000 free premium calls a month before per-call billing starts. Every other tool on this server stays free.
