Kkjdaniel Bgg Mcp

kkjdaniel/bgg-mcp

This server wraps the BoardGameGeek API so you can search for games, pull detailed info including ratings and mechanics, query user collections with filters for player count or rating, and check what's currently hot. It also integrates BoardGamePrices.co.uk for live pricing across retailers and Recommend.Games for algorithmic similarity recommendations. The experimental rules tool searches BGG forums to answer gameplay questions. Built in Go using the GoGeek library. Particularly handy if you're building game recommendation flows, managing collection data, or need to surface board game metadata without scraping. Requires a BGG API key for most operations. Also exposes your personal collection as a resource and includes prompts for generating trade posts.

GitHub stars: 44
tools: 10
auth: Secret needed
transport: HTTP
last updated: Sep 16, 2025

View on GitHub

Tools

10 tools

Public tool metadata for what this MCP can expose to an agent.

bgg-collectionFind the details about a specific users board game collection on BoardGameGeek (BGG)17 params

Find the details about a specific users board game collection on BoardGameGeek (BGG)

Parameters* required

fortradeboolean

Filters for games that are marked for trade in the collection

haspartsboolean

Filters for games that have spare parts or not in the collection

maxbggratingnumber

Filters based on the maximum global BoardGameGeek (BGG) rating of the games in the collection

maxplaysnumber

Filters based on the maximum number of plays of the games in the collection

maxratingnumber

Filters based on the maximum personal rating of the games in the collection

minbggratingnumber

Filters based on the minimum global BoardGameGeek (BGG) rating of the games in the collection

minplaysnumber

Filters based on the minimum number of plays of the games in the collection

minratingnumber

Filters based on the minimum personal rating of the games in the collection

ownedboolean

Filters for owned games in the collection (default: true if no ownership filters specified)

playedboolean

Filters for games that have recorded plays in the collection

preorderedboolean

Filters for preordered games in the collection

ratedboolean

Filters for games that are rated in the collection

subtypestring

Filter by game type: 'boardgame' for base games only (excludes expansions), 'boardgameexpansion' for expansions onlyone of boardgame · boardgameexpansion

usernamestring

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.

wanttobuyboolean

Filters for games that the user wants to buy in the collection

wanttoplayboolean

Filters for games that the user wants to play in the collection

wishlistboolean

Filters for wishlisted games in the collection

bgg-detailsFind the details about a specific board game on BoardGameGeek (BGG)4 params

Find the details about a specific board game on BoardGameGeek (BGG)

Parameters* required

full_detailsboolean

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 reque...

idnumber

The BoardGameGeek ID of the board game

idsarray

Array of BoardGameGeek IDs to get details for multiple games at once (maximum 20 IDs per request)

namestring

The name of the board game

bgg-hotFind the current board game hotness on BoardGameGeek (BGG)

Find the current board game hotness on BoardGameGeek (BGG)

No parameter schema in public metadata yet.

bgg-priceGet current prices for board games from multiple retailers using BGG IDs3 params

Get current prices for board games from multiple retailers using BGG IDs

Parameters* required

currencystring

Currency code: DKK, GBP, SEK, EUR, or USD (default: USD)

destinationstring

Destination country: DK, SE, GB, DE, or US (default: US)

idsstring

Comma-separated BGG IDs (e.g., '12,844,2096,13857')

bgg-recommenderGet game recommendations based on a specific game using either the BoardGameGeek (BGG) ID or name directly. ID is preferred for faster responses.3 params

Get game recommendations based on a specific game using either the BoardGameGeek (BGG) ID or name directly. ID is preferred for faster responses.

Parameters* required

idstring

BoardGameGeek (BGG) ID of the game to base recommendations on (preferred for speed)

min_votesnumber

Minimum votes threshold for recommendation quality (default: 30)

namestring

Name of the game to base recommendations on (slower than using ID)

bgg-rulesUse 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.2 params

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.

Parameters* required

idnumber

The BoardGameGeek ID of the board game

namestring

The name of the board game

bgg-searchSearch for board games on BoardGameGeek (BGG) by name or part of a name using a broad search (e.g., 'Catan', 'Ticket to Ride')3 params

Search for board games on BoardGameGeek (BGG) by name or part of a name using a broad search (e.g., 'Catan', 'Ticket to Ride')

Parameters* required

limitnumber

Maximum number of results to return (default: 30)

querystring

Game name to search for on BoardGameGeek (BGG)

typestring

Filter by type (default: all, options: 'boardgame' (aka base game), 'boardgameexpansion', or 'all')one of all · boardgame · boardgameexpansion

bgg-thread-detailsGet full content of a specific BoardGameGeek forum thread, including all posts and replies. Use this after finding relevant threads with bgg-rules.1 params

Get full content of a specific BoardGameGeek forum thread, including all posts and replies. Use this after finding relevant threads with bgg-rules.

Parameters* required

thread_idnumber

The BoardGameGeek thread ID to fetch

bgg-trade-finderFind what games user1 owns that user2 has on their wishlist. Shows potential trading opportunities.2 params

Find what games user1 owns that user2 has on their wishlist. Shows potential trading opportunities.

Parameters* required

user1string

BGG username whose collection will be checked. When the user refers to themselves (me, my, I), use 'SELF' as the value.

user2string

BGG username whose wishlist will be checked against user1's collection

bgg-userFind details about a specific user on BoardGameGeek (BGG)1 params

Find details about a specific user on BoardGameGeek (BGG)

Parameters* required

usernamestring

The username of the BoardGameGeek (BGG) user. When the user refers to themselves (me, my, I), use 'SELF' as the value.

Readme

BGG MCP: BoardGameGeek data for your AI assistant

An MCP server that gives AI assistants access to BoardGameGeek: game details, collections, prices, recommendations and rules answers.

View the full README on GitHub

Details

Repository: github.com/kkjdaniel/bgg-mcp
Transport: HTTP
Auth: Required
Registry: MCP registry, active

Kkjdaniel Bgg Mcp

Tools

Readme

Details

More from kkjdaniel