BGG MCP

BGG MCP

MCP to enable interaction with the BoardGameGeek API via AI tooling.

22
Stars
5
Forks
6
Releases

Overview

BGG MCP is a Go-based MCP server that provides access to BoardGameGeek's API through the Model Context Protocol. It enables retrieval and filtering of board game data, user collections, and profiles, backed by the GoGeek v2 library for robust API interactions. The server aggregates resources from external services: pricing data from BoardGamePrices.co.uk and algorithmic game recommendations from Recommend.Games. It exposes a core set of MCP tools for search, details, collection, hotness, user profiles, price lookups, trade opportunities, and recommendations, with an experimental tool for BGG rules discussions. Authentication is required and can be configured via BGG_API_KEY or BGG_COOKIE, with optional BGG_USERNAME to enable personal references. Direct AI-friendly resources are available as bgg:// hotness and bgg://my-collection URIs. The project supports easy installation via Smithery or MCP Registry and can be built with standard Go tooling; configuration details cover both Smithery and manual setups, including how to add authentication credentials. The server uses the latest Streamable HTTP transport and is designed to empower AI assistants and tools to interact with BGG data in natural language conversations.

Details

Owner
kkjdaniel
Language
Go
License
MIT License
Updated
2025-12-07

Features

Core Tools Suite

Access and manipulate BGG data via a core set of MCP tools, including bgg-search, bgg-details, bgg-collection, bgg-hot, bgg-user, bgg-price, bgg-trade-finder, and bgg-recommender.

Experimental Tool: bgg-rules

Experimental tool that answers rules questions by searching BGG forums for relevant discussions and clarifications.

Authentication and Access Control

Supports API Key or Cookie-based authentication; optional BGG_USERNAME enables personal references in queries.

Price Data Integration

Real-time pricing data from BoardGamePrices.co.uk across multiple retailers.

Recommendations Engine

Algorithmic similarity-based game recommendations powered by Recommend.Games.

AI-friendly Resources

Direct access to BGG data via bgg:// URIs for hotness and personal collection.

Go-based MCP Server

Implemented in Go using the GoGeek v2 library for robust API interactions.

Installation and Connectors

Smithery integration and MCP Registry availability with connector options for Claude and other tools.

Audience

AI developersIntegrate BGG data into MCP-enabled AI assistants for retrieval and filtering.
Bot buildersBuild conversational agents that query BGG data and provide recommendations.
System integratorsConfigure authentication, connectors, and deployments for enterprise MCP workflows at scale.

Tags

BGGBoardGameGeekMCPGoGoGeekPricingRecommendationsSmitheryMCP RegistryAITools