Skip to content
MCP server

Layoza

Design guidance and headless Chromium QA for AI coding agents building front ends

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI
Runs
Locally
Version
0.1.4
Listing updated
1 day ago

About Layoza

Layoza is an open-source MCP server for browser automation. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add layoza -- npx -y layoza

Add to claude_desktop_config.json

{
  "mcpServers": {
    "layoza": {
      "command": "npx",
      "args": [
        "-y",
        "layoza"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "layoza": {
      "command": "npx",
      "args": [
        "-y",
        "layoza"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (13)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

Layoza 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 to Layoza

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Browser Use

    MCP server

    Browser agents and cloud browsers for AI, with an MCP server for web tasks

    • 7 tools
    • Remote
    • Freemium
    • 121K GitHub stars
    • Browser automation
  3. MCP server for AI clients to scrape sites with HTTP and stealth browser sessions

    Runs locally
    • 17 tools
    • Open source
    • 104K GitHub stars
    • Web search and scraping
  4. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  5. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  6. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools