Ensemble

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.

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

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-mcpensemble-mcp

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

Get your API key →

Design Philosophy

Ensemble tools are built on these principles:

1. One color in, design system out - Start with a single value, get a complete system
2. Cross-tool sync - Colors flow to typography, typography informs spacing
3. Export everywhere - CSS, Tailwind, SCSS, JSON
4. Accessibility first - WCAG 2.1 + APCA checking built in

Links

• 🌐 Ensemble Web Tools - Use in browser, no install
• 📖 API Documentation
• 🤖 WebMCP Spec