Bgg Mcp
by kkjdanielcommunityv1.6.1
38
11
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.
From the registry: BoardGameGeek MCP server providing access to BGG API data through standardized tools
Install & configure
Prerequisites
- requiredBoardGameGeek API keyObtain an API key from BGG's API application form.https://boardgamegeek.com/applications
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `bgg-mcp` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **BoardGameGeek API key** — Obtain an API key from BGG's API application form. (https://boardgamegeek.com/applications)
Canonical MCP server config (stdio transport):
- command: `docker`
- args: ["run","-i","--rm","-e","BGG_API_KEY","-e","BGG_USERNAME","kdaniel/bgg-mcp"]
- required environment variables:
- `BGG_API_KEY`: BoardGameGeek API key (recommended auth). Alternative: BGG_COOKIE. (example: `<your-bgg-api-key>`)
- optional environment variables:
- `BGG_USERNAME`: Your BGG username — enables 'me'/'my' references in queries (example: `<your-bgg-username>`)
- `BGG_COOKIE`: Cookie-based authentication (alternative to BGG_API_KEY)
Note: Docker is the recommended install (Go binary). Manual build-from-source path also documented.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: Docker is the recommended install (Go binary). Manual build-from-source path also documented.
Tools (10)
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
bgg-rules
Answer rules questions by searching BGG forums for relevant discussions and clarifications
Environment variables
BGG_API_KEYrequiredAPI key for accessing BoardGameGeek's APIBGG_USERNAMErequiredYour BoardGameGeek username for personalized queriesDemos
Packages
docker.io/kdaniel/bgg-mcp:1.6.1
ocitransport: stdio
Details
- Language
- Go
- License
- MIT
- Released
- Feb 13, 2026
- Last commit
- Apr 19, 2026
- Registry name
- io.github.kkjdaniel/bgg-mcp