Get Most Anticipated Games
get_most_anticipated_gamesFetch upcoming video games with high anticipation by retrieving titles sorted by hype count, filtered for future or TBA releases from the IGDB database.
Instructions
Fetch upcoming games sorted by hype count, filtered for future or TBA releases
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fields | No | Comma-separated list of fields to return | id,slug,name,hypes,first_release_date,platforms.name,genres.name,status |
| limit | No | Maximum number of results to return | |
| min_hypes | No | Minimum number of hypes required |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- src/igdb_mcp_server/server.py:222-226 (registration)Registration of the 'get_most_anticipated_games' tool using the @mcp.tool decorator from FastMCP, which defines the tool's name, title, and description.
@mcp.tool( name="get_most_anticipated_games", title="Get Most Anticipated Games", description="Fetch upcoming games sorted by hype count, filtered for future or TBA releases" ) - src/igdb_mcp_server/server.py:227-269 (handler)The core handler function implementing the tool logic: retrieves IGDB client, builds an Apicalypse query to filter games by minimum hypes, future release dates or TBA status, sorts by hypes descending, and executes the API request.
async def get_most_anticipated_games( ctx: Context, fields: Annotated[ str, Field(description="Comma-separated list of fields to return"), ] = "id,slug,name,hypes,first_release_date,platforms.name,genres.name,status", limit: Annotated[ int, Field(description="Maximum number of results to return", ge=1, le=500) ] = 25, min_hypes: Annotated[ int, Field(description="Minimum number of hypes required", ge=0) ] = 25, ) -> List[Dict[str, Any]]: """ Get the most anticipated upcoming games based on hype count. Automatically filters for future or TBA releases. Args: ctx: Context for accessing session configuration fields: Comma-separated list of fields to return limit: Maximum number of results to return (default: 25, max: 500) min_hypes: Minimum number of hypes required (default: 25) Returns: List of most anticipated games sorted by hype count """ igdb_client = get_igdb_client(ctx) # Get current timestamp current_timestamp = int(time.time()) # Build query: games with hypes that are either future releases or TBA query = ( f"fields {fields}; " f"where hypes >= {min_hypes} & " f"(status = null | status != 0) & " f"(first_release_date > {current_timestamp} | first_release_date = null); " f"sort hypes desc; " f"limit {limit};" ) return await igdb_client.make_request("games", query)