# Swatch

> Swatch is a free MCP server for design and media. WCAG contrast checker, color fixer and 50-950 palette builder, no account. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, API
- **Website:** https://swatch.clawhard.com
- **MCP Registry name:** com.clawhard/swatch
- **Categories:** design and media, developer tools
- **Listing updated:** 2026-11-15

## About

Swatch reports the exact WCAG contrast ratio for a text and background pair, with pass or fail for AA and AAA, and never rounds up: 4.499 fails. When a pair fails it keeps hue and chroma and moves only OKLCH lightness to the nearest value that passes, so the fixed color still resembles the original.

A second tool turns one brand color into an 11-step scale from 50 to 950 with contrast notes and CSS, Tailwind or JSON output. APCA scores appear as extra guidance, since WCAG 2.x ratios remain the standard. Colors may be hex, rgb, hsl, oklch or a CSS name.

The site also serves an SVG contrast badge for READMEs and docs, a public OpenAPI file and an llms.txt. It says colors you type stay in your browser, with no key or login for the MCP server.

## Features

- **Exact WCAG ratios:** AA and AAA results without rounding up.
- **Closest passing color:** Adjusts only lightness to reach the target ratio.
- **50-950 palettes:** Builds an 11-step scale with CSS, Tailwind or JSON output.
- **Pair batches:** Checks several color pairs in one call.
- **Contrast badge:** Serves an SVG badge for READMEs and design systems.
- **APCA guidance:** Shows APCA as an extra signal for size and weight.

## Good for

- Check a design token pair against AA
- Fix a failing brand color without changing its feel
- Generate a Tailwind palette from one color
- Add a live contrast badge to a design system doc

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http swatch https://swatch.clawhard.com/mcp
```

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

```sh
https://swatch.clawhard.com/mcp
```

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

```json
{
  "mcpServers": {
    "swatch": {
      "url": "https://swatch.clawhard.com/mcp"
    }
  }
}
```

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

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

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

```json
{
  "mcpServers": {
    "swatch": {
      "serverUrl": "https://swatch.clawhard.com/mcp"
    }
  }
}
```

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

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

## Tools

- `swatch_check_contrast`: Checks contrast of a text and background color pair and converts color formats.
- `swatch_fix_contrast`: Suggests the nearest color that passes a target ratio.
- `swatch_make_scale`: Builds a 50 to 950 palette from a base color.
- `swatch_check_pairs`: Checks several color pairs at once.

## FAQ

### Does #777777 on white pass AA?

No. It is 4.48:1, just under 4.5:1; #767676 is the lightest gray that passes at 4.54:1.

### Do I need an account?

No. There is no key or login.

### Which color formats work?

Hex, rgb(), hsl(), oklch() or a CSS name.

### Is there an API besides MCP?

Yes, a JSON API described at /openapi.json.

### Is Swatch free?

Yes. Swatch is free to use.

### How do I add Swatch to Claude Code?

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

### What are the best alternatives to Swatch?

The closest alternatives to Swatch 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/swatch
