Igdb Mcp Server

IGDB MCP Server

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

[](https://smithery.ai/server/@bielacki/igdb-mcp-server) [](https://www.python.org/downloads/) [](https://modelcontextprotocol.io) [](https://github.com/jlowin/fastmcp) [](https://github.com/astral-sh/uv) [](https://opensource.org/licenses/MIT) [](https://api-docs.igdb.com)

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 | |------|-------------|------------|---------------| | searchgames | 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" | | getgamedetails | Get comprehensive game information | • game_id (required): IGDB game ID• fields: Fields to return (default: extensive) | "Get details for game ID 1942" | | getmostanticipatedgames | 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 | |--------|-------------|----------| | searchgame | Formatted game search results | Quick game discovery with clean output | | gamedetails | Comprehensive game information | Full details including ratings, platforms, developers | | most_anticipated | Trending upcoming games | Discover hyped unreleased games with statistics |

Troubleshooting

Authentication Errors

• "IGDBCLIENTID 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](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.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: bielacki
• Source: bielacki/igdb-mcp-server
• License: MIT

Install and usage instructions live in the source repository linked above.