How to Use the BoardGameGeek MCP in Windsurf

Q: Can Cascade fetch forum discussions using BoardGameGeek on Windsurf?

Yes. Cascade chains getforumlist to find active forums for a game, then runs getthread to pull down specific discussion posts. This lets your agent analyze rules clarifications or reviews right inside your IDE.

Q: How do I track trending games inside Windsurf?

You ask Cascade to check what is popular, and it runs gethotitems to pull the top trending board games. It can then write these trending titles directly to a markdown file or JSON database in your project.

Get raw BoardGameGeek stats, forum threads, and user collections directly inside Windsurf to build and test tabletop apps.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect BoardGameGeek MCP to Windsurf

Create your Vinkius account to connect BoardGameGeek to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup BoardGameGeek with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Find and inspect games inside Windsurf

The `search_games` tool lets Cascade search the BoardGameGeek database by name to return game IDs and publish years. Once Cascade gets the ID, it chains `get_thing` to pull down player counts, complexity weights, and user ratings without needing your intervention. You don't have to copy-paste IDs or look up stats in a browser. Cascade handles the entire lookup sequence autonomously, giving your workspace the exact tabletop data points required for your code.

Analyze community play trends with this MCP Server

The `get_hot_items` tool fetches trending board games, RPGs, or designers currently buzzing on the BoardGameGeek platform. Cascade tracks these shifts over time and feeds the raw trending data directly into your active files or local database scripts. Combining this with `get_game_plays` lets your agent pull recent play logs to verify active player engagement for any specific game. You get raw numbers on who played, when, and what they commented, helping you build data-driven recommendations.

Load user collections into Windsurf workspaces

The `get_user_collection` tool pulls any public BoardGameGeek user's owned games, wishlists, and ratings directly into your workspace. Cascade reads this JSON payload, parses the play counts, and filters out expansions or specific subtypes based on your prompt. Your agent can immediately write scripts to analyze this collection data, finding common games among multiple users or generating custom stats. It saves you from manual API integration work by handling the raw data retrieval natively.

Setup guide

Set up BoardGameGeek MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the BoardGameGeek MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my BoardGameGeek payment history." If connected, Cascade will call the BoardGameGeek tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "boardgamegeek-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by BoardGameGeek. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect BoardGameGeek now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about BoardGameGeek MCP in Windsurf

Windsurf connects to the MCP Server using your Vinkius endpoint token added to your local configuration file. Cascade automatically discovers the ten available tools, allowing it to fetch game details or forum threads during your coding sessions.

Yes. Cascade chains `get_forum_list` to find active forums for a game, then runs `get_thread` to pull down specific discussion posts. This lets your agent analyze rules clarifications or reviews right inside your IDE.

No. The server only accesses public BoardGameGeek profiles and collections. If a user profile is private on the website, the server cannot retrieve its data.

You ask Cascade to check what is popular, and it runs `get_hot_items` to pull the top trending board games. It can then write these trending titles directly to a markdown file or JSON database in your project.

Vinkius runs this MCP Server in an isolated sandbox, meaning your BGG profile queries and collection data are never stored or shared. The server only reads public data from the BGG API and passes it directly to your local Windsurf instance.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript