# kkjdaniel-bgg-mcp

Connects an AI assistant to BoardGameGeek for game details, collections, pricing, recommendations, and rules discussions.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 55
- Author: kkjdaniel
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/kkjdaniel/bgg-mcp
- Updated: 2026-10-15
- HTML: https://affpapa.org/en/nevibecode/mcp/kkjdaniel-bgg-mcp

## What it does

This MCP server lets an assistant query BoardGameGeek. `bgg-search` finds games with filters for base games or expansions, while `bgg-details` can return ratings, player-count information, editions, and comments. Other tools cover user profiles and collections, the current hotness list, and forum threads.

For prices, `bgg-price` uses BGG IDs and data from BoardGamePrices.co.uk. Recommendations come from Recommend.Games. `bgg-rules` searches a game's rules forum for relevant discussions; `bgg-thread-details` retrieves a chosen thread's posts. Prices and recommendations rely on those external services.

The server also exposes resources for games, collections, hotness, and forum threads, plus prompts for game suggestions, rules questions, and sale posts. The personal collection resource appears when `BGG_USERNAME` is set, so configure that variable if you want the assistant to access your own collection.

## Requirements
- Remote server: `https://server.smithery.ai/@kkjdaniel/bgg-mcp/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http kkjdaniel-bgg-mcp https://server.smithery.ai/@kkjdaniel/bgg-mcp/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add kkjdaniel-bgg-mcp --url https://server.smithery.ai/@kkjdaniel/bgg-mcp/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "kkjdaniel-bgg-mcp": {
            "url": "https://server.smithery.ai/@kkjdaniel/bgg-mcp/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "kkjdaniel-bgg-mcp": {
            "type": "http",
            "url": "https://server.smithery.ai/@kkjdaniel/bgg-mcp/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http kkjdaniel-bgg-mcp https://server.smithery.ai/@kkjdaniel/bgg-mcp/mcp
```

## When to use it
- look up a board game and its expansions
- check a game's BGG rating and player-count information
- filter a user's collection by ratings or plays
- compare game prices using BGG IDs
- find similar games or relevant rules discussions

## Example prompts
- Search BoardGameGeek for Wingspan and show its expansions.
- List games rated 9 or higher in kkjdaniel's collection.
- Compare prices for Wingspan and Ark Nova, then suggest games similar to Azul.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74559
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
