# RAWG Video Games Database MCP > RAWG Video Games Database connects your AI agent to a massive catalog of over 500,000 video games. Search by title using `search_video_games`, check platform compatibility with `list_video_game_platforms`, or get deep metadata—like release dates and community ratings—using `get_video_game_details`. It gives you instant access to global gaming data. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** video-games, game-metadata, database-search, gaming-industry, discovery-engine ## Description Yo, listen up. This ain't your grandma's database; this is RAWG Video Games Database, and it plugs your AI agent straight into a massive catalog—we're talking over half a million video games tracked across fifty-plus platforms. Forget messing with API keys or building some ugly wrapper yourself. Your agent handles all that junk for you. Here’s the deal: When you subscribe to this MCP Server, your agent becomes a total gaming data specialist. It doesn't just look things up; it pulls specific facts from global gaming history and current titles right when you need 'em. You can use it whether you're writing an article about retro consoles or checking if some blockbuster game dropped on PS5 last week. The whole thing runs through three core tools, and they do the heavy lifting. Let's break down what your agent can actually *do* for ya. When you need to find a game, even if you only remember part of the title, your agent uses the `search_video_games` tool. You feed it the name or just a partial string, and it searches that entire massive catalog, spitting back matching video game IDs. That's how you narrow down what you're looking for without getting swamped by noise. Once you got an ID—say, you found 'Cyberpunk 2077' in the search results—you use `get_video_game_details`. This tool pulls comprehensive data on that specific game. It gives you more than just a title; it drops descriptions, community ratings, and release dates all in one go. You can get deep metadata for one particular game ID without needing to hit another endpoint. It's fast, clean, and loaded with facts. Need to know what consoles are even involved? Your agent uses `list_video_game_platforms`. This tool lists every historical and current platform—think Xbox Series X, Nintendo Switch, or even some old-school retro system—that the database tracks. You'll get a complete rundown of all available gaming platforms, so you never gotta wonder if a game was ever made for that machine. So picture this: You tell your agent, 'I need details on any game called *Starfield* that came out on PC.' Your agent doesn't just guess. It first uses `search_video_games` to lock down the ID, then it kicks off `get_video_game_details` using that ID, and if you wanted to confirm platform availability, it could cross-reference with the list of platforms tracked by `list_video_game_platforms`. It's structured data access without any of the boilerplate code. You just talk to your agent like a human talking to another human. This server gives you instant access to global gaming intelligence. Stop wrestling with messy APIs or trying to piece together info from different sources. Just hook up your AI client, and let it do the heavy lifting. It's reliable data, straight outta the world's biggest game catalog. ## Tools ### get_video_game_details Retrieves detailed metadata, including descriptions and ratings, for one specific game ID. ### list_video_game_platforms Returns a list of all available gaming platforms tracked by the database (e.g., PC, PS5). ### search_video_games Finds video games matching a given title or partial search string. ## Prompt Examples **Prompt:** ``` Search for 'The Legend of Zelda' games on RAWG. ``` **Response:** ``` Searching for Zelda... I've found multiple titles including 'Breath of the Wild' and 'Tears of the Kingdom'. I can provide release dates and ratings for each of them. Which one would you like to explore? ``` **Prompt:** ``` Get details for the game 'Grand Theft Auto V'. ``` **Response:** ``` Retrieving GTA V data... It's one of the most popular games in the database. Released in 2013, it's available on almost every platform from PC to PS5. It has an average rating of 4.5/5. Would you like to read the description? ``` **Prompt:** ``` List all gaming platforms supported by RAWG. ``` **Response:** ``` Fetching the platform list... RAWG supports over 50 platforms, including current generation systems like PlayStation 5, Xbox Series S/X, and Nintendo Switch, as well as retro systems like the NES and Commodore 64. ``` ## Capabilities ### Search for Games Searches the entire database by title string and returns matching video game IDs. ### Retrieve Game Details Pulls comprehensive data, including descriptions, ratings, and release dates, for a specific game ID. ### Check Platform Compatibility Lists all historical and current platforms (e.g., Xbox Series X, Nintendo Switch) that the database tracks. ## Use Cases ### Writing a Retro Gaming Deep Dive A journalist needs to write about early 2000s gaming. They ask their agent: 'Show me details for games on the original Xbox.' The agent runs `list_video_game_platforms` first, filters by the platform, and then uses `search_video_games` followed by `get_video_game_details` to pull release dates and ratings into a summary. ### Validating Game Compatibility for an App A developer is building a compatibility checker. They feed the game name 'Cyberpunk 2077' to their agent, which uses `search_video_games` to get the ID. Then, it calls `get_video_game_details` and checks the platform data to ensure the required console/OS is listed. ### Comparing Game Generations A researcher wants to compare two games (e.g., 'Zelda: Ocarina of Time' vs. 'Breath of the Wild'). They use `search_video_games` for both titles, then run platform checks and retrieve details to summarize differences in rating/availability across multiple consoles. ### Debugging a Game Listing Site A QA tester needs to verify all platforms listed on a competitor's site. They simply call `list_video_game_platforms` to get the definitive, current list of 50+ systems tracked by RAWG. ## Benefits - **Instant Metadata:** Don't waste time clicking through multiple sites. Use `get_video_game_details` to pull descriptions and community ratings for any title in one go. - **Platform Coverage:** Need to know if a game ran on the NES or is current-gen? Call `list_video_game_platforms` to get a definitive list of all supported systems, past and present. - **Targeted Searching:** Forget vague searches. Use `search_video_games` to narrow your focus immediately by title, cutting through millions of results to find the right game ID. - **Historical Auditing:** Analyze market trends across decades. Combine a search with platform checking to summarize how availability changed for games like 'Grand Theft Auto V'. - **Code Integration:** Integrate complex data retrieval into your apps. Your agent handles the sequence: `search_video_games` -> check platforms -> `get_video_game_details`. ## How It Works The bottom line is: you talk naturally, and the server handles the complex API calls needed to get the raw facts. 1. Subscribe to the RAWG server and input your API Key. 2. Your AI client converts a natural language request (e.g., 'What platforms is Zelda on?') into a sequence of tool calls. 3. The MCP Server executes these tools, pulls the data from the database, and sends the clean results back to your agent. ## Frequently Asked Questions **How do I find a game by name using `search_video_games`?** Just ask your agent to search the title. The tool uses partial strings, so you don't need the exact spelling. It returns IDs that you can then pass to other tools. **What is the best way to get full details using `get_video_game_details`?** You must first use another tool (like `search_video_games`) to get a valid game ID. Then, pass that specific ID into `get_video_game_details`. That's how you guarantee the data is linked correctly. **`list_video_game_platforms` shows all platforms for every game?** No, it lists all platforms tracked by RAWG in general. If you want to know what a *specific* game ran on, use `get_video_game_details` after getting the ID. **Can I combine searching and platform checking with RAWG?** Yes. The process is sequential: 1) Use `search_video_games` to find titles, then 2) use `get_video_game_details` on the resulting IDs to check platform compatibility. **How do I get started using `search_video_games` with RAWG?** You must first obtain an API key from rawg.io and supply it when connecting the server. Your AI client uses this unique key to authenticate every query, which ensures your searches run smoothly while respecting usage limits. **Is there a limit on how many times I can use `get_video_game_details`?** Yes, the service enforces rate limits to maintain stability. If you exceed the allotted calls, your agent will receive an explicit error code. You'll need to pause and wait before trying the query again. **What specific data points does `get_video_game_details` provide?** It returns structured metadata including release dates, average community ratings, primary genre tags, and a full descriptive text block. This means your agent gets more than just the title. **Does `list_video_game_platforms` cover obscure or very old consoles?** The platform list covers major modern systems as well as many retro platforms, including historical hardware like the NES and Commodore 64. It provides a wide scope of gaming history. **Can I search for 'Cyberpunk 2077' and see its platforms?** Yes! Use the `search_video_games` tool with the query 'Cyberpunk 2077'. The results will show you all platforms where the game is available, such as PC, PlayStation, and Xbox. **How do I see the average community rating?** The ratings are included in the game metadata retrieved by the `get_game_details` or `search_video_games` tools. It shows the average score given by RAWG users. **Is it possible to list all games for a specific platform?** The current toolset focuses on searching and retrieving specific game details. To explore platforms, you can use the `list_platforms` tool to see all supported systems.