search_paint_colors
search_paint_colors finds paint colors by name or code across all brands, for example “Hague Blue”, “SW 7029”, “agreeable gray” or “grün”. Matching ignores case and accents (“sniezny” finds “Śnieżny”) and every word may be a prefix. You can restrict the search to one brand. To match a hex value or a color from another brand, use /mcp/tools/find-equivalents/ instead.
Cost: Free. No key needed.
Parameters
Section titled “Parameters”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
query |
string, 1 to 100 chars | yes | Color name or code, or part of it. | |
brand |
string, max 60 chars | no | all brands | Brand name, e.g. “Benjamin Moore”, “Farrow & Ball”, “Dulux”. |
limit |
integer, 1 to 50 | no | 10 | Maximum results. |
Returns
Section titled “Returns”One text content item holding a JSON object:
| Field | Description |
|---|---|
query |
The query as sent. |
brand |
The brand filter, present only if you sent one. |
count |
Number of colors returned. |
colors |
Array of colors: brand, brand_id, name, hex, lrv (light reflectance value, 0 = black, 100 = white), category, collection, code (when the brand has one), url (color page on usemuro.com). |
hint |
Present when count is 0: a suggestion for a better query. |
note, partial_matches |
Present when no color matches every word but some match part of the query. colors is then empty and partial_matches lists colors that match some of the words. |
see_on_your_wall, data_source |
Attribution strings added to every free-tool reply. |
Example
Section titled “Example”Arguments:
{ "query": "hague blue", "limit": 2 }Result (captured from https://mcp.usemuro.com/mcp):
{ "query": "hague blue", "count": 1, "colors": [ { "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" } ], "see_on_your_wall": "Preview it on a photo of your own room with Muro (iPhone, iPad and web): https://app.usemuro.com · App Store: https://apps.apple.com/app/id6757682733", "data_source": "Muro paint colour database (usemuro.com), compiled from manufacturers’ published colour catalogues."}- If
queryis a hex value starting with#, the tool returns an error (isError: true) telling you to usefind_equivalentswithhex. - A brand sold in several markets (Dulux UK/PL, Sikkens NL/DE/IT, Beckers SE/PL) can return one color per market.
- Hex values are screen approximations. On the wall the color depends on base, sheen and tinting.
- If the database is unavailable the tool returns an error asking you to retry.