x51xxx avatar

Coolors MCP

x51xxx/coolors-mcp

Color tools for AI agents: WCAG/APCA contrast, Material 3 HCT themes, palettes, DESIGN.md audits

GitHub stars
5
tools
30
transport
STDIO
last updated
Nov 14, 2026

Tools

30 tools

Public tool metadata for what this MCP can expose to an agent.

describe_colorDescribes up to 20 colors in human terms: name, temperature, lightness and vividness, OKLCH/HCT/HSL/RGB, readable text color, UI roles, pitfalls.

Describes up to 20 colors in human terms: name, temperature, lightness and vividness, OKLCH/HCT/HSL/RGB, readable text color, UI roles, pitfalls.

No parameter schema in public metadata yet.

fix_contrastFinds the closest same-hue color that meets aa, aaa, aa-large, ui, apca-body, apca-content or apca-large. Adjusts foreground, background or either.

Finds the closest same-hue color that meets aa, aaa, aa-large, ui, apca-body, apca-content or apca-large. Adjusts foreground, background or either.

No parameter schema in public metadata yet.

design_ui_paletteBuilds a contrast-checked light + dark UI token set (60-30-10) from one brand color, as a report, CSS, JSON or W3C tokens.

Builds a contrast-checked light + dark UI token set (60-30-10) from one brand color, as a report, CSS, JSON or W3C tokens.

No parameter schema in public metadata yet.

audit_ui_colorsAudits up to 100 foreground/background pairs and 64 swatches: WCAG, APCA, CVD contrast drops, vibration and disliked colors, with fixes.

Audits up to 100 foreground/background pairs and 64 swatches: WCAG, APCA, CVD contrast drops, vibration and disliked colors, with fixes.

No parameter schema in public metadata yet.

generate_categorical_paletteGenerates 2–12 chart or tag colors that stay distinct for normal vision and protan/deutan/tritan viewers.

Generates 2–12 chart or tag colors that stay distinct for normal vision and protan/deutan/tritan viewers.

No parameter schema in public metadata yet.

convert_colorConverts a color to hex, rgb, hsl, lab, hct, oklab or oklch.

Converts a color to hex, rgb, hsl, lab, hct, oklab or oklch.

No parameter schema in public metadata yet.

color_distancePerceptual distance between two colors: deltaE2000 (default), deltaE94, deltaE76, euclidean or weighted.

Perceptual distance between two colors: deltaE2000 (default), deltaE94, deltaE76, euclidean or weighted.

No parameter schema in public metadata yet.

check_contrastWCAG 2.x ratio, APCA Lc or both, with CVD warnings and the nearest same-hue AA fix when a pair fails.

WCAG 2.x ratio, APCA Lc or both, with CVD warnings and the nearest same-hue AA fix when a pair fails.

No parameter schema in public metadata yet.

adjust_colorlighten, darken, saturate, desaturate, hue-shift, tint, shade, grayscale, invert or mix, in OKLCH (default), HCT or HSL.

lighten, darken, saturate, desaturate, hue-shift, tint, shade, grayscale, invert or mix, in OKLCH (default), HCT or HSL.

No parameter schema in public metadata yet.

simulate_color_blindnessShows how up to 64 colors look under protanopia, deuteranopia, tritanopia, the three anomalies and achromatopsia.

Shows how up to 64 colors look under protanopia, deuteranopia, tritanopia, the three anomalies and achromatopsia.

No parameter schema in public metadata yet.

check_palette_accessibilityFlags palette pairs whose ΔE2000 falls below a threshold (default 10) under each deficiency type.

Flags palette pairs whose ΔE2000 falls below a threshold (default 10) under each deficiency type.

No parameter schema in public metadata yet.

generate_paletteColor-harmony palette (monochromatic, analogous, complementary, split-complementary, triadic, tetradic, square, compound, shades-and-tints), 3–12 colors.

Color-harmony palette (monochromatic, analogous, complementary, split-complementary, triadic, tetradic, square, compound, shades-and-tints), 3–12 colors.

No parameter schema in public metadata yet.

generate_palette_with_locksPalette of 2–20 colors that keeps your locked colors, in harmony, contrast or gradient mode.

Palette of 2–20 colors that keeps your locked colors, in harmony, contrast or gradient mode.

No parameter schema in public metadata yet.

generate_gradientGradient of steps total colors (every input color is kept) as an array, hex list or CSS linear-gradient/radial-gradient.

Gradient of steps total colors (every input color is kept) as an array, hex list or CSS linear-gradient/radial-gradient.

No parameter schema in public metadata yet.

export_paletteExports up to 256 colors as css, scss, tailwind, tokens (W3C), json or design-md.

Exports up to 256 colors as css, scss, tailwind, tokens (W3C), json or design-md.

No parameter schema in public metadata yet.

generate_tonal_scaleTailwind-style 50–950 scale (or custom stops) from a seed color; stop 50 is HCT tone 95, 500 is tone 50, 950 is tone 5. Includes CSS variables.

