Skip to main content
Glama

The Designer MCP

MCP server: hela-phenotype · Version: 3.0.5 · Canonical tools: 28. Current tool reference.

Part of the HeLa MCP Ecosystem — This server is HeLa Phenotype (hela-phenotype) — the Design component of the HeLa cellular architecture. See the ecosystem docs for profiles, workflows, and multi-client setup.

MIT License TypeScript

A Design-Theory-as-a-Service Model Context Protocol (MCP) server for production-grade UI design. Unlike standard code-retrieval MCPs, designer-mcp codifies subjective design principles—perceptual color math (OKLCH), motion physics, typographic scaling, and accessibility—into executable algorithms with strict anti-slop quality gates.

28 canonical tools across 18 design systems (including Awwwards SOTA / Avant-Garde): anti-slop quality gates, motion.dev & anime.js integration, WCAG 2.1 auditing, React/Vue component output, framework-agnostic CSS, logo & brand-mark design backed by a 1,432-mark reference library, and Stitch Canvas & workflow integration.

Blotcat at the design pipeline: scan → evaluate → rules → tokens, 17 systems

Table of Contents

Related MCP server: mcp-mirage-brand-extract

Features

  • Anti-Slop Quality Gates — 35-gate slop test + 6-axis self-critique (P-H-E-S-R-V). Rejects anything < 3.

  • OKLCH Token System — 19 curated themes across 5 genres (including avant-garde: Obsidian Kinetic, Tokyo Neo-Brutal, Atelier Craft) with auto dark-mode derivation (full_css field ships both :root and @media (prefers-color-scheme: dark) + [data-theme="dark"] overrides).

  • Design Rules Generator — 18 design systems (including awwwards) + 7 palettes (including obsidian-noir, copper-cyber, acid-avant) + 6 archetypes (including awwwards-bento) + hybrid combos.

  • Pre-Flight Scan — Detect existing project context: framework, font stack, palette tokens, motion libraries.

  • Framework-Native Components — Every component (button, card, navbar, hero, etc.) outputs HTML/Tailwind, React TSX (typed FC with prop interface), or Vue 3 SFC (script setup) via the framework param.

  • CSS Output Engine — Generate vanilla CSS, CSS Modules (Button/Card/Input with all 8 states), SCSS (variables + mixins + BEM), or a single tokens.css with auto dark-mode overrides.

  • WCAG 2.1 Accessibility Audit — 25-check static auditor: alt text, unlabeled inputs, empty buttons/links, heading order, focus-visible removal, skip links, landmark regions, viewport scale lock, and more. Returns 0-100 score + A–F grade + actionable fixes.

  • SOTA Motion System (motion.dev & anime.js) — Style-aware animation presets baked into components. generate_motion_snippet for on-demand snippets with React <motion.div> and vanilla physics support (14 categories including magnetic, text-split, smooth-scroll, marquee, noise-grain, clip-path-mask, all reduced-motion guarded).

  • Color Palette Hunter — Live palettes from Color Hunt with format conversion.

  • Brand Design References — brand_fetch_design_md resolves DESIGN.md from the full 328+ brand getdesign catalog (Stripe, Vercel, Notion, Claude, Tesla, etc.); brand_list returns the 62-brand curated subset shipped locally.

  • Stitch Canvas & Visual Workflow Integration — six canonical tools: stitch_resource (get / edit / delete / url), stitch_find, stitch_create, stitch_generate, stitch_sync_design_system, and stitch_screen_audit.

  • Brand Architecture — the in-tree brand-architecture skill maps portfolio relationships, naming hierarchy, identity linkage, migration, governance, and measurement before visual production.

  • Logo & Brand-Mark Design — the in-tree logo-design skill plus logo_workflow with eight actions: audit, library search, renderer inspection, rendering, delivery variants, concept sheets, preview sheets, and presentation boards.

  • Modern Web Guidance — the in-tree modern-web-guidance skill packages Google's agent workflow for modern HTML, CSS, browser APIs, accessibility, and performance. Its CLI and guidance snapshot are pinned; invoking it requires Node.js 22+ and network access.

Tools

The authoritative advertised surface is the generated 28-tool reference. Consolidated entry points are design_tokens, design_audit, palette, logo_workflow, and stitch_resource. The older per-action names in the compatibility tables below remain aliases; they are not separate advertised tools.

Blotcat balancing the full output stack — tokens.css, components, anime.js, WCAG audit — one prompt in, OKLCH out

Core Design Flow

Tool

Description

evaluate_style

Score 18 design systems against product context

detect_genre

Classify brief into editorial / modern-minimal / atmospheric / playful / avant-garde

pre_flight_scan

Scan existing project for framework, fonts, palette, motion libs

generate_rules

Generate design rules for style + palette + archetype/hybrid

generate_tailwind_config

Generate ready-to-use tailwind.config.js

get_cross_cutting_rules

Get standalone rules (a11y, motion, icons, tokens, responsive)

Stitch Canvas & Workflow Integration

Tool

Description

stitch_get

Get a Stitch resource by ID (project, screen, design-system, status). Mirrors stitch get <resource> [id]

stitch_find

List Stitch resources (projects, screens, design-systems) with optional filters, criteria, and pagination

stitch_create

Create a new Stitch resource (project, screen prompt, or shared design-system payload). Mirrors stitch create <resource>

stitch_edit

Update mutable fields on a Stitch resource by ID. Mirrors stitch edit <resource> <id>

stitch_delete

Delete a Stitch resource by ID. Mirrors stitch delete <resource> <id>

stitch_generate

Trigger generative creation jobs for Stitch screens or variants. Mirrors stitch generate <resource>

stitch_url

Print the canonical web URL for a Stitch project or screen canvas. Mirrors stitch url <resource> <id>

stitch_sync_design_system

Export chosen OKLCH tokens and design rules into .stitch/design-system.json and a formatted DESIGN.md specification

stitch_screen_audit

Audit a Stitch-captured HTML screen or file against WCAG 2.1 (0-100 score), 35 anti-slop gates, and 6-axis craft quality critique

Theme & Token System

Tool

Description

generate_tokens

Generate complete OKLCH token system. Returns css (light :root), full_css (light + dark @media + [data-theme="dark"] overrides), dark_css, dark_tokens

list_themes

List all 19 themes with OKLCH values, fonts, axis metadata

build_custom_tokens

Build custom OKLCH token system from paper/accent/font values — also emits dark mode derivation

Quality Gates

Tool

Description

anti_pattern_check

Run 35-gate slop test on HTML/CSS

self_critique

Score output on 6 quality axes (P-H-E-S-R-V) — anything < 3 triggers revision

audit_accessibility

25-check WCAG 2.1 static auditor — alt text, unlabeled inputs/selects/textareas, empty buttons/links, heading order, focus-visible removal, skip links, landmark regions, viewport scale lock, and more. Returns 0–100 score, A–F grade, per-severity counts, fix instructions, and passed-check list

Component & Template

Tool

Description

generate_template

Full HTML starter page — ships with anime.js v3 animations

get_component

Production-ready component. framework param: html (default) | react (TypeScript FC with motion/react physics) | vue (SFC with script setup)

generate_8state_component

Standalone HTML preview with all 8 interactive states — animated via anime.js spring physics

generate_palette_variants

Light/dark/high-contrast variants from hex colors

export_project

Full project scaffold (config + HTML + components)

CSS Output

Tool

Description

generate_css_output

Framework-agnostic CSS generation from style + palette. Formats: vanilla (tokens.css + base.css + components.css) | css-modules (Button/Card/Input .module.css with all 8 states) | scss (_tokens + _mixins + _components + main.scss) | css-variables-only (tokens.css with auto dark mode). Returns named files array ready to save.

Motion (motion.dev & anime.js)

Tool

Description

generate_motion_snippet

Generate a ready-to-paste motion.dev or anime.js snippet matched to the current design style's physics and easing. Supports 8 categories: entrance, micro, stagger, scroll, loader, transition, counter, typewriter. Every snippet includes a prefers-reduced-motion guard.

Color & Palette

Tool

Description

palette_fetch

Fetch live palettes from Color Hunt

palette_convert

Convert palette JSON to CSS / Tailwind / SCSS / Figma / Android / Swift

Brand References

Tool

Description

brand_fetch_design_md

Download DESIGN.md for a real brand

brand_list

List the 62 curated local brands by category

Logo Design (see "Logo design" below)

Tool

Description

logo_audit

Audit logo SVGs — live text, rasters, filters, colours, gradients, tiny details, centring

