# PickShade color tools [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/tenzo-run/pickshade-mcp  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/pickshade-color-tools

## Description
18 color tools: OKLCH, WCAG and APCA contrast fixes, palettes, gradients, color blindness, tokens.

## Tools
Capabilities this server exposes over MCP:

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

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "pickshade-color-tools": {
    "command": "npx",
    "args": ["-y","@pickshade/mcp"]
  }
}
```

## Documentation

## What PickShade color tools MCP server does

PickShade color tools MCP server gives an MCP-compatible agent a collection of color analysis and generation operations. Inputs can use HEX, functional CSS formats, CSS keywords, common color names, names in multiple languages, or Tailwind palette classes. The tools return structured color data and generated outputs rather than requiring an external color service.

Core analysis includes parsing, format conversion, gamut checks, perceptual color comparison, color naming, and contrast evaluation. Accessibility workflows cover WCAG 2 ratios, AA and AAA results, APCA Lc guidance, palette-wide pair checks, and simulations for protanopia, deuteranopia, tritanopia, and achromatopsia. PickShade color tools MCP server can also identify palette pairs that become difficult to distinguish under color-vision simulation.

## How it works

The implementation follows CSS Color 4 color models, including sRGB, Display P3, Rec. 2020, Lab, LCH, OKLab, and OKLCH. Its calculations run locally and deterministically when using the local package. Contrast repair changes only OKLCH lightness, preserving the selected hue while searching for the nearest color that meets a requested target.

Generation tools cover 11-step 50–950 scales, tints, shades, tones, standard harmony types, seeded OKLCH palettes, and CSS gradients interpolated in OKLab or OKLCH. The system builder starts with one brand color and produces scales, light and dark roles, plus shadcn/ui and Tailwind-oriented exports. PickShade color tools MCP server can turn these results into CSS variables, Tailwind v4 `@theme`, SCSS, JSON, DTCG tokens, JavaScript arrays, or an SVG swatch strip.

## Setup and configuration

The hosted deployment is available at `https://pickshade.com/api/mcp` over streamable HTTP, so it does not require a local installation. Claude Code can register it with `claude mcp add --transport http pickshade https://pickshade.com/api/mcp`. Clients that use an `mcpServers` configuration can add the endpoint as the `pickshade` server URL.

For local stdio use, configure the server with `npx -y @pickshade/mcp`. Node.js 20 or newer is required. The server needs no API key, account, or environment variables, and the README states that it collects no telemetry.

## Tools and capabilities

- Parse, convert, name, compare, and check the gamut of colors.
- Evaluate and repair WCAG 2 and APCA contrast.
- Audit text and background pairs, including out-of-gamut and color-vision issues.
- Generate scales, harmonies, palettes, tints, shades, tones, and gradients.
- Build a color system from a brand color and export implementation-ready token formats.

The repository also documents three prompt workflows: accessible theme generation, palette auditing, and plain-language color descriptions. The same underlying tools are exposed through the documented REST API.

## Limitations and notes

Results depend on the supplied color values and requested color space. Contrast repair preserves hue by adjusting OKLCH lightness, so it is not a general-purpose hue or chroma optimization. Gamut status is reported for sRGB, Display P3, and Rec. 2020; choosing a wider gamut does not by itself make a color suitable for every display or CSS use case. The local server requires Node.js 20 or newer, while the hosted option depends on network access.

_Full upstream README: https://allmcps.com/mcp/pickshade-color-tools/readme_