$ npx @mdvp/cli@latest perceive stripe.com --live
Design quality measured, not opined.
MDVP scores web interfaces against established design standards — entropy, saliency, DOM structure, and visual hierarchy. Deterministic measurements you can track, diff, and gate on.
Deterministic
Same URL returns the same score. Not a model opinion — a measurement. Suitable for tracking over time.
Standards-based
Entropy, saliency, and hierarchy are established properties of visual design, not subjective criteria.
Structured output
Scores come back as named fields and stable terms. Diff two results, log them, set thresholds.
Payment-native
Credits for humans, HTTP 402 with x402 for automated pipelines. No subscription required.
Overview
MDVP is a design quality measurement layer. You give it a domain and it returns structured scores — entropy, saliency, DOM structure, hierarchy — computed from the rendered page.
The scores are deterministic: same URL, same result. This makes MDVP suitable for before/after comparisons, CI quality gates, and tracking design quality over time — things subjective feedback cannot do.
Surfaces: - CLI for direct terminal use - API for products and backend integrations - MCP for agents and coding environments
Who It's For
Developers
Add design quality gates to CI/CD. Catch regressions before they ship. Compare before/after on any branch.
Designers & teams
Show clients a number instead of an opinion. Track quality over time. Compare two designs without the argument.
Services
Embed design scoring in your product or workflow. Credits-based API, or HTTP 402 for automated pipelines.
Quick Start
The CLI is the fastest way to start. Use audit for a compact score and perceive for the full protocol response.
# quick score from the CLI npx @mdvp/cli audit stripe.com # full live protocol output npx @mdvp/cli perceive stripe.com --live # compare two sites npx @mdvp/cli compare figma.com linear.app # start MCP server npx -y -p @mdvp/cli@latest mdvp mcp
Protocol Output
The canonical wire format is a plain text block. The short form below is the shape you should expect in terminals, logs, and agent tool outputs.
MDVP-T/1.0 stripe.com A 87/100 [DOM] 77 elements · 4 fonts · 5 colors [ENTROPY] overall 0.74 · high noise [SALIENCY] cta low · heading low [RECOMMEND] raise hierarchy · strengthen cta
Full responses can expand into sections like [DOM], [ENTROPY], [SALIENCY], [TEMPORAL], [TOKENS], [DIAGNOSIS], and [RECOMMENDATIONS].
Flow
1. Submit
Pass a domain or URL through the CLI, API, or MCP server.
2. Measure
MDVP extracts DOM structure, computes entropy and saliency scores, and evaluates hierarchy against design standards.
3. Score
Results come back as a structured block — same URL, same score, every time.
4. Act
Compare designs before and after, catch regressions in CI, or show clients a number instead of an opinion.
CLI, API, MCP
CLI
Direct terminal use, local auditing, and pipeline scripting.
npx @mdvp/cli audit <domain> npx @mdvp/cli compare <a> <b> npx @mdvp/cli top 10
API
Server-side integration — embed design scoring in any product or CI workflow.
POST /perceive POST /token/create
MCP
Use MDVP as a tool in Cursor, Claude, or any MCP-compatible environment.
audit_url compare_sites top_sites submit_for_crawl
API example
POST https://api.mdvp.dev/perceive
{
"domain": "stripe.com",
"include_vision": false
}
200 OK
Content-Type: text/plain
MDVP-T/1.0 stripe.com A 87/100
[DOM]
[ENTROPY]
[SALIENCY]
[RECOMMEND]MCP config
{
"mcpServers": {
"mdvp": {
"command": "npx",
"args": ["-y", "-p", "@mdvp/cli@latest", "mdvp", "mcp"]
}
}
}Credits + x402
Human-facing credits
Buy credits once and use them for direct audits and live protocol requests. This is the simplest path for manual usage.
1 credit = 1 audit 40 credits = $10 at $0.25 / audit
Machine-facing x402
Agents can call paid endpoints without API key provisioning by handling HTTP 402 and replaying with proof of payment.
POST /audit -> 402 method: tempo amount: 200000 USDC Pay -> replay
Next Steps
Repository
https://github.com/Tixo-Digital/mdvp-cli