---
title: ToolRouter — Tool Detail
description: Detailed documentation for a ToolRouter tool including skills, parameters, and examples.
url: https://toolrouter.com/tools/color-tools
---
# Color Tools

Look up any color by hex, RGB, or HSL for full format conversions and naming. Generate palettes via color theory or AI. Check WCAG contrast ratios with AA/AAA compliance. Name colors from a database of 31,887 creative names.

- **Version:** 0.01
- **Categories:** data

## Skills (5)

### Color Info (`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.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `color` | string | Yes | Color to look up. Accepts hex "#FF5733", plain hex "FF5733", rgb "rgb(255,87,51)", or hsl "hsl(11,100%,60%)" |

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

**Examples:**

*Look up a hex color:*

```json
{
  "color": "#FF5733"
}
```

*Look up an RGB color:*

```json
{
  "color": "rgb(100,149,237)"
}
```

### Generate Palette (`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.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `color` | string | Yes | Starting hex color (e.g. "#FF5733" or "FF5733") |
| `mode` | string | No | Color scheme mode (default: analogic) (monochrome, analogic, complement, analogic-complement, triad, quad) [default: "analogic"] |
| `count` | number | No | Number of colors to generate, 2-10 (default: 5) [default: 5] |

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

**Examples:**

*Generate an analogic palette from coral:*

```json
{
  "color": "#FF6B6B"
}
```

*Generate a triad palette with 6 colors:*

```json
{
  "color": "#3498DB",
  "mode": "triad",
  "count": 6
}
```

### AI Palette (`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.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `locked_colors` | array | No | Array of up to 5 hex colors to lock. Use null for positions to auto-generate. Example: ["#FF5733", null, null, null, "#2C3E50"] |
| `model` | string | No | AI model style (default: "default") (default, ui, water_color, city_photography, lego_movie, ocean_photography) [default: "default"] |

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

**Examples:**

*Generate a random AI palette:*

```json
{}
```

*Generate with locked colors:*

```json
{
  "locked_colors": [
    "#FF5733",
    null,
    null,
    null,
    "#2C3E50"
  ],
  "model": "ui"
}
```

### Check Contrast (`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.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `foreground` | string | Yes | Foreground (text) hex color (e.g. "#333333" or "333333") |
| `background` | string | Yes | Background hex color (e.g. "#FFFFFF" or "FFFFFF") |

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

**Examples:**

*Check black text on white background:*

```json
{
  "foreground": "#000000",
  "background": "#FFFFFF"
}
```

*Check a problematic low-contrast pair:*

```json
{
  "foreground": "#777777",
  "background": "#AAAAAA"
}
```

### Name Colors (`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.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `colors` | array | Yes | Array of 1-10 hex color strings (e.g. ["#FF5733", "#3498DB", "#2ECC71"]) |

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

**Examples:**

*Name a set of brand colors:*

```json
{
  "colors": [
    "#FF5733",
    "#3498DB",
    "#2ECC71"
  ]
}
```

## Quick Start

```bash
# Via CLI
TOOLROUTER_API_KEY=tr_live_xxx npx -y toolrouter-mcp call color-tools color_info --color #FF5733

# Via REST API
curl -H "Authorization: Bearer tr_live_xxx" \
     -d '{"tool":"color-tools","skill":"color_info","input":{"color":"#FF5733"}}' \
     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.

---

## Get Started with ToolRouter

**Already connected?** Call any tool with `use_tool({ tool, skill, input })`. Browse tools with `discover` or visit https://toolrouter.com/llms-full.txt

**New to ToolRouter?** Connect with one command (no API key needed — auto-provisions on first use):

```bash
# MCP (Claude Code, Codex CLI)
claude mcp add toolrouter -- npx -y toolrouter-mcp

# MCP (Cursor, Windsurf, Cline, VS Code, Gemini CLI, Claude Desktop)
{"mcpServers":{"toolrouter":{"command":"npx","args":["-y","toolrouter-mcp"]}}}

# Claude Chat / Claude Cowork / Claude Mobile — add as a connector:
# Settings → Connectors → Add custom connector → URL: https://api.toolrouter.com/mcp

# ChatGPT — add as an app:
# Settings → Apps → Advanced settings → enable Developer mode → Create app → MCP Server URL: https://api.toolrouter.com/mcp

# CLI (works instantly, no restart needed)
npx -y toolrouter-mcp tools                    # browse all tools
npx -y toolrouter-mcp search "seo"             # search by keyword
npx -y toolrouter-mcp call seo analyze_page --url https://example.com
```

Free tools work immediately. For paid tools, visit https://toolrouter.com/claim to add credits.

All platforms: https://toolrouter.com/connect | Full catalog: https://toolrouter.com/llms-full.txt | Docs: https://toolrouter.com/docs