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

# 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](https://api-docs.igdb.com/# account-creation)

# # 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.