What is Ptcg Mcp

ptcg-mcp is a Model Context Protocol (MCP) server designed for searching and displaying Pokemon Trading Card Game cards.

Use cases

Use cases include querying for specific types of Pokemon cards, finding cards with certain attributes, and displaying card information for educational or collection purposes.

How to use

To use ptcg-mcp, configure your Claude application by adding the MCP server details to the configuration file, restart Claude, and then you can ask questions about Pokemon cards.

Key features

Key features include searching cards by various attributes such as name, type, subtype, and legality, viewing high-resolution card images, and filtering by attributes like HP and retreat cost.

Where to use

ptcg-mcp is primarily used in applications related to the Pokemon Trading Card Game, especially for players and collectors who need to search for specific cards.

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