Skip to main content

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

Metadata

Release files for igdb-mcp-client 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for igdb-mcp-client 0.1.1
File Size Uploaded Provenance Actions
igdb_mcp_client-0.1.1.tar.gz 35.7 kB Without provenance Details for igdb_mcp_client-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for igdb-mcp-client 0.1.1
File Interpreter ABI Platform Actions
igdb_mcp_client-0.1.1-py3-none-any.whl Python 3 none any Details for igdb_mcp_client-0.1.1-py3-none-any.whl

Total release size: 43.4 kB

Release files / igdb_mcp_client-0.1.1.tar.gz

Download URL igdb_mcp_client-0.1.1.tar.gz
Size 35.7 kB
Tags Source
SHA-256 checksum
How to use checksums
e9598c0eeb7190a482b865763e6e2c7003583f88ac9266fb6562559c6220f063
BLAKE2b-256 checksum
How to use checksums
3068be1afea616bc126ed04fad7fc6b53ef19e5a57b331822c177165263e7f52
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.13

Release files / igdb_mcp_client-0.1.1-py3-none-any.whl

Download URL igdb_mcp_client-0.1.1-py3-none-any.whl
Size 7.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5b318152fc746c149601d1d48b90b6ea814c5af5fe854439ecc8ce55f6ff32fd
BLAKE2b-256 checksum
How to use checksums
923d11aaffff915ec8bb20bf2396182f1d0e5a1816baba4d98a9a537e1ba9a4b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.13

Security for igdb-mcp-client 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page