# Ensemble

> Ensemble is a freemium MCP server for design and media. Generate a design system from one brand color, exported as CSS, Tailwind or JSON. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $4.99 a month
- **Platforms:** CLI, API
- **Website:** https://hearthbyte.dev/ensemble/
- **Repository:** https://github.com/mpfeifer33/ensemble-mcp
- **MCP Registry name:** dev.hearthbyte/ensemble
- **Categories:** design and media, developer tools
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add ensemble --env ENSEMBLE_API_KEY='<ENSEMBLE_API_KEY>' -- npx -y @hearthbyte/ensemble-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "ensemble": {
      "command": "npx",
      "args": [
        "-y",
        "@hearthbyte/ensemble-mcp"
      ],
      "env": {
        "ENSEMBLE_API_KEY": "<ENSEMBLE_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "ensemble": {
      "command": "npx",
      "args": [
        "-y",
        "@hearthbyte/ensemble-mcp"
      ],
      "env": {
        "ENSEMBLE_API_KEY": "<ENSEMBLE_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "ensemble": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@hearthbyte/ensemble-mcp"
      ],
      "env": {
        "ENSEMBLE_API_KEY": "<ENSEMBLE_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "ensemble": {
      "command": "npx",
      "args": [
        "-y",
        "@hearthbyte/ensemble-mcp"
      ],
      "env": {
        "ENSEMBLE_API_KEY": "<ENSEMBLE_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "ensemble": {
      "command": "npx",
      "args": [
        "-y",
        "@hearthbyte/ensemble-mcp"
      ],
      "env": {
        "ENSEMBLE_API_KEY": "<ENSEMBLE_API_KEY>"
      }
    }
  }
}
```

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/ensemble
