Pokemon TCG Card Search MCP

# Pokemon TCG Card Search MCP This Model Context Protocol (MCP) server allows Claude to search and display Pokemon Trading Card Game cards. ## 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 Once configured, you can ask Claude questions about Pokemon cards such as: - "Show me standard-legal basic Pokemon with free retreat" - "Find water-type Pokemon with more than 120 HP" - "Search for Pikachu cards" Claude will display the matching cards with their images and relevant information. ## 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 Here are some example queries you can try: - "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 Use `[` and `]` for inclusive ranges, `{` and `}` for exclusive ranges: - `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 The MCP returns card information including: - 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