What is Bgg Mcp

BGG MCP is an MCP (Model Context Protocol) server that allows AI tools like Claude to interact with the BoardGameGeek API (XML API2).

Use cases

Use cases include finding board games, managing user collections, and integrating board game data into AI-driven applications.

How to use

To use BGG MCP, you need to build the server binary using Go or Makefile, and then configure your AI tool (like VS Code or Claude) to point to the binary in its settings.

Key features

Key features include searching for games by name, filtering user collections, and future plans for hot games and specific game details.

Where to use

BGG MCP can be used in gaming applications, AI tools, and any software that requires interaction with the BoardGameGeek API.

BGG MCP: BoardGameGeek MCP API Server

[!WARNING]
This project is under active developmennt, therefore expect tooling to change.

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.

Example

Tools

• Game Details (find game by name, currently returns best match)
• Collection (find and filter about a users collection)
• Hottness (get the current BGG hotness)
• User (find details of a user by username)

Roadmap

• [x] Specific Game Details (by name)
• [x] Collection (+ filters)
• [x] Hot Games
• [x] User Details
• [ ] Broad Search
• [ ] Recommended Games

Setup

You have two options for setting up, the easiest is to use the integration of Smithery.

A) Installing via Smithery

To install bgg-mcp for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @kkjdaniel/bgg-mcp --client claude

B) Manual Setup

1. Install Go

You will need to have Go installed on your system to build binary. This can be easily downloaded and setup here, or you can use the package manager that you prefer such as Brew.

2. Build

The project includes a Makefile to simplify building and managing the binary.

# Build the application (output goes to build/bgg-mcp)
make build

# Clean build artifacts
make clean

# Both clean and build
make all

Or you can simply build it directly with Go…

go build -o build/bgg-mcp

3. Add MCP Config

In the settings.json (VS Code / Cursor) or claude_desktop_config.json add the following to your list of servers, pointing it to the binary you created earlier, once you load up your AI tool you should see the tools provided by the server connected:

More details for configuring Claude can be found here.

Using Makefile

The project includes a Makefile to simplify building and managing the binary.

# Build the application (output goes to build/bgg-mcp)
make build

# Clean build artifacts
make clean

# Both clean and build
make all