io.github.LE-VAI/designesy-org MCP Server

This MCP server provides tools for design-system contract verification, including scoring and review workflows for AI agents. Its documented scope centers on evaluating design-system contracts to support agent-driven checks and assessments.

🛠️ Key Features

Design-system contract verification
Scoring
Review tools for AI agents

🚀 Use Cases

Verifying design-system contracts used by AI agents
Scoring contract compliance or quality
Conducting review steps related to design-system contracts

⚡ Developer Benefits

Enables AI agents to perform design-system contract verification
Supports structured scoring and review operations for contracts

⚠️ Limitations

Available details only describe contract verification, scoring, and review; no additional capabilities, tool count, or configuration information is provided.

Designesy

designesy.org — design-system contract verification, scoring, and review tools for AI agents.

Designesy turns sources into principles, principles into contracts, and contracts into tools, systems, and artifacts that improve quality of life. The MCP server exposes 11 tools for scoring live URLs against a 34-check design contract, validating design tokens, auditing accessibility, and fetching the contract itself.

Install

bash

# Add to Claude Desktop, Cursor, or any MCP-compatible client:
claude mcp add designesy --transport http https://www.designesy.org/api/mcp

No authentication required — all 11 tools are read-only. The server runs on Vercel as a stateless Streamable HTTP endpoint.

Tools

Tool	Description
`designesy_score`	Score a live URL against the 34-check design contract — returns score, grade (A–F), per-check breakdown
`designesy_tokens_score`	Validate a DTCG design-token file (10 conformance checks, W3C DTCG 2025.10)
`designesy_a11y_score`	Get the WCAG 2.2 AA accessibility framework + Playwright/axe-core script template
`designesy_motion_score`	Validate a Lottie animation file (10 checks, Lottie spec v1.0.1 + §16 motion standards)
`designesy_contract`	Get the design-system contract (tokens, motion, takt, cadence, typography, verification)
`designesy_catalog`	List the 12 published Designesy packages with versions and URLs
`designesy_design_review`	Get the 8-dimension qualitative design review rubric
`designesy_skill_md`	Get the contract as an agent-skill-format SKILL.md (for Cursor/Claude Code/Replit)
`designesy_agent_json`	Get the /.well-known/agent.json discovery document
`designesy_llms_txt`	Get the short /llms.txt agent brief
`designesy_llms_full_txt`	Get the full /llms-full.txt agent brief with paste-ready prompt

Live

Site: designesy.org
MCP endpoint: designesy.org/api/mcp (Streamable HTTP, no auth)
Score a site: designesy.org/score
Leaderboard: designesy.org/leaderboard — 30 sites scored
Methodology: designesy.org/methodology — full 34-check scoring methodology
Contract: designesy.org/contracts/design-system
Machine export: designesy.org/contracts/design-system.json

Contract verification

Designesy Score

The live site is verified against the design system contract — 34 deterministic checks with provenance back to tokens. Current score: 99.1% (Grade A) — 30 passed, 0 failed, 1 warn, 3 skipped (browser-only checks). See the methodology page for how the score is computed.

Contract v0.3.0

34 verification checks across 11 weighted categories — tokens, motion, accessibility, cadence, takt, poise, identity, interaction, performance, responsive, semantic
10 Non-Negotiable Motion Standards — deliberate easing, explicit properties, opacity entrances, keyboard stillness, no layout animation, touch gating, bounded duration, reduced-motion paths, asymmetric press, no ease-in
10 acoustic cues — custom $type: sound (net-new vs W3C DTCG 2025.10), Cuelume v0.1.0 engine, interaction-only
9 open tensions — documented, not hidden
Spring physics — default + momentum tokens via custom $type: spring
Machine-readable — W3C DTCG 2025.10 format + custom extensions

See the contract page for the full adoption history.

GitHub Action

Gate your CI on design-contract compliance:

yaml

- uses: LE-VAI/designesy-org/action@main
  with:
    url: https://your-app.vercel.app
    min-score: 70
    min-grade: C

Scores a URL via the live /api/score engine and fails the workflow if the score or grade drops below your threshold. See action/README.md for full usage.

Repository

This is the controlled public root for Designesy — a Next.js 15 App Router site (React 19, Turbopack, Vercel deploy).

code

apps/site          Next.js application
action/            designesy/contract-check GitHub Action
docs/designesy     context, architecture, logs, registries
DESIGN.md          the design contract (human-readable)
AGENTS.md          agent operating rules

What Designesy is not

Designesy is not a template gallery. Designesy is not a generic AI design tool. Designesy is not a moodboard.

Designesy is a system.

artifact	string	optional	URL or description of the artifact to review.
purpose	string	optional	What the design is trying to make possible.
context	string	optional	Audience, device, environment, and constraints.
rules	string	optional	Governing rules or contract version (default: designesy design system v0.3.0).

url	string	optional	URL to a DTCG token file (JSON). The tool fetches and validates it.
dtcg_file	string	optional	Raw DTCG token JSON string to validate (alternative to url).

url	string	required	URL to scan for accessibility. The returned script template will target this URL.
ruleset	string	optional	Ruleset tag (default: wcag22aa). Options: wcag2a, wcag2aa, wcag21aa, wcag22aa, best-practice.
config	string	optional	Brand customization JSON for axe.configure() — branding, checks, rules, disableOtherRules.

url	string	optional	URL to a Lottie JSON file. The tool fetches and validates it.
lottie_file	string	optional	Raw Lottie JSON string to validate (alternative to url).

Designesy

io.github.LE-VAI/designesy-org MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

designesy_catalog

designesy_contract

designesy_design_review

designesy_skill_md

designesy_agent_json

designesy_llms_txt

designesy_llms_full_txt

designesy_score

designesy_tokens_score

designesy_a11y_score

designesy_motion_score

Designesy

Install

Tools

Live

Contract verification

Contract v0.3.0

GitHub Action

Repository

What Designesy is not

License

Install

Remote endpoint