Skip to content
MCP server

Ensemble

Generate a design system from one brand color, exported as CSS, Tailwind or JSON

Runs locallyStatus and history
Install
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-mcp

Add 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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  3. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  4. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  5. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  6. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory