igdb-mcp-client 0.1.0

STDIO-to-StreamableHTTP bridge for the IGDB MCP Server

igdb-mcp-client

A Python bridge that connects any MCP client to the IGDB MCP Server, giving your AI agent access to game data from the IGDB database.

Handles OAuth 2.0 authentication automatically.

Install

uvx igdb-mcp-client

Or with pip:

pip install igdb-mcp-client

Quick Start

Set your credentials and run:

export CLIENT_ID="your-client-id"
export CLIENT_SECRET="your-client-secret"
igdb-mcp-client

The client connects to https://mcp.igdb.com by default, reads JSON-RPC from stdin, and writes responses to stdout.

Use with your MCP client

Most MCP clients use a JSON config file to register servers. Add igdb-mcp-client as a stdio transport:

{
  "mcpServers": {
    "igdb": {
      "command": "uvx",
      "args": ["igdb-mcp-client"],
      "env": {
        "CLIENT_ID": "your-client-id",
        "CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

This works with Claude Desktop, Cursor, Kiro, Windsurf, and any MCP-compatible client that supports stdio transports.

Once connected, your agent can query the IGDB game database — search games, browse genres, platforms, companies, and more.

Configuration

Environment Variable	Default	Description
CLIENT_ID	(required)	OAuth 2.0 client ID
CLIENT_SECRET	(required)	OAuth 2.0 client secret
MCP_SERVER_URL	https://mcp.igdb.com	Server URL (overridable via CLI arg too)
AUTH_DOMAIN	https://mcp-auth.igdb.com	Auth endpoint base URL
LOG_LEVEL	INFO	Set to DEBUG for HTTP request/response logs

You can also pass the server URL as a CLI argument, which takes highest priority:

igdb-mcp-client https://mcp.igdb.com

Requirements

Python 3.10+

License

MIT