Skip to content
MCP server

ContrastKit

WCAG contrast checks with the nearest passing colour, CSS conversion and palette checks

Install
Pricing
Free
Platforms
API, Web
Runs
Remotely
Version
0.1.0
Listing updated
2 days ago

About ContrastKit

ContrastKit is a free MCP server for developer tools. It runs as a hosted remote server, so there is nothing to install locally.

The calculation uses WCAG 2.x relative luminance for sRGB. Ratios are floored to two decimals, so 4.499:1 fails AA. Levels covered are AA, AA large, AAA, AAA large and UI components at 3:1. A translucent foreground is blended over the background, and a translucent background over white.

Inputs can be hex in 3 to 8 digits, rgb, hsl or any of 148 CSS names, up to 64 characters. lab, lch, oklch, color() and currentColor are unsupported. A palette check handles up to 12 colours.

There is also a JSON API with an OpenAPI spec, about 60 requests a minute per IP, no key. Colours are processed in memory and discarded. The vendor notes a passing ratio is not a full accessibility audit.

Install

Run in a terminal

claude mcp add --transport http contrastkit https://contrastkit.mike-tusa.workers.dev/mcp

Add to Settings → Connectors → Add custom connector

https://contrastkit.mike-tusa.workers.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "contrastkit": {
      "url": "https://contrastkit.mike-tusa.workers.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "contrastkit": {
      "type": "http",
      "url": "https://contrastkit.mike-tusa.workers.dev/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "contrastkit": {
      "serverUrl": "https://contrastkit.mike-tusa.workers.dev/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "contrastkit": {
      "type": "http",
      "url": "https://contrastkit.mike-tusa.workers.dev/mcp"
    }
  }
}

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

check_contrast
Check text and background colours against WCAG levels
suggest_accessible_color
Find the nearest colour that passes
convert_color
Convert CSS colours between formats
check_palette
Check pairs in a palette

What it does

AA and AAA checks
Pass or fail at each WCAG level.
Nearest accessible colour
Suggests the closest passing colour.
CSS conversion
Converts between colour formats.
Palette pairs
Checks up to 12 colours.
No storage
Inputs are discarded.

Good for

  • Check a grey on white against AA
  • Fix a failing brand colour
  • Convert a named colour to hex
  • Audit a design palette

Pricing

Free

Free, no sign-up

Prices change. Check contrastkit.mike-tusa.workers.dev before you buy.

ContrastKit FAQ

Is a key needed?

No. Free with no sign-up.

Which colour formats work?

Hex, rgb, hsl, 148 names and transparent.

What is the rate limit?

About 60 requests a minute per IP.

Is it a full audit?

No, the vendor says passing ratios are only one part.

Is ContrastKit free?

Yes. ContrastKit is free to use.

How do I add ContrastKit to Claude Code?

Run this command in your terminal: claude mcp add --transport http contrastkit https://contrastkit.mike-tusa.workers.dev/mcp

What are the best alternatives to ContrastKit?

The closest alternatives to ContrastKit are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

Alternatives to ContrastKit

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  3. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  4. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  5. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  6. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory