# Stage1

> Stage1 is a free MCP server for design and media. Capture a live site and measure it against your Figma library, tokens and source code. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, macOS, Windows, Linux
- **Website:** https://aquex.ai/products/stage1
- **MCP Registry name:** ai.aquex/stage1
- **Categories:** design and media, developer tools
- **Listing updated:** 2026-11-15

## About

Stage1 looks for design drift: the gap between what a design system declares and what production ships. It drives a real browser through chosen pages, including signed-in journeys, and records structure, computed styles, tokens in use and accessibility findings, running Lighthouse on up to five pages.

Comparisons cover colour, type size and weight, radius, spacing, border colour and shadows against an exported Figma file or design tokens, and library components are checked against shipped markup. Each drift finding links to example pages and the elements behind it. Values the browser supplied and third-party widgets are reported separately, and anything it could not measure is listed as missing, not passed.

It runs as a command-line tool, a local viewer and an MCP server, with captures running on your machine by default. It needs Node 22.19+ or 24.x. Baselines support CI checks with team-written rules. Stage1 does not score design quality or certify accessibility.

## Features

- **Live capture:** Records structure, computed styles, tokens and accessibility findings from a real browser.
- **Design comparison:** Checks captured values against Figma exports or design tokens.
- **Baselines and CI:** Shows new, resolved and changed findings and applies team rules in CI.
- **Token export:** Exports tokens from Figma, CSS or root custom properties in DTCG format.
- **Multi-site capture:** Capture a list of sites under the same rules and compare side by side.
- **Shareable reports:** Exports a self-contained report that opens without installing anything.

## Good for

- Audit how far production has drifted from a design system
- Set a measured baseline before a redesign
- Block pull requests that introduce style drift
- Compare several competitor sites' styles and structure
- Give an AI assistant structured page evidence instead of screenshots

## Install

### Claude Code (Terminal)

```sh
claude mcp add stage1 -- npx -y @aquex/stage1
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "stage1": {
      "command": "npx",
      "args": [
        "-y",
        "@aquex/stage1"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "stage1": {
      "command": "npx",
      "args": [
        "-y",
        "@aquex/stage1"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "stage1": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@aquex/stage1"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "stage1": {
      "command": "npx",
      "args": [
        "-y",
        "@aquex/stage1"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "stage1": {
      "command": "npx",
      "args": [
        "-y",
        "@aquex/stage1"
      ]
    }
  }
}
```

## FAQ

### Is Stage1 free?

The site says it is free on npm, version 0.7.0. A separate Drift Audit service is run by the vendor.

### Where do captures run?

On your machine by default.

### Does it grade design quality?

No. It reports what it measured and what it could not, and does not certify accessibility.

### What does it need?

Node 22.19+ (22.x) or 24.x.

### How do I add Stage1 to Claude Code?

Run this command in your terminal: claude mcp add stage1 -- npx -y @aquex/stage1

### What are the best alternatives to Stage1?

The closest alternatives to Stage1 are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/stage1
