# Yu-Gi-Oh MCP > Yu-Gi-Oh! provides instant access to the entire card database. Search for specific cards, list all game archetypes, and explore historical set data directly through your AI agent. It’s a master duelist's tool for collectors and developers needing detailed TCG information without manual wiki lookups. ## Overview - **Category:** databases - **Price:** Free - **Tags:** yu-gi-oh, tcg, card-game, deck-building, trading-cards ## Description Need deep stats on a rare card or checking the history of an old set? This MCP connects your agent to a massive, authoritative Yu-Gi-Oh! database. You can ask it to pull specific card details—like ATK, DEF, and Level—or list every known game archetype. Need to know what cards were printed in the 'Alpha' set versus the latest releases? It handles that too. Your AI agent acts like a master duelist with instant access to every piece of data. Everything runs through Vinkius, which handles all connections via a zero-trust proxy; your keys pass through securely and never sit on disk. This means you get reliable, clean card data whenever you need it. ## Tools ### list_archetypes Returns a complete list of all established card archetypes in the game. ### get_card_info Pulls detailed stats, descriptions, and images for specified cards. ### get_card_set_info Retrieves specific details about a designated card set. ### list_card_sets Provides an exhaustive list of every released Yu-Gi-Oh! card set. ### check_db_version Confirms the current version number and last update time for the card database. ### get_random_card Picks and returns one random Yu-Gi-Oh! card from the entire database. ## Prompt Examples **Prompt:** ``` Search for card info on 'Blue-Eyes White Dragon'. ``` **Response:** ``` I've found the data for 'Blue-Eyes White Dragon'. It's a Level 8 LIGHT Dragon Normal Monster with 3000 ATK and 2500 DEF. It is one of the most iconic cards in the game. ``` **Prompt:** ``` List all Yu-Gi-Oh card sets available. ``` **Response:** ``` Fetching card sets... I've retrieved a list of all sets, including classics like 'Legend of Blue Eyes White Dragon' (LOB) and newer releases like 'Phantom Nightmare' (PHNI). ``` **Prompt:** ``` Give me a random Yu-Gi-Oh card. ``` **Response:** ``` Drawing a random card... You got 'Pot of Greed'! It's a Spell Card that allows you to draw 2 cards from your deck. ``` ## Capabilities ### undefined undefined ### undefined undefined ### undefined undefined ### undefined undefined ### undefined undefined ## Use Cases ### Verifying a specific card’s rules. A player needs to check if 'Blue-Eyes White Dragon' has been modified by the latest ruling. They ask their agent, and it uses `get_card_info` immediately, providing accurate stats and descriptions without leaving the chat. ### Building a deck around a specific theme. A deck builder wants to know all possible card groups for synergy. They ask the agent to list archetypes; it uses `list_archetypes` to give them a full thematic map, helping them structure their whole build. ### Auditing an old collection's contents. A collector wants to know exactly which cards were in the original 'Legend of Blue Eyes White Dragon' set. They use `list_card_sets` first, then drill down with `get_card_set_info` to confirm card IDs. ### Developing an app that indexes TCG data. A developer needs a comprehensive list of all available sets for their project. They use the agent to call `list_card_sets`, getting the necessary structure to start building out their own database schema. ## Benefits - Get instant stats: Instead of searching multiple pages, use `get_card_info` to pull a card's ATK, DEF, Level, and description in one query. - Understand synergies: Use `list_archetypes` to map out how different card types work together for deck building and strategy planning. - Track history: Need to know what cards were available when? `list_card_sets` lets you browse every published set list, down to the specifics using `get_card_set_info`. - Stay current: Use `check_db_version` to confirm your data is up-to-date before building a strategy or running an analysis. - Quick inspiration: Whenever you're stuck, just ask for a random card. The agent uses `get_random_card` to pull a fresh idea instantly. ## How It Works The bottom line is that your AI agent turns complex database lookups into simple conversation prompts. 1. Subscribe to this MCP, then give your AI client the necessary credentials. 2. Ask your agent a direct question, like 'What are all the archetypes related to dragons?' 3. The tool executes the query and sends back structured card data directly into your chat or script. ## Frequently Asked Questions **How do I check if the card database is up to date using `check_db_version`?** Run a query asking for the database version. The system will return the current version and the timestamp of the last update, confirming if your data is fresh enough for competitive play. **Can I list every possible card type in the game using `list_archetypes`?** Yes, calling `list_archetypes` provides a comprehensive listing of all established themes. It's perfect for seeing what kind of synergies are available across the entire game. **What if I want to know about a specific card set using `get_card_set_info`?** Simply ask your agent for details on the set name. The tool handles fetching all relevant information, from release date to included card IDs, keeping everything contained. **Can I use this MCP for my own custom application?** Absolutely. Developers can integrate the data by chaining multiple calls—like using `list_card_sets` and then looping through the results with `get_card_set_info` to build a full catalog. **When I want to know detailed stats for a specific card, how do I use `get_card_info`?** You provide the card name or ID directly to `get_card_info`. It returns a complete profile including ATK, DEF, level, type, and full descriptions. This is perfect for checking rulings or comparing monster stats. **If I'm just brainstorming and need some random card inspiration, how does `get_random_card` work?** It pulls one unique card from the entire database on demand. You simply call the function and get an immediate suggestion. This is a great tool for brainstorming or when you're stuck on what to build next. **How do I see every possible card set available in the system using `list_card_sets`?** Running `list_card_sets` returns a comprehensive list of all known sets. You get the names and IDs needed to start drilling down into specific contents later. It's your master index for card collections. **What information can I extract about a single card by calling `get_card_info`?** The tool gives you everything: stats, descriptions, images, level, and type. You don't have to guess what details are available; it returns a full profile for any card you name. **How can I find the specific effects and stats of a card by its name?** Use the `get_card_info` tool with the `name` or `fname` parameter. The agent will return full metadata including ATK/DEF, Level, Type, and the official card text. **Is there a way to see all the different card themes or archetypes available in the game?** Yes! Run the `list_archetypes` action. It will provide a comprehensive list of all archetypes currently recognized in the database, such as 'Elemental HERO' or 'Blue-Eyes'. **How do I know if the card data is up to date with the latest releases?** You can use the `check_db_version` tool. It returns the current database version and the timestamp of the last update from the YGOPRODeck servers.