BGG MCP
Model Context Protocol server for BoardGameGeek data, collections, pricing, and recommendations.
Key Features
Use Cases
README
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
▶️ Watch the Rules Tool Demo Video
Tools
Core Tools
| Tool | Description |
|---|---|
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 |
🧪 Experimental Tools
| Tool | Description |
|---|---|
bgg-rules |
Answer rules questions by searching BGG forums for relevant discussions and clarifications |
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 (requires BGG_USERNAME to be set) |
Resources provide AI assistants with direct access to BGG data without needing explicit tool calls, making conversations more natural and efficient.
Prompts
- Trade Sales Post - Generate a formatted sales post for your BGG 'for trade' collection with discounted market prices
- Game Recommendations - Get personalized game recommendations based on your BGG collection and preferences
Example Prompts
Here are some example prompts you can use to interact with the BGG MCP tools:
🔍 Search
"Search for Wingspan on BGG"
"How many expansions does Grand Austria Hotel have?"
"Search for Wingspan expansions only"
📊 Game Details
"Get details for Azul"
"Show me information about game ID 224517"
"What's the BGG rating for Gloomhaven?"
📚 Collection
"Show me ZeeGarcia's game collection"
"Show games rated 9+ in kkjdaniel's collection"
"List unplayed games in rahdo's collection"
"Find games for 6 players in kkjdaniel's collection"
"Show me all the games rated 3 and below in my collection"
"What games in my collection does rahdo want?"
"What games does kkjdaniel have that I want?"
🔥 Hotness
"Show me the current BGG hotness list"
"What's trending on BGG?"
👤 User Profile
"Show me details about BGG user rahdo"
"When did user ZeeGarcia join BGG?"
"How many buddies do I have on bgg?"
💰 Prices
"Get the best price for Wingspan in GBP"
"Show me the best UK price for Ark Nova"
"Compare prices for: Wingspan & Ark Nova"
🎯 Recommendations
"Recommend games similar to Wingspan"
"What games are like Azul but with at least 1000 ratings?"
"Find 5 games similar to Troyes"
📖 Rules (Experimental)
"[Your rules question about any board game] - use bgg-rules"
"How does [game mechanic] work in [game name]? use bgg-rules"
"Can I [specific action] in [game name]? use bgg-rules"
"What happens when [situation] in [game name]? use bgg-rules"
Note: Include "use bgg-rules" in your question to ensure the AI searches BGG forums for answers.
Installation
Authentication Required: Most BGG MCP tools require authentication to access BoardGameGeek's API. See the Configuration section below for setup instructions.
You have multiple options for installing BGG MCP:
A) Installing via Smithery (Recommended)
Get started in under a minute with Smithery:
- Sign up at Smithery and select your client (e.g., Claude Desktop)
- Click Configure to set up your BGG authentication (see Configuration)
- Connect and start using BGG tools immediately
Or via Connectors for Claude users
Add BGG MCP as a custom connector:
- Go to Settings → Connectors → Add custom connector
- Enter this URL:
https://server.smithery.ai/@kkjdaniel/bgg-mcp/mcp - Click Connect to authorise
That's it! The server uses the latest Streamable HTTP transport.
Tip: Connectors added on Claude Desktop will also appear and work on mobile!
B) MCP Registry
Install via the MCP Registry:
mcp install io.github.kkjdaniel/bgg-mcp
C) Manual Setup
1. 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.
2. Build
The project includes a Makefile to simplify building and managing the binary.
# Build the application (output goes to build/bgg-mcp)
make build
# Clean build artifacts
make clean
# Both clean and build
make all
Or you can simply build it directly with Go...
go build -o build/bgg-mcp
3. 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:
"bgg": {
"command": "path/to/build/bgg-mcp",
"args": ["-mode", "stdio"]
}
More details for configuring Claude can be found here.
Configuration
Authentication
BGG MCP v2.0+ uses the GoGeek v2.0 library which requires authentication for reliable access to BoardGameGeek's API.
You can configure authentication using either BGG_API_KEY (recommended) or BGG_COOKIE:
For Smithery Users
When connecting via Smithery, you can configure authentication directly in the connection UI:
- Click Configure button on the BGG MCP server page
- Fill in the configuration form (under optional):
- BGG API Key (recommended) - Get one at boardgamegeek.com/applications
- BGG Cookie (alternative) - Only if you're not using an API key
- BGG Username - Your username for personalized features
- Click Save Configuration, then connect with this profile
Your settings are stored securely and applied automatically when you use BGG MCP tools.
For Manual Setup
Option 1: API Key (Recommended)
Get an API key from BoardGameGeek's API application form and add it to your configuration:
"bgg": {
"env": {
"BGG_API_KEY": "your_api_key_here"
}
}
Option 2: Cookie Authentication
Alternatively, you can use cookie-based authentication:
"bgg": {
"env": {
"BGG_COOKIE": "bggusername=user; bggpassword=pass; SessionID=xyz"
}
}
Note: If both are provided, BGG_API_KEY takes precedence.
Username Configuration
You can optionally set the BGG_USERNAME environment variable to enable "me" and "my" references in queries:
"bgg": {
"env": {
"BGG_USERNAME": "your_bgg_username",
"BGG_API_KEY": "your_api_key_here"
}
}
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 BGG_USERNAME, you'll get a clear error message.
Star History
Repository Owner
User
Repository Details
Programming Languages
Topics
Join Our Newsletter
Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.
Related MCPs
Discover similar Model Context Protocol servers
OP.GG MCP Server
Seamlessly connect OP.GG data with AI agents via the Model Context Protocol.
OP.GG MCP Server is an implementation of the Model Context Protocol (MCP) designed to provide standardized access to OP.GG data for AI agents and platforms. It enables retrieval of a wide range of real-time data from games like League of Legends, Teamfight Tactics, and Valorant through a unified interface. The server supports integration using MCP-compatible clients and simplifies remote data access for model-based applications. Its flexible tools cover champion statistics, match histories, esports schedules, and in-game leaderboards.
- ⭐ 46
- MCP
- opgginc/opgg-mcp
Campertunity MCP Server
Model Context Protocol server for AI-driven camping and outdoor recreation data
Implements the Model Context Protocol (MCP) to provide AI models with structured access to camping and outdoor recreation data. Offers tools for searching, filtering, and booking campgrounds and sites based on a wide range of criteria. Enhances data accuracy with AI and aggregates information from multiple sources, enabling dynamic, real-time queries and bookings. Ideal for integrating intelligent camping experiences into AI-driven applications.
- ⭐ 11
- MCP
- campertunity/mcp-server
MCP Tic-Tac-Toe
A Model Context Protocol server for playing and analyzing tic-tac-toe games through standardized tool interfaces.
MCP Tic-Tac-Toe is a server implementation that provides a complete set of MCP tools for playing, managing, and analyzing tic-tac-toe games. It supports interactions with AI assistants such as Claude, enabling features like creating multiple parallel sessions, making moves, providing strategic analysis, and managing game context. The server is designed for easy integration with clients through various transport methods, including stdio and SSE, and supports seamless AI-human collaboration.
- ⭐ 2
- MCP
- tomholford/mcp-tic-tac-toe
Graphlit MCP Server
Integrate and unify knowledge sources for RAG-ready AI context with the Graphlit MCP Server.
Graphlit MCP Server provides a Model Context Protocol interface, enabling seamless integration between MCP clients and the Graphlit platform. It supports ingestion from a wide array of sources such as Slack, Discord, Google Drive, email, Jira, and GitHub, turning them into a searchable, RAG-ready knowledge base. Built-in tools allow for document, media extraction, web crawling, and web search, as well as advanced retrieval and publishing functionalities. The server facilitates easy configuration, sophisticated data operations, and automated notifications for diverse workflows.
- ⭐ 369
- MCP
- graphlit/graphlit-mcp-server
MLB API MCP Server
A Model Context Protocol server for seamless MLB data access through AI applications.
MLB API MCP Server provides comprehensive access to MLB statistics and baseball data via a FastMCP-based interface. It exposes a range of MLB functionalities—including live game data, player statistics, team information, and advanced metrics—as MCP tools accessible by AI workflows. Compatible with MCP-enabled AI clients, it enables structured, schema-validated querying and integrations for baseball data.
- ⭐ 33
- MCP
- guillochon/mlb-api-mcp
ShopSavvy Data API MCP Server
MCP server providing AI assistants with live product data, pricing, and price tracking from ShopSavvy.
ShopSavvy Data API MCP Server implements the Model Context Protocol to enable AI assistants to access and interact with ShopSavvy's extensive product database. It supports product lookup, retrieves current and historical pricing from multiple retailers, and allows scheduled monitoring of product prices. The server also manages API usage analytics and credit consumption, offering robust error handling and developer tools for integration.
- ⭐ 5
- MCP
- shopsavvy/shopsavvy-mcp-server
Didn't find tool you were looking for?