@pipeworx/boardgamegeek

Connect: https://pipeworx.io/mcp — every tool in the catalog, including @pipeworx/boardgamegeek’s. Install: one-click buttons

No MCP client? Skip the connection: POST https://gateway.pipeworx.io/v1/tools/search_packs {"query":"..."} to find a tool below, GET /v1/tools/<name> for its schema, POST the same URL with arguments for the data — see For AI agents.

Tools: 4

Board-game metadata, community ratings and ranks, name search and the trending list from BoardGameGeek’s board game database.

Tools

• bgg_get_games(ids, include_stats?) — up to 20 games by BoardGameGeek id: names, year, player count, play time, categories, mechanics, designers, publishers, and community statistics (rating, Bayes average, ranks, weight, owner counts).
• bgg_search_games(query, exact?, include_expansions?, limit?) — find BoardGameGeek ids by name. Reports total and truncated.
• bgg_hot_games(limit?) — the current “hot” list in rank order.
• bgg_user_collection(username, owned_only?, limit?) — a member’s owned/wishlist games with their own ratings and play counts. Large collections are queued by BoardGameGeek and may need a retry.

Auth

BYO only. BoardGameGeek answers unauthenticated requests with 401 and issues a token only to a registered application. Pass yours as _apiKey; without it every tool refuses with “requires an API key” and makes no upstream call.

Terms. BoardGameGeek licenses its API data for strictly non-commercial use, bars using it to train AI/LLM systems, and requires a separate commercial licence (offered case by case) for commercial use; attribution (“Powered by BGG”) applies to public-facing uses. Those terms bind whoever registers the application, which is why this pack carries no Pipeworx token. (Quoted from the terms as mirrored on BoardGameGeek’s sister-site wikis; the primary pages were behind a bot wall when this was written, so check them before relying on the wording.)

Data sources

• BoardGameGeek, board game database — game records, community ratings and ranks, member collections.

Notes for the next person: BGG double-encodes description text (
), so descriptions are decoded twice. Not Ranked is the literal rank value for an unranked game and is returned as null. The collection endpoint answers 202 while it builds the list; the pack retries twice. Test fixtures are synthetic documents in BGG’s documented shape (no token was available at build); the first keyed call after a token exists is the real shape check.

Tools

• bgg_get_games — Get BoardGameGeek details for up to 20 games by BoardGameGeek id: name, year, player count, play time, categories, mechanics, designers, and community statistics (rating, rank, weight, owners). Requir
• bgg_search_games — Search BoardGameGeek for board games and expansions by name. Returns BoardGameGeek ids to pass to bgg_get_games. Requires your own BoardGameGeek application token as _apiKey.
• bgg_hot_games — The BoardGameGeek “hot” list: the 50 board games currently trending on BoardGameGeek, in rank order. Requires your own BoardGameGeek application token as _apiKey.
• bgg_user_collection — A BoardGameGeek member’s game collection (owned, wishlist, rated). Requires your own BoardGameGeek application token as _apiKey. Large collections are queued upstream and may take a retry.