LABSCO SUMMARY
Deck-building filters, not a card lookup.
Anyone can search a card name. What makes this useful is that the query syntax carries through — legality, retreat cost, HP ranges and exclusions combine in one search, which is how you actually narrow a deck slot. Images come back inline, so the answer is something you can look at rather than a list of names.
What it is
An MCP server over the Pokémon TCG API that lets an assistant search cards with the API's real query syntax and display the results with their images. The point is the filtering: not just "find Pikachu", but standard-legal Basic Pokémon with free retreat, or Water types above 120 HP.
What you get
- Cards searched by name with exact matching using
!and wildcards using*, and hyphens preserved when the name needs it - Filtering on types, subtypes, format legality, retreat cost, HP and National Pokédex number, with exclusion via a leading
- - Range queries the API supports directly:
hp:[100 TO 200]inclusive,hp:{100 TO 200}exclusive, and open-ended forms likehp:[100 TO *] - Results returned with the card name, set name, legalities and a high-resolution image served from the Pokémon TCG API's CDN
- Multiple filters combined in one query, case-insensitively
Requirements
No account and no key — it uses the public Pokémon TCG API and images come from that API's CDN. Point your client at the built dist/index.js with an absolute path in claude_desktop_config.json, then quit the client completely and restart; the README notes that quitting from the task manager is what actually closes it.
Setup effort
Build from source — git clone https://github.com/jlgrimes/ptcg-mcp.git
USE CASES
01
Filling a specific slot in a deck
Search on the constraints that matter at once — format legality, subtype, retreat cost, HP range — instead of scanning a set list.
02
Checking what is legal in a format
Filter on the format's legality field and see which of your candidates survive, banned cards included.
03
Finding a card you half-remember
Use a wildcard on the name, or exclude the types you know it is not, rather than guessing the exact spelling.
04
Comparing cards visually
Get the high-resolution images back with the results so you can read the attacks rather than the field names.
BEFORE YOU INSTALL
What to know first
Requires
node on PATH
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
This one is built from source rather than installed with a single command.
Server setup
TERMINAL
git clone https://github.com/jlgrimes/ptcg-mcp.git
cd ptcg-mcp
npm install
npm run buildMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"ptcg-mcp": {
"command": "node",
"args": [
"<YOUR_ABSOLUTE_PATH>/dist/index.js"
]
}
}
}<YOUR_ABSOLUTE_PATH> is the full path of the ptcg-mcp folder you cloned and built. Quit Claude completely and restart it.