Tailwind-style 50–950 scale (or custom stops) from a seed color; stop 50 is HCT tone 95, 500 is tone 50, 950 is tone 5. Includes CSS variables.

No parameter schema in public metadata yet.

generate_state_colorsHover, active, pressed, focus, disabled and selected colors from a base color, for light or dark surfaces.

Hover, active, pressed, focus, disabled and selected colors from a base color, for light or dark surfaces.

No parameter schema in public metadata yet.

analyze_palette_consistencyScores tonal step uniformity, chroma cohesion and hue harmony, with an overall 0–100 cohesion score.

Scores tonal step uniformity, chroma cohesion and hue harmony, with an overall 0–100 cohesion score.

No parameter schema in public metadata yet.

generate_semantic_palettePrimary, secondary, tertiary and success/warning/error/info colors with matched tone and chroma.

Primary, secondary, tertiary and success/warning/error/info colors with matched tone and chroma.

No parameter schema in public metadata yet.

generate_material_themeLight and dark Material 3 schemes (primary, secondary, tertiary, error, surface roles) from a source color.

Light and dark Material 3 schemes (primary, secondary, tertiary, error, surface roles) from a source color.

No parameter schema in public metadata yet.

harmonize_colorsFor 2–10 colors: harmonize shifts each hue toward the first color, blend mixes them into one, temperature warms or cools them.

For 2–10 colors: harmonize shifts each hue toward the first color, blend mixes them into one, temperature warms or cools them.

No parameter schema in public metadata yet.

generate_tonal_paletteMaterial tonal palette for the standard tones or your own list of tones (0–100).

Material tonal palette for the standard tones or your own list of tones (0–100).

No parameter schema in public metadata yet.

match_theme_colorFinds the theme custom property closest to a color, with a confidence score.

Finds the theme custom property closest to a color, with a confidence score.

No parameter schema in public metadata yet.

match_theme_colors_batchThe same for up to 50 colors.

The same for up to 50 colors.

No parameter schema in public metadata yet.

refactor_css_with_themeRewrites hard-coded colors in declaration values to var(--…) references, with an optional report.

Rewrites hard-coded colors in declaration values to var(--…) references, with an optional report.

No parameter schema in public metadata yet.

generate_theme_cssMaterial tonal palettes and light-theme role mappings as CSS custom properties.

Material tonal palettes and light-theme role mappings as CSS custom properties.

No parameter schema in public metadata yet.

extract_image_colorsDominant colors of an RGBA image (Celebi quantization) as JSON, CSS or a palette.

Dominant colors of an RGBA image (Celebi quantization) as JSON, CSS or a palette.

No parameter schema in public metadata yet.

generate_theme_from_imageA Material 3 theme seeded from an image's colors.

A Material 3 theme seeded from an image's colors.

No parameter schema in public metadata yet.

analyze_color_likabilityChecks whether a color is a universally disliked dark yellow-green and returns a fixed version.

Checks whether a color is a universally disliked dark yellow-green and returns a fixed version.

No parameter schema in public metadata yet.

fix_disliked_colors_batchChecks up to 100 colors and returns liked versions.

Checks up to 100 colors and returns liked versions.

No parameter schema in public metadata yet.

Sponsors

Readme

Coolors MCP

A Model Context Protocol (MCP) server that gives AI assistants real color tools: perceptual color descriptions, WCAG 2.x and APCA contrast checks with exact fixes, Material Design 3 themes built on Google's HCT, palettes and gradients, color-vision-deficiency checks, CSS theme matching and refactoring, image color extraction, and DESIGN.md audits.

Features


View the full README on GitHub

Details

Repository
github.com/x51xxx/coolors-mcp
Website
x51xxx.github.io/coolors-mcp
Category
Design & Creative
Package
@trishchuk/coolors-mcp
Transport
STDIO
Registry
MCP registry, active

More from x51xxx

Related Design & Creative MCP servers

View all
1agentfxhq avatarAgentFXagentfxhq/agentfxMotion graphics and video effects your AI agent can script, lint, preview and render.4stars
2bielacki avatarBielacki Igdb Mcp Serverbielacki/igdb-mcp-serverExplore and discover video games from the Internet Game Database. Search titles, view detailed inf…4stars
3caullenomdahl avatarNext.js Tailwind Assistantcaullenomdahl/nextjs-react-tailwind-assistantYour comprehensive AI companion for building modern Next.js applications with React and Tailwind CSS. This MCP server provides instant access to complete docume4stars
4codex-curator avatarStudiomcphubcodex-curator/studiomcphub32 creative AI tools (18 free) for agents: generate, upscale, mockup, print, watermark.4stars
5focus-gts avatarEds Mcp Serverfocus-gts/eds-mcp-server41 tools for Adobe Edge Delivery Services: read, audit, track, monitor, fix, publish, undo — safely.4stars
6gregario avatarWarhammer Oraclegregario/warhammer-oracleWarhammer 40K and Kill Team rules, stats, and game flow MCP server4stars