Skip to main content
Glama

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

Claude Code:

claude mcp add --transport http pickshade https://pickshade.com/api/mcp

Cursor, 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

parse_color

Every format, the closest name and Tailwind class, gamut and the better text color for any color

convert_color

HEX, RGB, HSL, HSV, HWB, CMYK, Lab, LCH, OKLab, OKLCH, Display P3, Rec. 2020, XYZ, SwiftUI, Flutter

find_colors

Turns words like "sage" or "dusty rose" into real HEX values

check_contrast

WCAG 2 ratio with AA and AAA levels, and APCA Lc with the usage it allows

fix_contrast

The closest color that reaches a contrast target, changing only OKLCH lightness so the hue stays

audit_palette

Checks every text and background pair, color blindness conflicts and out-of-gamut colors in a palette

check_gamut

Whether a color fits sRGB, Display P3 and Rec. 2020

nearest_names

Closest named colors, CSS keywords and Tailwind classes by perceptual distance

compare_colors

CIEDE2000 and deltaE OK difference with a plain verdict, lightness, chroma and hue shift

generate_scale

An 11-step 50–950 scale in OKLCH with even perceived lightness, the shape of Tailwind palettes

tints_shades

Tints, shades and tones of a color

harmonies

Complementary, split-complementary, analogous, triadic, tetradic, square and monochromatic in OKLCH

mix_colors

Mixes two colors in a chosen space, like CSS color-mix()

make_gradient

CSS gradients interpolated in OKLab or OKLCH, without the gray middle

generate_palette

Harmonious palettes in OKLCH, repeatable with a seed

simulate_cvd

Protanopia, deuteranopia, tritanopia and achromatopsia, with pairs that become hard to tell apart

export_tokens

CSS variables, Tailwind v4 @theme, SCSS, JSON, DTCG tokens, JS arrays or an SVG swatch strip

build_system

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 checked

  • audit_colors: readable pairs, color blindness conflicts and gamut for a list of colors

  • describe_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

packages/color

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

packages/data

Color names (CSS keywords, common names in 30 languages, an extended list), the Tailwind CSS palette

packages/exports

Code generators: CSS variables, Tailwind v4 @theme, SCSS, JSON, DTCG tokens, SVG

packages/tools

The 18 tools with their input schemas, shared by the MCP server and the REST API

packages/mcp

The MCP server (@pickshade/mcp)

Develop

pnpm install
pnpm check
pnpm build

The 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 tools
audit_paletteAudit a palette for accessibilityA
Read-only
Inspect

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 systemA
Read-only
Inspect

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 contrastA
Read-only
Inspect

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 gamutA
Read-only
Inspect

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 colorsA
Read-only
Inspect

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 colorA
Read-only
Inspect

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 codeA
Read-only
Inspect

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 nameA
Read-only
Inspect

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 contrastA
Read-only
Inspect

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 paletteA
Read-only
Inspect

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 scaleA
Read-only
Inspect

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 harmoniesA
Read-only
Inspect

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 gradientA
Read-only
Inspect

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 colorsA
Read-only
Inspect

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 namesA
Read-only
Inspect

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 colorA
Read-only
Inspect

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 blindnessA
Read-only
Inspect

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 tonesB
Read-only
Inspect

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

    A3.8/5.0

    Scored across 18 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count4/5

    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.

    Completeness5/5

    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

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides comprehensive color conversion, manipulation, analysis, and WCAG accessibility tools supporting multiple formats (hex, rgb, hsl, oklch, oklab) for design systems and web development.
      23 npm
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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.
      2
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Extract 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
    • A
      license
      A
      quality
      D
      maintenance
      Enables color conversion between HEX/RGB/HSL/HSV/CMYK, palette generation, WCAG contrast checking, color mixing/adjustment, and CSS gradient creation for AI agents.
      5
      48 npm
      MIT