0.5.0

PyPI

aesthete-agent-mcp

aesthete-agent MCP server — mechanically validated frontend aesthetics: palette library ranking, OKLCH generation, WCAG/APCA contrast, color-blind-safe data colors, theme packs, token exports (w3c/context); zero keys, zero telemetry

Published15 Oct 2026

Direct dependencies1

Transitive dependenciesNot calculated

README

Version 0.5.0 documentation

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

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 1

Native requirements

1 direct targetsNot calculated transitive count

Package / target	Requirement	Relationship
fastmcp Environment { "extras": "", "marker": null, "requires_python": ">=3.10", "evaluation": "NOT_EVALUATED" }	`fastmcp>=2.0`	runtime

Distribution files

1 collected

aesthete_agent_mcp-0.5.0-py3-none-any.whl

bdist_wheel · 41.56 KB · Python py3

Source file

Metadata history

Meaningful changes

Current collected state Current

Observed since 20 Oct, 20:52 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package_version:a6475d9b6d8e76d9a3c1d508e843e2575cc47aa40d90717b4cb0908e8f73b6a5

Other collected versions

View all collected versions →