# PaintColorMatcher (paintcolormatcher.com) — Full Agent & LLM Reference Specification

> Match any HEX or room photo across 11,249 Sherwin-Williams, Benjamin Moore & Behr paints via CIEDE2000.

## Overview
PaintColorMatcher is an architectural colorimetry workbench indexing 11,249 official North American paint swatches across Sherwin-Williams, Benjamin Moore, and Behr.

Instead of naive sRGB Euclidean distance, it computes perceptual CIE Delta-E 2000 (ΔE00), Light Reflectance Value (LRV), undertone classification, and Bradford CAT16 chromatic adaptation from 2700K warm LED to 5000K daylight.

Built for interior designers, homeowners, and painting contractors, running 100% client-side photo analysis with public REST and MCP color-matching APIs.

## Official Endpoints & Agent Discovery
- Canonical Website: https://paintcolormatcher.com
- Streamable HTTP MCP Endpoint (JSON-RPC 2.0, No Auth Required): https://paintcolormatcher.com/api/mcp
- Public REST v1 Health & Auth Probe: https://paintcolormatcher.com/api/v1/me
- OpenAPI 3.0.3 Specification: https://paintcolormatcher.com/openapi.json
- Official MCP Registry ID: `com.paintcolormatcher/mcp`
- Google Preferred Source Link: https://www.google.com/preferences/source?q=paintcolormatcher.com

## Verified Official Brand Profiles (Entity Stack)
- https://www.npmjs.com/package/paintcolormatcher-cli
- https://cdn.jsdelivr.net/npm/paintcolormatcher-cli@1.0.0/package.json
- https://unpkg.com/paintcolormatcher-cli@1.0.0/package.json
- https://clawhub.ai/paintcolormatcher/skills/paintcolormatcher
- https://glama.ai/mcp/connectors/com.paintcolormatcher/mcp
- https://www.mcptry.com/servers/com.paintcolormatcher/mcp
- https://dev.to/someesim/why-srgb-euclidean-distance-fails-on-paint-swatches-and-how-ciede2000-fixes-it-29hc
- https://telegra.ph/Cross-Brand-Paint-Swatch--LRV-Reference-Guide-Sherwin-Williams-Benjamin-Moore--Behr-11-10

