Color Palette logo

Color Palette

Generates color harmonies, gradients, contrast scores, and CSS or Tailwind output through an MCP-accessible API.

Install Color Palette

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "color-palette": {
      "command": "npx",
      "args": [
        "-y",
        "@lazymac/mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y @lazymac/mcp

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 3d ago.

Overview

The color-palette MCP server provides color conversion, palette generation, harmony calculations, gradients, contrast checks, and accessibility scoring. It exposes HTTP endpoints for generating random palettes and producing CSS variables or Tailwind configuration from color lists. Reach for it when an agent needs to create, inspect, or export UI color systems without external dependencies. The documented local setup runs on port 4000.

Use cases

  • Convert hexadecimal colors into RGB and HSL values
  • Generate harmonious palettes for a UI theme
  • Check text and background contrast against WCAG levels
  • Create CSS variables from a brand color list
  • Export a color scale as Tailwind configuration

Key features

  • HEX, RGB, and HSL conversion
  • Six color harmony types
  • Gradient generation with CSS output
  • WCAG contrast and accessibility checks
  • Random palette generation
  • CSS variable and Tailwind config output

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

7/7 checks healthy over the last 41d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 13d ago via OSV.dev · @lazymac/mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads38Package downloads in the last 30 days.
Last commit6mo agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Color Palette works

What color-palette MCP server does

The color-palette MCP server exposes a color utility API for design and frontend tasks. It accepts hexadecimal colors and returns converted representations such as HEX, RGB, and HSL. It can also generate common color relationships, interpolate gradients, calculate contrast ratios, and evaluate WCAG-style accessibility results.

The API supports complementary, analogous, triadic, split, tetradic, and monochromatic harmonies. Random palette generation is available when an agent needs a starting set of colors. For implementation work, the service can turn a list of colors into CSS variables or a Tailwind configuration.

How it works

Requests use HTTP endpoints under the local /api/v1 path. Color operations generally place the color values in the URL, while CSS and Tailwind generation use POST requests with JSON bodies. Optional query parameters control output size for supported operations, including the number of monochromatic colors, gradient steps, or random palette entries.

A conversion request returns structured color data. Harmony requests return colors derived from a base value. Gradient requests provide both a color array and a CSS gradient string. Contrast requests return a ratio and boolean results for normal and large text at AA and AAA levels. The implementation is described as having zero external dependencies.

Setup and configuration

Clone or obtain the project, install its npm dependencies, and start the local service:

Terminal
npm install
npm start

The documented address is http://localhost:4000. It also does not document client-specific MCP setup instructions, so connection details may depend on the deployment or wrapper used around the API.

Tools and capabilities

The color-palette MCP server supports these operations:

  • Convert hexadecimal colors to HEX, RGB, and HSL values.
  • Generate complementary, analogous, triadic, split, tetradic, and monochromatic harmonies.
  • Create stepped gradients between two colors and return CSS gradient output.
  • Compare foreground and background colors using contrast ratios and AA or AAA checks.
  • Produce random palettes with a requested color count.
  • Generate CSS custom properties from named color collections.
  • Generate Tailwind color configuration from named color collections.

CSS and Tailwind generation accept arrays of colors and a name in the JSON request body. The documented examples use names such as brand and amber for the generated output.

Limitations and notes

The current listing identifies the project as a Cloudflare Workers MCP server, while the README's quick start describes a local service on port 4000; verify the intended deployment path before configuring an agent.

The documented inputs are hexadecimal colors. No claims are provided about named-color parsing, image extraction, color-space support beyond the returned RGB and HSL representations, or persistence of generated palettes. The project is licensed under MIT.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Color Palette

color-palette is an MCP server that connects agents to a color palette generation API. Its main tools cover HEX/RGB/HSL conversion, color harmonies, gradients, contrast and WCAG checks, random palettes, CSS variables, and Tailwind configuration output. It runs locally through the documented npm start command.

Install it by running `npm install`, then start it with `npm start`. The documented service listens at `http://localhost:4000` and exposes its operations under `/api/v1`.

Use the `/api/v1/contrast/{foreground}/{background}` endpoint with two hexadecimal colors. The response includes a contrast ratio and boolean results for AA and AAA checks at normal and large text sizes.

Yes, it can generate both formats from a JSON color array and a name. Send a POST request to `/api/v1/css` for CSS variables or `/api/v1/tailwind` for Tailwind configuration, with `colors` and `name` fields in the request body.

It describes HTTP endpoints and a local npm service, so verify how your Cursor configuration should connect to the deployed or wrapped MCP service.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewColor Palette AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/color-palette?style=directory)](https://allmcps.com/mcp/color-palette)
HTML Embed
<a href="https://allmcps.com/mcp/color-palette"><img src="https://allmcps.com/api/badge/color-palette?style=directory" alt="Color Palette on AllMCPs" /></a>