PaletteGet MCP Server
This server lets you discover and use PaletteGet color palettes through MCP tools.
List palettes, optionally filtered by platform (
app/web/miniapp) and tag, with a configurable result limit.Retrieve a palette’s full details by slug: role colors, contrast results, and pairing advice.
Recommend palettes from natural-language keywords in English or Chinese, showing what matched.
Get ready-to-paste CSS custom properties for a chosen palette.
Provides CSS custom properties for a palette, including semantic variable names, ready to paste into a project.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@PaletteGet MCP Server suggest a dark finance dashboard palette and give me the CSS variables"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
paletteget-mcp
An MCP server for the PaletteGet color palette library: 100 palettes across App, Web and Mini App UIs, each organized into 10 design roles and checked against WCAG contrast requirements.
It exists so your AI coding tool stops inventing hex values. Instead of guessing, the model calls a tool and gets the real role colors, the measured contrast ratios, and the pairing advice that ships with the palette.
No API key, no sign-up.
Use the hosted endpoint (nothing to install)
https://paletteget-mcp.y7206062.workers.dev/mcp{
"mcpServers": {
"paletteget": {
"type": "http",
"url": "https://paletteget-mcp.y7206062.workers.dev/mcp"
}
}
}ChatGPT: Settings → Connectors → Add custom connector → paste the URL.
The hosted server embeds the dataset at deploy time, so it never depends on the site being reachable and answers in a few milliseconds.
Related MCP server: Color Palette Generator MCP App
Or run it locally (stdio)
From npm, no clone
npx -y paletteget-mcp{
"mcpServers": {
"paletteget": {
"command": "npx",
"args": ["-y", "paletteget-mcp"]
}
}
}Behind a proxy, set PALETTEGET_PROXY=http://127.0.0.1:7897 in the server's env block.
From source
git clone https://github.com/yang7206/paletteget-mcp.git
cd paletteget-mcp
npm install{
"mcpServers": {
"paletteget": {
"command": "node",
"args": ["/absolute/path/to/paletteget-mcp/index.mjs"]
}
}
}The stdio server fetches live data from the public JSON endpoints and caches it for 10 minutes.
Tools
Tool | What it does |
| List palettes, optionally filtered by platform ( |
| Full data for one palette: role colors, contrast results, human-written pairing advice |
| Recommend palettes from keywords in English or Chinese, and say what matched |
| CSS custom properties for a palette, ready to paste |
| WCAG contrast between any two colors, with both the body-text and large-text verdicts |
| Readable text colors for a given background: same-hue tints and shades plus black and white, ranked by contrast |
| Derive a dark-mode version of a light palette with published rules, and the measured contrast of every pair |
| Paste-ready code for one palette: Android |
| Expand one base color into a 50 to 900 scale, with white and black contrast per step; JSON, CSS or Tailwind output |
Example call and result:
suggest_palette { "query": "dark finance dashboard", "limit": 2 }
- Ink Blue Night / 墨蓝夜(app,分 94)
slug: mo-lan-ye 主色: #4c8df6
场景: Finance & analytics apps (dark mode)
命中: 标签:dark, 场景:financeEnvironment variables (stdio server)
Variable | Default | Purpose |
|
| Override the dataset URL |
| derived ( | Override the Chinese dataset URL |
|
| Cache lifetime in milliseconds |
| none | Route requests through a proxy, e.g. |
Behind a firewall, Node's built-in fetch ignores the usual proxy variables, so set
PALETTEGET_PROXY explicitly.
Test
npm run smokeThe smoke test speaks the MCP stdio protocol directly and exercises every tool against a local
fixture, so it runs offline. Point PALETTEGET_API at the live site to test against production.
Maintaining the hosted worker
The worker (worker.mjs) is a hand-written, stateless subset of MCP Streamable HTTP
(initialize, tools/list, tools/call, ping) with no SDK dependency, which keeps it small and
Workers-native.
# 1. Regenerate the embedded dataset (run both locales)
SITE_URL=https://paletteget.com SITE_LOCALE=zh node --import ./alias-loader.mjs build-data.mjs
SITE_URL=https://paletteget.com SITE_LOCALE=en node --import ./alias-loader.mjs build-data.mjs
# 2. Local check
npx wrangler dev # POST JSON-RPC to http://127.0.0.1:8787/mcp
# 3. Deploy (needs CLOUDFLARE_API_TOKEN with Workers Scripts:Edit)
npx wrangler deploybuild-data.mjs reuses the site's own i18n modules through alias-hooks.mjs, so names, scenes and
advice stay identical to the published site. data/ is generated at build time and never committed.
Data and license
Code is MIT (see LICENSE). Palette data comes from paletteget.com and
may be reused freely in personal and commercial projects; a credit link is appreciated.
Machine-readable forms of the same data, if you would rather skip MCP entirely:
Full dataset:
https://paletteget.com/api/index.jsonOne palette:
https://paletteget.com/palette-list/{platform}/{slug}/index.jsonCSS variables:
https://paletteget.com/palette-list/{platform}/{slug}/index.cssAgent guide:
https://paletteget.com/llms.txt
Available Tools
4 toolsget_css_variablesBInspect
取一套配色的 CSS 自定义属性(可直接粘进项目),含语义化变量名。
Inputs: slug (required), platform.
get_paletteBInspect
取某一套配色的完整数据:角色色值(主色 / 功能色 / 中性色)、对比度、人工搭配建议。
Inputs: slug (required), platform.
list_palettesAInspect
列出配色库中的配色,可按平台(app / web / miniapp)与标签过滤。返回名称、slug、主色、场景与标签。
Inputs: tag, limit, platform.
suggest_paletteBInspect
按自然语言关键词推荐配色(中英文均可),例如「护眼的深色记账 App」「清新博客」。会说明每个结果命中了什么。
Inputs: query (required), limit, platform.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
list_palettes and suggest_palette both return palette sets, but the descriptions clearly separate filter-based browsing from natural-language recommendation with hit explanations. get_palette (full role data) and get_css_variables (CSS custom properties) differ in output format, though both take a palette identifier and could be momentarily confused.
All four names follow a uniform snake_case verb_noun pattern (list_, get_, suggest_, get_). The verbs accurately reflect the operation type, with no convention mixing.
Four tools is a tight, well-scoped surface for a read-only palette library. Each tool earns its place, though the set is on the thin side of the 3-15 range.
The surface covers the full consumption lifecycle: browse, inspect, recommend, and export to CSS. Minor gaps exist, such as searching by a specific color value or accessibility threshold, but core workflows have no dead ends.
Maintenance
Related MCP Connectors
Give your agent a real design system: tokens, measured WCAG contrast, and rules to follow.
Verified color tokens for AI coding agents: one brand hex in, WCAG/APCA-measured themes out.
Curated design references for AI — real CSS values, typography specs, and color palettes.
AI-agent design tools: fonts, font recognition, palettes, color naming, contrast, code, SVG, CSS.
Related MCP Servers
- AlicenseAqualityBmaintenanceEvery other colour API tells you what goes together. Colour Memory tells you what it means, where the evidence ends, and what it must not claim. 47,515 hand-researched records, graded A–E, every result cited. 91 specialist tools built for agents that need precision, not guesses. Direct MCP: https://api.colourmemory.com/mcp — no signup, no key for the free tools (10 calls).66MIT
- FlicenseNot gradedqualityDmaintenanceEnables users to generate color palettes (complementary, analogous, triadic, etc.) and check WCAG contrast ratios within AI chat applications using interactive UI.-
- AlicenseNot gradedqualityBmaintenanceEnables AI coding assistants to generate bespoke design systems by synthesizing OKLCH color palettes, chamfer highlights and spring physics, teaching layout composition grammar, and returning micro-interaction primitives and component blueprints. Also audits JSX/TSX/HTML through a senior design director's lens to score and critique UI quality.1 npm1MIT
- AlicenseAqualityCmaintenanceEnables AI agents to generate complete, deterministic design systems from a single brand color — harmonious palettes, font pairings, type and spacing scales, elevation shadows, responsive grids, motion presets, dark-mode themes, and WCAG contrast audits — and export them as CSS, JSON, Tailwind, or SCSS through natural conversation.1063 npmMIT