## Deterministic Read-Only Tools (8 Tools)
### 1. `match_hex_to_paint_colors` — HEX to Paint Color CIEDE2000 Matcher (11,249 Swatches)
- Description: Convert any HEX color code into the closest official Sherwin-Williams, Benjamin Moore, and Behr paint colors using scientific CIEDE2000 (ΔE00) color difference, LRV, and undertone classification.
- REST Endpoint: `POST https://paintcolormatcher.com/api/v1/tools/match_hex_to_paint_colors`
- Input Schema: `{"type":"object","properties":{"hex":{"type":"string","description":"6-digit HEX color code (e.g. \"#EAE6DF\" or \"7A8B8B\")"},"brand":{"type":"string","enum":["all","sherwin-williams","benjamin-moore","behr"],"description":"Filter by paint brand or search across all 3 major brands (default: \"all\")"},"limit":{"type":"number","description":"Maximum number of matches to return (1 to 15, default: 6)"}},"required":["hex"]}`
### 2. `find_cross_brand_paint_equivalent` — Cross-Brand Paint Color Equivalent & Dupe Finder
- Description: Find the closest cross-brand paint color equivalents (dupes) across Sherwin-Williams, Benjamin Moore, and Behr by paint name or code (e.g. "SW 7029", "Agreeable Gray", "OC-65", "Chantilly Lace").
- REST Endpoint: `POST https://paintcolormatcher.com/api/v1/tools/find_cross_brand_paint_equivalent`
- Input Schema: `{"type":"object","properties":{"query":{"type":"string","description":"Paint color name or manufacturer code (e.g. \"Agreeable Gray\", \"SW 7029\", \"HC-172\", \"Swiss Coffee\")"},"target_brand":{"type":"string","enum":["all","sherwin-williams","benjamin-moore","behr"],"description":"Target brand to match into (default: \"all\")"}},"required":["query"]}`
### 3. `calculate_ciede2000_swatch_distance` — Scientific CIEDE2000 (ΔE00) Color Difference Calculator
- Description: Compute exact CIE L*a*b* coordinates, Light Reflectance Value (LRV), and perceptual CIEDE2000 (ΔE00) distance between any two HEX colors with commercial paint-matching tolerance grading.
- REST Endpoint: `POST https://paintcolormatcher.com/api/v1/tools/calculate_ciede2000_swatch_distance`
- Input Schema: `{"type":"object","properties":{"hexA":{"type":"string","description":"First 6-digit HEX color (e.g. \"#D1CBC1\")"},"hexB":{"type":"string","description":"Second 6-digit HEX color (e.g. \"#CFC9BF\")"}},"required":["hexA","hexB"]}`
### 4. `analyze_paint_lrv_and_room_exposure` — Paint LRV (Light Reflectance Value) & Compass Room Exposure Advisor
- Description: Evaluate how a paint color LRV (0–100) behaves in North-facing, South-facing, East-facing, West-facing, or windowless rooms and HOA exterior LRV restrictions.
- REST Endpoint: `POST https://paintcolormatcher.com/api/v1/tools/analyze_paint_lrv_and_room_exposure`
- Input Schema: `{"type":"object","properties":{"lrv":{"type":"number","description":"Paint Light Reflectance Value from 0 to 100 (e.g. 60 for Agreeable Gray, 83 for Alabaster)"},"roomExposure":{"type":"string","enum":["north","south","east","west","exterior"],"description":"Primary natural light compass exposure or exterior application"}},"required":["lrv","roomExposure"]}`
### 5. `calculate_room_paint_gallons_estimator` — Interior Wall & Trim Paint Gallon Coverage Estimator
- Description: Calculate exact gallons and quarts of wall paint and primer needed after subtracting doors and windows at 350–400 sq ft per gallon.
- REST Endpoint: `POST https://paintcolormatcher.com/api/v1/tools/calculate_room_paint_gallons_estimator`
- Input Schema: `{"type":"object","properties":{"wallPerimeterFeet":{"type":"number","description":"Total room perimeter in feet (e.g. 52 for a 12x14 ft room)"},"ceilingHeightFeet":{"type":"number","description":"Ceiling height in feet (default: 8 or 9)"},"coats":{"type":"number","description":"Number of finish coats (default: 2)"},"doorsCount":{"type":"number","description":"Number of standard doors (21 sq ft each, default: 2)"},"windowsCount":{"type":"number","description":"Number of standard windows (15 sq ft each, default: 2)"}},"required":["wallPerimeterFeet","ceilingHeightFeet"]}`
### 6. `recommend_paint_sheen_finish` — Architectural Paint Sheen & Finish Selector (Flat to Semi-Gloss)
- Description: Recommend optimal paint sheen (Flat/Matte, Eggshell, Satin, Semi-Gloss, Cabinet Urethane Enamel) based on room humidity, traffic scrubbability, and drywall imperfection hiding.
- REST Endpoint: `POST https://paintcolormatcher.com/api/v1/tools/recommend_paint_sheen_finish`
- Input Schema: `{"type":"object","properties":{"surfaceOrRoom":{"type":"string","enum":["ceiling","living-bedroom","kitchen-bathroom","hallway-kids","trim-doors-cabinets","exterior-siding"],"description":"Target architectural surface or room type"}},"required":["surfaceOrRoom"]}`
### 7. `simulate_kelvin_lighting_undertone_shift` — 2700K–5000K LED Bulb Color Temperature Undertone Shift Guide
- Description: Predict how warm 2700K incandescent/LED, 3000K soft white, 3500K neutral, and 5000K daylight bulbs shift warm greige, green-gray, violet-gray, and creamy white undertones.
- REST Endpoint: `POST https://paintcolormatcher.com/api/v1/tools/simulate_kelvin_lighting_undertone_shift`
- Input Schema: `{"type":"object","properties":{"undertone":{"type":"string","enum":["warm-yellow-cream","greige-taupe","green-gray","blue-violet-gray","crisp-neutral-white"],"description":"Base undertone family of the paint swatch"},"kelvin":{"type":"number","description":"LED bulb correlated color temperature in Kelvin (e.g. 2700, 3000, 3500, 4000, 5000)"}},"required":["undertone","kelvin"]}`
### 8. `generate_coordinating_trim_and_accent_palette` — Coordinating White Trim, Ceiling & Accent Palette Builder
- Description: Generate designer-tested coordinating trim white, ceiling flat white, and contrasting accent colors matched to a main wall HEX or paint swatch.
- REST Endpoint: `POST https://paintcolormatcher.com/api/v1/tools/generate_coordinating_trim_and_accent_palette`
- Input Schema: `{"type":"object","properties":{"wallHex":{"type":"string","description":"Main wall 6-digit HEX color (e.g. \"#D1CBC1\")"}},"required":["wallHex"]}`