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):

   {
     "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