# ColorwayKit

> ColorwayKit is a free MCP server for design and media. Turn one brand hex into measured light and dark colour themes for AI coding agents. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, API
- **Repository:** https://github.com/5zjk5/colorwaykit-for-agents
- **MCP Registry name:** io.github.5zjk5/colorwaykit
- **Categories:** [design and media](https://ai-powered.com/categories/design-and-media), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-16

## About

The aim is to stop coding agents inventing colours. From a single brand colour the server returns a theme of 23 semantic roles in light and dark, with every text and background pair measured under both WCAG 2.1 and APCA, and with failing pairs offered a fix that keeps the brand hue. The README cites a public experiment in which agents kept only 43 to 50 of 79 design decisions across builds, as the motivation.

Eight tools cover the workflow. Beyond theme generation they export CSS variables, Tailwind v3 and v4 config, SCSS, W3C design tokens, Tokens Studio files and a DESIGN.md in one call, produce colour-blindness reports across four vision types, check any single pair, explain what each token is for and fetch themes saved in cloud projects. A free token is needed, and the README also offers a skill file and a committed DESIGN.md as an offline fallback.

## Features

- **Verified themes:** Generates 23 semantic roles in light and dark from one hex.
- **Contrast checks:** Measures every pair with WCAG 2.1 and APCA and suggests hue-preserving fixes.
- **Export formats:** Produces CSS, Tailwind, SCSS, DTCG, Tokens Studio and DESIGN.md.
- **Colour-blindness report:** Simulates four vision types for each role pair.
- **Token explanations:** Says what each semantic token is for, with light and dark values.
- **Saved projects:** Retrieves themes stored in ColorwayKit cloud projects.

## Good for

- Generate a consistent palette for a new UI from a brand colour
- Check whether white text on a brand colour passes contrast
- Export design tokens for a Tailwind project
- Add measured accessibility results to a pull request
- Keep page 10 of an app using the same colours as page 1

## Install

### Claude Code (Terminal)

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

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

```sh
https://www.colorwaykit.com/api/mcp
```

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

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

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

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

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

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

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

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

## Tools

- `get_theme`: Builds a verified theme from one brand hex
- `export_assets`: Returns every export file in one call
- `export_cvd`: Produces a colour-blindness report
- `get_report`: Returns the full accessibility report
- `check_pair`: Judges a text and background pair
- `get_token_usage`: Explains what each semantic token is for
- `get_theme_by_project`: Retrieves a saved project theme
- `list_projects`: Lists saved projects

## FAQ

### Do I need a token?

Yes, a free token from the ColorwayKit site is used to connect.

### Which export formats are supported?

CSS variables, Tailwind v3 and v4, SCSS, DTCG, Tokens Studio and DESIGN.md.

### Does it work offline?

A committed DESIGN.md can serve as a fallback when MCP is unreachable.

### What licence is the skill under?

The agent skill repository is MIT licensed.

### Is ColorwayKit free?

Yes. ColorwayKit is free to use.

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

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

### What are the best alternatives to ColorwayKit?

The closest alternatives to ColorwayKit are REA, HyperFrames by HeyGen, Context7, Chrome DevTools MCP and Codebase Memory.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## 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.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [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.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/colorwaykit
