# Pixso MCP

> Pixso MCP connects your AI client directly to a professional design platform, letting you manage complex UI/UX projects through natural conversation. Instead of clicking through dozens of tabs and file structures, your agent can instantly list all accessible files, audit defined color palettes, or retrieve granular layer details for any project—all without you ever leaving your chat window.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** ui-ux-design, collaborative-design, design-systems, prototyping, version-control, design-files

## Description

This MCP lets you treat your design workflow like a conversation. You connect it to Vinkius through your AI client and suddenly, complex tasks that used to require navigating the entire Pixso workspace feel simple. Your agent acts as a real-time assistant for any project—whether you're building out a massive design system or just need to verify a single component color code.

Need an overview of what's available? You can ask your agent to list every accessible design file and project right away. If you're working on components, it retrieves granular design nodes and layers so you know the exact UI structure instantly. Need to track who worked on something or when? The MCP lets you check version history for files or look up comments left by team members across multiple projects.

It helps keep your assets organized and your team aligned without manual overhead. It's about making deep, structural design data available through natural language commands.

## Tools

### get_comments
Retrieves recent comments and feedback left on a specific design file.

### get_file
Fetches detailed metadata about a selected design file.

### get_file_versions
Shows the complete version history and milestones for a specific design asset.

### get_org_members
Lists all people who are members of the current organization workspace.

### get_project_files
Retrieves a list of design files associated with a specific project.

### list_files
Gets a comprehensive inventory of all accessible Pixso design files in your workspace.

### list_nodes
Provides a detailed list of every structural node and layer inside an open design file.

### list_styles
Audits and lists all defined design styles, including color variables and typography settings.

### list_team_projects
Lists the various projects that belong to a specific team group.

### list_teams
Retrieves a list of all active teams within the Pixso workspace.

## Prompt Examples

**Prompt:** 
```
List all design files in my Pixso workspace.
```

**Response:** 
```
I've retrieved your Pixso design files. You have 4 active files, including 'Checkout Flow' and 'Design System v1.2'. Which one would you like to explore?
```

**Prompt:** 
```
Show me the comments for file 'pix-8821'.
```

**Response:** 
```
I've listed the comments for 'pix-8821'. There are 5 recent threads, including feedback on the CTA button color and footer alignment. Would you like a detailed summary?
```

**Prompt:** 
```
Retrieve the style library for design file 'branding-assets'.
```

**Response:** 
```
I've retrieved the styles for 'branding-assets'. It includes 12 primary color variables and 8 typography styles. Would you like me to list them all for you?
```

## Capabilities

### Identify all project assets
List every accessible design file and project across the entire Pixso workspace.

### Inspect UI structure details
Retrieve specific, granular design nodes and layers to understand a component's underlying structure.

### Audit style guidelines
List defined style elements, including color variables and typography rules, across selected files.

### Manage team visibility
View available teams, list all members in an organization, or get a roster of projects assigned to specific teams.

### Track design changes and feedback
Check the full version history of any file, or gather recent comments left by team collaborators.

## Use Cases

### The developer needs style validation
A frontend developer can ask their agent to list styles for 'branding-assets'. The agent responds with the 12 primary color variables and 8 typography rules, allowing them to code components accurately without manually opening the design file.

### The PM needs a project status summary
A product manager asks their agent about 'Checkout Flow'. The agent responds by checking the version history and listing recent comments, providing an immediate status update on feedback and milestones.

### The designer is starting a new system
A design ops person uses the MCP to list teams and then asks for all projects under 'Design System v1.2'. This gives them a clean, comprehensive overview of where their assets are spread.

### Finding that one component detail
Instead of manually clicking into dozens of files to find the nodes for the navigation bar, the agent uses list_nodes on 'Homepage' and returns a structured list of layers, solving the problem in seconds.

## Benefits

- Instead of digging through folders, your agent lists all design files instantly. You can get a complete inventory of every project asset with one command.
- Stop guessing where the correct color code is. The MCP audits and lists all defined styles, including primary colors and typography variables, letting you pull exact specs immediately.
- Track who made what and when. You can check the version history of any file or list organization members to keep everyone aligned on ownership.
- Understand component structure instantly. The agent retrieves granular design nodes and layers, providing a blueprint view without needing to open the file in the editor.
- Stay informed about team progress by listing file comments. You get visibility into feedback threads across multiple projects via your AI client.

## How It Works

The bottom line is you talk to your agent, and it executes complex commands directly within Pixso without you touching the UI.

1. Subscribe to this MCP on Vinkius and enter your Pixso Client ID and Secret.
2. Connect your preferred AI client (Claude, Cursor, or any compatible agent) through the Vinkius platform.
3. Tell your agent exactly what you need—for example, 'list all design files'—and it handles the rest.

## Frequently Asked Questions

**How does Pixso MCP help with version control?**
It provides a dedicated tool to get_file_versions, allowing you to check the full history and track every change or milestone for any design file without manually browsing folders.

**Can I list all my design files using Pixso MCP?**
Yes. You use list_files to get a comprehensive inventory of every accessible Pixso design asset in your entire workspace, giving you an immediate overview of what exists.

**What if I need to find a specific style guide? Does Pixso MCP support it?**
The list_styles tool audits defined styles across your files. You can pull technical details like color variables and typography rules instantly, which is key for developers.

**How do I check team assignments with Pixso MCP?**
You use the listing tools to list_teams or list_team_projects. This shows you how projects are organized under specific teams, helping map out ownership quickly.

**Does Pixso MCP let me see who left feedback on a file?**
Yes. You use get_comments to retrieve recent comments and the list_nodes tool to understand exactly what structure is being discussed in those comments.