BoardGameGeek
BGG MCP provides access to BoardGameGeek and a variety of board game related data through the Model Context Protocol. Enabling retrieval and filtering of board game data, user collections, and profil…
Quick Start
# Connect this server (installs CLI if needed)
npx -y smithery mcp add kkjdaniel/bgg-mcp
# Browse available tools
npx -y smithery tool list kkjdaniel/bgg-mcp
# Get full schema for a tool
npx -y smithery tool get kkjdaniel/bgg-mcp bgg-collection
# Call a tool
npx -y smithery tool call kkjdaniel/bgg-mcp bgg-collection '{}'Direct MCP Connection
Endpoint: https://bgg-mcp--kkjdaniel.run.tools
Optional config:
BGG_COOKIE(query) — Cookie string for BGG authentication. Only needed if not using API keyBGG_API_KEY(query) — API key from BoardGameGeek for authentication. Get one at https://boardgamegeek.com/applicationsBGG_USERNAME(query) — Your BGG username for personalized features
Tools (10)
bgg-collection— Find the details about a specific users board game collection on BoardGameGeek (BGG)bgg-details— Find the details about a specific board game on BoardGameGeek (BGG)bgg-hot— Find the current board game hotness on BoardGameGeek (BGG)bgg-price— Get current prices for board games from multiple retailers using BGG IDsbgg-recommender— Get game recommendations based on a specific game using either the BoardGameGeek (BGG) ID or name directly. ID is prefe…bgg-rules— Use this tool when users ask rules questions about board games (e.g., 'How does X work?', 'Can I do Y?', 'What happens …bgg-search— Search for board games on BoardGameGeek (BGG) by name or part of a name using a broad search (e.g., 'Catan', 'Ticket to…bgg-thread-details— Get full content of a specific BoardGameGeek forum thread, including all posts and replies. Use this after finding rele…bgg-trade-finder— Find what games user1 owns that user2 has on their wishlist. Shows potential trading opportunities.bgg-user— Find details about a specific user on BoardGameGeek (BGG)
# Get full input/output schema for a tool
npx -y smithery tool get kkjdaniel/bgg-mcp Resources
bgg://hotness— The current list of hot board games on BoardGameGeek, updated regularly by the BGG communitybgg://my-collection— Your BoardGameGeek collection (user: fiiish). Shows all owned games with their ratings, play counts, and status.
Prompts (2)
game-recommendations(username, currency, destination) — Get personalized board game recommendations based on your BGG collection and preferencestrade-sales-post(username, currency, destination) — Generate a sales post for your BGG 'for trade' collection with discounted prices