# SteamSpy MCP > SteamSpy lets your AI agent read deep data from the Steam market and game statistics. You can track estimated owner counts, average playtime per user, and find top-performing games based on specific metrics like genre or tags. Use it to research anything from competitor saturation to niche market gaps—all without leaving your client. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** steam-stats, market-research, game-data, player-analytics, gaming-trends ## Description You wanna know what makes a game tick? You gotta look at the raw numbers. **SteamSpy** gives your AI agent direct access to Steam's deep market data, so you can stop guessing and start knowing. This server lets your client run complex research queries—it’s all right there in the toolset. Need broad coverage? Use `get_all` to fetch massive batches of game records and their owner metrics; it gives you up to 1,000 entries per page, so you can crawl through huge swathes of data without getting stuck. For a deep dive into one specific title, use `get_app_details`. Just give it the unique AppID number for any Steam app, and your agent pulls precise stats—that's ownership estimates, playtime metrics, and more. If you wanna narrow down the haystack, you can filter by category. Use `get_genre` to query the catalog and pull up every game that fits an exact genre, like 'Puzzle' or 'Action'. You can also find games associated with specific community tags using `get_tag`, listing titles under a tag like 'Survival' or 'Coop'. When you need to know what's hot right now, there are tools for that. Use `get_top_100_in_2_weeks` and it gives you the list of the 100 games that have seen the most player action in just the last two weeks—that's your immediate trend report. To see what has always been popular, use `get_top_100_forever`; this ranks the Top 100 titles based on cumulative player activity dating all the way back to March 2009. If you're purely interested in market share and ownership size, `get_top_100_owned` pulls the list of the Top 100 games ranked by their estimated total number of owners. You use these tools—`get_all`, `get_app_details`, `get_genre`, `get_tag`, `get_top_100_forever`, `get_top_100_in_2_weeks`, and `get_top_100_owned`—to build a complete picture. Your agent reads the data, tracks player behavior patterns across genres or community tags, and gives you hard metrics on market saturation or niche gaps. You don't leave your client; your AI agent does all the heavy lifting right where you are. ## Tools ### get_all Fetches all game records and their owner data, limited to 1,000 entries per page. ### get_app_details Retrieves detailed statistics for a specific Steam application using its unique AppID. ### get_genre Finds and lists all games within an exact specified genre (e.g., 'Action', 'Puzzle'). ### get_tag Lists games associated with a specific community tag that users can apply to titles. ### get_top_100_forever Gets the Top 100 most popular games ranked by cumulative player activity since March 2009. ### get_top_100_in_2_weeks Gathers a list of the top 100 trending games based on recent player activity in the last two weeks. ### get_top_100_owned Ranks and retrieves the Top 100 titles by their estimated total number of owners. ## Prompt Examples **Prompt:** ``` Show me the statistics for Counter-Strike: Global Offensive (AppID 730). ``` **Response:** ``` I've retrieved the data for CS:GO (AppID 730). It has an estimated 100,000,000+ owners, with an average playtime of over 30,000 minutes per user. The current price is listed as 0 (Free to Play). ``` **Prompt:** ``` What are the top 100 games by player count in the last two weeks? ``` **Response:** ``` Fetching the trending titles... The top games by recent activity include 'Counter-Strike 2', 'Dota 2', and 'PUBG: BATTLEGROUNDS'. Would you like to see the full list or details for a specific one? ``` **Prompt:** ``` List the most popular games with the 'RPG' tag. ``` **Response:** ``` Searching for top-rated RPGs... I found several highly-owned titles with the 'RPG' tag, including 'Baldur's Gate 3', 'The Witcher 3: Wild Hunt', and 'Elden Ring'. ``` ## Capabilities ### Get all games data Retrieves a large batch of game records, providing owner metrics for up to 1,000 entries per page. ### Look up specific app details Fetches precise statistics—including ownership and playtime estimates—using the unique AppID number of a Steam title. ### Filter by game genre Queries the catalog to list all games that match one or more specified genres (e.g., RPG, Strategy). ### Filter by community tag Retrieves a list of games associated with a specific community-defined tag (e.g., 'Coop', 'Survival'). ### Find top 100 forever titles Generates a ranked list of the Top 100 most popular games based on player activity since March 2009. ### Find top 100 in two weeks Ranks and lists the Top 100 games that have seen the highest number of players join or play within the last 14 days. ### Find top 100 owned titles Identifies the Top 100 games based purely on the total number of owners estimated in the Steam database. ## Use Cases ### Analyzing a competitor's core game. A studio lead needs to know if their main rival's flagship title is still relevant. They use `get_app_details` with the AppID, immediately getting stats on owner count and playtime per user. This tells them whether they are competing against an aging favorite or a powerhouse. ### Finding a new niche genre to enter. A product manager wants to avoid saturated markets. They use `get_tag` to list all games with the 'Simulation' tag, then filter that list using `get_genre` for 'Strategy'. This quickly maps out potential under-represented combinations. ### Understanding current player hype. A marketer wants proof of immediate interest. They run the `get_top_100_in_2_weeks` tool, getting a list of titles that are trending right now. This data proves which games need ad spend *today*. ### Validating long-term market potential. A venture capitalist wants to know if the genre 'Survival' has staying power. They combine `get_top_100_forever` (for historical context) with `get_top_100_owned` (for sheer volume), giving a holistic view of market maturity. ## Benefits - Get deep player stats instantly. Using `get_app_details` allows you to pull owner estimates and average playtime for any specific AppID, so you don't have to manually check Steam. - Find what's hot right now. The `get_top_100_in_2_weeks` tool immediately identifies trending titles, letting you pivot your marketing or development focus without delay. - Benchmark against history. Need proof of longevity? Use `get_top_100_forever` to see which games have maintained player interest since 2009—a true measure of success. - Identify gaps fast. Instead of browsing, use `get_tag` or `get_genre` to filter the entire catalog by niche tags (like 'Roguelike') and pinpoint underserved markets. - See market saturation at scale. The `get_top_100_owned` tool shows you which games have amassed the largest user bases, helping you gauge overall industry size. ## How It Works The bottom line is you ask a question in plain English, and the server executes specialized database calls to give you the hard numbers. 1. You connect your AI client to the SteamSpy MCP Server and provide your API key. 2. Your agent formulates a query, specifying which data dimension you need (e.g., 'Top 100 by owners' or 'details for AppID 730'). 3. The server runs the appropriate tool (`get_top_100_owned`, `get_app_details`, etc.) and returns structured, actionable gaming data to your agent. ## Frequently Asked Questions **How do I get game statistics for a specific title using get_app_details?** You must provide the AppID number of the game when calling `get_app_details`. This returns owner estimates, current price, and average playtime per user. **What is the difference between get_tag and get_genre?** `get_genre` filters by official Steam categories (like 'Strategy'). `get_tag` uses community-defined tags that users can apply to titles, offering a different layer of filtering. **Which tool should I use if I want the most popular games overall?** If you mean historical popularity, use `get_top_100_forever`. If you mean current hype, run `get_top_100_in_2_weeks`. **Can get_all retrieve owner data for every game?** Yes. The `get_all` tool retrieves a large batch of games with their associated owner data, paginated in blocks of 1,000 records. **What do I need to set up before using any tool, like get_app_details?** You must provide a valid SteamSpy API Key when connecting the server. This key is mandatory for all operations and verifies your access credentials with the Vinkius Marketplace. **If I run get_all, how do I retrieve more than 1,000 entries?** The tool returns results in paginated batches of 1,000. To get more data, you need to use the pagination parameter (offset) and iterate through subsequent calls until all desired records are collected. **What should I do if my AppID used in get_app_details returns an error?** If the tool fails, check your input for a typo or verify that the given Steam AppID actually exists. Invalid identifiers will cause the API call to reject the request. **Can I filter top lists, like get_top_100_in_2_weeks, by specific tags?** The tool calls are specialized and usually cannot cross-reference multiple criteria in one go. You first run the desired list (e.g., get_tag) and then manually apply secondary filters to narrow down the results. **Can I get detailed ownership and playtime statistics for a specific game?** Yes! Use the `get_app_details` tool with the Steam AppID. It returns owner estimates, average playtime, median playtime, and price information. **How can I find the most popular games on Steam right now?** You can use the `get_top_100_in_2_weeks` tool to see which games have the most active players over the last 14 days, or `get_top_100_owned` for the most owned games of all time. **Is it possible to browse games by specific categories like 'Indie' or 'Strategy'?** Absolutely. Use the `get_genre` tool for broad categories or the `get_tag` tool for more specific community-defined labels to see top games in those segments.