Bgg Mcp

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:

"bgg": {
    "command": "path/to/build/bgg-mcp",
    "args": []
}

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