# Coolors MCP

Coolors MCP — an MCP server for Claude Code and Codex that handles WCAG and APCA contrast calculation, palette generation, and accessibility audits. All operations execute locally over stdio.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 repo stars
- Author: x51xxx
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/x51xxx/coolors-mcp
- Updated: 2026-11-14
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/coolors-mcp

## What it does

The server exposes 31 color tools directly to the coding agent without relying on external network endpoints. It evaluates foreground and background combinations using WCAG 2.x ratios alongside APCA algorithms, while `fix_contrast` finds the closest accessible color without changing hue. The CAM16-based Google HCT model builds consistent Material Design 3 light and dark themes from a single input swatch.

Accessibility modules simulate seven forms of color-vision deficiency to uncover collisions across UI and chart palettes. In addition, the tools extract primary color palettes from images using Celebi quantization, rewrite hardcoded stylesheet values into CSS variables, and inspect `DESIGN.md` files. Running the package requires Node.js 20 or newer.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add coolors-mcp -- npx -y @trishchuk/coolors-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add coolors-mcp -- npx -y @trishchuk/coolors-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "coolors-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@trishchuk/coolors-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "coolors-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@trishchuk/coolors-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add coolors-mcp npx -y @trishchuk/coolors-mcp
```

## When to use it
- adjust foreground colors to meet WCAG AA or APCA target levels
- generate Material Design 3 theme tokens from a seed color
- detect palette collisions across color-vision deficiency types
- refactor hardcoded hex codes in stylesheets to CSS variables

## Example prompts
- Check if #6366f1 passes WCAG AA on white and suggest an exact fix
- Generate a Material 3 palette from #10b981 as CSS custom properties
- Audit this palette for protanopia and deuteranopia collisions

## Similar
- [material](https://affpapa.org/en/nevibecode/skills/material.md) — skill · 2900 installs
- [spacious](https://affpapa.org/en/nevibecode/skills/spacious.md) — skill · 2800 installs
- [accessible-animation](https://affpapa.org/en/nevibecode/skills/accessible-animation.md) — skill · 4400 installs
- [web-design-guidelines](https://affpapa.org/en/nevibecode/skills/platform-design-skills-web-design-guidelines.md) — skill · 1600 installs
- [ui-design](https://affpapa.org/en/nevibecode/skills/mindrally-ui-design.md) — skill · 1000 installs
- [accessible-motion](https://affpapa.org/en/nevibecode/skills/accessible-motion.md) — skill · 723 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
