Skip to content
MCP server

PickShade color tools

Color conversion, contrast fixing, palettes and design tokens for AI assistants

Install
Pricing
Free
Platforms
API, CLI, self-hosted
Runs
Remotely
Version
0.2.0
Listing updated
2 days ago

About PickShade color tools

PickShade color tools is a free MCP server for design and media. It runs as a hosted remote server, so there is nothing to install locally.

Color maths done by a model tends to drift; this server hands it to deterministic code. The README says all calculations follow CSS Color 4 (OKLCH, OKLab, Display P3, Rec. 2020), run locally and deterministically, and need no API key, account or telemetry.

Its 18 tools go beyond conversion. fix_contrast finds the nearest color that reaches a chosen target (AA, AAA or an APCA level) by changing only OKLCH lightness so the hue is kept. audit_palette checks every text and background pair, flags pairs people with color blindness cannot tell apart and colors outside sRGB. build_system creates a full color system from one brand color, with light and dark roles and shadcn/ui and Tailwind export.

Colors can be given as hex, rgb(), hsl(), oklch(), CSS names, plain names such as royal blue (including Russian ones), or Tailwind classes. Use the hosted URL, or run the package locally over stdio with npx on Node.js 20 or newer.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://pickshade.com/api/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "pickshade": {
      "url": "https://pickshade.com/api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "pickshade": {
      "type": "http",
      "url": "https://pickshade.com/api/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "pickshade": {
      "serverUrl": "https://pickshade.com/api/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "pickshade": {
      "type": "http",
      "url": "https://pickshade.com/api/mcp"
    }
  }
}

Tools this server provides (18)

Taken from the project documentation; the running server may differ.

parse_color
Describe any color: formats, closest name and Tailwind class, gamut, better text color.
convert_color
Convert between hex, rgb, hsl, oklch, display-p3 and other spaces and platform code.
find_colors
Search color names by words and get hex values.
check_contrast
WCAG 2 and APCA contrast checks with passing suggestions.
fix_contrast
Closest color reaching a contrast target by changing OKLCH lightness.
audit_palette
Check every text and background pair and color blindness conflicts.
check_gamut
Whether a color fits sRGB, Display P3 and Rec. 2020.
nearest_names
Closest named colors, CSS keywords and Tailwind classes.
compare_colors
CIEDE2000 and deltaE OK difference with a verdict.
generate_scale
An 11-step 50-950 OKLCH scale.
tints_shades
Tints, shades and tones of a color.
harmonies
Complementary, analogous, triadic and other harmonies.
mix_colors
Mix two colors in a chosen space.
make_gradient
CSS gradients interpolated in OKLab or OKLCH.
generate_palette
Harmonious palettes, repeatable with a seed.
simulate_cvd
Simulate color vision deficiencies.
export_tokens
Export CSS variables, Tailwind v4, SCSS, JSON, DTCG, JS or SVG.
build_system
Full color system from one brand color.

What it does

WCAG and APCA contrast
check_contrast reports ratios and Lc values with the nearest passing text color.
Lightness-only fixes
fix_contrast reaches a target while keeping the hue.
Palette audit
audit_palette lists safe pairs and color blindness conflicts.
Color name search
find_colors searches common English and Russian names and about 30,000 extended names.
Token export
export_tokens writes CSS variables, Tailwind v4, SCSS, JSON, DTCG or SVG strip.
Color blindness simulation
simulate_cvd covers protanopia, deuteranopia, tritanopia and achromatopsia.

Good for

  • Check whether a gray text color is readable on white and fix it
  • Generate a shadcn theme from a brand color
  • Build a 50 to 950 scale and export it for Tailwind v4
  • Test whether two chart colors are distinguishable with deuteranopia
  • Make an OKLab gradient without a gray middle

Pricing

Free

Free hosted server; no key or account

Prices change. Check pickshade.com before you buy.

PickShade color tools FAQ

Is it free?

The site calls it a free remote server; the README says no API key or account is needed.

Can I run it locally?

Yes, over stdio with npx -y @pickshade/mcp on Node.js 20 or newer.

Which clients are shown?

Claude Code, Claude Desktop, Cursor and VS Code, using the URL pickshade.com/api/mcp.

How many tools are there?

Eighteen.

Is PickShade color tools free?

Yes. PickShade color tools is free to use.

How do I add PickShade color tools to Claude Code?

Run this command in your terminal: claude mcp add --transport http pickshade https://pickshade.com/api/mcp

What are the best alternatives to PickShade color tools?

The closest alternatives to PickShade color tools are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

Alternatives to PickShade color tools

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  3. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  4. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  5. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  6. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory