Pokemon TCG MCP for AI. Access every card detail and set list instantly.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
How this MCP server connects to your AI agent
Pokemon TCG MCP Server gives your AI client access to the entire Pokemon Trading Card Game database. Use it to search for specific cards by name or complex queries, list every historical set, and retrieve detailed metadata like attack descriptions, HP values, and rarity types.
Stop clicking through card websites; ask your agent directly.
What AI agents can do with Pokemon TCG Automation
Get card
Retrieves all specific details (HP, attacks, image links) for a Pokemon card using its unique ID.
Get set
Gets detailed metadata about an entire Pokémon TCG expansion set by providing the set's ID.
List cards
Finds and lists Pokemon cards, allowing you to search using keywords or specific parameters like card name.
Your agent queries the full card catalog to find cards matching names, types, or other specified parameters.
You retrieve all known sets or pull deep metadata for a single set using its ID.
The agent pulls lists of standardized data like energy types (list_types), rarities (list_rarities), or subtypes to validate search parameters.
You pull all available data—including image links, attack text, and HP—for a single specific card ID.
Ask an AI about this
Waiting for input…
What AI agents can do with Pokemon TCG: 8 Tools for Card Metadata Retrieval
Use these eight tools to query specific data points—from listing all rarities to getting detailed information on a single Pokémon card.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Pokemon TCG on VinkiusGet Card
Retrieves all specific details (HP, attacks, image links) for a Pokemon card using its unique ID.
Get Set
Gets detailed metadata about an entire Pokémon TCG expansion set by providing the...
List Cards
Finds and lists Pokemon cards, allowing you to search using keywords or specific...
List Rarities
Provides a definitive list of every possible rarity designation in the TCG (e.g....
List Sets
Lists all known Pokémon card sets and allows you to narrow down the scope using...
List Subtypes
Outputs a list of every official card subtype, such as EX or Mega, for classification purposes.
List Supertypes
Lists the core categories that cards fall into: Pokémon, Trainer, or Energy.
List Types
Provides a complete list of all energy types used in the TCG (e.g., Fire, Water...
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Claude AI
Open Claude Settings
Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
Add Custom Connector
Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:
https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp
Replace [YOUR_TOKEN_HERE] with your token
from cloud.vinkius.com. For OAuth-protected servers, expand
Advanced settings to add credentials.
Start a conversation
Open a new chat. The Pokemon TCG integration is available immediately — no restart needed.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Pokemon TCG, then connect any of our 5,100+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,100+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Pokemon TCG API. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Built on the Model Context Protocol (MCP) for Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This connection provides 8 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
Sifting through card databases used to feel like detective work., Solved with Vinkius AI Gateway
Before this MCP Server, getting a complete picture of a set or finding all variations meant opening multiple websites. You'd check the official API page for types, then switch to a different site just to verify rarity codes, and finally manually cross-reference every single card ID you found.
Now, your agent handles it. You ask: 'Show me everything about the Base set.' The server runs `list_sets`, pulls all metadata via `get_set`, and gives you structured data—no tabs, no copy/pasting, just clean results.
Pokemon TCG MCP Server: Get every card detail in seconds.
The manual steps that go away include verifying subtypes against general knowledge and then running separate searches for type lists. You don't need to manually cross-reference which cards are 'Mega' versus 'EX'; the `list_subtypes` tool gives you the clean list, and your subsequent calls use it automatically.
It’s simple: You define the scope (set or type), and the server does the heavy lifting. The data comes back structured, ready to be used in whatever workflow you've built.
What your AI can actually do with this
Your agent connects directly to the entire Pokémon TCG database. You can treat it like having a master collector sitting right next to you, letting your AI client search through every single card and set ever printed—all without clicking through a million websites.
If you need to find specific cards, start with list_cards. This tool lets you query the full catalog using keywords or specific parameters, so you can nail down exactly what you're looking for. Need to narrow that search? You've got several built-in reference tools. Use list_types to pull a complete roster of every energy type—you know, Fire, Water, Grass, and the rest.
Run list_rarities when you need to check every designation possible, like Common or Rare Holo. For classification help, run list_supertypes, which gives you the core categories (Pokémon, Trainer, Energy), or use list_subtypes for official card classifications like EX or Mega.
Want to look at a specific expansion? Run list_sets first; it'll give you a rundown of every known set, and you can filter that scope using search parameters. Once you know the set ID, get_set pulls all the deep metadata about that entire expansion package. For the ultimate card inspection, run get_card.
This tool takes one unique card ID and hands you everything: the HP total, the attack descriptions, and image links for that single specific piece of cardboard.
To kick off a search on an entire set's details, you use get_set with its unique identifier. If you just need to see what cards exist in the catalog without knowing the exact name or parameters, you can always run list_cards for a general listing.
019e5d49-3380-70fd-a8af-1e7472df8b11 
Here's how it actually works
The bottom line is, you stop browsing websites; you ask for the data structure you need, and it appears.
Subscribe to the server. If you need high query volume, enter your Pokemon TCG API Key.
Tell your AI agent what data you need (e.g., 'Find all Charizard cards from the Base set').
The agent runs the necessary tools (list_sets, then list_cards) and returns the structured card metadata directly to your client.
Who is this actually for?
Collectors who get tired of cross-referencing card images, competitive players optimizing decks, or developers needing structured TCG data. If your workflow involves querying vast amounts of specific, fixed metadata—you need this.
Uses list_sets and get_card to find variations, check historical sets, and verify the rarity or image links for a card ID.
Runs complex queries using list_cards combined with specific filters (e.g., 'type:fire' AND 'attack:blast') to optimize their deck list.
Integrates real-time TCG data into applications, using the 8 tools to pull standardized lists of subtypes or energy types for validation.
What Changes When You Connect
Pinpoint specific cards fast. Instead of browsing, use list_cards to search directly by name or complex query (like 'name:charizard'), getting the result immediately.
Map out entire collections. Use list_sets and get_set together to pull metadata for an entire expansion—all in one agent call cycle.
Stop guessing parameters. Call list_rarities, list_supertypes, or list_types first. This gives your agent the exact list of valid options you need before running a big search.
Deep dive into single cards. If you know an ID, use get_card to get everything: image links, HP, and full attack text—no jumping through multiple pages.
Build robust logic chains. Use the specific tools like list_subtypes in conjunction with get_set to build highly targeted data retrieval workflows that validate every piece of metadata.
See it in action
Validating a rare card's status
A collector finds an old, unknown card. Instead of searching forums, they ask their agent to run get_card with the ID and simultaneously use list_rarities and list_subtypes. The agent confirms if the card is valid, what its subtypes are, and if the rarity designation matches historical records.
Building a multi-type deck list
A player needs to build a deck focusing on Fire and Water types. They prompt their agent: 'Find all cards that are type:Fire or type:Water.' The agent runs list_types for validation, then uses the combined data in list_cards to return an optimized list of potential attackers.
Analyzing a new expansion's scope
A developer needs to know what metadata fields are available across all sets. They use list_sets first to see the full scope, then run get_set on several key expansions to map out every possible data field (energy types, subtypes) for their application.
Troubleshooting a search query
A user runs a card search that fails. They ask the agent to first run list_types and list_supertypes. The agent shows them the exact valid parameters (like 'Grass' or 'Pokémon') they need to include in their next, corrected list_cards query.
The honest tradeoffs
Guessing card IDs
I'll just try searching for 'Charizard Base Set Card 123'. The agent fails because I don't know the exact ID format.
Don't guess. First, run list_sets to find the correct set ID, then use list_cards with specific name and set parameters to get a list of IDs, and finally execute get_card on the confirmed ID.
Searching for attributes only
I need to know what subtypes exist. I just search 'subtypes' in general chat.
Run list_subtypes. This tool gives you a definitive list of all available subtypes (EX, Mega, etc.). Then, use those specific terms when calling list_cards for accurate filtering.
Assuming data consistency
I ran this search once and it worked. I'll assume next time the field names are the same.
When pulling structured lists (like energy types or rarities), always call list_types or list_rarities first. This guarantees you are working with the most current, validated vocabulary before trying to build a complex query.
When It Fits, When It Doesn't
Use this server if your goal is structured data retrieval about TCG cards—you need metadata like HP, specific attack text, or standardized lists of types. You're building an application or running deep analysis that requires the API to be queried multiple times with varying parameters.
Don't use it if you just want a general idea of what Charizard looks like (use a standard image search). Also, don't use it if your question is 'What are popular cards right now?'—the database only holds historical data. For that, you need market trend tools, not card metadata.
If you are trying to find the absolute maximum scope of possible values for filtering (like all subtypes), always start by running list_subtypes before attempting any complex query with list_cards. This confirms your inputs.
Questions you might have
How do I find all Charizard cards from a specific set using list_cards? +
You must use the name and set parameters within list_cards. You can search for 'name:charizard' AND specify the correct set identifier in your query. This prevents listing every single card named Charizard across unrelated sets.
Do I need to use list_types before running other searches? +
It's best practice to run list_types first. It confirms the exact, current names of energy types (e.g., 'Grass' vs. 'G') so your agent doesn't fail on an invalid parameter when calling list_cards.
What is the difference between list_sets and get_set? +
list_sets shows you all available sets in a browsable format. Use get_set only after you've identified a specific set ID; this tool pulls deep, detailed metadata for that single expansion.
Can I use get_card to find the full details if I just know the card name? +
No. get_card requires the unique card ID. If you only have the name, you must first run list_cards to narrow down the results and locate the specific ID before running get_card.
How do I manage rate limits when using list_cards to search large databases? +
You can optionally enter your Pokemon TCG API Key into the server settings. This significantly increases your rate limit capacity, allowing for deep data scraping and bulk queries without hitting usage caps.
Can I combine different filters (like rarity AND type) when using list_cards? +
Yes, you structure complex searches within the 'q' parameter. You combine criteria using specific field syntax, for example, "type:fire name:charizard" to narrow down results immediately.
What is the purpose of running list_subtypes before I use get_card? +
You don't need to run it first. The list_subtypes tool just gives you a reference list (like EX or Mega). You then use that information when building your search query with other tools.
If I only know the card name, what data can I get using get_card? +
The get_card tool returns comprehensive details including high-resolution image links, current market prices, and a full list of its abilities or attacks. This gives you everything you need for research.
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.
We've already built the connector for Pokemon TCG. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 8 tools are live and waiting.
You're up and running in seconds.
Gemini Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.
Built, hosted, and secured by Vinkius. You just connect and go.