How to Use the Color Palette Generator API — Free REST + MCP Server

#design #css #api #mcp

Building a design system? Need complementary colors, contrast ratios, or CSS variables from a base color? This API handles color harmonies, gradients, contrast checking, and even Tailwind config generation.

Try It Right Now

curl -s https://api.lazy-mac.com/color-palette/api/v1/random | jq

Response:

{
  "colors": ["#1c96ca", "#673abb", "#db809a", "#d4c23a", "#24c22b"],
  "count": 5,
  "css": ":root {\n  --palette-1: #1c96ca;\n  --palette-2: #673abb;\n  --palette-3: #db809a;\n}"
}

Random palette with ready-to-use CSS variables.

All Endpoints

Endpoint	Description
`GET /api/v1/convert/:color`	Convert between HEX, RGB, HSL
`GET /api/v1/harmony/:type/:color`	Complementary, triadic, analogous, etc.
`GET /api/v1/gradient/:color1/:color2`	Generate gradient steps
`GET /api/v1/contrast/:color1/:color2`	WCAG contrast ratio check
`GET /api/v1/random`	Random harmonious palette
`POST /api/v1/css`	Generate CSS custom properties
`POST /api/v1/tailwind`	Generate Tailwind config

Get Complementary Colors

curl -s https://api.lazy-mac.com/color-palette/api/v1/harmony/complementary/3498db | jq

Check WCAG Contrast

curl -s https://api.lazy-mac.com/color-palette/api/v1/contrast/ffffff/333333 | jq

Generate Tailwind Config

curl -s -X POST https://api.lazy-mac.com/color-palette/api/v1/tailwind \
  -H "Content-Type: application/json" \
  -d '{"colors": ["#3498db", "#2ecc71", "#e74c3c"]}' | jq

Use as an MCP Server

{
  "mcpServers": {
    "color-palette": {
      "url": "https://api.lazy-mac.com/color-palette/mcp"
    }
  }
}

Ask Claude: "Generate a complementary color palette for #3498db with CSS variables"

Pricing

Tier	Requests/mo	Price
Free	100	$0
Pro	10,000	$9/mo
Business	Unlimited	$49/mo

Get Pro Access on Gumroad →

Browse all 22 APIs at api.lazy-mac.com →

DEV Community