Behr Colormapper MCP

A public, stateless MCP server that converts digital sRGB colors into the nearest Behr paint colors and searches Behr colors by code or name. Matching uses CIEDE2000 perceptual distance in CIE Lab space.

MCP endpoint

https://behr-colormapper.coryking.workers.dev/mcp

The endpoint uses Streamable HTTP with JSON responses and requires no authentication. The Worker root is reserved for a human-facing project page.

Related MCP server: color-engine

Tools

• behr_match_paint accepts #RGB, #RRGGBB, rgb(r,g,b), bare r,g,b, and hsl(h,s%,l%). It returns canonical RGB, hex, and Lab input values plus nearest Behr colors ranked by CIEDE2000 delta E.

• behr_search_colors searches exact or partial Behr codes and names, ranking exact codes first.

Both tools exclude archived colors unless include_archived is true. Their Zod contracts provide MCP input/output JSON Schemas. They are marked read-only, non-destructive, idempotent, and closed-world.

Published screen colors approximate physical paint. Confirm consequential choices with a physical sample under the intended lighting.

Catalog source

data/behr.json is the normalized runtime catalog. Its metadata records the source URL, retrieval date, and catalog counts. src/colormapper/refresh.py is the authoritative definition of the Behr source and normalization rules.

Refresh and validate the checked-in snapshot:

uv sync --group refresh
uv run --group refresh behr-colormapper-refresh
uv run pytest
cd worker && npm test

The runtime never contacts Behr.

Deployment

Pushes to main that affect the Worker, catalog, smoke test, or workflow run tests and deploy through GitHub Actions. The repository requires:

• Actions secret CLOUDFLARE_API_TOKEN with Workers Scripts → Edit permission

• Actions variable CLOUDFLARE_ACCOUNT_ID

Run locally with cd worker && npm install && npm run dev.

License

Code is MIT licensed. Behr color names, codes, and catalog data belong to their respective owner and are included as factual compatibility data.