designesy-mcp
A read-only stdio MCP server exposing designesy.org's design-intelligence infrastructure as native agent tools.
Zero external dependencies. Pure Python stdlib. Implements the Model Context Protocol JSON-RPC 2.0 over stdio.
Install
pip install designesy-mcp
Run
designesy-mcp
Or as a module:
python -m designesy_mcp_server
Configure in your MCP client
Add to your MCP client config (Claude Desktop, Cursor, ZCode, etc.):
{
"mcpServers": {
"designesy": {
"command": "designesy-mcp"
}
}
}
No arguments needed. The server speaks JSON-RPC 2.0 over stdin/stdout.
Tools (11)
The server exposes 11 tools, all fetched live from https://www.designesy.org/:
Read-only discovery
| Tool | What it does |
|---|---|
designesy_catalog |
Get the 12-package catalog (versions, URLs, statuses) from /open.json |
designesy_contract |
Get the full design-system contract v0.3.0 (tokens, motion, acoustic, takt, cadence, typography, components, verification, open tensions) — or a filtered section |
designesy_design_review |
Get the Design Review kit (8 dimensions, agent prompt, output format, verification checklist) |
designesy_skill_md |
Get the agent-skill-format export (SKILL.md) with behavioral rules, tokens, anti-patterns |
designesy_agent_json |
Get the agent discovery document (.well-known/agent.json) — identity, authority, ingest protocol |
designesy_llms_txt |
Get the short agent brief (/llms.txt) |
designesy_llms_full_txt |
Get the full agent brief (/llms-full.txt) with ingest protocol, all packages, paste-ready prompt |
Executable verification
| Tool | What it does |
|---|---|
designesy_score |
Run the 36-check contract verification against a live URL. Fetches HTML + CSS, parses :root custom properties, returns PASS/FAIL/WARN/SKIP per check with an overall score, letter grade, and per-category breakdown. Supports 4 emission formats: designesy (default), canonical (review-findings.json schema), review (jakubkrehel markdown), google (@google/design.md JSON). |
designesy_tokens_score |
Validate a design token file against the W3C Design Tokens Community Group (DTCG) 2025.10 format. 10 checks (t01–t10). |
designesy_a11y_score |
Get the WCAG 2.2 AA accessibility verification framework (11 checks, a01–a11) + a Playwright/axe-core script template for local execution. |
designesy_motion_score |
Validate a Lottie animation file against Lottie spec v1.0.1 + the Designesy 10 Non-Negotiable Motion Standards. 10 checks (m01–m10). |
Resources (7)
The server also exposes 7 MCP resources (read-only URIs):
| URI | Content |
|---|---|
designesy://open |
Package catalog (JSON) |
designesy://contract |
Full design-system contract (JSON) |
designesy://kit/design-review |
Design Review kit (JSON) |
designesy://skill |
SKILL.md agent-skill export (Markdown) |
designesy://agent |
Agent discovery document (JSON) |
designesy://llms |
Short agent brief (text) |
designesy://llms-full |
Full agent brief (text) |
The 36-check verification engine
designesy_score runs 36 deterministic checks across 13 weighted categories:
| Category | Weight | What it measures |
|---|---|---|
| cadence | 18 | Typography rhythm — line-height, font-synthesis, text-underline-position, skip-ink |
| accessibility | 15 | WCAG 2.2 primitives — reduced-motion, forced-colors, AI disclosure, focus-visible |
| semantic | 12 | Token architecture — :root custom properties, no raw hex, semantic naming |
| motion | 10 | Motion hygiene — duration tokens, easing tokens, reduced-motion blocks |
| tokens | 9 | DTCG 2025.10 conformance — $type, $value, $description, colorSpace |
| takt | 8 | Timing discipline — transition bands, animation hierarchy |
| poise | 7 | Composure — viewport overflow, scroll behavior, print styles |
| identity | 6 | Brand coherence — title, meta description, favicon, og tags |
| interaction | 6 | Interaction primitives — hover states, press feedback, disabled states |
| performance | 6 | Core Web Vitals readiness — preload, font-display, render-blocking |
| responsive | 3 | Responsive primitives — viewport meta, container queries |
| security | 5 | Security headers — CSP, X-Content-Type-Options, referrer policy |
| spec | 4 | Spec conformance — lang attr, charset, doctype |
No LLM. No roast. The same engine scores designesy.org itself — in public, at 99.1% A.
Caching
All responses are cached with a 5-minute TTL. The server only fetches public, machine-readable exports from designesy.org via HTTPS. It does not read local files, credentials, or source roots.
Safety
Read-only. This server never writes anywhere. It does not execute code, mutate files, or access credentials.
Provenance
All data is fetched live from:
https://www.designesy.org/open.jsonhttps://www.designesy.org/contracts/design-system.jsonhttps://www.designesy.org/kits/design-review.jsonhttps://www.designesy.org/contracts/skillhttps://www.designesy.org/.well-known/agent.jsonhttps://www.designesy.org/llms.txthttps://www.designesy.org/llms-full.txt
License
MIT
Links
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file designesy_mcp-1.2.1.tar.gz.
File metadata
- Download URL: designesy_mcp-1.2.1.tar.gz
- Upload date:
- Size: 30.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/7.0.0 CPython/3.14.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a11b102e5e20e634bc549de5056b5b90f6bf122af731a4037c5f348324715d14
|
|
| MD5 |
e8d2285d2d6c635eac99e69101b4d9fa
|
|
| BLAKE2b-256 |
3f48b1e17e380ce6ce6e578f313c611a88a1d2901a44821837c9e1e42a9a16f6
|
File details
Details for the file designesy_mcp-1.2.1-py3-none-any.whl.
File metadata
- Download URL: designesy_mcp-1.2.1-py3-none-any.whl
- Upload date:
- Size: 29.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/7.0.0 CPython/3.14.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1f42f8cc3101bb5231558d15a3767df2ef2542a637e0fddb4fbe2db5ecebf39f
|
|
| MD5 |
405e3303a992c90c9c94d05641b564b0
|
|
| BLAKE2b-256 |
24613df6a6ff0bb0dd35d50185acb5c621c41480f684d3658ebddcdac24c54ab
|
