Bielacki Igdb Mcp Server

IGDB MCP Server

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

[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

Prerequisites

• uv installed
• MCP-compatible client (Claude Desktop, Cursor, Copilot, or others)

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

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

Resources

Pre-built Prompts

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

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