Skip to main content

Tool Reference

All public GameDiscoverCo MCP tools are read-only. Every user admitted to the MCP server receives the same tool registry; data availability can vary.

The MCP server returns compact tabular data by default when appropriate. Many tools also support JSON output through a format argument.

ToolPurpose
search_gamesSearch the unified GameDiscoverCo catalog across Steam, Xbox, PlayStation, and Nintendo Switch. Use this for cross-platform or console questions.
search_steam_gamesSearch Steam-specific catalog data with Steam-only filters, including reviews, wishlists, CCU, tags, price, and Steam metadata.
get_game_historyRetrieve Steam time series for sales/revenue/wishlists, reviews, hourly CCU, followers, price, active users, pre-release hype, and recommendation counts. Supports multiple games and release-relative dates.
get_related_gamesFind player/wishlister affinity on Steam, or played-game audience overlap on Xbox and PlayStation.
get_hype_chartRank unreleased Steam games releasing within 7 or 30 days by hype score.
get_trending_chartFind recently released Steam games with momentum.
get_post_release_chartCompare recently released Steam games' post-launch performance.
get_tag_ranking_chartRank tags/genres by hype score for a date, or retrieve one tag's history over a date range.
get_catalogsFetch Steam genres, tags, categories, and content descriptors.
get_review_sentimentGet AI-extracted likes, dislikes, discussion topics, and phrases from Steam reviews. Defaults to JSON.
get_publisher_statsBenchmark publisher/developer portfolios by game count, estimated revenue, and players.
get_tag_statsAnalyze market sizing and performance by tag or genre.
get_active_users_rankingsRank estimated DAU or MAU across platforms combined, or for Steam, Xbox, or PlayStation.
get_steam_recommendationsInspect Steam's “More Like This” recommendations in forward or reverse direction; distinct from audience affinity.
get_regional_breakdownGet country or region shares for followers, owners, or wishlisters, rather than a sales-by-country report.
get_game_platformsCompare per-platform metrics and availability for one game across Steam, Xbox, PlayStation, and Switch.
get_platform_historyRetrieve cross-platform history for players, DAU/MAU/WAU, revenue, and subscription splits. Supports multiple games and release-relative dates.
get_review_languagesAnalyze the language mix of reviews for a game.
get_supported_languagesGet Steam interface, audio, and subtitle support for one game, or aggregate language support counts across Steam games.
get_wishlist_qualityAnalyze quality and composition of Steam wishlist demand.
get_subscriptionsQuery current, former, or announced Xbox Game Pass, Games with Gold, and PlayStation Plus entries, with dates and tiers.
get_release_heatmapCompare weekly Steam release competition using cumulative hype, sales, and highly hyped games, roughly 12 months back and ahead. Quarter-only dates cluster at quarter end.
get_partner_affinityFind audience affinity within or across publisher/developer portfolios on Steam, or played-game overlap on Xbox and PlayStation.
get_game_fan_snapshotGet survey demographics, discovery methods, and device usage for owners and wishlisters of a Steam game; optionally filter owners by playtime.
get_fan_snapshot_totalsGet the global baseline for all fan snapshot survey participants.
ToolPurpose
list_trendsFind Trends by name, category, or tags; rank by momentum, size, or upcoming games.
get_trendGet a Trend's metrics, related Trends, any successors, and a filtered, ranked page of member games.
list_trend_categoriesList categories and their Trend counts; use a returned category slug with list_trends.
get_game_trendsGet a Steam game's Trend memberships, categories, ranks, and whether it started each Trend.

Trends are detected clusters of related Steam games. Start with list_trends or get_game_trends, then pass a returned slug to get_trend. Use member appids with other Steam or Twitch tools; not every member has a Twitch mapping.

Discovery defaults to view: "browse" and mature: "exclude". Views also include "new", "hot", "rising", "upcoming", and "biggest". Use q for search, category for a category slug, and include/exclude for characteristic tags. order: "rising"/"cooling" controls the rising view; size: "strongest"/"notable"/"hitRate"/"revenue"/"wishlists"/"games" controls browse/biggest ranking. from (YYYY-MM) includes Trends detected in that month or earlier, not metrics from that period. Category counts and game memberships include mature Trends even when discovery excludes them.

get_trend accepts member-name search through q, release: "all"/"released"/"upcoming", orderBy: "appid"/"revenue"/"wishlists"/"releaseDate", and direction: "asc"/"desc". Defaults are all releases and appid ascending. Filters and ordering apply before paging. Nulls come last; equal values are ordered by appid ascending. Older slugs may resolve to a current or retired Trend.

All four tools use limit (default 20, maximum 100), offset (default 0), total, and hasMore. On get_trend, these describe member games, not Trends. Advance the offset by the returned row count while hasMore is true. Output defaults to TSV; format: "json" includes the same metadata and pagination. See data notes for coverage and estimates.

Twitch​

ToolPurpose
search_streaming_gamesResolve a game name to a Twitch gameId, with Steam and IGDB mappings when available. Non-game categories are excluded unless requested.
search_streaming_channelsResolve a Twitch channel display-name prefix to a channelId. Login-only lookup is not supported.
find_streamers_for_gamesFind channels that played all (default) or any of 1–25 games in a date range; filter by known follower counts or minimum hours watched.
get_channel_streaming_gamesRank a channel's games by hours watched, with share of channel, stream hours, viewer metrics, and active days.
get_channel_streaming_activityGet daily channel activity for a date range, optionally filtered to one game, including that channel's share of the game's watched hours.
get_game_streaming_statsGet a game's hours watched, channel counts, and available viewer metrics as a range summary or daily, weekly, monthly, or yearly series.
get_game_top_streamersRank one game's channels, with hours watched, share of game, viewer coverage, and recent top games.

Use gameId or steamAppid, not both, for single-game Twitch queries. Channel activity can omit both to include all games. Multi-game discovery uses gameIds or steamAppids, not both. Steam mappings are not guaranteed; resolve names with the streaming search tools if a mapping is unavailable. channelId is a string returned by channel search, not a channel name or URL.

Explicit startDate/endDate pairs are inclusive UTC YYYY-MM-DD dates, at most 366 days. Streamer discovery, channel activity, and game statistics require both. For game statistics, granularity defaults to summary; use daily for partial calendar periods. weekly requires Monday–Sunday boundaries, monthly full months, and yearly full years. includeChannelCount (default true) and includeAllTimePeak (default false) apply to summaries only.

For channel games, choose at most one range mode: allTime: true, windowDays of 7, 30, 90, or 365, or a date pair. Omitting all modes uses a 90-day window. For top streamers, choose window of "7", "30" (default), "365", or "all_time", or a date pair. Follower and minimum-hours-watched filters on top streamers require a date pair, not a preset window.

Streaming tools paginate with limit and an opaque cursor: pass the returned nextCursor unchanged while hasMore is true. Searches and streamer/channel-game rankings allow up to 50 rows per call; channel activity and game-statistics series allow up to 100. See data notes before interpreting viewer metrics or shares.

Steam Demos, DLC, And Soundtracks​

ToolPurpose
search_steam_demosDiscover and rank tracked standalone demos by current, 24-hour peak, all-time peak, or date-window peak CCU; filter by demo or parent release dates and metadata.
get_game_demosList every tracked demo attached to a parentAppid, including inactive and post-release demos.
get_steam_demo_detailsGet catalog, availability, parent-game, and CCU details for a demo or its parent game's appid.
get_steam_demo_ccu_historyGet positive hourly CCU observations or daily peaks for a demo, using its own or its parent's appid.
get_game_dlcsList and rank DLC and soundtracks attached to a parentAppid, with release-date, name, and free-status filters.
search_steam_dlcsDiscover DLC and soundtracks across parent games; rank by estimated revenue (default), copies, wishlists, attach rate, or other supported fields.
get_steam_dlc_detailsGet catalog and estimated commercial metrics for a DLC/soundtrack appid, with optional bounded daily history.

For “top demos last week,” make one search_steam_demos call with ccuStartDate, ccuEndDate, and limit. The dates select window-peak ranking automatically: inclusive UTC dates, at most 90 days, positive observations only. Do not add isActive unless the question is about demos active now. Ordinary demo discovery defaults to pre-release parent games and positive CCU (phase: "prerelease", scope: "top", metric: "current"). Parent-scoped queries default to all phases and all tracked demos; historical-window ranking defaults to all phases but cannot use scope: "all".

Demo CCU history requires startDate and endDate (inclusive UTC, at most 90 days). granularity is day (default, daily peaks) or hour. Parent IDs resolve to one canonical tracked demo; use the parent catalog to enumerate demos and then supply each demo ID when comparing multiple demos.

Demo/DLC catalog lists use limit (default 20, maximum 100) and offset. Demo history uses limit (default 90, maximum 500) and offset. Follow hasMore with the next offset to retrieve remaining rows. These are not streaming cursors.

DLC details return history only when fields includes history. Use historyStartDate/historyEndDate (YYYY-MM-DD) and historyLimit (default 90, maximum 365 daily points) to bound it. Catalog release-date filters describe release dates, not the period over which revenue was earned. See data notes for units and coverage limits.

Identifiers​

  • Steam games use appid, Steam's application ID.
  • Cross-platform games use gdcoId, GameDiscoverCo's unified game identifier across supported platforms.
  • Demo and DLC appid values identify the demo or add-on itself; parentAppid identifies its base Steam game. DLC details require the add-on ID.
  • Twitch tools use separate string gameId and channelId identifiers; do not substitute a gdcoId or a Steam ID in those fields.

Your MCP client usually chooses tools automatically. If you are testing the MCP server, ask a direct question like "search for Balatro" or "show trending Steam games" instead of calling a tool by name.