Quick Verdict
BGG MCP is an independent community integration maintained by kkjdaniel. It is not an official BoardGameGeek server and should not be presented as endorsed or operated by BoardGameGeek, BoardGamePrices, or Recommend.Games. Written in Go with the GoGeek library, it exposes board-game search, details, collections, hotness, user profiles, retailer prices, trade matching, recommendations, and forum threads to MCP clients. As of July 21, 2026, the latest stable GitHub release is v1.6.1. The repository uses the MIT License and can run from a Docker image or a locally built binary.
The current README separates nine stable core tools from one experimental tool. Experimental bgg-rules searches BoardGameGeek forums for discussions and clarifications. It is useful for finding leads, not for replacing the rulebook, official FAQ, errata, or a publisher ruling. Most BoardGameGeek calls require a BGG API key. Price results come from BoardGamePrices.co.uk rather than the BoardGameGeek API, so retailer coverage, region, stock, tax, shipping, currency, and freshness are separate concerns.
Best For
- Board-game players who want natural-language search, game details, current hotness, and collection filtering inside an MCP client.
- Community organizers comparing public collections or finding possible trades between two BoardGameGeek users.
- Writers, podcasters, and video creators who need a research shortlist and will preserve IDs, links, query dates, and human fact-checking.
- Technical users comfortable operating a Docker container or Go binary and managing MCP configuration, environment variables, and API credentials.
- Developers prototyping a private board-game assistant without building separate wrappers around search, collection, forum, recommendation, and pricing services.
It is not a strong fit for anyone requiring official BoardGameGeek support, guaranteed global real-time pricing, automated purchasing, or authoritative rules adjudication from forum summaries.
Key Features
bgg-search: searches titles with a filter for base games, expansions, or all types. Confirm the resulting BGG ID before chaining other calls.bgg-details: retrieves details and community metadata for a specific game. Ratings, ranks, ownership counts, and community fields can change.bgg-collection: queries and filters a user’s public collection, including useful constraints around ratings, play status, and player counts.bgg-hotandbgg-user: retrieve the current hotness list and public profile information. Hotness measures attention, not durable quality or suitability.bgg-price: requests prices from multiple retailers by BGG ID. The upstream provider is BoardGamePrices.co.uk, not an official BGG shop or universal quote feed.bgg-trade-finder: compares two users to identify potential exchanges. Edition, language, condition, missing pieces, location, shipping, and final consent remain outside the tool.bgg-recommender: obtains similarity-based candidates from Recommend.Games. That external algorithm and service are a dependency, not functionality controlled entirely by BGG MCP.bgg-thread-details: retrieves a forum thread and its posts. Long discussions can consume substantial context and contain old, conflicting, or incorrect advice.- Experimental
bgg-rules: searches forum discussions for rules questions. Its output should point users toward evidence rather than act as the final ruling.
The server also exposes hotness and optional personal-collection resources plus preconfigured prompts for trade-sale posts and recommendations. These conveniences do not change the authentication or source boundaries.
Use Cases
For a personal collection assistant, set BGG_USERNAME so references such as “my collection” resolve to a known account. Use bgg-collection to identify unplayed titles, high-rated games, or options for a player count. The collection is still a snapshot of public BGG data. Before publishing or acting on it, confirm that the correct username was used and that private context has not been inferred from a public list.
A trade workflow can use bgg-trade-finder to produce candidates, but it cannot validate edition, language, component completeness, wear, shipping cost, country restrictions, or whether either person still wants the trade. Treat the result as a conversation starter. Both users should inspect the exact listings and agree on the exchange outside the model.
For buying research, search first, preserve the exact BGG ID, then combine details, recommendations, and a price lookup. Similar names and expansions are common, so title matching alone is unsafe. Record the query time, country or region, currency, retailer, stock indication, and whether tax or shipping is included. BoardGamePrices links or prices may lag; the retailer checkout page is the transaction authority. Rules research needs the same discipline: use bgg-rules to find discussions, then check the rulebook edition, official FAQ, errata, and publisher or designer clarification.
Pricing
BGG MCP v1.6.1 is free software under the MIT License. The license permits use, modification, distribution, sublicensing, and sale of copies when its copyright and permission notice are preserved. Operating it is not costless: users provide a machine or container host, network access, an MCP client, upgrades, monitoring, and any downstream model usage. The project publishes the kdaniel/bgg-mcp Docker image, and the v1.6.1 release highlights a universal Docker image.
Most tools require BoardGameGeek API authentication. The recommended configuration is BGG_API_KEY, obtained through BoardGameGeek’s API application form. BGG_COOKIE is supported as an alternative, and the API key takes precedence if both are supplied. A cookie may expose a broader account session and is therefore more sensitive than a dedicated key; do not commit it, paste it into a chat, or place it in shared configuration. BGG_USERNAME is optional and enables “me” and “my” references.
The repository’s MIT license does not override BoardGameGeek API access rules, rate limits, content rights, trademarks, or the terms of BoardGamePrices and Recommend.Games. Review each upstream service before operating a public or commercial integration.
Pros
- Nine stable tools cover search, details, collections, hotness, users, prices, trades, recommendations, and forum retrieval in one domain-focused server.
- A Go binary and published Docker image make local MCP deployment relatively direct.
- The MIT License gives a familiar and permissive code-use boundary.
- Optional
BGG_USERNAMEmakes personal collection prompts less repetitive while keeping the selected identity explicit in configuration. - BoardGamePrices and Recommend.Games integrations can enrich a research shortlist without requiring separate MCP servers.
- The README clearly labels the forum-based rules tool as experimental rather than presenting all tools as equally stable.
Cons
- It is an independent community integration, not an official BoardGameGeek product; maintenance continuity and API compatibility depend on its maintainers.
- Most features require a BGG API key and remain subject to BoardGameGeek availability, application approval, rate limits, and policy changes.
bgg-pricedepends on BoardGamePrices, whose retailer coverage and freshness cannot represent every market or a final checkout price.- Recommendations depend on Recommend.Games, so algorithm changes, service outages, and bias are outside this repository’s control.
- Experimental
bgg-rulessearches community forums rather than an authoritative rules corpus and may combine different editions or incorrect posts. - Large collections and full forum threads can increase latency and token use unless queries are narrowly scoped.
- Self-hosting controls the MCP process but does not remove network dependencies on BoardGameGeek and the other upstream providers.
Alternatives
| Tool | Better for | Main strength | Main boundary |
|---|---|---|---|
| GitHub MCP | Developers whose agents need repository, issue, and release data | Broad software-collaboration context and GitHub operations | No BoardGameGeek catalog, collection, recommendation, or price data |
| Filesystem MCP | Users with local rulebooks, exported collections, and private notes | User-controlled private files and predictable local sources | Does not connect automatically to BGG, BoardGamePrices, or recommendations |
| Slack MCP Server | Board-game communities organized around Slack history and coordination | Channel, message, and collaboration context | No structured BGG game catalog or user collections |
| n8n MCP | Teams orchestrating APIs, alerts, and human approvals | Flexible workflows and controlled execution | Requires the team to integrate and maintain board-game data providers |
| MCP Use | Engineers developing and testing custom MCP agents | General MCP client and agent-building capabilities | A framework rather than a ready-made board-game data integration |
FAQ
Is BGG MCP an official BoardGameGeek project?
No. It is an independent community project maintained by kkjdaniel. BoardGameGeek is an upstream data and authentication provider, not the stated developer or operator of this MCP server.
What are the current stable version and license?
As of July 21, 2026, the latest stable GitHub release is v1.6.1 and the repository uses the MIT License. Preserve its license notice and separately follow every upstream service’s terms.
How many tools does it provide?
The current README lists nine stable core tools and one experimental tool, bgg-rules. The experimental label is important because forum-based rules retrieval should not receive the same reliability expectation as stable catalog tools.
Why is a BGG API key required?
GoGeek v2 uses authenticated access for more reliable BoardGameGeek API calls. Apply for a dedicated BGG_API_KEY. Cookie authentication is available, but it carries more sensitive session material and should generally not be the first choice.
Are the prices official BoardGameGeek prices?
No. bgg-price uses multi-retailer data from BoardGamePrices.co.uk. Region, currency, retailer participation, stock, tax, shipping, and update time affect the result. Verify the retailer’s checkout page before purchasing.
Can bgg-rules replace a rulebook?
No. It searches BoardGameGeek forum discussions and can locate useful clarifications. Final decisions should use the matching edition’s rulebook, official FAQ, errata, and explicit publisher or designer rulings.
Bottom Line
BGG MCP v1.6.1 is a capable community server for board-game research. Its nine stable tools cover the main discovery, collection, trade, and discussion workflows, while the experimental rules tool is best used as a forum-search aid. Start by obtaining a dedicated BGG key and testing a small Docker deployment with search, details, collection, and hotness before enabling external pricing or long forum retrieval. Keep three provider boundaries visible in every workflow: BoardGameGeek supplies core catalog and community data, BoardGamePrices supplies retailer prices, and Recommend.Games supplies similarity recommendations. With source links, IDs, timestamps, edition checks, and human review, the server is useful; official support, guaranteed transaction prices, and authoritative rules decisions still belong to the relevant primary sources.