ai.smithery/kkjdaniel-bgg-mcp

Install

Config snippet generator goes here (5 client tabs)

README

<p align="center">
  <img src="images/bgg-mcp-logo.png" width="200" alt="BGG MCP Logo">
</p>
<h1 align="center">BGG MCP: BoardGameGeek MCP Server</h1>

<p align="center">
  <a href="https://archestra.ai/mcp-catalog/kkjdaniel__bgg-mcp"><img src="https://archestra.ai/mcp-catalog/api/badge/quality/kkjdaniel/bgg-mcp" alt="trust score badge"></a>
  <a href="https://github.com/modelcontextprotocol/registry"><img src="https://img.shields.io/badge/MCP_Registry-BGG_MCP-green" alt="MCP Registry"></a>
  <br>
  <a href="https://go.dev/"><img src="https://img.shields.io/github/go-mod/go-version/kkjdaniel/bgg-mcp" alt="Go Version"></a>
  <a href="LICENSE"><img src="https://img.shields.io/github/license/kkjdaniel/bgg-mcp" alt="License"></a>
  <a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP-Protocol-blue" alt="MCP Protocol"></a>
</p>

BGG MCP provides access to the BoardGameGeek API through the [Model Context Protocol](https://www.anthropic.com/news/model-context-protocol), enabling retrieval and filtering of board game data, user collections, and profiles. The server is implemented in Go, using the [GoGeek](https://github.com/kkjdaniel/gogeek) library, which helps ensure robust API interactions.

Price data is provided by [BoardGamePrices.co.uk](https://boardgameprices.co.uk), offering real-time pricing from multiple retailers.

Game recommendations are powered by [Recommend.Games](https://recommend.games/), which provides algorithmic similarity recommendations based on BoardGameGeek data.

<a href="https://boardgamegeek.com/">
  <img src="images/powered-bgg.webp" width="160" alt="Powered by BGG">
</a>

## Demo

<div align="center">
  
  [![Rules Tool Demo Video](https://img.youtube.com/vi/cNX4WwVbFko/maxresdefault.jpg)](https://youtu.be/cNX4WwVbFko)
  
  **[▶️ Watch the Rules Tool Demo Video](https://youtu.be/cNX4WwVbFko)**
  
</div>

## 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