Skip to main content
Glama

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

Related MCP server: boardgames

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

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:


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

Available Tools

4 tools
custom_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

    B3.4/5.0

    Scored across 4 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count3/5

    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.

    Completeness3/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides 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.
      3
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables users to search and retrieve board game data via the Board Game Atlas API, including game details, ratings, and availability.
      3 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to search and retrieve video game information from the IGDB catalog, including games, platforms, companies, release dates, ratings, and cover art.
      85 npm
      2
      MIT