ux-mcp

/ux-mcp — the design intelligence MCP

One server. Fourteen tools. Every MCP-aware client gets the engine.

This is the asymmetric move. None of the leading Claude UX skills (ui-ux-pro-max-skill, open-design, taste-skill, huashu-design, stitch, nothing-design, hallmark, material-3) ship an MCP server. Doing so turns ux-skill into the canonical design-intelligence MCP — agents in any host can call into the same recommender, linter, and manifests that the plugin uses, without needing to install the plugin itself.

When to use

• You're using Cursor, Windsurf, Claude Desktop, or any other MCP-capable host and want ux-skill available without forcing the host to learn the plugin layout.
• You're orchestrating a multi-agent pipeline and need a single source of truth for design constraints across agents.
• You're writing CI tooling that calls the recommender or linter from a long-running daemon rather than spawning a CLI each time.

When to skip

• You're already inside Claude Code with the plugin installed — the slash commands hit the engine directly, no MCP transport needed.
• You only need a one-shot recommendation or lint — ux recommend / ux lint from the CLI is simpler.

Install

The MCP transport is an optional dependency to keep the base install slim:

pip install 'uxskill[mcp]'

Or, if you already have uxskill:

pip install 'mcp>=1.0'

Start the server

ux-mcp                       # entry point (preferred — wired by pyproject.toml)
python3 -m engine.mcp.server # equivalent module form

The server speaks stdio JSON-RPC. Logs go to stderr only; stdout is reserved for the protocol stream.

Exposed tools (14)

Tool	What it does
ux_recommend	Run the 5-parallel-search recommender over a brief. Returns style + palette + type pair + motion + components + brand exemplars + guardrails + rationale.
ux_lint	Run the anti-AI-slop regex linter over paths. Returns findings with rule id, severity, file, line, excerpt, fix.
ux_styles	Return all 84+ entries from data/styles.json.
ux_palettes	Return all 176+ entries from data/palettes.json. Optional mode filter (light / dark).
ux_type_pairs	Return all 70+ entries from data/type-pairs.json.
ux_components	Return all 148+ entries from data/components.json. Optional category filter.
ux_industries	Return all 184+ entries from data/industries.json. Optional category filter.
ux_motion_presets	Return all 57+ entries from data/motion-presets.json. Optional category filter.
ux_anti_patterns	Return all 35+ regex rules from data/anti-patterns.json. Optional severity filter.
ux_brands	Return all 92 brand specs from data/brands/*.json (Apple, Stripe, Linear, Tesla, Notion, etc.). Optional category filter.
ux_landing_patterns	Return all 24+ entries from data/landing-patterns.json. Optional category filter.
ux_persist_save	Persist a recommendation as .ux/design-system/MASTER.md in a given project root. Idempotent — same input writes byte-identical bytes.
ux_persist_load	Load .ux/design-system/MASTER.md back into a structured dict.
ux_stats	Return the engine version and per-manifest entry counts. Useful as a health probe.