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