Skip to content
MCP server

Designesy

Score any live URL against 45 design checks and gate CI on the grade

Install
Pricing
Freemium
Platforms
Web, API, CLI
Runs
Locally or Remotely
Version
1.13.10
Listing updated
2 days ago

About Designesy

Designesy is a freemium MCP server for design and media. It can run locally on your machine or as a hosted remote server.

Designesy's checks read the HTML and linked CSS a server returns and run no JavaScript, so they grade what arrives over the wire. Forty-two of the 45 checks run that way and three need a browser. Contrast, line length, type scale and target size are measured against published thresholds, and a failing check names the rule it broke. The output is a score with an A to F grade, and the README says no LLM is involved, so the same page gives the same verdict.

The MCP server offers 17 tools beyond plain scoring: validating DTCG design-token files, checking Lottie animations, scoring UI drift and AI readiness, generating guardrail bundles for coding agents, and fetching the contract, llms.txt and a SKILL.md. It runs remotely over HTTP with no auth or locally as a PyPI package, and the same engine ships as a CLI and a GitHub Action with minimum score and grade thresholds.

The pricing page says scoring is free with no hard cap. A Continuity monitoring plan is listed at $29 a month for 5 sites but is not yet live, and a one-time human Designesy Review costs $899.

Install

Run in a terminal

claude mcp add --transport http designesy-org https://www.designesy.org/api/mcp

Add to Settings → Connectors → Add custom connector

https://www.designesy.org/api/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "designesy-org": {
      "url": "https://www.designesy.org/api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "designesy-org": {
      "type": "http",
      "url": "https://www.designesy.org/api/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "designesy-org": {
      "serverUrl": "https://www.designesy.org/api/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "designesy-org": {
      "type": "http",
      "url": "https://www.designesy.org/api/mcp"
    }
  }
}

Tools this server provides (14)

Taken from the project documentation; the running server may differ.

designesy_score
Score a live URL against the 45-check contract.
designesy_tokens_score
Validate a DTCG design-token file.
designesy_a11y_score
Get the WCAG 2.2 AA framework and a Playwright/axe-core template.
designesy_motion_score
Validate a Lottie animation file.
designesy_contract
Get the design-system contract, whole or by section.
designesy_catalog
List published Designesy packages.
designesy_design_review
Get the 8-dimension design review rubric.
designesy_skill_md
Get the contract as an agent-skill SKILL.md.
designesy_agent_json
Get the agent.json discovery document.
designesy_llms_txt
Get the short llms.txt brief.
designesy_llms_full_txt
Get the full llms-full.txt brief.
designesy_drift_score
Score a URL for UI drift with 12 checks.
designesy_readiness_score
Score a URL for AI readiness with 10 probes.
designesy_guardrails
Generate a build-contract bundle for coding agents.

What it does

45-check score
Deterministic checks across tokens, motion, accessibility, typography and more, rolled into an A to F grade.
CI gate
A GitHub Action and CLI fail a build when the score or grade drops below a threshold.
Token and animation validation
Checks DTCG token files and Lottie animation files.
Drift and readiness scores
12 drift checks and 10 AI-readiness probes on a live URL.
Agent guardrails
Generates tokens, Stylelint config and AGENTS.md rules from a site's tokens.
Remote or local
Streamable HTTP endpoint without auth, or the designesy-mcp PyPI package over stdio.

Good for

  • Check AI-generated UI before it ships
  • Fail a pull request when design quality drops
  • Give a coding agent design rules drawn from an existing site
  • Validate a design-token file
  • Test how machine-readable a site's design artifacts are

Pricing

Freemium, from $29 a month

Scoring free; Continuity $29/mo for 5 sites (waitlist); one-time Review $899

Prices change. Check designesy.org before you buy.

Designesy FAQ

Is scoring free?

The pricing page says any URL can be scored free with no hard cap, and the first tier includes the CI gate and score API.

Does it run JavaScript on the page?

No. It reads the served HTML and stylesheets, and three checks that need a browser are separate.

How do I add the remote server in Claude Code?

The README gives: claude mcp add --transport http designesy https://www.designesy.org/api/mcp.

Does an LLM produce the verdicts?

The README says no, every check is a published deterministic rule.

Is Designesy free?

Designesy has a free plan, with paid plans for more usage or features. Paid plans start at $29 a month.

How do I add Designesy to Claude Code?

Run this command in your terminal: claude mcp add --transport http designesy-org https://www.designesy.org/api/mcp

What are the best alternatives to Designesy?

The closest alternatives to Designesy are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

Alternatives to Designesy

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  3. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  4. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  5. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  6. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory