# PickShade color tools

> PickShade color tools is a free MCP server for design and media. Color conversion, contrast fixing, palettes and design tokens for AI assistants. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, CLI, self-hosted
- **Website:** https://pickshade.com/mcp
- **Repository:** https://github.com/tenzo-run/pickshade-mcp/tree/HEAD/packages/mcp
- **MCP Registry name:** com.pickshade/pickshade
- **Categories:** design and media, developer tools
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://pickshade.com/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "pickshade": {
      "url": "https://pickshade.com/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/pickshade-color-tools
