Pokemon TCG Card Search MCP

Setup Instructions

1. Update your Claude configuration file: - Open `/Users/ABSOLUTE_PATH_HERE/Library/Application Support/Claude/claude_desktop_config.json` - Add the following configuration (remove any existing MCP configurations): ```json { "mcpServers": { "ptcg-mcp": { "command": "node", "args": ["ABSOLUTE_PATH_HERE/dist/index.js"] } } } ```

2. Quit Claude: - Open Task Manager - Find and quit Claude completely

3. Restart Claude: - The Pokemon TCG Card Search MCP will be automatically loaded - You can now ask Claude questions about Pokemon cards

Usage

• "Show me standard-legal basic Pokemon with free retreat"

• "Find water-type Pokemon with more than 120 HP"

• "Search for Pikachu cards"

Features

• Search cards by name, type, subtype, legality, and more

• View high-resolution card images

• Filter by various card attributes: - Name (supports exact matching with `!` and wildcards with `*`) - Subtypes (e.g., Basic, EX, GX, V, VMAX, etc.) - Legalities (Standard, Expanded, Unlimited) - Types (Water, Fire, Grass, etc.) - Retreat cost - HP - National Pokedex numbers - And more!

Example Queries

• "Show me standard-legal basic Pokemon with free retreat"

• "Find water-type Pokemon with more than 120 HP"

• "Search for cards with 'char\*' in their name"

• "Show me banned cards in Standard format"

• "Find EX Pokemon that evolve from Charmander"

Query Syntax

Name Search

• Regular search: `name:pikachu`

• Exact match: `!name:pikachu`

• Wildcard: `name:char*`

• Preserve hyphens: `name:chien-pao`

Filters

• Types: `types:water` or `-types:water` (exclude)

• Subtypes: `subtypes:basic`

• Legalities: `legalities.standard:legal`

• HP: `hp:[100 TO 200]`

• Retreat Cost: `convertedRetreatCost:0`

Range Queries

• `hp:[100 TO 200]` - HP between 100 and 200 (inclusive)

• `hp:{100 TO 200}` - HP between 100 and 200 (exclusive)

• `hp:[* TO 100]` - HP up to 100

• `hp:[100 TO *]` - HP 100 or higher

Response Format

• Card name

• Set name

• High-resolution card image

• Card legalities

• Other card details as requested

Notes

• The MCP uses the Pokemon TCG API to fetch card data

• Images are displayed directly from the Pokemon TCG API's CDN

• All queries are case-insensitive

• Multiple filters can be combined in a single query