[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_118":119},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":41,"_42":43,"_44":45,"_46":47,"_48":49,"_50":51,"_52":53,"_54":55,"_56":-5,"_57":49,"_58":59,"_60":61,"_62":63,"_64":65,"_66":67,"_68":49,"_69":70,"_71":72,"_73":74,"_75":76,"_77":78,"_79":-5,"_80":-5,"_81":-5,"_82":49,"_83":-5,"_84":85,"_86":87,"_88":89,"_90":91,"_92":93,"_94":95,"_96":97},"apiUrl","https://odel.app/api","creator","kkjdaniel","moduleId","bgg-mcp","@kkjdaniel/bgg-mcp","displayName","bgg mcp","tagline","BGG MCP provides access to the BoardGameGeek API through the Model Context Protocol, enabling retr…","iconKey","https://avatars.githubusercontent.com/u/7441747?v=4","category","remote","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://server.smithery.ai/@kkjdaniel/bgg-mcp/mcp\",\"transport\":\"streamable-http\",\"authType\":\"bearer\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1781363218000,"updatedAt",1788755190000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=ai.smithery%2Fkkjdaniel-bgg-mcp","sourceVerified",false,"sourceMissingSince","importedAt","upstreamStars",52,"upstreamUpdatedAt",1787232166000,"detectedTransport","streamable-http","detectedAuthType","oauth","probeStatus","ok","lastProbedAt","githubRepoUrl","https://github.com/kkjdaniel/bgg-mcp","githubRepoFullName","kkjdaniel/bgg-mcp","releaseId","ext-kkjdaniel-bgg-mcp","version","1.3.2","descriptionMarkdown","

\n $\"BGG$ \n

BGG MCP: BoardGameGeek MCP Server

\n\n

\n $\"trust$ \n $\"MCP$ \n
\n $\"Go$ \n $\"License\"$ \n $\"MCP$ \n

