# Layoza

> Layoza is an open-source MCP server for browser automation. Design guidance and headless Chromium QA for AI coding agents building front ends. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Repository:** https://github.com/layoza/layoza
- **MCP Registry name:** io.github.layoza/layoza
- **Categories:** browser automation, developer tools, design and media
- **Listing updated:** 2026-11-16

## About

Layoza is built around a complaint about AI-built websites: they converge on the same look and ship bugs the agent cannot see, such as headings hidden under a sticky header or a phone menu that Escape will not close. It pairs design guidance with a live browser check, so an agent proposes a direction and then measures the result.

For a new site it reads the brief, returns design dials and three distinct art directions, and deals motion mechanics suited to the trade. For an existing site it extracts the design tokens, type scale, spacing and motion into files such as DESIGN.md and SITE-DNA.json so new pages extend the current look. A per-project ledger records each look it has dealt, and a uniqueness score compares new work against recent runs.

The QA side drives headless Chromium at 1440, 768 and 375 px and reports contrast, clipping, overlap, focus visibility and phone-menu behaviour. Baselines, before/after comparison and rollback make redesigns reversible. The README is candid about where it loses to rival design skills in its own benchmark.

## Features

- **Three art directions:** Returns an industry read of the brief, design dials and three directions that differ in layout, type, colour and motion.
- **Site DNA extraction:** Writes an existing site's tokens, spacing and motion into DESIGN.md, BRAND.md, MOTION.md and SITE-DNA.json.
- **Motion mechanics:** Deals from 71 hero, section and micro mechanics matched to the niche and intensity.
- **Visual QA in Chromium:** Checks contrast, overflow, focus and the mobile menu at three widths with measured numbers.
- **Baseline and rollback:** Takes a baseline before changes, compares before and after, and can roll back.
- **Multi-stack output:** Writes code for React, Next.js, Astro, Vue, Nuxt, SvelteKit, plain HTML, WordPress, Elementor, Bricks or Shopify Liquid.

## Good for

- Design a new homepage with several distinct directions to choose from
- Add a page that matches an existing site's tokens and motion
- Audit a page for contrast, overflow and mobile-menu problems
- Redesign a site while keeping content and forms working, with a rollback point

## Install

### Claude Code (Terminal)

```sh
claude mcp add layoza -- npx -y layoza
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "layoza": {
      "command": "npx",
      "args": [
        "-y",
        "layoza"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "layoza": {
      "command": "npx",
      "args": [
        "-y",
        "layoza"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "layoza": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "layoza"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "layoza": {
      "command": "npx",
      "args": [
        "-y",
        "layoza"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "layoza": {
      "command": "npx",
      "args": [
        "-y",
        "layoza"
      ]
    }
  }
}
```

## Tools

- `get_design_system`: Design system and art directions for a brief
- `recommend_layout`: Layout recommendation
- `inspect_project`: Inspect a project's design
- `extract_site_dna`: Extract tokens, type, spacing and motion
- `inspect_site`: Inspect a live site
- `deal_mechanics`: Deal motion mechanics for a niche
- `recommend_animation`: Recommend an animation approach
- `capture_screenshots`: Capture screenshots in Chromium
- `audit_accessibility`: Accessibility audit
- `audit_performance`: Performance audit
- `verify_functional`: Functional verification
- `compare_before_after`: Compare before and after
- `safe_rollback`: Roll back changes

## FAQ

### What do I need to run it?

Node.js 18 or newer. Visual QA also needs Playwright with Chromium installed.

### Which agents does it support?

The README names Claude Code, Cursor, Codex, OpenCode, Antigravity and Windsurf, and npx layoza init configures the ones it finds.

### Does it beat other design skills?

Not always. The README says kinetic pages were a tie with one rival and that other skills won some earlier rounds.

### How do I try the QA?

Run npx layoza qa on an HTML file or URL.

### Is Layoza free?

Yes. Layoza is open source, so you can use and self-host it for free.

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

Run this command in your terminal: claude mcp add layoza -- npx -y layoza

### What are the best alternatives to Layoza?

The closest alternatives to Layoza are REA, Browser Use, Scrapling MCP Server, HyperFrames by HeyGen and Codebase Memory.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Browser Use](https://ai-powered.com/mcp/browser-use): Browser Use is a freemium MCP server for browser automation.
- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [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.

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