Find colors that meet rules
colors_findFind verified hex colors that satisfy combined hue, chroma, lightness, background contrast, and color-difference rules in one call; returns colors with margin or identifies the unmet rule.
Instructions
Find colors that satisfy your rules in one call. Combine any of: hue band (or the hue family of a color), chroma range, lightness range, contrast against one or more backgrounds (against), and for several colors a minimum lightness gap, hue gap or color difference (optionally color-blind safe). Returns verified hex colors with the most margin, or says which rule cannot be met.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "colors_find"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cvd | No | Several colors: also keep every pair apart (minDeltaE) under this color blindness. "all" covers the three common types. Default "none". | none |
| count | No | How many colors to find. Default 1. | |
| hueOf | No | Instead of hueMin/hueMax: keep the found colors in the hue family of this color (for example the brand color). The band is its OKLCH hue plus or minus hueWithin. | |
| hueMax | No | OKLCH hue band end, degrees 0-360. | |
| hueMin | No | OKLCH hue band start, degrees 0-360 (red 30, yellow 100, green 145, cyan 200, blue 260, purple 305, pink 350). If hueMin is above hueMax the band wraps through 0. | |
| against | No | Every found color must reach the ratio against each of these colors, for example a light and a dark surface. | |
| chromaMax | No | Maximum OKLCH chroma. | |
| chromaMin | No | Minimum OKLCH chroma (0 gray, 0.1 muted, 0.2 vivid). | |
| hueWithin | No | Degrees either side of hueOf. Default 20. | |
| minDeltaE | No | Several colors: minimum CIEDE2000 difference between every pair. Default 15 when no other pair rule is given. | |
| minHueGap | No | Several colors: minimum OKLCH hue difference in degrees between every pair of colorful colors. | |
| lightnessMax | No | Maximum OKLCH lightness. | |
| lightnessMin | No | Minimum OKLCH lightness, 0 black to 1 white. | |
| minLightnessGap | No | Several colors: minimum OKLab lightness difference between every pair (keeps them apart in grayscale). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| found | Yes | ||
| pairs | No | ||
| colors | Yes | ||
| details | No | ||
| allRulesHold | Yes |