UI Color Palette MCP Server

A Model Context Protocol (MCP) server built on Cloudflare Workers using the Agents SDK (McpAgent + Durable Objects) that exposes the UI Color Palette API as tools for AI agents and LLMs.

Transport

Streamable HTTP at /mcp (supports both SSE and Streamable HTTP transports).

Available Tools

Palette Generation

| Tool | Description | | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------- | | get_palette | Generate a complete color palette from base and theme configurations | | get_color_system | Build a semantic color system by resolving taxonomy bindings against a generated palette | | create_color_harmony | Create color harmonies (complementary, analogous, triadic, tetradic, compound, square) | | extract_dominant_colors | Extract dominant colors from a JPEG/PNG image URL | | generate_code | Generate design tokens/code from base + themes (CSS, SCSS, Less, Tailwind v3/v4, SwiftUI, UIKit, Compose, CSV, DTCG, etc.) | | generate_colors_from_prompt | Generate a palette from a natural language description via AI |

generate_code input

The generate_code tool expects:

• base: base palette configuration
• themes: array of theme configurations
• format (optional)
• colorSpace (optional)

This mirrors the API POST /v1/generate-code contract and no longer uses a paletteData input.

The MCP server calls versioned API routes and automatically prefixes requests with /v1.

Authentication

Authenticated tools (Auth: Yes) use OAuth 2.1. MCP clients that support OAuth auto-configure via the discovery endpoint at /.well-known/oauth-authorization-server. The Bearer token is passed in the Authorization header and injected into every tool call automatically — no manual token parameter is needed.

Published Palettes

| Tool | Auth | Description | | ---------------------------- | ---- | ----------------------------------------------------- | | list_published_palettes | No | List publicly shared palettes (paginated, searchable) | | list_my_published_palettes | Yes | List the authenticated user's own palettes | | publish_palette | Yes | Publish a new palette | | get_published_palette | No | Get a specific shared palette by ID | | share_published_palette | Yes | Make a palette publicly visible | | unshare_published_palette | Yes | Make a palette private | | update_published_palette | Yes | Update an existing palette | | unpublish_palette | Yes | Permanently delete a palette |

Configuration

VS Code / Copilot

Add to your settings.json or .vscode/mcp.json:

{
  "mcp": {
    "servers": {
      "ui-color-palette": {
        "type": "http",
        "url": "https://mcp-uicp.<your-subdomain>.workers.dev/mcp"
      }
    }
  }
}

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "ui-color-palette": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp-uicp.<your-subdomain>.workers.dev/mcp"]
    }
  }
}

Development

npm install
npm run dev        # Start local dev server
npm run deploy     # Deploy to Cloudflare

Environment Variables

| Variable | Description | | --------- | ---------------------------------------------------------------------------------------------------------------------- | | API_URL | Base URL of the deployed api-ui-color-palette worker (without /v1) |

License

This project is licensed under the MIT License. See the LICENSE file for details.