Ensemble MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Ensemble MCP Build a design system from #0F766E and export it as Tailwind config"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
🎨 Ensemble MCP
Give your AI agent design taste.
Website · Documentation · Get API Key
What is this?
Ensemble MCP is a Model Context Protocol server that gives AI agents access to professional design tools. Generate color palettes, pair typography, create shadow systems, and export complete design tokens - all through natural conversation.
10 tools. One API. Infinite possibilities.
Tool | What it does | Its main argument |
| A full color system from one brand color |
|
| Heading, body and mono fonts with a type scale |
|
| A spacing system tuned to the type |
|
| Elevation shadows tinted by the palette |
|
| Responsive grid: breakpoints, columns, gutters |
|
| Durations, easing curves and transition presets |
|
| A complete dark mode from the light system |
|
| Which palette pairs pass WCAG, and what to fix |
|
| The whole system as CSS, JSON, Tailwind or SCSS |
|
| Check one color pair for accessibility (FREE, no key needed) |
|
Every builder takes a brand color and an optional preferences object, so tools called
separately agree with each other. Results are deterministic: the same color and preferences
always give the same system.
------|--------------|
| harmony_generate_palette | Generate harmonious color palettes from a single color |
| duet_pair_fonts | Pair heading and body fonts that complement each other |
| tempo_generate_scale | Create type scales and spacing systems |
| chord_generate_shadows | Generate 5-level shadow elevation systems |
| bridge_generate_theme | Auto-generate dark mode from light theme colors |
| cadence_set_grid | Configure CSS Grid layouts with presets |
| pitch_create_gradient | Create linear, radial, and conic gradients |
| riff_set_easing | Set cubic-bezier easing curves |
| compose_export | Export complete design system (CSS, Tailwind, SCSS, JSON) |
| a11y_validate | Check color contrast accessibility (FREE, no key needed) |
Related MCP server: Better Design
Quick Start
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"ensemble": {
"command": "npx",
"args": ["-y", "@hearthbyte/ensemble-mcp"],
"env": {
"ENSEMBLE_API_KEY": "your-api-key-here"
}
}
}
}Cursor / Cline
{
"ensemble": {
"command": "npx",
"args": ["-y", "@hearthbyte/ensemble-mcp"],
"env": {
"ENSEMBLE_API_KEY": "your-api-key-here"
}
}
}Manual Installation
npm install -g @hearthbyte/ensemble-mcp
ensemble-mcpExample Prompts
Once installed, try these with your AI:
"Generate a triadic color palette from #6366F1"
"Give me a classical font pairing and an airy spacing system to go with it"
"Check if #FFFFFF text on #6366F1 background is accessible"
"Build a design system from #0F766E with dramatic shadows and export it as Tailwind config"
"Audit the contrast of the palette you just made and tell me what fails"
API Key
The builders call the Ensemble API, which needs a Pro key ($4.99/month, or $39/year).
Free tool: a11y_validate - accessibility validation with no API key required.
Design Philosophy
Ensemble tools are built on these principles:
One color in, design system out - Start with a single value, get a complete system
Cross-tool sync - Colors flow to typography, typography informs spacing
Export everywhere - CSS, Tailwind, SCSS, JSON
Accessibility first - WCAG 2.1 + APCA checking built in
Links
🌐 Ensemble Web Tools - Use in browser, no install
Built with 🧡 by HearthByte
Your work. Your choice. Always.
Available Tools
10 toolsa11y_validateA
Check one foreground and background color pair for accessibility (WCAG 2.1 and APCA).
FREE - No API key required.
Returns the contrast ratio, pass or fail for normal and large text, and suggested fixes.
Inputs: background (required), foreground (required), fontSize, algorithm.
bridge_generate_themeB
Generate a complete dark mode from the light system built on a brand color: dark surfaces and text, adjusted palette, shadows and spacing, with contrast checked.
Inputs: color (required), colors, preferences, color_scheme.
cadence_generate_gridB
Generate a responsive grid: breakpoints, column counts, gutters and max widths, sized from the spacing system.
density: compact, balanced (the default), airy.
Inputs: color, colors, density, preferences.
chord_generate_shadowsB
Generate a shadow and elevation system tinted by the palette: elevation levels, a focus ring and a glow.
shadow_intensity: flat (borders, no depth), subtle (the default), pronounced, dramatic.
Inputs: color (required), colors, preferences, color_scheme, +1 more.
compose_exportA
Build the whole design system from one brand color and export it: colors, typography, spacing, shadows, grid, motion and accessibility notes, as ready-to-use files.
formats: css (custom properties), json, tailwind (config) and scss. Pass the same preferences you used with the other tools so the export matches them.
Inputs: color (required), colors, corners, density, +6 more.
duet_pair_fontsA
Pick a heading, body and monospace font pairing with a type scale, chosen for a typographic character.
type_style: modern (clean sans), classical (serif-led), minimalist (restrained), expressive (display-led). Returns font families, weights, fallbacks and the size scale.
Inputs: color, colors, type_style, preferences.
harmony_generate_paletteA
Generate a working color system from one brand color: primary, secondary and accent ramps, neutrals, and semantic colors (success, warning, error, info).
color_scheme decides how the secondary and accent hues are derived: • monochromatic — one hue, many shades (elegant, unified) • analogous — neighbors on the wheel (calm, cohesive; the default) • complementary — the opposite hue (high contrast) • triadic — three evenly spaced hues (balanced, colorful) • split-complementary — the two hues beside the complement (nuanced contrast)
Inputs: color (required), colors, preferences, color_scheme.
pitch_audit_contrastA
Audit the contrast of the palette built from a brand color: which text and background pairs pass WCAG, which fail, and what to change. Returns a contrast matrix, the failures and recommendations.
To check one specific foreground and background pair, use a11y_validate (free, no key). audit_all_combinations checks every pair in the palette, not just the meaningful ones.
Inputs: color (required), colors, preferences, color_scheme, +2 more.
riff_generate_motionB
Generate a motion system: durations, easing curves (cubic-bezier) and ready-made transition presets.
animation_style: none (reduced motion), minimal (the default), fluid (smooth, longer), energetic (snappy, springy).
Inputs: color, colors, preferences, animation_style.
tempo_generate_scaleB
Generate a spacing system tuned to the type: a base unit, a spacing scale, semantic spacing (padding, gaps, sections) and layout measures.
density: compact (dense UIs), balanced (the default), airy (generous whitespace).
Inputs: color, colors, density, type_style, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Each tool targets a clearly distinct part of the design system lifecycle: palette, typography, spacing, shadows, grid, motion, dark mode, contrast audit, export, and standalone a11y validation. The only mild overlap is between pitch_audit_contrast and a11y_validate, but their descriptions clearly distinguish full-palette auditing from single-pair checking.
All names use lowercase snake_case with a consistent [prefix]_[verb]_[object] structure for most tools. Minor deviations exist: a11y_validate drops the musical prefix, and compose_export lacks an object noun, but the overall pattern remains predictable and readable.
Ten tools is well-scoped for generating a complete design system from one brand color. Each tool maps to a necessary subsystem or audit step, and none feel redundant or excessive.
The surface covers all major design-system token categories named in the export description: colors, typography, spacing, shadows, grid, motion, accessibility, and dark mode. The inclusion of both a full-palette contrast audit and a free single-pair validator makes the accessibility workflow robust with no obvious dead ends.
Maintenance
Related MCP Connectors
Give your agent a real design system: tokens, measured WCAG contrast, and rules to follow.
Build and manage your design system with AI: tokens, themes, components, icons, Figma and code.
Design systems your AI agent builds with and you reshape, plus standalone React components.
Generate design systems: OKLCH colors, fluid type scales, spacing, shape, icon and motion tokens.
Related MCP Servers
- AlicenseAqualityBmaintenanceProvides deterministic, read-only design knowledge for AI coding agents to help them choose visual directions, plan UI states, and compose design tokens, all without network access.6250 npm29MIT
- AlicenseAqualityCmaintenanceA design harness for AI coding agents. Better Design gives an agent design systems, UI and UX principles, icons and UI review: it finds or creates a design system that fits the product and installs its components, explains how sign-up, forms and onboarding should work, and reviews finished screens for readability, accessibility and unclear copy.48568MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI coding assistants to generate bespoke design systems by synthesizing OKLCH color palettes, chamfer highlights and spring physics, teaching layout composition grammar, and returning micro-interaction primitives and component blueprints. Also audits JSX/TSX/HTML through a senior design director's lens to score and critique UI quality.1 npm1MIT

WunderUI MCPofficial
AlicenseAqualityBmaintenanceEnables AI coding agents to build UI with a design system's tokens, component inventory and prop signatures, page templates, and starter snippets, while tracking free/pro availability and live-updating design data.11102 npm2MIT