aesthete-agent MCP server

Expose the aesthete-agent color engine as MCP tools — usable from Claude Desktop, Cursor, and any MCP client.

Run

uvx --from "git+https://github.com/docsor1212/aesthete-agent#subdirectory=mcp" aesthete-agent-mcp

Or with a local FastMCP environment: python mcp/server.py (stdio).

Tools

Tool	What it does
`palette_match(brief, limit, no_flags)`	Rank the 89-palette evidence library for a natural-language brief (register auto-detect + learned preferences)
`palette_harmony(base, mode, theme)`	OKLCH harmony generation (7 rules × light/dark)
`palette_score(palette)`	5-dimension scorecard /20 with P0-P3 findings
`palette_contrast(fg, bg, method)`	WCAG ratio or APCA Lc (WCAG 3 draft) for one pair
`palette_matrix(palette, method, recommend)`	Full pairwise matrix + best-pair recommendation
`palette_blind(palette)`	Protanopia/deuteranopia/tritanopia simulation with collision flags
`palette_semantic(count, base)`	Color-blind-safe categorical colors for charts
`palette_themes()` / `palette_theme(name)`	Named theme packs → CSS tokens
`palette_export(palette, fmt)`	css / tailwind / json / svg / w3c (Design Tokens) / context (LLM-ready)
`palette_slop(palette)`	AI-slop signature detection (median-trap hexes, purple gradients, flat lightness)

Client config (Claude Desktop example)

{
  "mcpServers": {
    "aesthete-agent": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/docsor1212/aesthete-agent#subdirectory=mcp", "aesthete-agent-mcp"]
    }
  }
}

Zero keys, zero telemetry. The engine runs fully offline; only palette_*_extract-style image tools require Pillow (not exposed here).

Self-check

python mcp/server.py --check   # engine selftest + fastmcp availability

Metadata

Release files for aesthete-agent-mcp 0.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for aesthete-agent-mcp 0.4.0
File	Interpreter	ABI	Platform	Reset
aesthete_agent_mcp-0.4.0-py3-none-any.whl 39.9 kB Oct 15, 2026	Python 3	none	any	Details

Release files / aesthete_agent_mcp-0.4.0-py3-none-any.whl

Download URL	aesthete_agent_mcp-0.4.0-py3-none-any.whl
Size	39.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`c2ae3e78cfef20a6d0a6458ee3f53adac508ca919698cff76485e5968a436ce9`
BLAKE2b-256 checksum How to use checksums	`4b819c16790ce02da6d9057bc27cbabe3c7d09452fc95dd05f8c276712941319`
Upload date	Oct 15, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.6`