Skip to main content
Glama
Ensemble MCP

Ensemble MCP

by MPfeifer33

🎨 Ensemble MCP

Give your AI agent design taste.

npm version License: MIT

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.

Tool

What it does

Its main argument

harmony_generate_palette

A full color system from one brand color

color_scheme

duet_pair_fonts

Heading, body and mono fonts with a type scale

type_style

tempo_generate_scale

A spacing system tuned to the type

density

chord_generate_shadows

Elevation shadows tinted by the palette

shadow_intensity

cadence_generate_grid

Responsive grid: breakpoints, columns, gutters

density

riff_generate_motion

Durations, easing curves and transition presets

animation_style

bridge_generate_theme

A complete dark mode from the light system

color

pitch_audit_contrast

Which palette pairs pass WCAG, and what to fix

color

compose_export

The whole system as CSS, JSON, Tailwind or SCSS

formats

a11y_validate

Check one color pair for accessibility (FREE, no key needed)

foreground, background

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


Related MCP server: Better Design

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



Built with 🧡 by HearthByte

Your work. Your choice. Always.

Available Tools

10 tools
a11y_validateA

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

Inputs: background (required), foreground (required), fontSize, algorithm.

bridge_generate_themeB

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

Inputs: color (required), colors, preferences, color_scheme.

cadence_generate_gridB

Generate a responsive grid: breakpoints, column counts, gutters and max widths, sized from the spacing system.

density: compact, balanced (the default), airy.

Inputs: color, colors, density, preferences.

chord_generate_shadowsB

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

Inputs: color (required), colors, preferences, color_scheme, +1 more.

compose_exportA

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

Inputs: color (required), colors, corners, density, +6 more.

duet_pair_fontsA

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

Inputs: color, colors, type_style, preferences.

harmony_generate_paletteA

Generate 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) • triadic — three evenly spaced hues (balanced, colorful) • split-complementary — the two hues beside the complement (nuanced contrast)

Inputs: color (required), colors, preferences, color_scheme.

pitch_audit_contrastA

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

Inputs: color (required), colors, preferences, color_scheme, +2 more.

riff_generate_motionB

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

Inputs: color, colors, preferences, animation_style.

tempo_generate_scaleB

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

Inputs: color, colors, density, type_style, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 10 tools

    Disambiguation5/5

    Each tool targets a clearly distinct part of the design system lifecycle: palette, typography, spacing, shadows, grid, motion, dark mode, contrast audit, export, and standalone a11y validation. The only mild overlap is between pitch_audit_contrast and a11y_validate, but their descriptions clearly distinguish full-palette auditing from single-pair checking.

    Naming Consistency4/5

    All names use lowercase snake_case with a consistent [prefix]_[verb]_[object] structure for most tools. Minor deviations exist: a11y_validate drops the musical prefix, and compose_export lacks an object noun, but the overall pattern remains predictable and readable.

    Tool Count5/5

    Ten tools is well-scoped for generating a complete design system from one brand color. Each tool maps to a necessary subsystem or audit step, and none feel redundant or excessive.

    Completeness5/5

    The surface covers all major design-system token categories named in the export description: colors, typography, spacing, shadows, grid, motion, accessibility, and dark mode. The inclusion of both a full-palette contrast audit and a free single-pair validator makes the accessibility workflow robust with no obvious dead ends.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Provides deterministic, read-only design knowledge for AI coding agents to help them choose visual directions, plan UI states, and compose design tokens, all without network access.
      6
      250 npm
      29
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      A design harness for AI coding agents. Better Design gives an agent design systems, UI and UX principles, icons and UI review: it finds or creates a design system that fits the product and installs its components, explains how sign-up, forms and onboarding should work, and reviews finished screens for readability, accessibility and unclear copy.
      48
      568
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI coding assistants to generate bespoke design systems by synthesizing OKLCH color palettes, chamfer highlights and spring physics, teaching layout composition grammar, and returning micro-interaction primitives and component blueprints. Also audits JSX/TSX/HTML through a senior design director's lens to score and critique UI quality.
      1 npm
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI coding agents to build UI with a design system's tokens, component inventory and prop signatures, page templates, and starter snippets, while tracking free/pro availability and live-updating design data.
      11
      102 npm
      2
      MIT