Layoza
Design guidance and headless Chromium QA for AI coding agents building front ends
- 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 layozaAdd to claude_desktop_config.json
{
"mcpServers": {
"layoza": {
"command": "npx",
"args": [
"-y",
"layoza"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"layoza": {
"command": "npx",
"args": [
"-y",
"layoza"
]
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Browser Use
MCP serverBrowser agents and cloud browsers for AI, with an MCP server for web tasks
- 7 tools
- Remote
- Freemium
- 121K GitHub stars
- Browser automation

Scrapling MCP Server
MCP serverMCP 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

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools