Skip to content
MCP server

PaintColorHQ Color Match

Find the closest purchasable paint colour in 13 brands for any hex value

Install
Pricing
Open source
Platforms
API, Web
Runs
Remotely
Version
1.1.0
Listing updated
today

Similar MCP servers

About PaintColorHQ Color Match

PaintColorHQ Color Match is an open-source MCP server for home services. It runs as a hosted remote server, so there is nothing to install locally.

Matching a colour across paint brands usually means squinting at swatches. This hosted server does it numerically: each colour in a catalogue of more than 26,000 is converted to CIE LAB space and compared to the input with CIEDE2000, the Delta-E measure used in paint and coatings manufacturing. Each result carries a closeness label and its Delta-E.

Three tools cover the workflow. find_paint_color looks up a colour by name, number or both (for example SW 7029 or Repose Gray), and reports hex and whether it is current, retired or discontinued. list_brands returns the 13 brands and the slugs the other tools accept. match_paint_color takes a hex and returns equivalents with brand, name, number, hex and a link to each colour page.

It is stateless Streamable HTTP with no authentication. The README cautions that a screen match can look different on a wall, so a physical sample should confirm the final choice. A free REST endpoint and an embeddable widget exist alongside it.

Install

Run in a terminal

claude mcp add --transport http paintcolorhq-mcp https://www.paintcolorhq.com/api/mcp

Add to Settings → Connectors → Add custom connector

https://www.paintcolorhq.com/api/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "paintcolorhq-mcp": {
      "url": "https://www.paintcolorhq.com/api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "paintcolorhq-mcp": {
      "type": "http",
      "url": "https://www.paintcolorhq.com/api/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "paintcolorhq-mcp": {
      "serverUrl": "https://www.paintcolorhq.com/api/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "paintcolorhq-mcp": {
      "type": "http",
      "url": "https://www.paintcolorhq.com/api/mcp"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (3)

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

find_paint_color
Look up a paint colour by name or number
list_brands
List the 13 supported brands and their slugs
match_paint_color
Find the closest cross-brand matches for a hex value

What it does

Cross-brand matching
Returns the closest colours in other brands for a hex value.
CIEDE2000 scoring
Uses the perceptual colour-difference standard rather than raw hex distance.
Lookup by name or number
Finds colours by name, code or brand-qualified query.
Availability status
Shows if a colour is current, retired or discontinued.
Brand filter
Restricts matches to one of 13 brands by slug.
No key needed
Remote server with no authentication.

Good for

  • Find the Behr equivalent of a Sherwin-Williams colour
  • Match a hex from a design to real paint
  • Check whether a colour has been discontinued
  • Compare similar shades across brands before buying samples

Pricing

Open source

Free to use, MIT licence; paid batch tier on RapidAPI

Prices change. Check paintcolorhq.com before you buy.

PaintColorHQ Color Match FAQ

How many colours and brands?

More than 26,000 colours across 13 brands.

Do I need an API key?

No. It is a remote server with no authentication.

Is a screen match reliable?

The README advises confirming a final choice with a physical sample, since colours read differently under different lighting.

What licence is it under?

MIT. The README notes paint names and numbers are trademarks of their manufacturers and the project is not affiliated with any paint brand.

Is PaintColorHQ Color Match free?

Yes. PaintColorHQ Color Match is open source, so you can use and self-host it for free.

How do I add PaintColorHQ Color Match to Claude Code?

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

What are the best alternatives to PaintColorHQ Color Match?

The closest alternatives to PaintColorHQ Color Match are Site, MadMax Trade Supply parts, Host Tools, HALPII and Spark Pack.

Where this comes from

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

How AIPoweredBot checks servers