{
"markdown": "# IGDB MCP Server\n\nAccess the IGDB (Internet Game Database) API through Model Context Protocol (MCP)\n\n[](https://smithery.ai/server/@bielacki/igdb-mcp-server)\n[](https://www.python.org/downloads/)\n[](https://modelcontextprotocol.io)\n[](https://github.com/jlowin/fastmcp)\n[](https://github.com/astral-sh/uv)\n[](https://opensource.org/licenses/MIT)\n[](https://api-docs.igdb.com)\n\n## Overview\n\nThe 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:\n\n- Game metadata (titles, descriptions, ratings)\n- Release dates and platforms\n- Developer and publisher information\n- Genres, themes, and game modes\n- User ratings and hype metrics\n- Cover art and media\n\n### Key Features\n\n- **Full IGDB API Access**: Search games, get detailed information, find trending titles\n- **Smart Caching**: OAuth tokens are cached to minimize authentication overhead\n- **Flexible Queries**: Use simple searches or advanced Apicalypse query language\n- **Pre-built Prompts**: Common queries ready to use\n- **Type-Safe**: Built with Pydantic for robust data validation\n\n## Quick Start\n\n### Get IGDB Credentials\n1. Create a [Twitch account](https://www.twitch.tv) (if you don't have one)\n2. Go to [Twitch Developer Console](https://dev.twitch.tv/console) ā Register Your Application\n3. Get your **Client ID** and generate a **Client Secret**\n\nš [Full IGDB authentication guide](https://api-docs.igdb.com/#account-creation)\n\n### Option A: install via Smithery\n\nTo install igdb-mcp-server automatically via [Smithery](https://smithery.ai/server/@bielacki/igdb-mcp-server):\n\n```bash\nnpx -y @smithery/cli install @bielacki/igdb-mcp-server\n```\n\n### Option B: install with uvx\n\nInstall [uv](https://github.com/astral-sh/uv).\n\nAdd this to your MCP client's configuration:\n\n```json\n{\n \"mcpServers\": {\n \"igdb-mcp\": {\n \"command\": \"uvx\",\n \"args\": [\"--from\", \"git+https://github.com/bielacki/igdb-mcp-server.git\", \"igdb-mcp-server\"],\n \"env\": {\n \"IGDB_CLIENT_ID\": \"your_client_id\",\n \"IGDB_CLIENT_SECRET\": \"your_secret\"\n }\n }\n }\n}\n```\n\n## Start Exploring\n\nStart exploring with these example prompts:\n\nš **Search & Discovery**\n- \"Search for Elden Ring and its expansions\"\n- \"Find all Persona games from the last 5 years\"\n- \"Show me games similar to Hades\"\n\nš **Game Information**\n- \"Get details about Baldur's Gate 3\"\n- \"Tell me everything about Cyberpunk 2077 including DLC\"\n- \"What platforms is Hogwarts Legacy available on?\"\n\nš„ **Trending & Popular**\n- \"What are the most anticipated upcoming games?\"\n- \"Show me the highest rated indie games of 2024\"\n- \"Find games with the most hype right now\"\n\nšÆ **Advanced Queries**\n- \"Find games similar to Skyrim with a rating of 85 or higher\"\n- \"List all games by Larian Studios\"\n- \"Show upcoming Silent Hill and Resident Evil games\"\n\n## Core Components\n\n### Tools\n\n| Tool | Description | Parameters | Example Usage |\n|------|-------------|------------|---------------|\n| **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\" |\n| **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\" |\n| **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\" |\n| **custom_query** | Execute Apicalypse queries | ā¢ `endpoint` (required): API endpoint
ā¢ `query` (required): Apicalypse query string | \"Find RPGs rated above 90\" |\n\n### Resources\n\n| Resource | Description | Returns |\n|----------|-------------|---------|\n| **igdb://endpoints** | List of all IGDB API endpoints | Available endpoints with descriptions |\n| **igdb://query-syntax** | Apicalypse query language guide | Syntax reference and examples |\n\n### Pre-built Prompts\n\n| Prompt | Description | Use Case |\n|--------|-------------|----------|\n| **search_game** | Formatted game search results | Quick game discovery with clean output |\n| **game_details** | Comprehensive game information | Full details including ratings, platforms, developers |\n| **most_anticipated** | Trending upcoming games | Discover hyped unreleased games with statistics |\n\n## Troubleshooting\n\n### Authentication Errors\n- **\"IGDB_CLIENT_ID not set\"**: Check your MCP client config has the env variables\n- **\"Invalid credentials\"**: Verify your Client ID and Secret are correct\n- **\"Token expired\"**: The server handles token refresh automatically\n\n### Rate Limiting\nIGDB allows 4 requests per second. The server doesn't implement rate limiting, so:\n- Avoid rapid repeated queries\n- Use field expansion instead of multiple requests\n- Leverage multi-query for batch operations\n\n### Common Query Issues\n- **No results**: Check spelling, try broader search terms\n- **Missing fields**: Some fields may be null; handle gracefully\n- **Query syntax error**: Verify Apicalypse syntax, check semicolons\n\n### Environment Variables\nEnsure your MCP client config includes:\n```json\n\"env\": {\n \"IGDB_CLIENT_ID\": \"abc123...\",\n \"IGDB_CLIENT_SECRET\": \"xyz789...\"\n}\n```\n\n## License & Credits\n\n[MIT License](LICENSE) - see LICENSE file for details\n\n\n**Credits**:\n- IGDB API by [IGDB.com](https://www.igdb.com)\n- MCP protocol by Anthropic\n- Built with [FastMCP](https://github.com/jlowin/fastmcp)\n- Published on [Smithery](https://smithery.ai)\n\n---\n\nFor more information about IGDB API capabilities, visit the [official IGDB API documentation](https://api-docs.igdb.com).",
"bytes": 6258,
"sha": "c65914c0e19adcc0f652661e7d8ea8dfbf7b0f5be8208ace7cad97dfcd933391",
"repo_slug": "bielacki/igdb-mcp-server",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/mcp_ai_smithery_bielacki_igdb_mcp_server_ef78fdbb/readme"
}