BoardGameGeek MCP Server

kkjdaniel/bgg-mcp

Connects Claude to the BoardGameGeek API for querying board game data, user collections, and community information. You get search with type filtering, detailed game info including ratings and mechanics, collection queries with extensive filters, hot lists, user profiles, and UK pricing via BoardGamePrices.co.uk. The experimental rules tool searches BGG forums to answer gameplay questions. Also includes a trade finder for matching wanted games between users and algorithmic recommendations from Recommend.Games. Built in Go using the GoGeek library and ships as a Docker image. Requires a BGG API key for most operations. Reach for this when you need structured access to BGG's catalog and community data without scraping HTML or wrestling with their XML API directly.

GitHub stars: 59
tools: 10
transport: STDIO
env vars: 4
last updated: Oct 14, 2026

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.

Configuration

BGG_API_KEY

API key for BoardGameGeek authentication (recommended). Obtain from https://boardgamegeek.com/applications

BGG_COOKIE

Cookie string for BGG authentication (alternative to API key). Format: 'bggusername=user; bggpassword=pass; SessionID=xyz'

BGG_USERNAME

Your BoardGameGeek username for references such as ME or MY in prompts

BGG_DISABLE_UPDATE_CHECK

Set to true to stop the server checking GitHub for a newer release

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
Category: Data & Analytics
Package: docker.io/kdaniel/bgg-mcp:1.9.2
Transport: STDIO
Registry: MCP registry, active

Related Data & Analytics MCP servers

View all

Postgreswaystation-ai/mcpConnect to your PostgreSQL database to query data and schemas.0stars

Supabasewaystation-ai/mcpConnect to your Supabase database to query data and schemas.0stars

Saga Mcpspranab/saga-mcpJira-like project tracker for AI agents with SQLite, full task hierarchy, and dashboard42stars

Alive Analysiswith-geun/alive-analysisQuery alive-analysis history from any AI client. Tools: list, get, search, dashboard export.42stars

Bilig WorkPaperproompteng/biligFormula-backed WorkPaper tools for workbook readback, input edits, and JSON persistence.35stars

YouTube Datakirbah/mcp-youtubeYouTube MCP server for token-optimized, structured data using the YouTube Data API v3.33stars

BoardGameGeek MCP Server

Tools

Configuration

Readme

Details

More from kkjdaniel

Related Data & Analytics MCP servers