# BoardGameGeek

BGG MCP provides access to BoardGameGeek and a variety of board game related data through the Model Context Protocol. Enabling retrieval and filtering of board game data, user collections, and profil…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add kkjdaniel/bgg-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list kkjdaniel/bgg-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get kkjdaniel/bgg-mcp bgg-collection

# Call a tool
npx -y @smithery/cli@latest tool call kkjdaniel/bgg-mcp bgg-collection '{}'
```

## Direct MCP Connection

Endpoint: `https://bgg-mcp--kkjdaniel.run.tools`

**Optional config:**
- `BGG_COOKIE` (query) — Cookie string for BGG authentication. Only needed if not using API key
- `BGG_API_KEY` (query) — API key from BoardGameGeek for authentication. Get one at https://boardgamegeek.com/applications
- `BGG_USERNAME` (query) — Your BGG username for personalized features

## Tools (10)

- `bgg-collection` — Find the details about a specific users board game collection on BoardGameGeek (BGG)
- `bgg-details` — Find the details about a specific board game on BoardGameGeek (BGG)
- `bgg-hot` — Find the current board game hotness on BoardGameGeek (BGG)
- `bgg-price` — Get current prices for board games from multiple retailers using BGG IDs
- `bgg-recommender` — Get game recommendations based on a specific game using either the BoardGameGeek (BGG) ID or name directly. ID is prefe…
- `bgg-rules` — Use this tool when users ask rules questions about board games (e.g., 'How does X work?', 'Can I do Y?', 'What happens …
- `bgg-search` — Search for board games on BoardGameGeek (BGG) by name or part of a name using a broad search (e.g., 'Catan', 'Ticket to…
- `bgg-thread-details` — Get full content of a specific BoardGameGeek forum thread, including all posts and replies. Use this after finding rele…
- `bgg-trade-finder` — Find what games user1 owns that user2 has on their wishlist. Shows potential trading opportunities.
- `bgg-user` — Find details about a specific user on BoardGameGeek (BGG)

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get kkjdaniel/bgg-mcp <tool-name>
```

## Resources

- `bgg://hotness` — The current list of hot board games on BoardGameGeek, updated regularly by the BGG community
- `bgg://my-collection` — Your BoardGameGeek collection (user: fiiish). Shows all owned games with their ratings, play counts, and status.

## Prompts (2)

- `game-recommendations` (username, currency, destination) — Get personalized board game recommendations based on your BGG collection and preferences
- `trade-sales-post` (username, currency, destination) — Generate a sales post for your BGG 'for trade' collection with discounted prices

---

Source: https://github.com/kkjdaniel/bgg-mcp