# PaintColorHQ Color Match

> PaintColorHQ Color Match is an open-source MCP server for home services. Find the closest purchasable paint colour in 13 brands for any hex value. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, Web
- **Website:** https://www.paintcolorhq.com
- **Repository:** https://github.com/pcameron80/paintcolorhq-mcp
- **MCP Registry name:** io.github.pcameron80/paintcolorhq-mcp
- **Categories:** [home services](https://ai-powered.com/categories/home-services)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `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

## 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.

## Alternatives

- [Site](https://ai-powered.com/mcp/site-mwepjo2i): Site is a free MCP server for home services.
- [MadMax Trade Supply parts](https://ai-powered.com/mcp/madmax-trade-supply-parts): MadMax Trade Supply parts is a free MCP server for e-commerce.
- [Host Tools](https://ai-powered.com/mcp/host-tools): Host Tools is an MCP server for home services.
- [HALPII](https://ai-powered.com/mcp/halpii): HALPII is a free MCP server for home services.
- [Spark Pack](https://ai-powered.com/mcp/spark-pack): Spark Pack is a free MCP server for home services.
- [Nero Work](https://ai-powered.com/mcp/nero-work): Nero Work is a paid MCP server for home services.
- [Property Search](https://ai-powered.com/mcp/property-search): Property Search is a free MCP server for local services.
- [Wanbao House](https://ai-powered.com/mcp/wanbao-house): Wanbao House is a free MCP server for community directories.

---
Source: https://ai-powered.com/mcp/paintcolorhq-color-match
