
Ensemble MCP server
dev.hearthbyte/ensemble·v1.0.0AI-ready design toolkit: color palettes, typography, spacing, shadows and accessibility audits.
0 stars337 downloads/wk
Reviews
Write oneNobody has reviewed Ensemble yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Ensemble tools (10)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
a11y_validateCheck 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.
bridge_generate_themeGenerate 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.
cadence_generate_gridGenerate a responsive grid: breakpoints, column counts, gutters and max widths, sized from the spacing system. density: compact, balanced (the default), airy.
chord_generate_shadowsGenerate 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.
compose_exportBuild 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.
duet_pair_fontsPick 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.
harmony_generate_paletteGenerate 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) •
pitch_audit_contrastAudit 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.
riff_generate_motionGenerate 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).
tempo_generate_scaleGenerate 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).
Public scan report
scanner v0.1.10 · 2026-10-13 · same rubric, same numbers if you re-run it
- Code scan5 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 2 days ago15/15
- Maintainer identitynamespace and repository owner differ; GitHub account older than a year; website matches verified namespace7/10
How Ensemble compares
Against every graded Media MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 82/100
- higher than 65% of 1,337 Media servers
- Tools
- 10
- the typical Media server has 7
- Tools that change things
- 0%
- typical: 4%. Fewer write tools means less an agent can break
- Downloads a week
- 337
- more than 83% of 365 Media servers with a package
What its tools let an agent do: 10 read
Install Ensemble in Claude Code, Cursor or VS Code
Runs npx -y @hearthbyte/ensemble-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add ensemble -- npx -y @hearthbyte/ensemble-mcp
What the publisher says
From the Ensemble repository's README, as published. We do not edit it. Read it on GitHub
🎨 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.
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.
Quick Start
Claude Desktop
Add to your claudedesktopconfig.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"
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Ensemble: common questions
- Is Ensemble MCP server safe?
- Mostly: it is graded B (82/100). Read the Ensemble safety report
- How do I install Ensemble?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Ensemble need an API key?
- Yes. The registry entry asks for
ENSEMBLE_API_KEY. - Is Ensemble maintained?
- The last commit was 24 days ago (2026-10-11). The latest release is v1.0.0.
- What can I use instead of Ensemble?
- Servers from other publishers that do the same job: OverlayQA MCP server, Dembrandt MCP server and melta UI MCP server. Compare all Ensemble alternatives.
- How does Ensemble compare with other Media MCP servers?
- safety score 82/100 (higher than 65% of 1,337 Media servers); tools 10 (the typical Media server has 7); tools that change things 0% (typical: 4%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Ensemble
Same job from other publishers: the closest match first, then the best rated.
OverlayQARun accessibility, contrast, and design token audits and file QA issues from your AI coding tool.not reviewedGrowingA- DembrandtDesign tokens from any live site: colours, type, spacing, components, drift against a baseline.not reviewedWidely usedB
- melta UIAI-Ready design system MCP: melta UI tokens, component contracts, 107 rules, check_html self-verifynot reviewedEstablishedA
- memiMemi is the read-only design engineering audit and skill layer for coding agents.not reviewedGrowingA
RavenDesign intelligence for coding agents: audits, design systems, and a taste profile agents consult.not reviewedGrowingB