# BoardGameGeek MCP for AI Agents AI Agent Connect > BoardGameGeek lets you plug the world's biggest board game database directly into your AI client. You can search through over 150,000 titles, pull deep metadata like complexity weights and ratings, and analyze user play history without leaving your chat interface. It turns your agent into a tabletop gaming expert that knows every rulebook and community forum. ## Overview - **Category:** knowledge-management - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_Lrs8m3uk5o8LPS3DtgwijQDM4pTZeHRzgP1pRKHI/ai-agent-connect - **Tags:** board-games, database-search, user-collections, game-ratings, community-forums, play-tracking ## Description This Connector connects your AI agent to the world's largest board game database. If you spend your time digging through endless forums or trying to find that one specific board game based on player count and duration, you know how tedious that manual search can be. This connection changes that by giving your agent a direct line to the data. Instead of copy-pasting information from multiple tabs, you can just ask your agent to find games that fit your group size or check what a specific reviewer said about a new release. It pulls everything from basic game stats like play time and complexity to deep community insights like forum threads and guild details. Because Vinkius makes it easy to manage these connections, you can get these insights into your workflow without worrying about API keys or complex setups. It makes researching the hobby feel less like a data entry job and more like a conversation. Whether you're looking for your next game night staple or researching market trends for a new release, the data is right there for you to use. You can quickly identify which titles have the highest ratings or see how many people actually own a certain expansion. This isn't just a list of names; it's a way to see how the community interacts with the games they love. You can see who is playing what, read through rules clarifications, and discover new guilds based on shared interests. It turns a massive, often overwhelming database into a structured resource that your agent can navigate on your behalf. ## Tools ### get_game_plays See who played a game and when they did it. This helps you gauge how active a game's community actually is. ### get_user_plays Look up a specific user's play history and comments. You can filter these logs by specific date ranges. ### search_games Find games by name to get their unique BGG IDs. This is the first step for deep inspection of any title. ### get_thread Read specific forum discussions or rules clarifications. It helps you find answers to niche questions about a game. ### get_user_collection View a player's entire collection including ratings and status. You can filter by game types or see what's on their wishlist. ### get_forum_list List all discussion areas for a specific game. Use these IDs to navigate to the right community threads. ### get_guild Get details on community groups organized around shared interests. Use this to find local or online tabletop groups. ### get_hot_items See what's currently trending in board games or RPGs. It's great for spotting new hits in the hobby quickly. ### get_thing Fetch full metadata for a game using its BGG ID. You get everything from player counts to complexity weights in one go. ### get_user_info Pull a user's profile to see their preferences and connections. It helps you understand a player's specific tastes. ## Prompt Examples **Prompt:** ``` Find some highly rated games for 2 players with a play time under 90 minutes. ``` **Response:** ``` Here are some highly-rated titles that fit a 2-player, sub-90-minute window: | Game Title | Rating | Complexity | Play Time | | :--- | :--- | :--- | :--- | | **7 Wonders Duel** | 8.6/10 | 2.4/5 | 30-45 min | | **Patchwork** | 8.3/10 | 1.8/5 | 15-30 min | | **Splendor Duel** | 8.1/10 | 2.1/5 | 30 min | Would you like to see the full descriptions for any of these? ``` **Prompt:** ``` What are the top 5 trending board games right now? ``` **Response:** ``` The current trending titles on BoardGameGeek include: 1. **Ark Nova: Marine Worlds** 2. **Terraforming Mars: Ares Expedition** 3. **Dune: Imperium - Uprising** 4. **Cascadia: Landmarks** 5. **Great Western Trail** These are currently seeing high engagement across the community. ``` **Prompt:** ``` Show me the forum threads for the rules of Ark Nova. ``` **Response:** ``` I found the following community discussion areas for **Ark Nova**: - **Rules Clarifications** (Thread ID: 45678) - **Strategy & Tactics** (Thread ID: 45679) - **General Discussion** (Thread ID: 45680) Would you like me to read the rules clarification thread and summarize the specific mechanics you're looking for? ``` ## Capabilities ### Search 150,000+ board games by name Find any title in the database instantly with your AI agent. ### Pull detailed game stats Get complexity weights, ratings, and player counts for any game. ### Track trending titles See what is currently popular across board games and RPGs. ### Browse personal user collections View what games other players own, rate, or have on their wishlist. ### Analyze historical play logs Check specific play dates, locations, and user comments. ### Read community forum threads Access rules clarifications and discussion threads directly. ### Locate tabletop guilds Find community groups organized around shared tabletop interests. ## Use Cases ### Finding a game for a specific group size A user asks for a 3-player game that takes under 90 minutes. The agent finds several options and shows their ratings. ### Checking community sentiment A designer wants to know what people think of a new RPG. The agent reads the latest forum threads to summarize the mood. ### Data gathering for video reviews A creator needs the specs for 10 top-rated games. The agent pulls the descriptions and complexity weights into a list. ### Friend collection lookup A player wants to see if a friend already owns a specific expansion. The agent checks the friend's public collection. ## Benefits - Skip manual searches by using `search_games` to find titles and IDs instantly. - Get precise data on game difficulty with `get_thing` complexity weights. - See what's currently popular by using `get_hot_items` to spot trends. - Read community opinions directly via `get_thread` without clicking through pages. - Organize game nights faster by checking `get_user_plays` for duration and player counts. - Research competitor titles using `get_user_collection` to see what people actually own. ## How It Works The bottom line is you get instant access to a massive tabletop database without the manual browsing. 1. Subscribe to the BoardGameGeek MCP through Vinkius. 2. Connect your preferred AI client to the Vinkius catalog. 3. Ask your agent to find games, check ratings, or read forum threads. ## Frequently Asked Questions **Can I use the BoardGameGeek MCP to find specific game rules?** Yes, you can ask your agent to fetch specific forum threads where rules are discussed. It can then summarize those points for you. **Does the BoardGameGeek MCP work with my current AI client?** It works with any MCP-compatible client like Claude, Cursor, or Windsurf. **Can I see what games my friends own using the BoardGameGeek MCP?** Yes, you can use the tool to browse any user's public collection and see their ratings and play counts. **How does the BoardGameGeek MCP help with game night planning?** It lets you filter by player count and duration to find the perfect fit for your group, saving you from browsing dozens of individual pages. **Can I see what's currently popular on BoardGameGeek?** Yes, the Connector can pull the latest hot items across board games, RPGs, and other hobby categories instantly. **Do I need an API key to use the BoardGameGeek MCP?** No, the connection is ready to use as soon as you subscribe through Vinkius. **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.