kkjdaniel/bgg-mcp

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
Tools
| Tool | Description |
| -------------------- | --------------------------------------------------------------------------------------- |
| bgg-search | Search for board games with type filtering (base games, expansions, or all) |
| bgg-details | Get game details, including best player counts, rank, and optional marketplace listings, editions and user comments |
| bgg-collection | Query and filter a user's collection, with their ratings, BGG ratings, rank and plays |
| 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-rules | Answer rules questions by finding the most relevant threads in a game's BGG rules forum |
| bgg-thread-details | Get the full content of a specific BGG forum thread including all posts |
> [!NOTE]
> Results link back to their pages on boardgamegeek.com, and the assistant is asked to include those links in its answers.
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 (only listed when BGG_USERNAME is set) |
| BGG User Collection | bgg://collection/{username} | The owned games in any BGG user's collection |
| BGG Game | bgg://game/{id} | Essential information about a game by its BGG ID |
| BGG Forum Thread | bgg://thread/{id} | A BGG forum thread by its ID, with every post as plain text |
Prompts
BGG MCP includes pre-configured prompts for common workflows:
| Prompt | Arguments | Description |
| ---------------------- | ------------------------------------------------------------ | ---------------------------------------------------------------------------------------- |
| trade-sales-post | username, currency, destination, discount, platform | Generate a sales post for your BGG 'for trade' collection, discounted from retail prices |
| game-recommendations | username, currency, destination | Get personalized game recommendations based on your BGG collection and preferences |
| rules-question | game, question | Answer a rules question from the game's BGG rules forum |
username is optional on both prompts when BGG_USERNAME is set.
Example Prompts
Here are some example prompts you can use to interact with the BGG MCP tools:
🔍 Search
📊 Game Details
📚 Collection
🔥 Hotness
👤 User Profile
💰 Prices
🎯 Recommendations
📖 Rules
> [!TIP]
> Assistants often answer rules questions from memory. Mention BGG and make it clear you mean a board game so the rules forum gets searched, or use the rules-question prompt.