logo_search_library

Search 1,432 real-world logo SVGs by type, technique, geometry, industry, colour, mood

logo_render

Render SVG → transparent PNG, screenshot HTML sheets, build favicon.ico

logo_renderers

Report which rendering backends are installed

logo_export_variants

Produce the delivery set: mono, black/white, square, favicon, app-icon, web icons

logo_concept_sheet

One-image concept overview with true 64/32/16 px renderings and a recommendation

logo_preview_sheet

HTML test sheet: size ladder, 16 px test, one-colour, contexts, shelf test vs. competitors

logo_presentation_board

Client presentation with industry-specific mockups from a JSON spec

Utility

Tool

Description

list_options

List all available systems, palettes, archetypes, hybrids

validate_combo

Validate style + palette + hybrid combo

get_reference

Pull full content of any reference doc

list_installed_skills

Detect installed skill submodules

Motion Design

The MCP provides a dual-engine motion system: motion.dev (modern, physics-based, React-native) and anime.js v3 (lightweight vanilla JS).

When calling generate_motion_snippet or get_component (for React), the output is automatically calibrated to the design system's character:

System

Easing / Physics

Duration

glass

easeOutQuart / [0.16, 1, 0.3, 1]

700ms

claymorphism

spring(1, 80, 10, 0) / bounce: 0.4

600ms

neo-brutalism

easeInOutExpo / [0.87, 0, 0.13, 1]

400ms

material

cubicBezier(0.4, 0, 0.2, 1)

300ms

apple-hig

spring(1, 100, 18, 0) / bounce: 0.2

550ms

swiss

linear

200ms

m3-pastel

spring(1, 80, 12, 0) / bounce: 0.3

450ms

Use generate_motion_snippet for standalone snippets targeting specific use cases across React, Vue, and HTML:

{
  "tool": "generate_motion_snippet",
  "arguments": {
    "category": "entrance",
    "style": "glass",
    "engine": "motion.dev",
    "framework": "react"
  }
}

Returns { cdn, snippet, easing, duration, usage_hint, reduced_motion_note }.

All snippets respect prefers-reduced-motion — animations are skipped entirely when the user has enabled reduced motion.

Examples

🔥 Live Demo: Ellis UI Collection

Ellis UI (examples/ellis-ui) A comprehensive, anti-slop component library demonstrating the extreme versatility of designer-mcp's ruleset. The project takes a single romantic letter and renders it across 24 radically different, strictly enforced aesthetic systems (e.g., Swiss Archival, Vintage Airmail, Brutalist, UNIX Phosphor, 8-Bit Game Boy).

Each design acts as a fully standalone, reusable UI kit utilizing zero JS dependencies—relying entirely on strict structural typography, CSS geometry, and advanced CSS rendering techniques (clip-paths, custom filters, OKLCH gradients). Each of the 24 folders includes a design.md detailing the tokens and layout strategy, acting as an advanced template reference for designer-mcp.

Installation

git clone https://github.com/Hela-Ecosystem/designer-mcp.git
cd designer-mcp
npm install
npm run build

Requirements: Node.js 22 LTS is the tested ecosystem environment. logo_workflow additionally needs Python 3 (no third-party packages) and at least one SVG renderer — cairosvg, rsvg-convert, Inkscape, or headless Chrome. Check available renderers with logo_workflow and action: "renderers". Other capabilities may require their configured external services; discovery alone does not prove those integrations are available.

Usage

npm start
npx @modelcontextprotocol/inspector node dist/index.js

Development

npm run build   # tsc
npm test        # 39 checks across two suites

Tests are plain node scripts that import the TypeScript sources directly through --experimental-strip-types; there is no test framework dependency. path-containment.test.mjs drives the real server over stdio to keep the CWE-22 regression honest (see below). logo-tools.test.mjs runs the real Python scripts in a temp directory rather than mocking them, so a change to a script's CLI surface fails the suite instead of silently drifting from src/logoTools.ts.

Path handling and the security boundary

Two different rules, and the difference is deliberate:

  • Names that address a bundled file — get_reference (a reference doc) and get_ellis_ui_template (a design folder) — go through resolveWithinRoot() in src/envelope.ts. It refuses separators, .., absolute paths and NUL bytes, resolves against the real path of the trusted root, and verifies the result is still inside it, so neither a crafted argument nor a symlink can read outside the skill. This closes CWE-22 in get_reference (issue #14), which concatenated the argument straight into a path.

  • Paths the caller deliberately supplies — pre_flight_scan on a project directory, and the logo_* tools on artwork files — are allowed anywhere, because supplying your own project path is the feature. They validate that the path exists and is the right kind of thing, and are the one place an MCP client can still read a file of its choosing.

pre-commit

Hooks are configured in .pre-commit-config.yaml and cover this repo:

Hook

Scope

trailing-whitespace, end-of-file-fixer

first-party files

check-added-large-files (500 KB)

first-party files; the two generated library indexes are exempt

check-yaml, check-merge-conflict, detect-private-key

all files

prettier

JS/TS/CSS/HTML/JSON/Markdown, first-party files

Three trees are kept byte-stable and excluded from the reformatting hooks, each for a stated reason rather than by convenience: examples/ (demo artifacts must match what was designed), skills/video/ (canonical upstream HyperFrames packages), and skills/logo-design/assets/library/ (generated indexes plus third-party reference marks). The list is repeated per hook because pre-commit has no shared exclude — keep the three in sync when you add a fourth.

prettier runs as a system command via scripts/prettier-hook.sh, not through pre-commit's nodeenv installer: pre-commit 4.6.x installs node hooks with npm install --allow-git=root, which npm >= 11 rejects for non-root users, so the stock mirrors-prettier hook cannot install at all on this machine. The wrapper prefers node_modules/.bin/prettier, falls back to prettier on PATH, and warns instead of blocking when neither exists.

Heads-up: this machine sets a global core.hooksPath whose hook is scoped to chaining-mcp, so these hooks do not fire automatically on git commit here. Run pre-commit run --all-files before pushing, or add the repo to that global hook's allowlist.

Architecture

designer-mcp operates on a multi-tier architecture. An MCP server on its own is just an API; by pairing the MCP with companion AI skills, the AI gets both the tools (the MCP) and the instruction manual (the skills).

  • ui-designer skill: Provides the design intelligence, heuristics, and brand context so the AI knows what to ask the MCP to generate.

  • color-palette-hunter skill: Handles external palette sourcing and feeds them into the OKLCH token engine.

  • motion-designer skill: Defines SOTA animation heuristics, spring physics logic, and motion.dev best practices.

  • logo-design skill: Professional logo and brand-mark design, brief to production files, plus a searchable library of 1,432 real-world SVG logos for category research.

  • brand-architecture skill: Portfolio strategy, brand relationship models, naming systems, migration, governance, and measurement planning.

src/
  index.ts              # MCP server entry, tool routing (37 tools)
  rules.ts              # 17 design systems, palettes, archetypes, hybrids
  anti-patterns.ts      # 35-gate slop test + 6-axis self-critique
  a11y-audit.ts         # 25-check WCAG 2.1 accessibility auditor (no deps, regex-only)
  tokens.ts             # 16 curated themes, OKLCH token generation, dark mode derivation
  css-output.ts         # vanilla CSS / CSS Modules / SCSS / css-variables-only generator
  anime-motion.ts       # anime.js v3 integration — style-aware presets, CDN helper, snippet generator
  components.ts         # Component library — HTML/React TSX/Vue 3 SFC output
  components-8state.ts  # 8-state component demo generator (anime.js micro-interactions)
  preflight.ts          # Project context scanner (framework, fonts, palette, motion)
  evaluate.ts           # Style scoring engine
  palette.ts            # Color Hunt palette fetcher
  palette-convert.ts    # Format converter
  palette-variants.ts   # Light/dark/high-contrast variant generator
  templates.ts          # HTML template generator (anime.js baked in)
  tailwind-config.ts    # Tailwind config generator
  export.ts             # Project scaffold exporter
  logoTools.ts          # logo-design wrappers: validate, exec, envelope
skills/
  ui-designer/          # Reference docs + genre files (git submodule)
  color-palette-hunter/ # Palette CLI scripts (git submodule)
  motion-designer/      # Motion/physics heuristics (in-tree)
  logo-design/          # Logo/brand-mark design skill (in-tree, origin in ATTRIBUTION.md)
  modern-web-guidance/  # Modern browser guidance skill (in-tree, pinned upstream)
  brand-architecture/   # Portfolio strategy, naming, governance, and migration (in-tree)
  video/                # Canonical upstream HyperFrames v0.8.77 packages (byte-stable)
test/
  designer-envelope.test.mjs  # envelope shape, side-effect contract
  logo-tools.test.mjs         # 30 checks: validation + real script subprocesses
scripts/
  prettier-hook.sh      # pre-commit formatter entry point
examples/
  ellis-ui/             # 24 design systems showcase (byte-stable, deployed as the demo)

Skills live here in two forms. ui-designer and color-palette-hunter are git submodules pointing at standalone repos; motion-designer, logo-design, and brand-architecture are in-tree because they are tied to this server's tools. See Development for the rules that follow from that.

Logo design

The logo-design skill lives in-tree at skills/logo-design/ and is maintained here like any other source. It began as a copy of kaankiziltug/logo-design-skill (MIT; upstream copyright and licence retained, origin and maintenance rules in skills/logo-design/ATTRIBUTION.md). It ships the design workflow (brief → concepts → mark type → SVG construction → optical refinement → testing → presentation → delivery), nine dependency-free Python scripts (seven wrapped as tools, plus a shared svglib and a maintainer catalog builder), fourteen reference docs, two templates, and a 1,432-mark SVG library. skills/logo-design/HELA.md is the HeLa overlay: palettes must come from the token engine, logotypes ship as outlines, gradients and filters are rejected, and rendering before presenting is mandatory.

One canonical tool, logo_workflow, exposes eight actions to an agent. The older names below are compatibility aliases. These operations are read-only with respect to your source artwork; the writers create new output files in the directory you name.

Tool

What it does

logo_audit

Audit SVGs: live text, rasters, filters, colour count, gradients, strokes, near-miss angles, tiny details, centring, complexity. JSON report.

logo_search_library

Query the 1,432-mark library by type, technique, geometry, subject, industry, colour, mood, type style, aspect. summary for category conventions, format=paths for files to open.

logo_render

SVG → transparent PNG at exact sizes, HTML sheet → screenshot, and favicon.ico. This is how the agent looks at its own work.

logo_renderers

Report which backends are installed (cairosvg, rsvg-convert, Inkscape, headless Chrome, Quick Look) before promising a PNG.

logo_export_variants

Delivery set from a master SVG: black, white, one-colour, square, favicon, app-icon, plus --web-icons (favicon.ico + PNG set + webmanifest + <head> snippet).

logo_concept_sheet

One-image concept overview with true 64/32/16 px renderings and a recommendation. Show this at the concept checkpoint, before building the kit.

logo_preview_sheet

HTML test sheet: size ladder, 16/32 px pixel test, backgrounds, one-colour, squint test, mirror/rotate, real contexts, and a shelf test against category competitors.

logo_presentation_board

Client-facing presentation from a JSON spec, with industry-specific mockups per concept; optional PNG export per slide.

The design conversation itself still belongs to the skill. A typical run: logo_search_library to study the category, then the skill's concept phase, then logo_concept_sheet to show three directions, then — only after the user picks one — logo_export_variants for the delivery set, gated on logo_audit and a rendered logo_preview_sheet.

{
  "name": "logo_workflow",
  "arguments": { "action": "audit", "files": ["/path/to/concepts/acme-a.svg"], "bg": "#ffffff" }
}

Renderer notes: on a machine with only headless Chrome, logo_render still works for PNG output and HTML screenshots, but favicon assembly and multi-size batches are slower. Run logo_renderers first when a deliverable depends on it.

Anti-Slop Design Philosophy

Blotcat stamping the 35-gate checklist — HTML/CSS queued left, rejected crumpled right, score < 3 → revise

  • Locked tokens — every color/font references a named CSS variable, never inline values

  • No fabricated content — real metrics or labeled placeholders only

  • No re-drawn chrome — no fake browser bars, phone frames, or code window chrome

  • Typography purity — headings always roman, no italic display faces

  • Structural variety — different briefs produce structurally different pages

  • Mobile-responsiveness hard floor — 320/375/414/768px, overflow-x: clip, minmax(0, 1fr), no two-line clickable text

  • OKLCH-first — all new tokens defined in OKLCH for perceptual uniformity

  • Motion with restraint — animations are style-calibrated, spring-physics-grounded, and always gated on prefers-reduced-motion

Configuration

Variable

Default

Description

UI_DESIGNER_SKILL_PATH

skills/ui-designer

Path to the ui-designer skill references

COLOR_PALETTE_HUNTER_PATH

skills/color-palette-hunter

Path to the color palette hunter skill

LOGO_DESIGN_SKILL_PATH

skills/logo-design

Path to the logo-design skill (its scripts/ and assets/library/ are required for the logo_* tools)

PYTHON_BIN

python3

Interpreter used to run the logo-design scripts

HELA_ENVELOPE

unset = off

Set to true to wrap tool results in the HeLaResult envelope. Side effects depend on the selected action: logo rendering can run processes and write deliverables. Run/step ids propagate from HELA_RUN_ID/HELA_STEP_ID.

Configuring with AI Assistants

{
  "mcpServers": {
    "designer-mcp": {
      "command": "node",
      "args": ["/path/to/designer-mcp/dist/index.js"],
      "env": {}
    }
  }
}

License

MIT

Available Tools

28 tools
brand_fetch_design_mdB

Download and return the DESIGN.md for a real brand (stripe, vercel, linear, notion, claude, tesla, etc.).

Inputs: brand (required).

brand_listA

List the curated local brand catalog (62 brands across 7 categories) grouped by category. For DESIGN.md retrieval beyond this list, use brand_fetch_design_md, which resolves the full 328+ brand getdesign catalog.

Inputs: category.

design_auditA

Audit design work. Select action: accessibility (25-check WCAG 2.1), slop (35-gate anti-pattern check), critique (6-axis quality score), or preflight (scan an existing project's design tokens and stack).

Inputs: action (required), html, genre, content, +1 more.

design_tokensB

Generate design tokens. Select action: theme (named theme or genre), custom (OKLCH paper/accent + fonts), css (vanilla/CSS Modules/SCSS/variables-only), or tailwind (complete tailwind.config.js).

Inputs: action (required), genre, style, format, +13 more.

detect_genreA

Detect the most appropriate design genre from a product description or brief. Returns one of: editorial, modern-minimal, atmospheric, playful.

Inputs: brief (required).

evaluate_styleA

Evaluates a product description against all design systems and returns ranked style recommendations with scoring. USE THIS FIRST before generate_rules. Takes a product context (e.g. 'automotive gaming mouse', 'enterprise dashboard', 'luxury ecommerce') and returns the best-matching style, palette, archetype, and a step-by-step workflow.

Inputs: description (required).

export_projectA

Export a complete project scaffold: tailwind.config.js, index.html, input.css, package.json, and component files. Returns all files as a structured manifest ready to write to disk.

Inputs: style (required), palette (required), archetype (required), projectName.

generate_8state_componentA

Generate a complete 8-state component demo page (default, hover, focus, active, disabled, loading, error, success) for a given component kind. Returns a standalone HTML preview file with all states rendered.

Inputs: kind (required).

generate_motion_snippetA

Generate a ready-to-paste anime.js v3 animation snippet for a given motion category and design style. Returns CDN link, code snippet, usage hint, and reduced-motion note. Categories: entrance, micro, stagger, scroll, loader, transition, counter, typewriter. All snippets include prefers-reduced-motion guards.

Inputs: style (required), category (required), engine, framework.

generate_rulesA

Generate design rules for a style + palette + optional archetype/hybrid. IMPORTANT: Run evaluate_style first to determine the best style for your product context. Only use this tool after evaluation confirms the style choice.

Inputs: style (required), palette (required), hybrid, tailwind, +1 more.

generate_templateA

Generate a full HTML starter page for a style + palette + archetype combination. IMPORTANT: Run evaluate_style first to determine the best style/palette/archetype for your product context.

Inputs: style (required), palette (required), archetype (required).

get_componentA

Get a production-ready component snippet styled for a specific design system. Supports HTML (Tailwind), React (TSX functional component with typed props), and Vue 3 (SFC with script setup). IMPORTANT: Run evaluate_style first to confirm the style choice.

Inputs: style (required), component (required), framework.

get_cross_cutting_rulesA

Get standalone cross-cutting design rules by category. Categories: icons, accessibility, motion, tokens, responsive, tailwind. Returns the rules as a formatted string.

Inputs: category (required).

get_ellis_ui_templateB

Fetch the HTML structure and CSS logic of a specific Ellis UI design system (e.g., 'backup_dossier' or 'backup_gameboy'). Returns both the design.md guidelines and the root index.html template.

Inputs: design_name (required).

get_referenceA

Return the full content of a reference document by name (e.g. 'ant-design', 'accessibility', 'design-tokens', 'getdesign-md').

Inputs: name (required).

list_ellis_ui_designsA

List all 24 bespoke Ellis UI component design templates with their specific aesthetic focus.

Inputs: no named parameters.

list_installed_skillsA

Detect and list all installed skill submodules alongside this MCP. Shows which skills are available for standalone use and what capabilities they provide.

Inputs: no named parameters.

list_optionsA

List all available design systems, palettes, archetypes, and valid hybrid combinations.

Inputs: no named parameters.

list_themesB

List all available named themes, optionally filtered by genre. Each theme includes paper/accent OKLCH values, font pairing, and axis metadata for diversification.

Inputs: genre.

logo_workflowB

Logo-design workflow. Select action: audit, search, renderers, render, export_variants, concept_sheet, preview_sheet, or presentation_board. Search queries the 1,400+ mark library; render/export/board actions write files.

Inputs: action (required), bg, ico, out, +57 more.

paletteB

Fetch live palettes from Color Hunt, convert palette JSON into CSS/Tailwind/SCSS/Figma/Android/Swift, or generate light/dark/high-contrast/muted/vivid variants. Select action: fetch, convert, or variants.

Inputs: action (required), mode, limit, query, +5 more.

stitch_createC

Creates one Stitch resource (project, screen, design-system). Mirrors 'stitch create '. Returns created resource metadata.

Inputs: body (required), resource (required), dryRun, project, +1 more.

stitch_findA

Lists Stitch resources of a given type (projects, screens, design-systems). Mirrors 'stitch find '. Returns items list, count, and pagination info.

Inputs: resource (required), limit, filter, project, +2 more.

stitch_generateB

Triggers a backend generative creation job for Stitch screens or variants. Mirrors 'stitch generate '.

Inputs: resource (required), count, device, dryRun, +4 more.

stitch_resourceC

Read, edit, or delete one Stitch resource, or print its canonical canvas URL. Select action: get, edit, delete, or url.

Inputs: action (required), id, body, project, +2 more.

stitch_screen_auditA

Run a unified audit on a Stitch-captured HTML screen or file. Executes 25-check WCAG 2.1 static analysis, 35+ gate anti-slop checks, and 6-axis craft critique.

Inputs: genre, filePath, screenHtml.

stitch_sync_design_systemB

Export the current or chosen OKLCH theme and design rules into a Stitch-compliant DESIGN.md and .stitch/design-system.json for automated visual canvas synchronization.

Inputs: style, targetDir, themeName.

validate_comboA

Validate a style + palette + optional hybrid combination before generating rules.

Inputs: style (required), palette (required), hybrid.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 28 tools

    Disambiguation3/5

    Descriptions are detailed and many tools have explicit 'run X first' guidance, which helps. But there is real overlap: design_audit and stitch_screen_audit perform essentially the same 25-check WCAG / anti-slop / 6-axis critique, design_tokens and palette both emit theme variants, and generate_rules / generate_template / export_project form a blurry progression. Several multi-action tools (palette, design_tokens, design_audit, stitch_resource, logo_workflow) hide multiple operations behind one name, which is convenient but widens each tool's boundaries.

    Naming Consistency3/5

    A majority follow snake_case verb_noun (generate_rules, list_options, get_component, validate_combo, export_project), and the stitch_* / brand_* families are grouped consistently. However, some tools are bare nouns with no verb (palette, design_tokens) while others are verb-led (design_audit, evaluate_style), mixing conventions within the same conceptual group.

    Tool Count2/5

    At 28 tools this is heavy for a design-system server, and several entries duplicate capability already covered elsewhere (two audits, three template/scaffold generators, two token/palette generators). The surface could be meaningfully consolidated to ~15 tools without losing functionality.

    Completeness4/5

    Coverage is broad and lifecycle-ish: style evaluation, validation, rule/token generation, components, templates, motion, export, auditing, brand references, and Stitch canvas sync. Minor gaps exist around editing or updating previously generated local artifacts (only Stitch resources support edit/delete), but core design workflows are covered end to end.

    Maintenance

    ActivityActive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers