Server Details
BGG MCP provides access to the BoardGameGeek API through the Model Context Protocol, enabling retr…
- Status
- Healthy
- Last Tested
- Transport
- Streamable HTTP
- URL
- Repository
- kkjdaniel/bgg-mcp
- GitHub Stars
- 21
Available Tools
10 toolsbgg-collectionTry in Inspector
Find the details about a specific users board game collection on BoardGameGeek (BGG)
| Name | Required | Description | Default |
|---|---|---|---|
| owned | No | Filters for owned games in the collection (default: true if no ownership filters specified) | |
| rated | No | Filters for games that are rated in the collection | |
| played | No | Filters for games that have recorded plays in the collection | |
| subtype | No | Filter by game type: 'boardgame' for base games only (excludes expansions), 'boardgameexpansion' for expansions only | |
| fortrade | No | Filters for games that are marked for trade in the collection | |
| hasparts | No | Filters for games that have spare parts or not in the collection | |
| maxplays | No | Filters based on the maximum number of plays of the games in the collection | |
| minplays | No | Filters based on the minimum number of plays of the games in the collection | |
| username | Yes | The username of the BoardGameGeek (BGG) user who owns the collection. When the user refers to themselves (me, my, I), use 'SELF' as the value. | |
| wishlist | No | Filters for wishlisted games in the collection | |
| maxrating | No | Filters based on the maximum personal rating of the games in the collection | |
| minrating | No | Filters based on the minimum personal rating of the games in the collection | |
| wanttobuy | No | Filters for games that the user wants to buy in the collection | |
| preordered | No | Filters for preordered games in the collection | |
| wanttoplay | No | Filters for games that the user wants to play in the collection | |
| maxbggrating | No | Filters based on the maximum global BoardGameGeek (BGG) rating of the games in the collection | |
| minbggrating | No | Filters based on the minimum global BoardGameGeek (BGG) rating of the games in the collection |
bgg-detailsTry in Inspector
Find the details about a specific board game on BoardGameGeek (BGG)
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | The BoardGameGeek ID of the board game | |
| ids | No | Array of BoardGameGeek IDs to get details for multiple games at once (maximum 20 IDs per request) | |
| name | No | The name of the board game | |
| full_details | No | Return the complete BGG API response instead of essential info. WARNING: This returns significantly more data and can overload AI context windows. ONLY set this to true if the user explicitly requests 'full details', 'complete data', or similar. Default behavior returns essential info which is sufficient for most use cases. |
bgg-hotTry in Inspector
Find the current board game hotness on BoardGameGeek (BGG)
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
bgg-priceTry in Inspector
Get current prices for board games from multiple retailers using BGG IDs
| Name | Required | Description | Default |
|---|---|---|---|
| ids | Yes | Comma-separated BGG IDs (e.g., '12,844,2096,13857') | |
| currency | No | Currency code: DKK, GBP, SEK, EUR, or USD (default: USD) | |
| destination | No | Destination country: DK, SE, GB, DE, or US (default: US) |
bgg-recommenderTry in Inspector
Get game recommendations based on a specific game using either the BoardGameGeek (BGG) ID or name directly. ID is preferred for faster responses.
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | BoardGameGeek (BGG) ID of the game to base recommendations on (preferred for speed) | |
| name | No | Name of the game to base recommendations on (slower than using ID) | |
| min_votes | No | Minimum votes threshold for recommendation quality (default: 30) |
bgg-rulesTry in Inspector
Use this tool when users ask rules questions about board games (e.g., 'How does X work?', 'Can I do Y?', 'What happens when Z?'). Searches BoardGameGeek rules forums to find answers and clarifications from the community.
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | The BoardGameGeek ID of the board game | |
| name | No | The name of the board game |
bgg-searchTry in Inspector
Search for board games on BoardGameGeek (BGG) by name or part of a name using a broad search (e.g., 'Catan', 'Ticket to Ride')
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | Filter by type (default: all, options: 'boardgame' (aka base game), 'boardgameexpansion', or 'all') | |
| limit | No | Maximum number of results to return (default: 30) | |
| query | Yes | Game name to search for on BoardGameGeek (BGG) |
bgg-thread-detailsTry in Inspector
Get full content of a specific BoardGameGeek forum thread, including all posts and replies. Use this after finding relevant threads with bgg-rules.
| Name | Required | Description | Default |
|---|---|---|---|
| thread_id | Yes | The BoardGameGeek thread ID to fetch |
bgg-trade-finderTry in Inspector
Find what games user1 owns that user2 has on their wishlist. Shows potential trading opportunities.
| Name | Required | Description | Default |
|---|---|---|---|
| user1 | Yes | BGG username whose collection will be checked. When the user refers to themselves (me, my, I), use 'SELF' as the value. | |
| user2 | Yes | BGG username whose wishlist will be checked against user1's collection |
bgg-userTry in Inspector
Find details about a specific user on BoardGameGeek (BGG)
| Name | Required | Description | Default |
|---|---|---|---|
| username | Yes | The username of the BoardGameGeek (BGG) user. When the user refers to themselves (me, my, I), use 'SELF' as the value. |
FAQ
How do I claim this server?
To claim this server, publish a /.well-known/glama.json file on your server's domain with the following structure:
The email address must match the email associated with your Glama account. Once verified, the server will appear as claimed by you.
What are the benefits of claiming a server?
- Control your server's listing on Glama, including description and metadata
- Receive usage reports showing how your server is being used
- Get monitoring and health status updates for your server
Your Connectors
Sign in to create a connector for this server.