`identify_color`

Pack: colorapi · Endpoint: https://gateway.pipeworx.io/colorapi/mcp

Identify a color by hex code (e.g., “#FF5733”). Returns color name, RGB/HSL/HSV/CMYK values, and WCAG contrast ratios for accessibility.

Parameters

Name	Type	Required	Description
`hex`	string	yes	Hex color value without the # prefix (e.g. “FF5733”).

Example call

Arguments

{
  "hex": "FF5733"
}

curl

curl -X POST https://gateway.pipeworx.io/colorapi/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"identify_color","arguments":{"hex":"FF5733"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('identify_color', {
  "hex": "FF5733"
});

More examples

{
  "hex": "3498DB"
}

Response shape

Always returns: name, exact_name_match, closest_named_hex, hex, rgb, hsl, hsv, cmyk, contrast

Field	Type	Description
`name`	string	Common color name
`exact_name_match`	boolean	Whether the name is an exact match
`closest_named_hex`	string	Hex code of closest named color
`hex`	string	Hex color value
`rgb`	string	RGB color format string
`hsl`	string	HSL color format string
`hsv`	string	HSV color format string
`cmyk`	string	CMYK color format string
`contrast`	string	WCAG contrast ratio value

Full JSON Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Common color name"
    },
    "exact_name_match": {
      "type": "boolean",
      "description": "Whether the name is an exact match"
    },
    "closest_named_hex": {
      "type": "string",
      "description": "Hex code of closest named color"
    },
    "hex": {
      "type": "string",
      "description": "Hex color value"
    },
    "rgb": {
      "type": "string",
      "description": "RGB color format string"
    },
    "hsl": {
      "type": "string",
      "description": "HSL color format string"
    },
    "hsv": {
      "type": "string",
      "description": "HSV color format string"
    },
    "cmyk": {
      "type": "string",
      "description": "CMYK color format string"
    },
    "contrast": {
      "type": "string",
      "description": "WCAG contrast ratio value"
    }
  },
  "required": [
    "name",
    "exact_name_match",
    "closest_named_hex",
    "hex",
    "rgb",
    "hsl",
    "hsv",
    "cmyk",
    "contrast"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "colorapi": {
      "url": "https://gateway.pipeworx.io/colorapi/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

identify_color