# MasterGo MCP for AI Agents AI Agent Connect

> MasterGo MCP lets your AI agent read and manage design files directly. You can ask your agent to find specific layers, audit your style library, or check team comments without clicking through nested folders. It turns your design workspace into a searchable, queryable database for your AI.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_zI4TJIBtwjDcLIebHu0qLLZdFYD1MPDEdjy41B8D/ai-agent-connect
- **Tags:** ui-ux-design, design-collaboration, prototyping, design-systems, workflow-automation, asset-management

## Description

MasterGo is the design tool your agent needs to understand your UI/UX work. When you connect this Connector, you give your AI client a direct line to your design files, layers, and style libraries. By connecting MasterGo to your agent, you turn complex design file navigation and project coordination into a natural conversation. Instead of clicking through nested folders or scrolling through endless frames, you can just ask your agent to find a specific component or tell you what the latest feedback is. It handles the navigation for you, pulling data like color variables, typography, and node structures into your chat. This is a huge win for staying organized, especially when you're managing a massive design system across multiple projects. By using Vinkius to host this connection, you get a reliable way to turn your static design assets into a searchable database. Your agent becomes a design assistant that can audit styles, check version histories, and summarize team comments in seconds. It removes the friction of switching tabs just to find a single hex code or a specific layer name.

## Tools

### get_project_files
Grabs all files within a specific project. Use this to see how your assets are organized by project.

### list_nodes
Lists every frame and layer in a file. This lets you see the exact UI structure of a design.

### list_projects
Lists all your team projects. Use this to quickly navigate between different client work.

### list_styles
Pulls all colors and typography styles. This lets you audit your design system's components instantly.

### list_teams
Lists the available teams in your workspace. Use this to see how your organization is structured.

### get_comments
Fetches all comments from a specific design file. Use this to see what the team is saying without opening the app.

### get_file
Retrieves the core details of a design file. This helps you get high-level info about a specific project.

### get_file_versions
Pulls the history of changes for a file. Use this to see what happened in previous iterations of a design.

### get_org_members
Lists everyone in your organization. This is useful for seeing who has access to your workspace.

### list_files
Shows every file in your MasterGo workspace. This gives you a bird's-eye view of all your design assets.

## Prompt Examples

**Prompt:** 
```
List all the colors and fonts used in the 'Core UI' file.
```

**Response:** 
```
I've retrieved the styles for the 'Core UI' file. Here is the breakdown:

| Category | Count |
| :--- | :--- |
| **Color Variables** | 14
| **Typography Styles** | 9

Would you like me to list the specific hex codes and font weights for these?
```

**Prompt:** 
```
What is the latest feedback on the mobile landing page?
```

**Response:** 
```
I've pulled the comments for the mobile landing page. There are 3 active threads:

*   **Header Fix:** Feedback on the logo alignment.
*   **CTA Button:** Request to change the color to primary blue.
*   **Spacing:** Note about the padding on the hero section.

Would you like me to summarize these for you?
```

**Prompt:** 
```
Show me the version history for the 'Design System' project.
```

**Response:** 
```
Here is the recent version history for the 'Design System' project:

*   **v2.4.0** (Today): Added new icon set.
*   **v2.3.9** (Yesterday): Fixed typography weight on buttons.
*   **v2.3.8** (2 days ago): Updated primary color palette.

Do you want to see the details for a specific version?
```

## Capabilities

### List all projects
See every project in your workspace at a glance.

### Fetch specific layers
Pull granular node and layer data for specific UI elements.

### Check design styles
Retrieve all colors and typography styles from your files.

### Read team comments
Get all feedback and comments from a specific design file.

### View version history
Check previous versions to see how a design has changed over time.

### Identify org members
List the members who have access to your organization.

## Use Cases

### Finding a specific button style
A designer wants to know if a specific button style exists in the library. They ask the agent to list styles.

### Summarizing team feedback
A product manager wants to see all feedback on a mobile prototype. They ask the agent to fetch comments.

### Getting specs for handoff
A frontend developer needs to get all colors from a specific file. They ask the agent to list styles for that file.

### Auditing project files
A design ops lead wants to see how many projects are currently active. They ask the agent to list projects.

## Benefits

- Stop digging through folders by using list_files to find assets instantly.
- Get exact hex codes and font weights from list_styles without opening the app.
- See all team feedback at once with get_comments to stay on top of revisions.
- Audit your design system's consistency using list_nodes to check layer structures.
- Track project progress over time by checking the history with get_file_versions.

## How It Works

The bottom line is that your AI gets direct eyes on your design files so you can stop hunting for specs.

1. Subscribe to the MasterGo MCP on the Vinkius catalog.
2. Enter your MasterGo API Token (X-MG-Authentication) into your AI client.
3. Ask your agent to find files, list styles, or summarize comments.

## Frequently Asked Questions

**Can the MasterGo MCP help me find specific design assets?**
Yes. It allows your agent to search through your design files and list specific layers or nodes so you can find exactly what you need without manual searching.

**How does the MasterGo MCP help with design system audits?**
It lets you query your style libraries instantly. You can ask your agent to list all colors or typography styles to check for consistency across your files.

**Can I use the MasterGo MCP to see what my team is saying?**
Yes, you can fetch all comments from a specific design file. This helps you stay updated on team feedback and project notes without switching apps.

**Does the MasterGo MCP work with my existing design files?**
It connects directly to your MasterGo workspace, giving your agent access to the files and projects you already have set up.

**How does the MasterGo MCP help frontend developers?**
It helps developers quickly retrieve exact style information, like hex codes and font weights, directly from the design files for more accurate implementation.

**Can the MasterGo MCP list all my projects at once?**
Yes. Your agent can list all team projects in your workspace, giving you a high-level view of your work across different clients or products.

**How do I obtain a MasterGo API Token?**
Log in to MasterGo, go to the [Developer Center](https://mastergo.com/developers), and create a new application or generate a personal access token under your account settings.

**Can I read specific layer information through this server?**
Yes. Use the `list_nodes` tool with the file key and optional node IDs. This allows your agent to retrieve detailed data about frames, layers, and their properties.

**What is a 'fileKey' in MasterGo?**
The `fileKey` is the unique identifier found in the URL of your MasterGo design file. It typically appears after `/file/` in the browser address bar.