# Designesy

> Designesy is a freemium MCP server for design and media. Score any live URL against 45 design checks and gate CI on the grade. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $29 a month
- **Platforms:** Web, API, CLI
- **Website:** https://www.designesy.org
- **Repository:** https://github.com/le-vai/designesy-org
- **MCP Registry name:** io.github.LE-VAI/designesy-org
- **Categories:** design and media, developer tools
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://www.designesy.org/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "designesy-org": {
      "url": "https://www.designesy.org/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/designesy
