
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 toolsPublic 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.
- 31 tools, all read-only and local: no API keys, no network access, stdio transport.
- Documentation: https://x51xxx.github.io/coolors-mcp/
- Changelog: CHANGELOG.md
Features
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