Pokemon TCG Card Search

by jlgrimes

8 stars
422 downloads
Not rated
GitHub

About

Enables searching and displaying Pokemon Trading Card Game cards with rich filtering capabilities for name, type, legality, and more through the Pokemon TCG API.

Details

Author
jlgrimes
Repository
jlgrimes/ptcg-mcp
GitHub stars
8
Downloads
422
Categories
Search, Other, API, Developer Tools, Design, AI, Media, Knowledge Base, Frontend

- 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!

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Pokemon TCG Card Search
    Command (node, npx, python, etc.) node
    Arguments
    • Argument 1 ABSOLUTE_PATH_HERE/dist/index.js

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

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.

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

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "pokemon tcg card search": {
            "cwd": "string",
            "env": {},
            "args": [
                "ABSOLUTE_PATH_HERE/dist/index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

Linux

{
    "cwd": "string",
    "env": [],
    "args": [
        "ABSOLUTE_PATH_HERE/dist/index.js"
    ],
    "shell": false,
    "command": "node"
}

Macos

{
    "cwd": "string",
    "env": [],
    "args": [
        "ABSOLUTE_PATH_HERE/dist/index.js"
    ],
    "shell": false,
    "command": "node"
}

Windows

{
    "cwd": "string",
    "env": [],
    "args": [
        "ABSOLUTE_PATH_HERE/dist/index.js"
    ],
    "shell": false,
    "command": "node"
}

Search and display Pokemon Trading Card Game cards using the Pokemon TCG API.

This Model Context Protocol (MCP) server allows Claude to search and display Pokemon Trading Card Game cards.

- 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"] } } }

- Open Task Manager
- Find and quit Claude completely

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

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.

- 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!

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"

- Regular search:name:pikachu
- Exact match:!name:pikachu
- Wildcard:name:char
- Preserve hyphens:name:chien-pao

- Types:types:wateror-types:water(exclude)
- Subtypes:subtypes:basic
- Legalities:legalities.standard:legal
- HP:hp:[100 TO 200]
- Retreat Cost:convertedRetreatCost:0

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

The MCP returns card information including:

- Card name
- Set name
- High-resolution card image
- Card legalities
- Other card details as requested

- 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

Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.

Search for Magic: The Gathering cards and get details, rulings, and prices using the Scryfall API.

Search the web using Kagi's search API

Unlock geospatial intelligence through Mapbox APIs like geocoding, POI search, directions, isochrones and more.

Interact & query with Meilisearch (Full-text & semantic search API)

One API for Search, Crawling, and Sitemaps

Discover public A2A agents on the Agently platform using its public API.

Integrate with the Amazon Product Advertising API to search for products and access product information.

Multi-provider search broker for AI agents. Routes across SearXNG, Brave, Serper, Tavily, and Exa with automatic fallback, RRF ranking, content extraction, and budget enforcement.

An MCP server using the AviationStack API to fetch real-time flight data including airline flights, airport schedules, future flights and aircraft types.

A search server for the Model Context Protocol (MCP) that uses the Baidu Wenxin API.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.