
Ensemble
Generate a design system from one brand color, exported as CSS, Tailwind or JSON
- Pricing
- Freemium
- Platforms
- CLI, API
- Runs
- Locally
- Version
- 1.0.0
- Listing updated
- 2 days ago
About Ensemble
Ensemble is a freemium MCP server for design and media. It runs locally on your machine and is started by your AI client.
Ensemble is a set of design generators that agree with each other. Give it a brand color and optional preferences, and the tools produce an OKLCH shade palette, a heading, body and mono font pairing with a type scale, spacing tuned to that type, tinted elevation shadows, a responsive grid, motion presets and a dark theme. Results are deterministic, so the same color and preferences always yield the same system.
The npm package exposes ten tools: nine builders prefixed by name (harmony, duet, tempo, chord, cadence, riff, bridge, pitch and compose) plus a free a11y_validate that checks one foreground and background pair for accessibility without a key. The builders call the Ensemble API and need a Pro key. pitch_audit_contrast reports which palette pairs pass WCAG and what to fix, and compose_export writes the whole system as CSS custom properties, SCSS variables, a Tailwind config or W3C JSON tokens.
Run it over stdio with npx in Claude Desktop, Cursor or Cline. The website also lists browser tools and says they stay free.
Install
Run in a terminal
claude mcp add ensemble --env ENSEMBLE_API_KEY='<ENSEMBLE_API_KEY>' -- npx -y @hearthbyte/ensemble-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"ensemble": {
"command": "npx",
"args": [
"-y",
"@hearthbyte/ensemble-mcp"
],
"env": {
"ENSEMBLE_API_KEY": "<ENSEMBLE_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"ensemble": {
"command": "npx",
"args": [
"-y",
"@hearthbyte/ensemble-mcp"
],
"env": {
"ENSEMBLE_API_KEY": "<ENSEMBLE_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"ensemble": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@hearthbyte/ensemble-mcp"
],
"env": {
"ENSEMBLE_API_KEY": "<ENSEMBLE_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"ensemble": {
"command": "npx",
"args": [
"-y",
"@hearthbyte/ensemble-mcp"
],
"env": {
"ENSEMBLE_API_KEY": "<ENSEMBLE_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"ensemble": {
"command": "npx",
"args": [
"-y",
"@hearthbyte/ensemble-mcp"
],
"env": {
"ENSEMBLE_API_KEY": "<ENSEMBLE_API_KEY>"
}
}
}
}Configuration
ENSEMBLE_API_KEYEnsemble Pro API key (hearthbyte.dev/ensemble/pricing). Without it only the free a11y_validate tool works.
Tools this server provides (10)
Taken from the project documentation; the running server may differ.
- harmony_generate_palette
- Full color system from one brand color.
- duet_pair_fonts
- Heading, body and mono fonts with a type scale.
- tempo_generate_scale
- Spacing system tuned to the type.
- chord_generate_shadows
- Elevation shadows tinted by the palette.
- cadence_generate_grid
- Responsive grid with breakpoints, columns and gutters.
- riff_generate_motion
- Durations, easing curves and transition presets.
- bridge_generate_theme
- Dark mode derived from the light system.
- pitch_audit_contrast
- Which palette pairs pass WCAG, and what to fix.
- compose_export
- Exports the system as CSS, JSON, Tailwind or SCSS.
- a11y_validate
- Checks one color pair for accessibility; free, no key.
What it does
- Palette from one color
- harmony_generate_palette builds a full OKLCH color system from a brand color.
- Font pairing and type scale
- duet_pair_fonts picks heading, body and mono fonts with a scale.
- Spacing, shadows, grid
- Tempo, Chord and Cadence tools generate spacing, tinted shadows and responsive grids.
- Dark mode generation
- bridge_generate_theme derives a dark theme from the light system.
- Contrast audit
- pitch_audit_contrast checks palette pairs against WCAG and lists fixes.
- Token export
- compose_export outputs CSS, SCSS, Tailwind or W3C JSON tokens.
- Free accessibility check
- a11y_validate tests a color pair without an API key.
Good for
- Turn a brand hex code into Tailwind config
- Audit an existing palette for failing contrast pairs
- Create matching light and dark themes
- Keep spacing and shadows consistent with the chosen type scale
Pricing
Freemium, from $4.99 a month
a11y_validate free; builders need Pro at $4.99/mo or $39/yr
Prices change. Check hearthbyte.dev before you buy.
Ensemble FAQ
Do I need an API key?
Only for the builder tools. a11y_validate works without one; the Pro key costs $4.99 a month or $39 a year.
How do I install it?
Run it with npx -y @hearthbyte/ensemble-mcp and set ENSEMBLE_API_KEY in the client's env block.
Is the output repeatable?
Yes. The README says the same color and preferences always give the same system.
Which formats can I export?
CSS custom properties, SCSS variables, a Tailwind config or W3C JSON tokens.
Is Ensemble free?
Ensemble has a free plan, with paid plans for more usage or features. Paid plans start at $4.99 a month.
How do I add Ensemble to Claude Code?
Run this command in your terminal: claude mcp add ensemble --env ENSEMBLE_API_KEY='<ENSEMBLE_API_KEY>' -- npx -y @hearthbyte/ensemble-mcp
What are the best alternatives to Ensemble?
The closest alternatives to Ensemble are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.
Alternatives to Ensemble

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory