Color API
live DesignIdentify, convert, and generate color schemes using thecolorapi.com
3 tools
0ms auth
free tier 50 calls/day
Tools
identify_color
required: hex Identify a color by its hex value. Returns the color name, all format representations (RGB, HSL, HSV, CMYK), and contrast info.
Parameters
Name Type Description
hex req string Hex color value without the # prefix (e.g. "FF5733"). Try it
Response
generate_scheme
required: hex Generate a color scheme from a seed hex color. Returns a set of harmonious colors based on the chosen mode.
Parameters
Name Type Description
hex req string Seed hex color value without the # prefix (e.g. "FF5733"). mode opt string Color scheme mode. One of: monochrome, analogic, complement, triad, quad. Defaults to "monochrome". count opt number Number of colors to return (1-10, default 5). Try it
Response
convert_color
required: r, g, b Convert an RGB color to all other color formats (hex, HSL, HSV, CMYK) and get its closest color name.
Parameters
Name Type Description
r req number Red channel (0-255). g req number Green channel (0-255). b req number Blue channel (0-255). Try it
Response
Test with curl
The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.
List available tools
bash
curl -X POST https://gateway.pipeworx.io/colorapi/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Call a tool
bash
curl -X POST https://gateway.pipeworx.io/colorapi/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"identify_color","arguments":{"hex": "FF5733"}}}'Use with the SDK
Install @pipeworx/sdk to call tools from any TypeScript/Node project.
TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("identify_color", {"hex":"example"}); ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("identify, convert, and generate color schemes using thecolorapi");Related packs
Other Pipeworx packs in the same categories (Design):