API Documentation

Generate balanced light and dark themes using color harmony theory with one coherent brightness/contrast/saturation adjustment stage.

Request Body

Example Request

curl -X POST https://taichi.bucaastudio.com/api/generate-theme \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "analogous",
    "baseColor": "#3B82F6",
    "saturationLevel": 2,
    "darkFirst": true,
    "splitAdjustments": true,
    "lightBrightnessLevel": 1,
    "darkBrightnessLevel": -1
  }'

Response

{
  "success": true,
  "light": { "bg": "#f4f5f9", "primary": "#3d6fc2", ... },
  "dark": { "bg": "#0a0b0d", "primary": "#5e8ad4", ... },
  "metadata": {
    "mode": "analogous",
    "style": "analogous",
    "seed": "#3B82F6",
    "colorSpace": "OKLCH",
    "philosophy": "Harmony found in nature...",
    "options": {
      "darkFirst": true,
      "splitAdjustments": true,
      "saturationLevel": 2,
      "contrastLevel": 0,
      "brightnessLevel": 0,
      "lightSaturationLevel": 2,
      "lightContrastLevel": 0,
      "lightBrightnessLevel": 1,
      "darkSaturationLevel": 2,
      "darkContrastLevel": 0,
      "darkBrightnessLevel": -1
    }
  }
}

Turn a natural-language description into a complete light and dark theme. The AI chooses every color token; label colors on buttons are derived for legibility.

Request Body

Example Request

curl -X POST https://taichi.bucaastudio.com/api/prompt-theme \
  -H "Content-Type: application/json" \
  -d '{ "prompt": "a bright colorful theme that feels like spring" }'

Response

{
  "success": true,
  "light": { "bg": "#f7fbf4", "primary": "#3f9a3a", ... },
  "dark": { "bg": "#141814", "primary": "#7ec850", ... },
  "intent": {
    "light": { "bg": "#f7fbf4", "card": "#ffffff", "text": "#16241a", "primary": "#3f9a3a", ... },
    "dark": { "bg": "#141814", "card": "#1c221c", "text": "#eaf4ea", "primary": "#7ec850", ... },
    "rationale": "Leaf green, blossom pink and daffodil yellow on fresh white."
  },
  "metadata": { "mode": "ai", "seed": "#3f9a3a", "prompt": "..." }
}

Convert a theme object to CSS, SCSS, LESS, Tailwind, or JSON format.

Request Body

Example Request

curl -X POST https://taichi.bucaastudio.com/api/export-theme \
  -H "Content-Type: application/json" \
  -d '{
    "theme": { "primary": "#3B82F6", "bg": "#F8FAFC", ... },
    "format": "css",
    "options": { "prefix": "my-app" }
  }'

Tools

Connect from Claude Code

claude mcp add --transport http taichi https://taichi.bucaastudio.com/api/mcp

Connect from any MCP client

Point a streamable-HTTP MCP client at the URL below. Clients that only send Accept: application/json are accepted too — responses are always plain JSON.

https://taichi.bucaastudio.com/api/mcp