BoardGameGeek

BGG MCP connects to the BoardGameGeek ecosystem to retrieve board game data, user collections, pricing, and recommendations through the Model Context Protocol. Key capabilities include: - Search and filter board games by type (base games, expansions) and retrieve detailed game information - Query user profiles and game collections with advanced filtering options - Access the BoardGameGeek hotness list to discover trending games - Retrieve real-time pricing data from multiple retailers via BoardGamePrices.co.uk - Find trading opportunities between BGG users - Get algorithmic game recommendations based on similarity scores from Recommend.Games - Fetch forum thread content for community discussions

BGG MCP: BoardGameGeek MCP Server

BGG MCP provides access to the BoardGameGeek API through the Model Context Protocol, enabling retrieval and filtering of board game data, user collections, and profiles. The server is implemented in Go, using the GoGeek library, which helps ensure robust API interactions.

Price data is provided by BoardGamePrices.co.uk, offering real-time pricing from multiple retailers.

Game recommendations are powered by Recommend.Games, which provides algorithmic similarity recommendations based on BoardGameGeek data.

Demo

[](https://youtu.be/cNX4WwVbFko) ▶️ Watch the Rules Tool Demo Video

Tools

Core Tools

| Tool | Description | | -------------------- | --------------------------------------------------------------------------- | | bgg-search | Search for board games with type filtering (base games, expansions, or all) | | bgg-details | Get detailed information about a specific board game | | bgg-collection | Query and filter a user's game collection with extensive filtering options | | bgg-hot | Get the current BGG hotness list | | bgg-user | Get user profile information | | bgg-price | Get current prices from multiple retailers using BGG IDs | | bgg-trade-finder | Find trading opportunities between two BGG users | | bgg-recommender | Get game recommendations based on similarity to a specific game | | bgg-thread-details | Get the full content of a specific BGG forum thread including all posts |

🧪 Experimental Tools

| Tool | Description | | ----------- | ------------------------------------------------------------------------------------------ | | bgg-rules | Answer rules questions by searching BGG forums for relevant discussions and clarifications |

Resources

BGG MCP exposes resources that AI assistants can access directly for contextual information:

| Resource | URI | Description | | ------------------- | --------------------- | ---------------------------------------------------------------- | | BGG Hotness | bgg://hotness | Current BGG hotness list, always available | | My BGG Collection | bgg://my-collection | Your personal BGG collection (requires BGG_USERNAME to be set) |

Prompts

BGG MCP includes pre-configured prompts for common workflows:

| Prompt | Description | | ------------------------ | ------------------------------------------------------------------------------------ | | Trade Sales Post | Generate a formatted sales post for your BGG 'for trade' collection with discounted market prices | | Game Recommendations | Get personalized game recommendations based on your BGG collection and preferences |

Example Prompts

Here are some example prompts you can use to interact with the BGG MCP tools:

🔍 Search

"Search for Wingspan on BGG"
"How many expansions does Grand Austria Hotel have?"
"Search for Wingspan expansions only"

📊 Game Details

"Get details for Azul"
"Show me information about game ID 224517"
"What's the BGG rating for Gloomhaven?"

📚 Collection

``` "Show me ZeeGarcia's game collection" "Show games rated 9+ in kkjdaniel's c