IGDB MCP Server
This server provides access to the IGDB video game database through MCP tools, enabling game searches, detailed lookups, trending discovery, and custom Apicalypse queries.
Search games by name with configurable fields and result limits (up to 500).
Get detailed game info by IGDB ID, including ratings, platforms, genres, developers/publishers, summary, and cover art.
Find most anticipated games filtered for future/TBA releases and sorted by hype count.
Run custom Apicalypse queries against any IGDB endpoint (games, companies, platforms, people, characters).
Browse reference resources for available IGDB endpoints and query syntax.
Use pre-built prompts for quick game searches, full game details, and trending upcoming titles.
Provides access to the Internet Game Database (IGDB) API for searching games, retrieving detailed game information including metadata, ratings, platforms, developers, publishers, genres, and discovering trending or most anticipated games through the Apicalypse query language.
Uses Twitch Developer credentials for OAuth authentication to access the IGDB API, with automatic token caching and refresh management.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@IGDB MCP Server search for Elden Ring and its expansions"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
IGDB MCP Server
Access the IGDB (Internet Game Database) API through Model Context Protocol (MCP)
Overview
The IGDB MCP Server provides seamless access to the Internet Game Database (IGDB) through the Model Context Protocol. IGDB is a comprehensive database containing information about video games, including:
Game metadata (titles, descriptions, ratings)
Release dates and platforms
Developer and publisher information
Genres, themes, and game modes
User ratings and hype metrics
Cover art and media
Key Features
Full IGDB API Access: Search games, get detailed information, find trending titles
Smart Caching: OAuth tokens are cached to minimize authentication overhead
Flexible Queries: Use simple searches or advanced Apicalypse query language
Pre-built Prompts: Common queries ready to use
Type-Safe: Built with Pydantic for robust data validation
Related MCP server: boardgames
Quick Start
Prerequisites
uv installed
MCP-compatible client (Claude Desktop, Cursor, Copilot, or others)
Get IGDB Credentials
Create a Twitch account (if you don't have one)
Go to Twitch Developer Console β Register Your Application
Get your Client ID and generate a Client Secret
π Full IGDB authentication guide
Configure Your MCP Client
Add this to your MCP client's configuration:
{
"mcpServers": {
"igdb-mcp": {
"command": "uvx",
"args": ["--from", "git+https://github.com/bielacki/igdb-mcp-server.git", "igdb-mcp-server"],
"env": {
"IGDB_CLIENT_ID": "your_client_id",
"IGDB_CLIENT_SECRET": "your_secret"
}
}
}
}Start Exploring
Start exploring with these example prompts:
π Search & Discovery
"Search for Elden Ring and its expansions"
"Find all Persona games from the last 5 years"
"Show me games similar to Hades"
π Game Information
"Get details about Baldur's Gate 3"
"Tell me everything about Cyberpunk 2077 including DLC"
"What platforms is Hogwarts Legacy available on?"
π₯ Trending & Popular
"What are the most anticipated upcoming games?"
"Show me the highest rated indie games of 2024"
"Find games with the most hype right now"
π― Advanced Queries
"Find games similar to Skyrim with a rating of 85 or higher"
"List all games by Larian Studios"
"Show upcoming Silent Hill and Resident Evil games"
Core Components
Tools
Tool | Description | Parameters | Example Usage |
search_games | Search for games by name | β’ | "Search for Elden Ring games" |
get_game_details | Get comprehensive game information | β’ | "Get details for game ID 1942" |
get_most_anticipated_games | Find upcoming games by hype | β’ | "Show most anticipated games" |
custom_query | Execute Apicalypse queries | β’ | "Find RPGs rated above 90" |
Resources
Resource | Description | Returns |
igdb://endpoints | List of all IGDB API endpoints | Available endpoints with descriptions |
igdb://query-syntax | Apicalypse query language guide | Syntax reference and examples |
Pre-built Prompts
Prompt | Description | Use Case |
search_game | Formatted game search results | Quick game discovery with clean output |
game_details | Comprehensive game information | Full details including ratings, platforms, developers |
most_anticipated | Trending upcoming games | Discover hyped unreleased games with statistics |
Troubleshooting
Authentication Errors
"IGDB_CLIENT_ID not set": Check your MCP client config has the env variables
"Invalid credentials": Verify your Client ID and Secret are correct
"Token expired": The server handles token refresh automatically
Rate Limiting
IGDB allows 4 requests per second. The server doesn't implement rate limiting, so:
Avoid rapid repeated queries
Use field expansion instead of multiple requests
Leverage multi-query for batch operations
Common Query Issues
No results: Check spelling, try broader search terms
Missing fields: Some fields may be null; handle gracefully
Query syntax error: Verify Apicalypse syntax, check semicolons
Environment Variables
Ensure your MCP client config includes:
"env": {
"IGDB_CLIENT_ID": "abc123...",
"IGDB_CLIENT_SECRET": "xyz789..."
}License & Credits
MIT License - see LICENSE file for details
Credits:
For more information about IGDB API capabilities, visit the official IGDB API documentation.
Available Tools
4 toolscustom_queryCustom IGDB QueryBInspect
Run a custom Apicalypse query against any IGDB API endpoint
Inputs: query (required), endpoint (required). Returns: result
get_game_detailsGet Game DetailsBInspect
Retrieve detailed information about a specific game from IGDB
Inputs: game_id (required), fields. Returns: object
get_most_anticipated_gamesGet Most Anticipated GamesBInspect
Fetch upcoming games sorted by hype count, filtered for future or TBA releases
Inputs: limit, fields, min_hypes. Returns: result
search_gamesSearch GamesBInspect
Search for games in the IGDB database
Inputs: query (required), limit, fields. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: custom_query is for raw API queries, get_game_details retrieves specific game info, get_most_anticipated_games fetches upcoming games by hype, and search_games performs general searches. There is no overlap in functionality, making tool selection straightforward for an agent.
All tool names follow a consistent verb_noun pattern (e.g., custom_query, get_game_details, get_most_anticipated_games, search_games). The naming is uniform and predictable, using snake_case throughout with clear action descriptors.
With only 4 tools, the server feels slightly thin for interacting with a comprehensive database like IGDB. While the tools cover key operations, more specialized functions (e.g., filtering by genre, platform, or date) might be missing, making the count borderline for the domain's scope.
The tools provide basic search and retrieval capabilities but lack full CRUD/lifecycle coverage typical of a database API. There are notable gaps, such as no update or delete operations (though IGDB might be read-only), and limited filtering options beyond hype-based sorting, which could hinder complex agent workflows.
Maintenance
Related MCP Connectors
IGDB β the Internet Game Database (Twitch/Amazon), the reference catalogue for video games.
Search a video game catalog and manage your own collection, imports and recommendation lists.
Unofficial RAWG MCP β wraps the RAWG video games database API (rawg.io)
Videogames MCP β wraps Free-to-Play Games API (freetogame.com, free, no auth)
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides direct access to the RAWG gaming database, allowing users to search for games, retrieve detailed metadata, and explore genres within Claude. It streamlines game research by offering information on ratings, platforms, and release dates through natural language queries.3MIT
- AlicenseNot gradedqualityCmaintenanceEnables users to search and retrieve board game data via the Board Game Atlas API, including game details, ratings, and availability.3 npmMIT
- AlicenseAqualityDmaintenanceProvides comprehensive video game metadata and assets from Steam, SteamGridDB, and ScreenScraper, enabling game search, details, DLCs, reviews, player counts, and visual assets.1618 npm3MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to search and retrieve video game information from the IGDB catalog, including games, platforms, companies, release dates, ratings, and cover art.85 npm2MIT