Summary

Gives a number and then the next change to make.

A grade on its own is not actionable; the useful output is the specific finding underneath it — the maintainers' own dogfood run scored B+ 75/100 and flagged 5 font families on a page where the professional limit is 2, which is a concrete task. Because it reads the rendered DOM rather than comparing screenshots, it works on a page that has never shipped and has no baseline. Four of the six tools need no key at all.

What it is

A design linter for AI-generated frontends, shipped as a CLI with an MCP server built in. It crawls the page in a real browser, measures color, spacing and type discipline, checks APCA contrast and semantic structure, and flags the patterns generated UIs share — default Tailwind palettes, pill radius on everything, generic hero chips, missing design tokens.

What you get

A URL scored across 12 design dimensions with a grade from A+ to F and a 0–100 number — `audit_url`
The full MDVP-T/1.0 perception — DOM, entropy, saliency, motion, classification and recommendations — `perceive_url`
Two domains compared side by side — `compare_sites`
Top or worst sites by label: `premium`, `good`, `vibecoded`, `bad` — `top_sites`
The page as Markdown with its MDVP scores embedded — `get_page_content`
A URL submitted to the public dataset, results in about 60s — `submit_for_crawl`, the one tool that needs a key
A CI gate — `audit --check` on preview URLs, with `init --github-action` generating the workflow

Requirements

No API key, no account and no screenshot baseline for the default audits — they run locally through the rendered browser path. Run the server with `npx -y @mdvp/cli@latest mcp` over stdio; `npx @mdvp/cli mcp-config` prints a copy-pasteable snippet for your editor. Only `submit_for_crawl` needs a key, read from `MDVP_API_KEY` or `~/.mdvp/config.json` via `npx @mdvp/cli login`. Static and cache shortcuts are opt-in through `MDVP_USE_CACHE=1`, with `--fast` making that visible in scripts. Package `@mdvp/cli` 1.36.1 with the binary `mdvp`, MIT licensed.

Setup effort

One command plus a key — npx -y @mdvp/cli@latest mcp, then supply credentials