Color Tools — Palettes, contrast, and color info

Tools / Color Tools

Color Info

Get comprehensive info about any color — name, hex, RGB, HSL, HSV, CMYK, closest named color, creative name, and contrast recommendation. Accepts hex, RGB, and HSL input formats.

Returns: All color format conversions (hex, RGB, HSL, HSV, CMYK), named color, creative name, and contrast recommendation

Parameters

color *stringColor to look up. Accepts hex "#FF5733", plain hex "FF5733", rgb "rgb(255,87,51)", or hsl "hsl(11,100%,60%)"

Example

Look up a hex color

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "color-tools",
  "skill": "color_info",
  "input": {
    "color": "#FF5733"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Generate Palette

Generate a color scheme from a starting color using classic color theory. Supports monochrome, analogic, complement, analogic-complement, triad, and quad modes with 2-10 colors.

Returns: Color palette with hex, RGB, HSL values and creative names for each color

Parameters

color *stringStarting hex color (e.g. "#FF5733" or "FF5733")

modestringColor scheme mode (default: analogic)

countnumberNumber of colors to generate, 2-10 (default: 5)

Example

Generate an analogic palette from coral

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "color-tools",
  "skill": "generate_palette",
  "input": {
    "color": "#FF6B6B"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

AI Palette

Generate an AI-powered 5-color palette using machine learning. Optionally lock specific colors and let the AI generate complementary colors for the remaining positions.

Returns: 5-color AI-generated palette with hex, RGB, creative names, and locked status for each color

Parameters

locked_colorsarrayArray of up to 5 hex colors to lock. Use null for positions to auto-generate. Example: ["#FF5733", null, null, null, "#2C3E50"]

modelstringAI model style (default: "default")

Example

Generate a random AI palette

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "color-tools",
  "skill": "ai_palette",
  "input": {}
}' \
  https://api.toolrouter.com/v1/tools/call

Check Contrast

Check WCAG 2.1 accessibility contrast ratio between a foreground and background color. Returns AA and AAA compliance for both normal and large text with improvement suggestions.

Returns: WCAG contrast ratio, AA and AAA compliance for normal and large text, and improvement suggestions

Parameters

foreground *stringForeground (text) hex color (e.g. "#333333" or "333333")

background *stringBackground hex color (e.g. "#FFFFFF" or "FFFFFF")

Example

Check black text on white background

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "color-tools",
  "skill": "check_contrast",
  "input": {
    "foreground": "#000000",
    "background": "#FFFFFF"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Name Colors

Get creative names for up to 10 colors from a database of 31,887 named colors. Returns each color with its closest creative name, plus a generated palette title for the group.

Returns: Creative color names from 31,887-name database, plus a generated palette title

Parameters

colors *arrayArray of 1-10 hex color strings (e.g. ["#FF5733", "#3498DB", "#2ECC71"])

Example

Name a set of brand colors

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "color-tools",
  "skill": "name_colors",
  "input": {
    "colors": [
      "#FF5733",
      "#3498DB",
      "#2ECC71"
    ]
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Quick Start

MCP (Claude Code)

claude mcp add --transport stdio \
  --env TOOLROUTER_API_KEY=YOUR_API_KEY \
  toolrouter -- npx -y toolrouter-mcp

REST API

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{"tool":"color-tools","skill":"color_info","input":{}}' \
  https://api.toolrouter.com/v1/tools/call

Frequently Asked Questions

Can I convert between hex, RGB, HSL, HSV, and CMYK?

Yes. `color_info` accepts hex, RGB, or HSL input and returns the full set of color conversions along with the closest named color and a contrast-friendly text color.

How do I generate a palette from one color?

`generate_palette` builds classic color schemes like monochrome, analogic, complement, triad, and quad. If you want a smarter starting point, `ai_palette` can lock up to five colors and fill in the rest.

Will it check accessibility contrast for my design?

`check_contrast` measures WCAG 2.1 AA and AAA contrast for foreground and background colors, including the large-text rules, and suggests a readable pairing.

Can I name several brand colors at once?

Yes. `name_colors` can name up to 10 hex colors in one call, which is useful when you are matching a palette to a brand system.