Uxloom MCP server
io.github.uxloom-dev/uxloom·v0.14.0·1 starsAgent-native UI/UX design validation: journey completeness, state coverage, and WCAG checks.
1 stars56 downloads/wk
Reviews
Write oneNobody has reviewed Uxloom yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Uxloom tools (17, 3 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
brief_answerwrite actionSubmit brief answers. Unanswered fields take researched defaults and are recorded in the assumption ledger (auditable, reversible).
brief_startStart a design brief. Returns a structured questionnaire. Answer every question you can yourself — from the provided context document (PRD, spec) first, then conversation context; only relay questions marked askHuman:true to the user. Then call brief_answer.
comment_contextThe full work packet for one reviewer comment: the comment, the exact layout block its pin lands on, the complete screen definition (contract, components, layout, rationale, exemptions), every journey state referencing that screen with its transitions, and the current validation findings scoped to that screen. Use it to address the comment precisely, then call comment_resolve.
comment_resolveResolve a reviewer comment after addressing it. The resolution note is shown to the reviewer and persisted; the pin clears live in every open preview. Never resolve without actually making the change.
comments_listReviewer comments from the preview, with lifecycle status. Comments the reviewer clicked "→ agent" on are ASSIGNED — they are your work queue: call comment_context for each (assigned first, then open), make the change, then comment_resolve. Check this at session start and after every validation run.
coverage_reportThe demo number: screens delivered vs. states the journeys actually need. Returns per-screen coverage and the missing-state list.
design_auditReverse bridge (RFC 0007): audit a design export against the contract. Point it at a Figma/Penpot SVG or JSON export, a folder of them, or a uxloom `--manifest` index.json. Recovers screen×state from frame names (grammar "<Screen> / <state>", or the manifest) and reports which required screens/states have no frame: design-screen-unmapped, design-state-missing, design-frame-unmapped. Optional scaff
design_reviewOne iterative design-review round (max 3 per project — enforced). Computes validation + rationale coverage, persists the round with deltas to <project>.reviews.json, and returns a structured rubric to critique the design against: completeness, evidence, consistency, market fit, accessibility, honesty. Address the rubric, improve the design, then call again. Round 4 is refused: present results to t
journey_defineAdd or replace a journey (a state machine: states reference screens, events move between states). Screens referenced here must be registered via screen_register before project_validate passes.
palette_checkCheck a design system's color pairs against WCAG 2.2 AA (4.5:1) before any screens exist. Reports each pair's exact ratio, pass/fail, and thin-margin passes (under 5.0:1) that one shade lighter would break.
project_auditAudit the implementation against the design contract (drift detection). Static tiers: the uxloom.map.json screen registry and data-ux-screen/data-ux-state markers in source. Returns per-state verdicts (implemented with file:line evidence / unimplemented / unproven) and findings with fixes. When implementing screens from the contract, emit data-ux-state markers so the code stays self-auditing.
project_exportReturn the complete current project document (for inspection, backup, or transformation before a project_import).
project_importReplace the whole project in one call: journeys and screens together. Prefer this over many journey_define/screen_register calls when registering a complete or large design. Validates the full document; unknown fields are rejected.
project_initwrite actionCreate a new UXLoom project file (uxloom.project.json). Run once per product.
project_validatewrite actionRun every critic: journey completeness (unreachable states, dead ends, broken transitions), state coverage, WCAG contrast, touch targets, text expansion — plus fragment-merge errors and open reviewer comments from the preview. Honors uxloom.config.json thresholds. Iterate until errors = 0 and reviewer comments are addressed.
screen_critiqueFindings scoped to a single screen. Use during iteration on one screen.
screen_registerAdd or replace a screen: its intent, requiredStates (the contract), designedStates (progress), and components with colors/labels/target sizes for the critics.
Public scan report
scanner v0.1.9 · 2026-09-23 · same rubric, same numbers if you re-run it
- Code scan49 source files scanned20/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 45 days ago12/15
- Maintainer identityregistry namespace matches repository owner7/10
Findings (1)
- mediumeval / new Function used
exec.evaldist/optional-browser.js: …ime via an * indirect dynamic import (`new Function("return import(...)")()`), so tsc * nev…
How Uxloom compares
Against every graded AI and agents MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 78/100
- higher than 57% of 4,460 AI and agents servers
- Tools
- 17
- the typical AI and agents server has 6
- Tools that change things
- 18%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 1
- more than 50% of 2,711 AI and agents servers
- Downloads a week
- 56
- more than 46% of 1,538 AI and agents servers with a package
What its tools let an agent do: 11 read · 3 change · 3 send or post
Install Uxloom in Claude Code, Cursor or VS Code
Runs npx -y uxloom on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add uxloom -- npx -y uxloom
What the publisher says
From the Uxloom repository's README, as published. We do not edit it. Read it on GitHub
UXLoom
Your generator gave you 6 screens. UXLoom proves you're missing 9 states.
AI generators (v0, Lovable, Figma Make, Claude) produce happy-path screens. UXLoom is the critic layer: it models user journeys as state machines, treats screens as nodes with state contracts, and mechanically proves what's missing before a line of production code exists — unreachable screens, dead ends, missing error/empty/loading states, WCAG contrast failures, undersized touch targets, and labels that will overflow under localization.
Agent-native by design: the interface is an MCP server (works with Claude Code, Codex, and any MCP client), with Agent Skills included.
Deterministic by design: same input, byte-identical report — benchmarked (packages/bench) at 1.000 precision/recall on a seeded defect catalog, SHA-256-stable across processes, 1000 screens in under 5ms. That's what lets design completeness gate CI, where an LLM opinion can't.
Website: uxloom.dev · npm: uxloom · MCP registry: io.github.uxloom-dev/uxloom ·
Packages
New here? Start with the Quickstart — prerequisites, the Claude Code walkthrough, what to say to your agent, and troubleshooting.
Quick start (agents)
# Claude Code
claude mcp add uxloom -- npx -y uxloom
# Codex CLI
codex mcp add uxloom -- npx -y uxloomThe project file (uxloom.project.json) lives in your workspace and belongs in git — the design is data, versioned next to the code it specifies.
Quick start (humans & CI)
npx uxloom init # one-command setup: MCP config + agent skill + starter file
npx uxloom preview # live mocks (themed, commentable, EDITABLE in the browser)
npx uxloom export # shareable HTML — plus --svg (Figma/Penpot import; add
# --manifest for the round-trip key) and --png (playwright)
npx uxloom check # design completeness — exit 1 on errors, CI-ready
npx uxloom audit # implementation drift — web AND native (Swift/Kotlin/
# Dart/Java markers); --live verifies the real DOM;
# --design <file|dir> audits a Figma/Penpot export vs the contract
npx uxloom diff # human-readable design diffs for PR reviewEvidence-based design: every decision in the contract can carry its rationale — reasoning, rejected alternatives with pros/cons, sources, confidence — enforced by the critics once adopted, iterated through a bounded design_review loop (max 3 rounds), and shown to stakeholders in the preview's evidence panel (ⓘ) and exports. The design doesn't just validate; it argues its case.
Agent-addressable comments: a reviewer drops a pinned comment in the preview and clicks "→ agent". The comment becomes a work item any Gen-AI model can read with full context — comment_context returns the pinned layout block, the screen contract, the journey references, and the current findings for that screen — act on, and resolve back into the preview with a note. One click from feedback to addressed.
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Uxloom: common questions
- Is Uxloom MCP server safe?
- Mostly: it is graded B (78/100). Read the Uxloom safety report
- How do I install Uxloom?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Uxloom need an API key?
- No secret keys are declared. It reads 1 setting from the environment.
- Is Uxloom maintained?
- The last commit was 87 days ago (2026-08-09). The latest release is v0.14.0.
- What can I use instead of Uxloom?
- Servers from other publishers that do the same job: Agent-Native Design MCP server, Kiln MCP server and Figma Context MCP server.
- How does Uxloom compare with other AI and agents MCP servers?
- safety score 78/100 (higher than 57% of 4,460 AI and agents servers); tools 17 (the typical AI and agents server has 6); tools that change things 18% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Uxloom
Same job from other publishers: the closest match first, then the best rated.
- Agent-Native DesignAgent-Native design tool - create and edit visual designs with agent assistancenot reviewedEstablishedA
- KilnSpawn an object into existence: describe it, and your agent designs it, checks it, and 3D prints it.not reviewedEstablishedB
- Figma ContextGive your coding agent access to your Figma data. Implement designs in any framework in one-shot.not reviewedWidely usedB
- Ts CoreAgent-native TypeScript framework for building MCP servers.not reviewedEstablishedA
- Godot MCPAgent-driven Godot playtesting: editor control, input injection, game-time stepping, live state.not reviewedEstablishedA