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.
| Tool | Purpose |
|---|---|
search_games | Search the unified GameDiscoverCo catalog across Steam, Xbox, PlayStation, and Nintendo Switch. Use this for cross-platform or console questions. |
search_steam_games | Search Steam-specific catalog data with Steam-only filters, including reviews, wishlists, CCU, tags, price, and Steam metadata. |
get_game_history | Retrieve 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_games | Find player/wishlister affinity on Steam, or played-game audience overlap on Xbox and PlayStation. |
get_hype_chart | Rank unreleased Steam games releasing within 7 or 30 days by hype score. |
get_trending_chart | Find recently released Steam games with momentum. |
get_post_release_chart | Compare recently released Steam games' post-launch performance. |
get_tag_ranking_chart | Rank tags/genres by hype score for a date, or retrieve one tag's history over a date range. |
get_catalogs | Fetch Steam genres, tags, categories, and content descriptors. |
get_review_sentiment | Get AI-extracted likes, dislikes, discussion topics, and phrases from Steam reviews. Defaults to JSON. |
get_publisher_stats | Benchmark publisher/developer portfolios by game count, estimated revenue, and players. |
get_tag_stats | Analyze market sizing and performance by tag or genre. |
get_active_users_rankings | Rank estimated DAU or MAU across platforms combined, or for Steam, Xbox, or PlayStation. |
get_steam_recommendations | Inspect Steam's “More Like This” recommendations in forward or reverse direction; distinct from audience affinity. |
get_regional_breakdown | Get country or region shares for followers, owners, or wishlisters, rather than a sales-by-country report. |
get_game_platforms | Compare per-platform metrics and availability for one game across Steam, Xbox, PlayStation, and Switch. |
get_platform_history | Retrieve cross-platform history for players, DAU/MAU/WAU, revenue, and subscription splits. Supports multiple games and release-relative dates. |
get_review_languages | Analyze the language mix of reviews for a game. |
get_supported_languages | Get Steam interface, audio, and subtitle support for one game, or aggregate language support counts across Steam games. |
get_wishlist_quality | Analyze quality and composition of Steam wishlist demand. |
get_subscriptions | Query current, former, or announced Xbox Game Pass, Games with Gold, and PlayStation Plus entries, with dates and tiers. |
get_release_heatmap | Compare 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_affinity | Find audience affinity within or across publisher/developer portfolios on Steam, or played-game overlap on Xbox and PlayStation. |
get_game_fan_snapshot | Get survey demographics, discovery methods, and device usage for owners and wishlisters of a Steam game; optionally filter owners by playtime. |
get_fan_snapshot_totals | Get the global baseline for all fan snapshot survey participants. |
Steam Trends
| Tool | Purpose |
|---|---|
list_trends | Find Trends by name, category, or tags; rank by momentum, size, or upcoming games. |
get_trend | Get a Trend's metrics, related Trends, any successors, and a filtered, ranked page of member games. |
list_trend_categories | List categories and their Trend counts; use a returned category slug with list_trends. |
get_game_trends | Get 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
| Tool | Purpose |
|---|---|
search_streaming_games | Resolve a game name to a Twitch gameId, with Steam and IGDB mappings when available. Non-game categories are excluded unless requested. |
search_streaming_channels | Resolve a Twitch channel display-name prefix to a channelId. Login-only lookup is not supported. |
find_streamers_for_games | Find 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_games | Rank a channel's games by hours watched, with share of channel, stream hours, viewer metrics, and active days. |
get_channel_streaming_activity | Get 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_stats | Get 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_streamers | Rank 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
| Tool | Purpose |
|---|---|
search_steam_demos | Discover 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_demos | List every tracked demo attached to a parentAppid, including inactive and post-release demos. |
get_steam_demo_details | Get catalog, availability, parent-game, and CCU details for a demo or its parent game's appid. |
get_steam_demo_ccu_history | Get positive hourly CCU observations or daily peaks for a demo, using its own or its parent's appid. |
get_game_dlcs | List and rank DLC and soundtracks attached to a parentAppid, with release-date, name, and free-status filters. |
search_steam_dlcs | Discover DLC and soundtracks across parent games; rank by estimated revenue (default), copies, wishlists, attach rate, or other supported fields. |
get_steam_dlc_details | Get 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
appidvalues identify the demo or add-on itself;parentAppididentifies its base Steam game. DLC details require the add-on ID. - Twitch tools use separate string
gameIdandchannelIdidentifiers; do not substitute agdcoIdor 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.