How do I find a game's BGG ID to get full details?

Use the `search_games` tool with the game's name. The results include the BGG ID for each match. Then pass that ID to `get_thing` for complete metadata including ratings, player count, complexity weight and description.

Can I see what board games are currently trending?

Absolutely! Use the `get_hot_items` tool. By default it returns the 50 hottest board games, but you can also check trending RPGs, video games, or even industry people by specifying the type parameter.

Does this integration allow modifying data on BoardGameGeek?

No. All tools are strictly read-only queries. You can search, explore collections, read forums and analyze play history, but no data on BoardGameGeek will be created, modified or deleted through this integration.

BoardGameGeek MCP Server for Mastra AI 10 tools — connect in under 2 minutes

Name: BoardGameGeek
Availability: InStock
Author: Vinkius

docs.mastra.ai/docs/agents/mcp-tools

Built by Vinkius GDPR 10 Tools SDK

Mastra AI is a TypeScript-native agent framework built for modern web stacks. Connect BoardGameGeek through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.

Get MCP Server for AI Agents

ASK AI ABOUT THIS MCP SERVER

Open in ChatGPT Open in Claude Open in Perplexity

Vinkius supports streamable HTTP and SSE.

typescript

import { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";

async function main() {
  // Your Vinkius token. get it at cloud.vinkius.com
  const mcpClient = await createMCPClient({
    servers: {
      "boardgamegeek": {
        url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
      },
    },
  });

  const tools = await mcpClient.getTools();
  const agent = new Agent({
    name: "BoardGameGeek Agent",
    instructions:
      "You help users interact with BoardGameGeek " +
      "using 10 tools.",
    model: openai("gpt-4o"),
    tools,
  });

  const result = await agent.generate(
    "What can I do with BoardGameGeek?"
  );
  console.log(result.text);
}

main();

Fully ManagedVinkius Servers

60%Token savings

High SecurityEnterprise-grade

IAMAccess control

EU AI ActCompliant

DLPData protection

V8 IsolateSandboxed

Ed25519Audit chain

<40msKill switch

Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

About BoardGameGeek MCP Server

Connect your BoardGameGeek account to any AI agent and unlock the full analytical power of the world's largest board game database.

Mastra's agent abstraction provides a clean separation between LLM logic and BoardGameGeek tool infrastructure. Connect 10 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.

What you can do

Smart Game Search — Find any of 150,000+ board games by name with fuzzy or exact matching, instantly retrieving BGG IDs for deep inspection
Deep Game Intelligence — Fetch comprehensive metadata for any game: year published, player count range, play time, complexity weight, Bayesian rating, user rating, global rank, description and artwork
Trending Discovery — See what's hot right now across board games, RPGs, video games, and industry people
User Collections — Browse any player's full collection with personal ratings, play counts, wishlist and want-to-play status
Play History Analytics — Analyze a user's logged play sessions filtered by date range, revealing play patterns and favorite games
Community Engagement — Access game forums, read discussion threads, rules clarifications and community reviews
Guild Exploration — Discover BGG guilds, their members and community organizing around shared tabletop interests

The BoardGameGeek MCP Server exposes 10 tools through the Vinkius. Connect it to Mastra AI in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

How to Connect BoardGameGeek to Mastra AI via MCP

Follow these steps to integrate the BoardGameGeek MCP Server with Mastra AI.

Install dependencies

Run npm install @mastra/core @mastra/mcp @ai-sdk/openai

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token

Run the agent

Save to agent.ts and run with npx tsx agent.ts

Explore tools

Mastra discovers 10 tools from BoardGameGeek via MCP

Why Use Mastra AI with the BoardGameGeek MCP Server

Mastra AI provides unique advantages when paired with BoardGameGeek through the Model Context Protocol.

Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add BoardGameGeek without touching business code

Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation

TypeScript-native: full type inference for every BoardGameGeek tool response with IDE autocomplete and compile-time checks

One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure

BoardGameGeek + Mastra AI Use Cases

Practical scenarios where Mastra AI combined with the BoardGameGeek MCP Server delivers measurable value.

Automated workflows: build multi-step agents that query BoardGameGeek, process results, and trigger downstream actions in a typed pipeline

SaaS integrations: embed BoardGameGeek as a first-class tool in your product's AI features with Mastra's clean agent API

Background jobs: schedule Mastra agents to query BoardGameGeek on a cron and store results in your database automatically

Multi-agent systems: create specialist agents that collaborate using BoardGameGeek tools alongside other MCP servers

BoardGameGeek MCP Tools for Mastra AI (10)

These 10 tools become available when you connect BoardGameGeek to Mastra AI via MCP:

get_forum_list

g. Reviews, Rules, General, Strategy) associated with a specific board game by its BGG ID. Use the returned forum IDs to browse individual threads. List discussion forums for a board game

get_game_plays

Returns who played, when, and any comments. Useful for gauging a game's active community and recent engagement. Get recent play logs for a specific board game

get_guild

Guilds are community groups on BGG organized around shared interests. Get details about a BoardGameGeek guild

get_hot_items

Defaults to "boardgame" type but also supports "rpg", "videogame", "boardgameperson", "boardgamecompany". Ideal for discovering what is popular in the hobby right now. Get the current trending/hot board games on BoardGameGeek

get_thing

Returns game names, year published, min/max players, playing time, complexity weight, Bayesian/user ratings, rank, description and thumbnail. Use comma-separated IDs for multiple games. Get detailed info for a board game by BGG ID

get_thread

Useful for reading discussions, rules clarifications, or reviews about a game. Read a specific forum thread on BoardGameGeek

get_user_collection

Returns all games owned with stats, ratings, play counts, own/want/wishlist status. Optionally filter by subtype or exclude expansions. Get a BGG user's board game collection

get_user_info

Useful for understanding a user's preferences and social connections on the platform. Get a BoardGameGeek user profile

get_user_plays

Returns game names, play dates, locations, quantities and comments. Optionally filter by date range using YYYY-MM-DD format. Get a user's board game play history

search_games

Returns matching games with their BGG IDs, primary names, year published. Use the returned ID with get_thing to fetch full details including ratings, player count and complexity. Search for board games by name on BoardGameGeek