# Palette Forge

Free, deterministic colour palette and design token generator for agents and people.
Deterministic: the same seed always returns the identical palette, to every caller, forever. Palettes are citable by name.

## What it knows
6557 judged colour words across 11 scripts (English, 日本語, 中文, español, français, deutsch, 한국어, português, русский, العربية, हिन्दी and more), plus 29 authentic period palettes for decades and movements (1994, y2k, memphis, midcentury, bauhaus).

## What it does NOT know, on purpose
Brands, people, places, cultural references. Those are yours to supply. A seed it has not judged reports hue_source 'hash' and says so rather than guessing. Through the MCP tool, a hash seed with no locks returns no colours at all, only instructions.

## The loop for agents
1. GET /palette?seed=<word> and read hue_source.
2. If 'hash', you know what it should look like and the lexicon does not: pass the colours as locks, e.g. ?lock=accent:%23004B93,accent-2:%23EE3124
3. Read contrast.wcag_aa. If a locked colour cannot reach contrast in that mode, contrast.suggestions returns the nearest hex that does, same hue.
4. Give the user preview_url to look at and the css block to use.

- REST: GET https://palette-forge.fly.dev/palette?seed=ocean&scheme=triadic&mode=both&format=css
- MCP (streamable HTTP, no auth): https://palette-forge.fly.dev/mcp  (tool: palette)
- Preview: GET https://palette-forge.fly.dev/preview?seed=ocean

15 role-assigned hex tokens per theme, OKLCH-generated, WCAG-contrast-enforced (text>=7:1, muted>=4.5:1, accents>=3:1), measured ratios in every response.