# GiantBomb MCP > GiantBomb MCP connects your AI agent directly to a massive video game encyclopedia. You can query deep data on titles, characters, consoles, and companies—all from one place. Need to know which platform Link first appeared on? Want to compare the tech specs of the Dreamcast versus the Saturn? This MCP pulls accurate metadata, bios, release dates, and technical details for thousands of games and figures in gaming history. ## Overview - **Category:** databases - **Price:** Free - **Tags:** video-games, game-database, gaming-history, character-wiki, platform-specs ## Description This connector lets you research video game data without leaving your workflow. Instead of juggling multiple wikis or searching through disparate databases, you ask your AI client a question and get the deep facts back instantly. Need to compare platform specs? Want to check a character's full biography across franchises? Your agent handles it all. It fetches details on everything from specific game metadata using unique IDs to listing every company ever involved in gaming. Because this MCP is managed by Vinkius, you connect once and get access to this entire catalog of video game knowledge. You can ask your AI client to cross-reference a character's appearances with the platforms they appeared on, all through simple conversation. ## Tools ### get_character Retrieves specific details for one video game character using their ID. ### get_company Pulls detailed records for a single company, like Nintendo or SEGA. ### get_game Gets the full set of data—descriptions, release info, and ratings—for one specific game title. ### get_platform Retrieves technical specifications and history for a single gaming console or platform. ### list_characters Provides a list of characters, allowing you to filter and narrow down who you want to research. ### list_companies Returns an index of companies so you can browse the industry players. ### list_games Retrieves a list of games, letting you use filters like genre or date to pinpoint titles. ### list_platforms Gives you an index of all gaming platforms available in the database. ### search Searches across multiple types of data (games, characters, companies) using a single query. ## Prompt Examples **Prompt:** ``` Search for 'The Legend of Zelda' in the Giant Bomb database. ``` **Response:** ``` I found several matches for 'The Legend of Zelda'. The main game series entry is GUID 3030-4725. I also found characters like Link (GUID 3005-32) and various platforms. Which one would you like to explore? ``` **Prompt:** ``` Get the full details for the game with GUID 3030-4725. ``` **Response:** ``` Fetching details for 'The Legend of Zelda'... This classic action-adventure game was developed and published by Nintendo. It features a vast overworld, challenging dungeons, and introduced the iconic character Link. It was originally released for the Famicom Disk System in 1986. ``` **Prompt:** ``` List all gaming platforms released by SEGA. ``` **Response:** ``` Querying platforms... I've found several SEGA platforms including the Genesis (GUID 3045-6), Dreamcast (GUID 3045-37), Game Gear (GUID 3045-5), and Saturn (GUID 3045-42). Would you like the technical specifications for any of these? ``` ## Capabilities ### Search across all resources You can run one query and find matches involving games, characters, companies, or platforms simultaneously. ### Get specific game details Fetch complete information for a single title, including its description, release history, and ratings. ### Retrieve character bios Pull detailed biographies and records of appearances for any video game character. ### List all games by filter Filter huge lists of titles using criteria like genre or release date to narrow down results quickly. ### Identify industry companies Pull specific corporate details for developers, publishers, and other entities in the gaming world. ### List all platforms and consoles Get a full list of historical and current gaming hardware, from handhelds to mainframes. ## Use Cases ### Writing an article on the 90s console wars The content creator asks their agent to find all gaming platforms released between 1985 and 1995. The agent uses `list_platforms` and then cross-references those results with `get_company` data, giving the writer a structured list of key players and consoles for the article. ### Settling a debate about character origins A casual gamer asks their agent to look up Link. The agent uses `get_character`, which pulls all biographical details, instantly resolving the argument without needing to check multiple wiki pages manually. ### Researching platform compatibility for a new game A developer needs to know if their game can run on older hardware. They use `list_platforms` to see all options, then use `get_platform` to pull the specific technical specs of legacy systems. ### Finding a niche game in a massive database Instead of relying on keyword searches, the agent uses `search` with multiple parameters—like 'Action RPG' + '1998' + 'Nintendo'—to pull exact matches from thousands of titles. ## Benefits - You get instant access to deep metadata. Instead of visiting separate pages, you ask your agent for a game's full details using `get_game`, pulling descriptions and ratings in one shot. - Avoid confusing search results. If you need a specific character's history, use `get_character` or `list_characters`. This keeps the focus tight on biography and appearances. - Cross-reference data effortlessly. The `search` tool lets you ask things like 'What games were released by Company X on Platform Y?' without writing complex code. - Build an industry map. Use `list_companies` to see all involved entities, then use `get_company` to dive into the history of a single developer or publisher. - Compare hardware specs easily. Need to know how different consoles stack up? You can list platforms and get detailed technical specs using `get_platform`. ## How It Works The bottom line is that you don't worry about API calls; your AI client handles all the database lookups for you. 1. Subscribe to this MCP and enter your Giant Bomb API Key into the Vinkius catalog. 2. Your AI client accesses the connection. It determines which specialized tool is best for your query—whether you need a list of platforms or details on a character. 3. The agent runs the necessary function, pulls the data from the encyclopedia, and sends the clean, structured facts back to you. ## Frequently Asked Questions **How does the GiantBomb MCP use the 'search' tool?** The `search` tool lets you query multiple resources at once. You can ask it to look for a character associated with a specific company, which is much faster than running two separate queries. **What if I only need platform specs? Should I use 'get_platform' or list_platforms?** If you know the name of the console (like Sega Saturn), use `get_platform`. If you want to see a full index of all available consoles, then run `list_platforms`. **Can I find character info with get_character?** Yes. The `get_character` tool pulls detailed bios for specific video game characters, giving you their appearances and history instantly. **What is the difference between list_games and search?** Use `list_games` when you know what filter you want to apply (e.g., 'Show me all games from 1995'). Use `search` if you are looking for a combination of criteria, like 'Games about Space travel' AND 'Published by Company X'. **If I want to get full details for a game using `get_game`, what information do I need?** You must provide the game's unique GUID. This ID is essential because it points directly to one specific title in the database. Simply searching by name isn't enough; you need that precise identifier. **How should I use filters when calling `list_games`?** You pass parameters like genre, release date range, or developer ID directly into the tool call. This process narrows down the list significantly, giving you a much more focused and actionable result set. **After using `get_game`, how do I pull details about its developer using `get_company`?** The data returned by `get_game` includes the company's unique identifier. You pass that specific ID directly into the `get_company` tool to retrieve all related corporate and publishing history. **Are there limitations when using the universal `search` tool?** The search function indexes public metadata across resources, but it won't pull real-time data or information not exposed through the core API endpoints. It works best for historical lookups. **How do I find the unique GUID for a specific game or character?** You can use the `search` tool with your query. The results will include the `guid` (e.g., 3030-4725) for each item, which you can then use with `get_game` or `get_character` for full details. **Can I filter games by a specific platform or developer?** Yes! Use the `list_games` tool and provide a string to the `filter` parameter (e.g., `platforms:146` or `name:Mario`). You can also use `field_list` to limit the data returned. **What kind of resources can I search for simultaneously?** The `search` tool allows you to specify multiple types in the `resources` parameter, such as `game,character,company,platform`. This returns the most relevant matches across all those categories in one go.