# Pokemon TCG MCP for AI Agents AI Agent Connect

> Pokemon TCG MCP. Search and browse the entire Pokemon Trading Card Game database. Find specific cards, explore sets, and filter by types or rarities to manage your collection or build better decks.

## Overview
- **Category:** knowledge-management
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_DcsQkiiGekd8MpZ3kwMh1y9NBdSyx8n5cUNocxdD/ai-agent-connect
- **Tags:** pokemon, tcg, trading-cards, collectibles, card-games

## Description

This Connector lets you turn your AI agent into a power user for the Pokemon Trading Card Game. Instead of digging through endless websites or spreadsheets, you can just ask your agent to find exactly what you're looking for. It pulls from the official Pokemon TCG API to give you real-time data on every card ever released. Whether you're trying to build a competitive deck or you're just trying to track down a rare holo from a specific set, you can just talk to your agent to get the facts. It handles the heavy lifting of navigating different expansions and filtering by complex attributes like energy types or card subtypes. It's one of the many specialized tools you can find in the Vinkius catalog to make your AI actually useful for your hobbies. You get high-resolution image links and market prices without having to leave your current chat window.

## Tools

### list_sets
See all released Pokemon card sets with optional search and pagination. Use this to browse different expansions.

### list_subtypes
Get a list of all card subtypes like EX, Mega, or Rapid Strike. This helps you filter for specific mechanics.

### list_supertypes
View all card supertypes including Pokemon, Trainer, and Energy. Use this to narrow down your card categories.

### list_types
See all Pokemon energy types like Fire, Water, and Grass. This is useful for identifying card elemental types.

### get_card
Fetch specific details for a Pokemon card using its unique ID. It provides attack data and market pricing.

### get_set
Get detailed metadata for a specific card set by its ID. This helps you see everything included in a set.

### list_cards
Search for Pokemon cards using names or complex queries. Use this for general discovery of cards in the game.

### list_rarities
View all card rarities like Rare Holo or Uncommon. This helps you identify the value and scarcity of cards.

## Prompt Examples

**Prompt:** 
```
Search for all Charizard cards from the 'Base' set.
```

**Response:** 
```
I found the Charizard cards in the Base set for you. The most notable one is:

**Charizard (ID: base1-4)**
- **Type:** Fire / Stage 2 Pokemon
- **HP:** 120
- **Attacks:** Fire Spin
- **Rarity:** Rare Holo
```

**Prompt:** 
```
List all available Pokemon energy types.
```

**Response:** 
```
Here are the current energy types in the Pokemon TCG:

* Colorless
* Darkness
* Dragon
* Fairy
* Fighting
* Fire
* Grass
* Lightning
* Metal
* Psychic
* Water
```

**Prompt:** 
```
Get the full details for the card with ID 'swsh1-1'.
```

**Response:** 
```
Here are the details for card **swsh1-1**:

- **Name:** Celebi V
- **Expansion:** Sword & Shield
- **Type:** Basic Grass Pokemon
- **HP:** 180
- **Attacks:** Line Spray, Beam Blast
- **Image:** [Link to High-Res Image]
```

## Capabilities

### Find specific cards
Search for any card in the database using names, types, or specific queries.

### Browse card sets
List every released expansion and fetch detailed metadata for specific sets.

### Lookup card types
Get lists of energy types, subtypes, and rarities to refine your search results.

### Get card details
Fetch specific attack data, high-resolution images, and market prices for individual cards.

### Filter by rarity
Quickly identify card rarities like Rare Holo or Uncommon across different sets.

## Use Cases

### Building a Fire-type deck
A player asks for all cards with Fire attacks in the Sword & Shield set to see what's available for their new deck.

### Finding a specific card
A collector wants to see the price and image of a specific Charizard card using `get_card` to see if it's worth buying.

### Exploring new sets
A fan wants to know what's in a new expansion and uses `list_sets` to see the full list of cards and metadata.

### Checking card types
A developer wants to see all possible energy types to build a card-tracking app or a custom database.

## Benefits

- Stop manually searching through multiple websites because `list_cards` lets you find any card instantly.
- Build better decks faster by using `list_types` and `list_subtypes` to filter for specific mechanics.
- Get accurate pricing and attack details for your favorites using `get_card` without leaving your chat.
- Organize your collection by exploring every expansion with `list_sets` and `get_set`.
- Verify card rarities and types quickly with `list_rarities` to ensure your collection is complete.

## How It Works

The bottom line is you get instant access to a massive trading card database through a simple chat interface.

1. Subscribe to the Pokemon TCG MCP in the Vinkius catalog.
2. Enter your Pokemon TCG API key in the settings to increase your rate limits.
3. Ask your AI client to search for cards, sets, or specific card details.

## Frequently Asked Questions

**Can I use the Pokemon TCG MCP to find specific card prices?**
Yes, this Connector allows your agent to pull market prices and attack details for specific cards using `get_card`.

**Does the Pokemon TCG MCP work with my favorite AI client?**
It works with any MCP-compatible client like Claude, Cursor, or Windsurf.

**How do I see all the different card sets available?**
You can ask your agent to list all sets using the `list_sets` tool to see every expansion.

**Can I filter cards by their rarity or type?**
Yes, the Connector provides tools like `list_rarities` and `list_types` to help you narrow down your search.

**Do I need a special key to use the Pokemon TCG MCP?**
You can use it without one, but adding your Pokemon TCG API key helps with higher rate limits.

**Is this Connector good for building competitive decks?**
It's perfect for that because you can quickly search for cards with specific attacks or subtypes.

**Can I search for cards from a specific set like 'Base Set'?**
Yes! Use the `list_cards` tool with a query parameter like `q="set.name:base"`. You can combine this with other filters like name or type.

**How do I see all the available card rarities in the game?**
Simply run the `list_rarities` tool. It will return a complete list of all rarity strings used in the database, such as 'Rare Holo', 'Uncommon', or 'Promo'.

**Is an API key required to use this server?**
An API key is optional. The server will work without one using the public tier, but providing a key from pokemontcg.io allows for much higher rate limits and faster responses.