# BoardMix MCP MCP

> BoardMix connects your AI agent directly to your entire visual workspace. It lets you manage whiteboards, retrieve specific nodes, and track file versions just by talking to it. Stop clicking through complex design menus; simply ask your agent for project roadmaps or team updates across all your files.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** whiteboarding, visual-brainstorming, project-coordination, team-collaboration, node-management, creative-workflow

## Description

Visual planning used to mean jumping between dozens of tabs and manually tracing connections on massive boards. This MCP lets you bypass that mess entirely. Your AI client talks directly to the BoardMix system, treating your entire visual library like a single database. You can ask it things like, 'What did we decide about Project X last month?' and get an immediate rundown by pulling version history, or, 'Show me all the sticky notes related to billing.' It doesn't just search file names; it reads the actual content of nodes and shapes across multiple boards. This makes complex collaboration coordination feel like a conversation instead of homework. When you connect BoardMix via Vinkius, your agent acts as a real-time visual assistant, giving you full control over files, teams, and templates without ever needing to navigate the design workspace itself.

## Tools

### create_file
Generates a brand new whiteboard file in your workspace.

### get_comments
Retrieves all written comments left on a specific whiteboard.

### get_file
Pulls detailed information about an existing whiteboard file.

### get_file_versions
Checks the full change history and version timeline for a specific board file.

### get_org_info
Fetches high-level details about your entire organization setup within BoardMix.

### list_files
Provides a list of all board files accessible in your account.

### list_nodes
Extracts and lists the specific shapes and connected nodes from a given whiteboard file.

### list_team_projects
Lists all major projects currently assigned to your teams.

### list_teams
Provides a list of active collaboration teams in your workspace.

### list_templates
Shows all pre-built design templates available to kickstart new boards.

## Prompt Examples

**Prompt:** 
```
List all whiteboards in my BoardMix workspace.
```

**Response:** 
```
I've retrieved your BoardMix whiteboards. You have 3 active boards: 'Q3 Brainstorming', 'Product Architecture', and 'Team Retrospective'. Which one would you like to explore?
```

**Prompt:** 
```
Show me the comments for whiteboard 'board-8821'.
```

**Response:** 
```
I've listed the comments for 'board-8821'. There are 5 recent threads, including feedback on the flow diagram and a question about the next milestone. Would you like a detailed summary?
```

**Prompt:** 
```
Retrieve the nodes for whiteboard 'architecture-layout'.
```

**Response:** 
```
I've retrieved the nodes for 'architecture-layout'. It includes 12 rectangle shapes, 8 text blocks, and 5 connected lines. Would you like me to analyze the connections?
```

## Capabilities

### Inventory all boards and assets
Your agent can list every board file in your workspace, or retrieve details about a specific team's project structure.

### Analyze visual content
It pulls out specific components like shapes, text blocks, and connected lines (nodes) from any given whiteboard to understand the layout instantly.

### Track history and feedback
You can check a file's version timeline or pull all recorded comments across multiple boards in one go.

### Manage team context
The system lists available teams, projects, and design templates to help you get started on new work.

## Use Cases

### Auditing a large project roadmap
The PM needs to see if the 'Payment Flow' board still contains the original scope requirements. They ask their agent to run `get_file` on the board and then check `list_nodes` for specific keywords, confirming that the nodes detailing the initial payment method are still present.

### Onboarding a new team member
A workshop facilitator needs to show the new hire what tools they have. They use the agent to `list_templates` and then `list_teams`, giving them an immediate overview of all available starting points and active groups.

### Tracking design iterations
A UX designer discovers a change in a board's core flow. They ask the agent to run `get_file_versions` on the specific file, identifying exactly which version contained the previous state and who made the last edit.

### Gathering consensus feedback
A team lead wants a summary of all client comments. They use the agent to `get_comments` for three different files across multiple teams, compiling all recent discussion points into one report without manual copying.

## Benefits

- Avoid manual file hunting. Instead of clicking through folders, ask your agent to `list_files` and immediately get a rundown of every board available to you.
- Pinpoint exact feedback instantly. Need to know who said what about the architecture diagram? Use `get_comments` to gather all discussion threads across any specific whiteboard file.
- Never lose context again. If you need to see how the project scope changed three months ago, simply run `get_file_versions` and get a full audit trail.
- Organize complex work streams. The agent can list team projects and available teams (`list_team_projects`, `list_teams`), helping you structure your collaboration before starting any new board.
- Understand the visual layout at depth. Instead of just looking at the board, use `list_nodes` to retrieve a structured data dump of every shape and connection, perfect for analysis.

## How It Works

The bottom line is you use plain language prompts to perform deep, complex actions within the visual design platform.

1. Subscribe to this MCP and enter your BoardMix License Key and API Secret.
2. Connect the credential set to your preferred agent client, like Cursor or Windsurf.
3. Ask your AI agent a natural language question, such as 'List all files related to Q4 planning' to get an immediate answer.

## Frequently Asked Questions

**How do I use get_comments with BoardMix?**
You first need a file ID or board name. Then you ask your agent to run `get_comments` on that specific identifier, and it returns all the discussion threads attached to that board.

**Can list_nodes help me understand my design?**
Yes, `list_nodes` extracts structured data about every shape and connection. Instead of visually tracing lines on a huge board, you get an organized list of all elements and how they connect.

**How do I check the history using get_file_versions?**
`get_file_versions` takes a file ID and gives you every milestone recorded for that whiteboard. You can see exactly when changes were made, which is critical for auditing.

**What if I want to start a new board?**
Use the `create_file` tool. It generates an entirely new, blank whiteboard in your workspace ready for collaboration. You can also use `list_templates` first to find a better starting point.

**When should I use `get_org_info` to check my workspace scope?**
This tool provides the core details for your entire BoardMix organization. Use it when you need context about the parent structure or overall account settings before running specific actions on individual boards.

**How does `list_templates` help me find a starting point?**
It retrieves all available design templates in your workspace library. Instead of building from scratch, you can browse these pre-built resources and select the perfect format for your new project.

**What if I need to check specific file metadata using `get_file`?**
This function pulls detailed information about a single whiteboard file. It's useful for checking ownership, creation dates, or general status without needing the full board content itself.

**How can I use `list_team_projects` to scope my search?**
This tool gives you a list of all defined team projects. If your workspace is large, using this narrows down the available boards and assets to only those relevant to a specific initiative.