Kkjdaniel Bgg Mcp

Frequently asked questions

What does the Kkjdaniel Bgg Mcp MCP server do?

> > > An MCP server that gives AI assistants access to BoardGameGeek: game details, collections, prices, recommendations and rules answers. 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. Price data is provided by BoardGamePrices.co.uk, offering real-time pricing from multiple retailers. Game recommendations are powered by Recommend.Games, which provides algorithmic similarity recommendations based on BoardGameGeek data. > > > Demo > > > Tools Tool Description -------------------- --------------------------------------------------------------------------------------- bgg-search Search for board games with type filtering (base games, expansions, or all) bgg-details Get game details, including best player counts, rank, and optional marketplace listings, editions and user comments bgg-collection Query and filter a user's collection, with their ratings, BGG ratings, rank and plays 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-rules Answer rules questions by finding the most relevant threads in a game's BGG rules forum bgg-thread-details Get the full content of a specific BGG forum thread including all posts > [!NOTE] > Results link back to their pages on boardgamegeek.com, and the assistant is asked to include those links in its answers. Resources BGG MCP exposes resources that AI assistants can access directly for contextual information: Resource URI Description --------------------- ----------------------------- ------------------------------------------------------------------------ BGG Hotness bgg://hotness Current BGG hotness list, always available My BGG Collection bgg://my-collection Your personal BGG collection (only listed when BGG USERNAME is set) BGG User Collection bgg://collection/{username} The owned games in any BGG user's collection BGG Game bgg://game/{id} Essential information about a game by its BGG ID BGG Forum Thread bgg://thread/{id} A BGG forum thread by its ID, with every post as plain text Prompts BGG MCP includes pre-configured prompts for common workflows: Prompt Arguments Description ---------------------- ------------------------------------------------------------ ---------------------------------------------------------------------------------------- trade-sales-post username , currency , destination , discount , platform Generate a sales post for your BGG 'for trade' collection, discounted from retail prices game-recommendations username , currency , destination Get personalized game recommendations based on your BGG collection and preferences rules-question game , question Answer a rules question from the game's BGG rules forum username is optional on both prompts when BGG USERNAME is set. Example Prompts Here are some example prompts you can use to interact with the BGG MCP tools: 🔍 Search 📊 Game Details 📚 Collection 🔥 Hotness 👤 User Profile 💰 Prices 🎯 Recommendations 📖 Rules > [!TIP] > Assistants often answer rules questions from memory. Mention BGG and make it clear you mean a board game so the rules forum gets searched, or use the rules-question prompt. Installation > Authentication Required : Most BGG MCP tools require authentication to access BoardGameGeek's API. See the Configuration section below for setup instructions. A) Claude Desktop Extension (macOS / Windows) (Recommended) Download bgg-mcp.mcpb from the latest release and double-click it. Claude Desktop opens an install dialog where you can enter your BGG API key and username, with no Docker or Go needed. B) Smithery (macOS / Windows) BGG MCP is also on Smithery, which distributes the same bundle, so the server runs locally on your machine. Open the server page, choose your client and follow its install steps, entering your BGG API key and username in the configuration form. C) Docker BGG MCP is published to Docker Hub and listed on the MCP Registry. Add the following to your claude desktop config.json (Claude Desktop) or settings.json (VS Code / Cursor): > See Configuration below for details on obtaining a BGG API key and setting up your username. --pull=always fetches the newest image each time the server starts, so you stay up to date automatically. Remove it if you need to start the server offline. For more details on connecting MCP servers to your client, see the official MCP guide. D) Manual Setup 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. Build The project includes a Makefile to simplify building and managing the binary. Or you can simply build it directly with Go... 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. Configuration Authentication BGG MCP uses the GoGeek v3 library, which requires authentication for access to BoardGameGeek's API. You can configure authentication using either BGG API KEY (recommended) or BGG COOKIE : Authentication Setup Option 1: API Key (Recommended) Get an API key from BoardGameGeek's API application form and add it to your configuration: Option 2: Cookie Authentication Alternatively, you can use cookie-based authentication: Note : If both are provided, BGG API KEY will be used by default. Username Configuration You can optionally set your BGG username to enable "me" and "my" references in queries without needing to explicitly state your username. If you installed the Claude Desktop Extension, enter your username in the extension's settings in Claude Desktop (Settings > Extensions > BGG MCP), where you also set your API key. There is no config file to edit. If you installed through Smithery, its configuration form asks for both. For Docker or a manual setup, set the BGG USERNAME environment variable: This enables: Collection queries : "Show my collection" instead of specifying your username User queries : "Show my BGG profile" AI assistance : The AI can automatically use your username for comparisons and analysis Note : When you use self-references (me, my, I) without setting your username, you'll get a clear error message. Update Notifications When it runs on your machine, BGG MCP checks GitHub once a day for a newer release. If there is one, the assistant mentions it once per conversation with a link to the release. Set BGG DISABLE UPDATE CHECK to true to turn this off. The server never checks when it runs in HTTP mode.

How do I install Kkjdaniel Bgg Mcp?

Run the install command shown above, then paste the config for your client (Claude Desktop, Claude Code, Cursor, VS Code or Windsurf) into its MCP settings and restart the client.

Is Kkjdaniel Bgg Mcp free to use?

The MCP server itself is free to install. The source is public on https://github.com/kkjdaniel/bgg-mcp. Any third-party service it calls may require its own API key and account.

Which clients support Kkjdaniel Bgg Mcp?

Any MCP-compatible client can use it, including Claude Desktop, Claude Code, Cursor, VS Code, Windsurf and custom agents.