Rams MCP · The full engine, now in your coding agent

Rams Action

The judge, in your CI. Every change scored 0 to 100, merges gated on critical design defects, fixes handed back as patches your agents apply themselves.

Add to a workflowGet a free API key
IssueAgent writesRams judgesAgent repairsReleaseVerify

The loop, in four steps

01
Your agents write the UI

Claude Code, Codex, Cursor — they already produce most of the interface code in a modern repo. Fast, plausible, and unreviewed.

02
Rams judges every change

The engine reads the changed UI files and scores them 0–100 against 291 design rules — accessibility, hierarchy, motion, craft. Criticals cap the score: one holds it to 59, two to 49, three or more to 39.

03
Your agents repair

Findings come back as structured JSON plus git-applyable patches. Your own agent step applies them — Rams never touches your code.

04
The gate holds the bar

fail-on: critical blocks the merge until the defect is fixed. The loop keeps its speed; the product keeps its standard.

One YAML block

- uses: actions/checkout@v4
  with: { fetch-depth: 0 }
- uses: rams-design/rams-action@v1
  with:
    api-key: ${{ secrets.RAMS_API_KEY }}
    fail-on: critical            # or score<80, or never

Or run it on a schedule with mode: since-last-run — it reviews only what changed since the last sweep and leaves findings plus patches in rams-review/ for your own agent step to apply.

What comes back

scoreThe 0–100 design score — a number CI can compare, chart, and gate on
critical-countConfirmed criticals. fail-on: critical blocks the merge while it’s above zero
rams-review/issues.jsonEvery finding, structured: severity, category, file:line, the fix
rams-review/patches/One git-applyable diff per unambiguous fix — your agent runs git apply, not a guessing game

The judge has receipts

291

design rules, versioned and public · see them

2,500+

reviews run on real pull requests

45%

of the most-starred UI repos we scored carry a critical defect · see them

Every public score is a live page you can read — the finding, the file, the fix. The same engine, the same bar:

appflowy-io/appflowy100radix-ui/primitives97calcom/cal.com96sveltejs/svelte94shadcn-ui/ui90supabase/supabase59mui/material-ui49n8n-io/n8n39

What the gate looks like

rams / design review✕ failing — 1 criticalscore 59

critical · accessibility
Icon-only button ships without an accessible name — screen readers announce nothing.

src/components/Toolbar.tsx:41

- <button onClick={openSearch}><SearchIcon /></button>
+ <button aria-label="Search" onClick={openSearch}><SearchIcon /></button>

Patch written to rams-review/patches/ — your agent applies it, pushes, and the gate turns green.

Rendered example — the format is exactly what lands on your PR.

Block bad design before it merges

One YAML block. Free key, 30 reviews a month, no card.

Add to a workflowThe full agent loop