Bielacki Igdb Server

Access the IGDB (Internet Game Database) API through Model Context Protocol (MCP)

smithery badge Python MCP FastMCP uv License: MIT IGDB API

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

Quick Start

Get IGDB Credentials

1. Create a Twitch account (if you don't have one)
2. Go to Twitch Developer Console → Register Your Application
3. Get your Client ID and generate a Client Secret

📖 Full IGDB authentication guide

Option A: install via Smithery

To install igdb-mcp-server automatically via Smithery:

npx -y @smithery/cli install @bielacki/igdb-mcp-server

Option B: install with uvx

Install uv.

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	• query (required): Search term • fields: Fields to return (default: basic info) • limit: Results count (1-500, default: 10)	"Search for Elden Ring games"
get_game_details	Get comprehensive game information	• game_id (required): IGDB game ID • fields: Fields to return (default: extensive)	"Get details for game ID 1942"
get_most_anticipated_games	Find upcoming games by hype	• fields: Fields to return • limit: Results count (1-500, default: 25) • min_hypes: Min hype count (default: 25)	"Show most anticipated games"
custom_query	Execute Apicalypse queries	• endpoint (required): API endpoint • query (required): Apicalypse query string	"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:

• IGDB API by IGDB.com
• MCP protocol by Anthropic
• Built with FastMCP
• Published on Smithery

---

For more information about IGDB API capabilities, visit the official IGDB API documentation.