PickShade MCP Server
Provides color conversion and token export for CSS, including CSS variables, gradients, and CSS Color 4 syntaxes such as OKLCH and color-mix().
Converts colors to Flutter-compatible color values.
Builds full color systems with shadcn/ui and Tailwind exports, including light and dark theme roles.
Exports color tokens as an SVG swatch strip.
Supports Tailwind CSS classes and exports Tailwind v4 @theme tokens, and generates Tailwind-style color scales.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@PickShade MCP Server check the contrast of #777 on white and fix it to pass WCAG AA"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
PickShade MCP server
Color tools for AI assistants: convert any color, find colors by name, check and fix WCAG 2 and APCA contrast, audit palettes for accessibility and color blindness, build gradients, scales and full design systems, export tokens for CSS, Tailwind v4, SCSS and DTCG.
All math follows CSS Color 4 (OKLCH, OKLab, Display P3, Rec. 2020) and runs locally and deterministically. No API key, no account, no telemetry.
Website and docs: pickshade.com/mcp
Use the hosted server
No install. Streamable HTTP endpoint:
https://pickshade.com/api/mcpClaude Code:
claude mcp add --transport http pickshade https://pickshade.com/api/mcpCursor, VS Code and other clients that read mcpServers:
{
"mcpServers": {
"pickshade": { "url": "https://pickshade.com/api/mcp" }
}
}Related MCP server: MCP Color Converter
Run locally over stdio
{
"mcpServers": {
"pickshade": { "command": "npx", "args": ["-y", "@pickshade/mcp"] }
}
}Requires Node.js 20 or newer.
Tools
Every tool accepts colors as HEX, rgb(), hsl(), oklch(), CSS names like navy, common names like royal blue or бордовый, and Tailwind classes like sky-500.
Tool | What it does |
| Every format, the closest name and Tailwind class, gamut and the better text color for any color |
| HEX, RGB, HSL, HSV, HWB, CMYK, Lab, LCH, OKLab, OKLCH, Display P3, Rec. 2020, XYZ, SwiftUI, Flutter |
| Turns words like "sage" or "dusty rose" into real HEX values |
| WCAG 2 ratio with AA and AAA levels, and APCA Lc with the usage it allows |
| The closest color that reaches a contrast target, changing only OKLCH lightness so the hue stays |
| Checks every text and background pair, color blindness conflicts and out-of-gamut colors in a palette |
| Whether a color fits sRGB, Display P3 and Rec. 2020 |
| Closest named colors, CSS keywords and Tailwind classes by perceptual distance |
| CIEDE2000 and deltaE OK difference with a plain verdict, lightness, chroma and hue shift |
| An 11-step 50–950 scale in OKLCH with even perceived lightness, the shape of Tailwind palettes |
| Tints, shades and tones of a color |
| Complementary, split-complementary, analogous, triadic, tetradic, square and monochromatic in OKLCH |
| Mixes two colors in a chosen space, like CSS |
| CSS gradients interpolated in OKLab or OKLCH, without the gray middle |
| Harmonious palettes in OKLCH, repeatable with a seed |
| Protanopia, deuteranopia, tritanopia and achromatopsia, with pairs that become hard to tell apart |
| CSS variables, Tailwind v4 |
| A full color system from one brand color: scales, light and dark roles, shadcn/ui and Tailwind export |
Prompts
accessible_theme: light and dark themes from a brand color with every text pair checkedaudit_colors: readable pairs, color blindness conflicts and gamut for a list of colorsdescribe_color: a color explained in plain words with its values, name, contrast and matches
REST API
The same tools over HTTP, JSON in and out: pickshade.com/api, OpenAPI 3.1 at https://pickshade.com/api/v1/openapi.json.
What is inside
Package | Purpose |
| Color math: parsing every CSS color syntax, conversions between sRGB, Display P3, Rec. 2020, Lab, LCH, OKLab and OKLCH, gamut mapping, WCAG 2 and APCA contrast, CIEDE2000 and deltaE OK, scales, harmonies and color vision simulation |
| Color names (CSS keywords, common names in 30 languages, an extended list), the Tailwind CSS palette |
| Code generators: CSS variables, Tailwind v4 |
| The 18 tools with their input schemas, shared by the MCP server and the REST API |
| The MCP server ( |
Develop
pnpm install
pnpm check
pnpm buildThe bundled server is written to packages/mcp/dist.
License
MIT. Color names include data from meodai/color-names (MIT); Tailwind palette values are from Tailwind CSS (MIT).
Available Tools
18 toolsaudit_paletteAudit a palette for accessibilityARead-onlyInspect
Check every text and background pair in a palette with WCAG 2 and APCA, list which pairs are safe for body text, large text or only decoration, find colors that people with color blindness cannot tell apart, and flag colors outside sRGB. Use it before shipping a theme or chart palette.
Inputs: colors (required).
build_systemBuild a design systemARead-onlyInspect
Build a full color system from a brand color: 50–950 scales for primary, secondary, accent, neutral and status colors, light and dark theme roles, exported as a Tailwind v4 theme, CSS variables, shadcn/ui globals.css or DTCG tokens, with a contrast audit of text and surface pairs.
Inputs: primary (required), name, accent, format, +3 more.
check_contrastCheck text contrastARead-onlyInspect
Check text contrast against a background with both WCAG 2 (ratio, AA and AAA for normal and large text) and APCA (Lc value and the usage level it allows). Also suggests the nearest text color that passes AA and AAA while keeping its hue.
Inputs: text (required), background (required).
check_gamutCheck gamutARead-onlyInspect
Check whether a color fits the sRGB, Display P3 and Rec. 2020 gamuts, and get the closest sRGB fallback that keeps lightness and hue (CSS Color 4 gamut mapping in OKLCH).
Inputs: color (required).
compare_colorsCompare two colorsARead-onlyInspect
Compare two colors: CIEDE2000 and deltaE OK difference with a plain verdict (identical, nearly, similar, different, opposite), lightness shift in percent, chroma and hue shift, and the contrast between them.
Inputs: first (required), second (required).
convert_colorConvert a colorARead-onlyInspect
Convert a color between formats: hex, rgb, hsl, hsv, hwb, cmyk, lab, lch, oklab, oklch, display-p3, rec2020, xyz and platform code (swiftui, uikit, flutter, android). Values follow CSS Color 4.
Inputs: color (required), formats.
export_tokensExport colors as codeARead-onlyInspect
Turn a list of colors into ready code: CSS custom properties, a Tailwind v4 @theme block, SCSS variables, JSON, W3C design tokens (DTCG), a JavaScript array or an SVG swatch strip. Unnamed colors get their closest color name.
Inputs: colors (required), format, values.
find_colorsFind colors by nameARead-onlyInspect
Search color names by words, like "sage", "dusty rose", "midnight blue" or "бордовый", and get their HEX values. Searches common names in English and Russian and about 30 000 extended color names. Use it to turn a description into real colors.
Inputs: query (required), limit, locale.
fix_contrastFix contrastARead-onlyInspect
Find the closest color that reaches a contrast target by changing only OKLCH lightness, so the hue and character stay. Targets: aa (4.5:1), aa-large (3:1), aaa (7:1), apca-body (Lc 75), apca-content (Lc 60), apca-large (Lc 45). Adjust the text color or the background.
Inputs: text (required), background (required), adjust, target.
generate_paletteGenerate a paletteARead-onlyInspect
Generate a harmonious palette in OKLCH. Keep colors you already have, pick a style (auto, analogous, complementary, triadic, monochromatic, pastel, vivid, muted, dark) and pass a seed to get the same palette every time.
Inputs: keep, mode, seed, size.
generate_scaleGenerate a 50–950 scaleARead-onlyInspect
Build an 11-step tint and shade scale (50, 100 … 900, 950) from one color in OKLCH, the same shape as Tailwind palettes, with even perceived lightness steps.
Inputs: color (required).
harmoniesColor harmoniesARead-onlyInspect
Get color harmonies for a base color, computed in OKLCH so lightness stays even: complementary, split-complementary, analogous, triadic, tetradic, square and monochromatic.
Inputs: color (required), kind.
make_gradientMake a CSS gradientARead-onlyInspect
Build a CSS gradient from 2 or more colors with interpolation in OKLab, OKLCH or sRGB. Returns modern CSS with the color space, a fallback with precomputed stops for older browsers, and the stop colors. OKLab avoids the gray middle that sRGB gradients get.
Inputs: colors (required), kind, angle, space, +1 more.
mix_colorsMix two colorsARead-onlyInspect
Mix two colors at a ratio in a chosen color space, like CSS color-mix(). OKLab keeps the middle bright, sRGB tends to turn gray. Returns the result and a ready color-mix() expression.
Inputs: first (required), second (required), space, amount.
nearest_namesFind color namesARead-onlyInspect
Find the closest named colors, CSS color keywords and Tailwind CSS classes for a color, ranked by perceptual distance (deltaE OK).
Inputs: color (required), limit, locale.
parse_colorDescribe a colorARead-onlyInspect
Read any color and describe it: HEX, RGB, HSL and OKLCH values, the closest human name, the closest Tailwind class, its hue family, whether it fits sRGB and Display P3, and which text color, white or black, reads better on it.
Inputs: color (required), locale.
simulate_cvdSimulate color blindnessARead-onlyInspect
Show how colors look with protanopia, deuteranopia, tritanopia and achromatopsia (Machado 2009 at full severity), and list the pairs that become hard to tell apart.
Inputs: colors (required), kinds.
tints_shadesTints, shades and tonesBRead-onlyInspect
Get tints (mixed with white), shades (mixed with black) and tones (mixed with gray) of a color, evenly spaced, as HEX. Good for hover states, borders and backgrounds.
Inputs: color (required), steps.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 18 tools
Most tools target distinct color operations (contrast, gamut, CVD, mixing, gradients), and the rich descriptions clarify intent. However, several clusters overlap: parse_color, nearest_names and convert_color all report closest names/formats; generate_palette and harmonies both generate harmonious sets; audit_palette partially duplicates check_contrast and simulate_cvd; and generate_scale vs tints_shades both produce shades.
Nearly all names are snake_case verb_noun (parse_color, check_contrast, generate_scale, export_tokens), which is predictable. A few deviate to noun or adjective forms (harmonies, tints_shades, nearest_names), but the convention stays readable and consistent in style.
18 tools is on the heavier side but justified for a broad color/design-system domain with distinct feature areas. Each tool earns its place, though the palette-generation and analysis clusters could be consolidated slightly.
The surface covers the full color lifecycle: parsing, conversion, search, contrast checking and fixing, CVD simulation, gamut checking, scales, tints, harmonies, mixing, gradients, palette generation, token export and full system building. No obvious dead ends for a color design workflow.
Related MCP Connectors
Contrast checks with fixes, OKLCH harmonies, palettes, color-blind previews and code export.
WCAG color contrast checks, nearest accessible color, CSS color conversion and palette pair checks.
Verified color tokens for AI coding agents: one brand hex in, WCAG/APCA-measured themes out.
Convert colours between hex, RGB, HSL, OKLCH and CMYK, and compute harmonies.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides comprehensive color conversion, manipulation, analysis, and WCAG accessibility tools supporting multiple formats (hex, rgb, hsl, oklch, oklab) for design systems and web development.23 npm2MIT
- AlicenseNot gradedqualityDmaintenanceA comprehensive toolkit for color conversion, manipulation, and accessibility analysis supporting formats like OkLCH and WCAG compliance. It enables AI agents to manage design systems by generating harmonious palettes, transforming color spaces, and performing contrast checks.2MIT
- AlicenseNot gradedqualityBmaintenanceExtract palettes from images, generate harmonies, gradients, random palettes; Check WCAG and APCA contrast; Suggest nearest passing OkLCH lightness; Simulate color-blindness; Convert and sort colors across formats (hex / RGB / HSL / OkLCH / …)MIT
- AlicenseAqualityDmaintenanceEnables color conversion between HEX/RGB/HSL/HSV/CMYK, palette generation, WCAG contrast checking, color mixing/adjustment, and CSS gradient creation for AI agents.548 npmMIT