\n\nBGG MCP provides access to the BoardGameGeek API through the [Model Context Protocol](https://www.anthropic.com/news/model-context-protocol), enabling retrieval and filtering of board game data, user collections, and profiles. The server is implemented in Go, using the [GoGeek](https://github.com/kkjdaniel/gogeek) library, which helps ensure robust API interactions.\n\nPrice data is provided by [BoardGamePrices.co.uk](https://boardgameprices.co.uk), offering real-time pricing from multiple retailers.\n\nGame recommendations are powered by [Recommend.Games](https://recommend.games/), which provides algorithmic similarity recommendations based on BoardGameGeek data.\n\n\n $\"Powered$ \n\n\n## Demo\n\n

\n \n [![Rules Tool Demo Video](https://img.youtube.com/vi/cNX4WwVbFko/maxresdefault.jpg)](https://youtu.be/cNX4WwVbFko)\n \n **[▶️ Watch the Rules Tool Demo Video](https://youtu.be/cNX4WwVbFko)**\n \n

\n\n## Tools\n\n### Core Tools\n\n| Tool | Description |\n| -------------------- | --------------------------------------------------------------------------- |\n| `bgg-search` | Search for board games with type filtering (base games, expansions, or all) |\n| `bgg-details` | Get detailed information about a specific board game |\n| `bgg-collection` | Query and filter a user's game collection with extensive filtering options |\n| `bgg-hot` | Get the current BGG hotness list |\n| `bgg-user` | Get user profile information |\n| `bgg-price` | Get current prices from multiple retailers using BGG IDs |\n| `bgg-trade-finder` | Find trading opportunities between two BGG users |\n| `bgg-recommender` | Get game recommendations based on similarity to a specific game |\n| `bgg-thread-details` | Get the full content of a specific BGG forum thread including all posts |\n\n### 🧪 Experimental Tools\n\n| Tool | Description |\n| ----------- | ------------------------------------------------------------------------------------------ |\n| `bgg-rules` | Answer rules questions by searching BGG forums for relevant discussions and clarifications |\n\n## Resources\n\nBGG MCP exposes resources that AI assistants can access directly for contextual information:\n\n| Resource | URI | Description |\n| ------------------- | --------------------- | ---------------------------------------------------------------- |\n| `BGG Hotness` | `bgg://hotness` | Current BGG hotness list, always available |\n| `My BGG Collection` | `bgg://my-collection` | Your personal BGG collection (requires `BGG_USERNAME` to be set) |\n\n## Prompts\n\nBGG MCP includes pre-configured prompts for common workflows:\n\n| Prompt | Description |\n| ------------------------ | ------------------------------------------------------------------------------------ |\n| `Trade Sales Post` | Generate a formatted sales post for your BGG 'for trade' collection with discounted market prices |\n| `Game Recommendations` | Get personalized game recommendations based on your BGG collection and preferences |\n\n## Example Prompts\n\nHere are some example prompts you can use to interact with the BGG MCP tools:\n\n### 🔍 Search\n\n```\n\"Search for Wingspan on BGG\"\n\"How many expansions does Grand Austria Hotel have?\"\n\"Search for Wingspan expansions only\"\n```\n\n### 📊 Game Details\n\n```\n\"Get details for Azul\"\n\"Show me information about game ID 224517\"\n\"What's the BGG rating for Gloomhaven?\"\n```\n\n### 📚 Collection\n\n```\n\"Show me ZeeGarcia's game collection\"\n\"Show games rated 9+ in kkjdaniel's collection\"\n\"List unplayed games in rahdo's collection\"\n\"Find games for 6 players in kkjdaniel's collection\"\n\"Show me all the games rated 3 and below in my collection\"\n\"What games in my collection does rahdo want?\"\n\"What games does kkjdaniel have that I want?\"\n```\n\n### 🔥 Hotness\n\n```\n\"Show me the current BGG hotness list\"\n\"What's trending on BGG?\"\n```\n\n### 👤 User Profile\n\n```\n\"Show me details about BGG user rahdo\"\n\"When did user ZeeGarcia join BGG?\"\n\"How many buddies do I have on bgg?\"\n```\n\n### 💰 Prices\n\n```\n\"Get the best price for Wingspan in GBP\"\n\"Show me the best UK price for Ark Nova\"\n\"Compare prices for: Wingspan & Ark Nova\"\n```\n\n### 🎯 Recommendations\n\n```\n\"Recommend games similar to Wingspan\"\n\"What games are like Azul but with at least 1000 ratings?\"\n\"Find 5 games similar to Troyes\"\n```\n\n### 📖 Rules (Experimental)\n\n```\n\"[Your rules question about any board game] - use bgg-rules\"\n\"How does [game mechanic] work in [game name]? use bgg-rules\"\n\"Can I [specific action] in [game name]? use bgg-rules\"\n\"What happens when [situation] in [game name]? use bgg-rules\"\n```\n\nNote: Include \"use bgg-rules\" in your question to ensure the AI searches BGG forums for answers.\n\n## Installation\n\n> **Authentication Required**: Most BGG MCP tools require authentication to access BoardGameGeek's API. See the [Configuration section](#configuration) below for setup instructions.\n\n### A) Docker (Recommended)\n\nBGG MCP is published to [Docker Hub](https://hub.docker.com/r/kdaniel/bgg-mcp) and listed on the [MCP Registry](https://github.com/modelcontextprotocol/registry). Add the following to your `claude_desktop_config.json` (Claude Desktop) or `settings.json` (VS Code / Cursor):\n\n```json\n\"bgg\": {\n \"command\": \"docker\",\n \"args\": [\"run\", \"-i\", \"--rm\",\n \"-e\", \"BGG_API_KEY\",\n \"-e\", \"BGG_USERNAME\",\n \"kdaniel/bgg-mcp\"\n ],\n \"env\": {\n \"BGG_API_KEY\": \"your_api_key_here\",\n \"BGG_USERNAME\": \"your_bgg_username\"\n }\n}\n```\n\n> See [Configuration](#configuration) below for details on obtaining a BGG API key and setting up your username.\n\nFor more details on connecting MCP servers to your client, see the [official MCP guide](https://modelcontextprotocol.io/docs/develop/connect-local-servers).\n\n### B) Manual Setup\n\n#### 1. Install Go\n\nYou will need to have Go installed on your system to build binary. This can be easily [downloaded and setup here](https://go.dev/doc/install), or you can use the package manager that you prefer such as Brew.\n\n#### 2. Build\n\nThe project includes a Makefile to simplify building and managing the binary.\n\n```bash\n# Build the application (output goes to build/bgg-mcp)\nmake build\n\n# Clean build artifacts\nmake clean\n\n# Both clean and build\nmake all\n```\n\nOr you can simply build it directly with Go...\n\n```bash\ngo build -o build/bgg-mcp\n```\n\n#### 3. Add MCP Config\n\nIn 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:\n\n```json\n\"bgg\": {\n \"command\": \"path/to/build/bgg-mcp\",\n \"args\": [\"-mode\", \"stdio\"]\n}\n```\n\nMore details for configuring Claude can be [found here](https://modelcontextprotocol.io/quickstart/user).\n\n## Configuration\n\n### Authentication\n\nBGG MCP uses the GoGeek v3 library, which requires authentication for access to BoardGameGeek's API.\n\nYou can configure authentication using **either** `BGG_API_KEY` (recommended) or `BGG_COOKIE`:\n\n#### Authentication Setup\n\n##### Option 1: API Key (Recommended)\n\nGet an API key from [BoardGameGeek's API application form](https://boardgamegeek.com/applications) and add it to your configuration:\n\n```json\n\"bgg\": {\n \"env\": {\n \"BGG_API_KEY\": \"your_api_key_here\"\n }\n}\n```\n\n##### Option 2: Cookie Authentication\n\nAlternatively, you can use cookie-based authentication:\n\n```json\n\"bgg\": {\n \"env\": {\n \"BGG_COOKIE\": \"bggusername=user; bggpassword=pass; SessionID=xyz\"\n }\n}\n```\n\n**Note**: If both are provided, `BGG_API_KEY` will be used by default.\n\n### Username Configuration\n\nYou can optionally set the `BGG_USERNAME` environment variable to enable \"me\" and \"my\" references in queries without needing to explicitly state your username:\n\n```json\n\"bgg\": {\n \"env\": {\n \"BGG_USERNAME\": \"your_bgg_username\",\n \"BGG_API_KEY\": \"your_api_key_here\"\n }\n}\n```\n\nThis enables:\n\n- **Collection queries**: \"Show my collection\" instead of specifying your username\n- **User queries**: \"Show my BGG profile\"\n- **AI assistance**: The AI can automatically use your username for comparisons and analysis\n\n**Note**: When you use self-references (me, my, I) without setting BGG_USERNAME, you'll get a clear error message.\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"iconType","image","upstream",{"_105":106,"_107":108,"_109":110,"_111":112,"_113":-5,"_114":115},"requiredSecrets",[],"tags",[100,101,102,103,104],"assets",[],"stats",{"_98":85,"_99":85},"ratingAvg","reviewCount","bgg","bgg-api","board-game","boardgamegeek","boardgames","topics",[100,101,102,103,104,116,117],"license","MIT","language","Go","registryName","ai.smithery/kkjdaniel-bgg-mcp","homepage","packages",[],"mcp","mcp-server","ENV",{"_120":121,"_122":123,"_124":125},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]