# CheapShark MCP > CheapShark finds the best PC game deals from major digital stores like Steam, Epic Games Store, and GOG. Your AI agent queries its database to compare current prices, track historical lows, and set email alerts for games you want without visiting ten different websites. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** game-deals, price-tracking, pc-gaming, shopping-assistant, price-comparison ## Description Stop juggling tabs across a dozen different gaming storefronts just to check if that RPG dropped another dollar. This MCP lets your agent query CheapShark’s massive database instantly, pulling together the lowest current price for any game across major platforms. You can tell it to find all top deals matching certain criteria or look up a specific title by ID to see its cheapest recorded price ever. If you're keeping an eye on a wishlist, it handles that too; you just set your desired target price and get notified when the deal pops up. It’s like having a dedicated pricing analyst for every game you care about, all accessible directly through Vinkius. ## Tools ### get_deals Retrieves a list of current, active game deals across various stores. ### get_game Fetches specific details for one game using its unique identifier. ### manage_alert Sets or modifies email notifications to warn you when a game's price drops below your specified threshold. ### search_games Searches the database for games using either their title name or Steam App ID. ### get_stores Provides a comprehensive list of all digital stores tracked by the database. ## Prompt Examples **Prompt:** ``` Search for the game 'Elden Ring' to get its ID. ``` **Response:** ``` I found 'Elden Ring' with Game ID: 237788. It's currently available on several stores. Would you like to see the best current deals for it? ``` **Prompt:** ``` Show me the best deals for games under $20 with a Metacritic score over 80. ``` **Response:** ``` I've filtered the current deals for you. Top picks include 'The Witcher 3: Wild Hunt' at $12.49 (Metacritic: 93) and 'Hades' at $14.99 (Metacritic: 93). ``` **Prompt:** ``` Set a price alert for game ID 237788 to notify me at gamer@example.com if it drops below $30. ``` **Response:** ``` Success! I've set a price alert for 'Elden Ring' (ID: 237788). You will receive an email at gamer@example.com as soon as the price hits $30.00 or lower. ``` ## Capabilities ### Discover current deals Retrieve a list of active game deals, filtering by price range or overall rating. ### Identify games by title or ID Search the database for specific game titles or use their unique Steam App ID to find them. ### Check detailed pricing history Fetch comprehensive information on a single game, including its current offers and lowest recorded price across all tracked stores. ### Map store IDs Get a complete list of every digital storefront the database tracks so you can map out their specific identifiers. ### Automate deal tracking alerts Set up email notifications that trigger when a specific game drops below your chosen target price. ## Use Cases ### I'm writing a game review and need pricing data. Instead of manually checking Steam, Epic, and GOG for the title 'Cyberpunk 2077', you tell your agent to use `search_games` first. Then you feed that ID into `get_game`. Your agent returns the current price and the historical low in one go, letting you write a fact-based comparison. ### I want to track my favorite game before its release. You tell your agent: 'Set an alert for Game ID 999.' The `manage_alert` tool takes care of the rest. You don't have to manually check back every day; you just wait for the email notification. ### I want to see what deals are best right now. You ask your agent for 'deals under $20 with 90+ rating.' The `get_deals` tool filters the entire market and spits out a clean list of the top options, saving you from sifting through thousands of irrelevant titles. ### I'm building a comparison script. You first call `get_stores` to get all available store IDs. Then you loop through them, calling `get_game` for multiple specific titles to collect comprehensive pricing data points into a structured format. ## Benefits - Check the current market instantly. Instead of visiting multiple websites, using `get_deals` gives you a filtered list of top sales based on criteria like price or rating. - Know the true value of a game. Use `get_game` to see not just the current price, but the absolute lowest price that title has ever hit across all tracked stores. - Stay updated without checking email spam. Set up alerts with `manage_alert`; your agent handles monitoring and only tells you when the deal criteria are met. - Targeted searching saves time. If you know the game name or its Steam App ID, `search_games` finds it immediately so you can check all pricing data for that title. - Build a store map. Need to figure out which IDs match which stores? Use `get_stores` to list every platform tracked by CheapShark. ## How It Works The bottom line is you tell it what game you want to check, and it brings back the deal information from all the stores at once. 1. First, connect to the CheapShark MCP in Vinkius and initiate a query through your AI client. 2. Next, direct your agent to perform an action, like searching for a game or listing current deals, providing necessary parameters (e.g., price range, store ID). 3. Finally, your agent processes the data and returns structured results: either a list of matching games or confirmation that the requested alert is active. ## Frequently Asked Questions **How do I use the get_deals tool to find sales?** You just ask your agent to run `get_deals`. You can filter the results by criteria like minimum price or store name, so you don't get overwhelmed with irrelevant listings. **Can I use search_games if I only know the game title?** Yes. You feed the title to `search_games`. It will help narrow down results and often give you the unique App ID, which is useful for more precise queries later. **What does get_game do with pricing history?** `get_game` retrieves detailed data on a specific title. Crucially, it shows not just the current price but also the lowest recorded price that game has ever sold for in the database. **How often does manage_alert check prices?** The alert system runs continuously and monitors the target price against the live data. You'll get an email as soon as a drop hits your set threshold. **How do I use get_stores if I need a list of all supported retailers?** It returns a complete directory of every store CheapShark tracks. This is essential for mapping external IDs to the official store names, letting your agent know exactly where to look for deals. **What happens if I use search_games with an ID that no longer exists?** The agent will report a specific error indicating the Game ID was not found. You can then correct the input or check the get_stores tool to verify the current store catalogue. **Can I use manage_alert to change an existing price alert?** Yes, you don't need to set it up from scratch. You simply tell your agent which specific Game ID and email address belong to the alert, and then specify the new target price or threshold. **If I search_games for a very broad title, how does the tool handle multiple potential matches?** The tool provides a list of possible titles and their IDs. Your agent will present these options to you, allowing you to select the exact game you're interested in. **How can I find the historical lowest price for a specific game?** Use the `get_game` tool with the specific game ID. It returns the 'cheapestPriceEver' metadata along with current deals across all stores. **Can I filter for only highly-rated games on sale?** Yes! Use the `get_deals` tool and set the `steamRating` or `metacritic` parameters to filter for quality titles. **How do I set up a notification for when a game goes on sale?** Use the `manage_alert` tool with the 'set' action, providing your email, the game ID, and your target price threshold.