find_equivalents

find_equivalents finds the closest colours in other brands to a given paint colour or hex value, for example “Behr equivalent of Farrow & Ball Hague Blue” or “which Benjamin Moore is closest to #D1CBC1”. Give either brand plus name_or_code, or hex. Distance is CIEDE2000 ΔE. By default it returns the single best match per brand, closest first. Pass brands to restrict the search; with one brand you get several options from it.

Cost: Free. No key needed.

Parameters

Name	Type	Required	Default	Description
`brand`	string, max 60 chars	no		Brand of the source colour. Use together with `name_or_code`.
`name_or_code`	string, max 100 chars	no		Name or code of the source colour.
`hex`	string, max 7 chars	no		Source colour as hex, e.g. `#3D4E57`, instead of `brand` + `name_or_code`.
`brands`	array of strings (max 60 chars each), max 20 items	no	all other brands	Only search these brands, e.g. `["Behr", "Sherwin-Williams"]`.
`limit`	integer, 1 to 30	no	8	Maximum results.

If hex is given it is used and brand/name_or_code are ignored. With neither hex nor both brand and name_or_code, the tool returns an error.

Returns

One text content item holding a JSON object:

Field	Description
`source_color`	The source colour: the catalogue colour (all colour fields) or `{ "hex": "#…" }`.
`note`	Present if the source name exists in several catalogues of the same brand; says which one was matched.
`count`	Number of equivalents.
`equivalents`	Colours (same fields as in /mcp/tools/search-paint-colors/) plus `delta_e` (CIEDE2000 ΔE) and `match` (verdict).
`hint`	Present when nothing is within ΔE 6: `Nothing within ΔE 6 in the requested brands.`
`caveat`	On-wall results depend on base, sheen and tinting; test a sample.
`found`, `message`, `suggestions`	Returned instead of the above if the source colour is not in the catalogue.

Verdicts (match): under 1 “practically identical”, under 2 “very close”, under 3.5 “close”, otherwise “similar”. Nothing above ΔE 6 is returned. A catalogue source colour skips its own brand and that brand’s sister catalogues.

Example

Arguments:

{
  "brand": "Farrow & Ball",
  "name_or_code": "Hague Blue",
  "brands": ["Behr", "Sherwin-Williams"],
  "limit": 2
}

Result (captured from https://mcp.usemuro.com/mcp, attribution fields trimmed):

{
  "source_color": {
    "brand": "Farrow & Ball",
    "brand_id": "farrow_ball",
    "name": "Hague Blue",
    "hex": "#3D4E57",
    "lrv": 29.4,
    "category": "blue",
    "collection": "Main Collection",
    "code": "30",
    "url": "https://usemuro.com/en/colors/farrow_ball/hague-blue"
  },
  "count": 2,
  "equivalents": [
    {
      "brand": "Behr",
      "brand_id": "behr",
      "name": "Orion Gray",
      "hex": "#3D4C55",
      "lrv": 28.8,
      "category": "blue",
      "collection": "Main Collection",
      "code": "N510-6",
      "url": "https://usemuro.com/en/colors/behr/orion-gray",
      "delta_e": 0.98,
      "match": "practically identical"
    },
    {
      "brand": "Sherwin-Williams",
      "brand_id": "sherwin_williams",
      "name": "Sea Serpent",
      "hex": "#3E4B54",
      "lrv": 28.6,
      "category": "blue",
      "collection": "Sherwin-Williams-all",
      "code": "SW 7615",
      "url": "https://usemuro.com/en/colors/sherwin_williams/sea-serpent",
      "delta_e": 1.82,
      "match": "very close"
    }
  ],
  "caveat": "Screen colours are approximations. On the wall the result depends on the paint base, sheen and tinting, so test a sample before buying."
}

Notes

Always pass on the caveat: the colour on the wall depends on the paint base, sheen and tinting. A low ΔE means the screen values are close, not that two paints look identical on a wall.
An invalid hex returns an error: Use six hex digits like #3D4E57.