{"apiVersion":"v1","directorySlug":"aestheta-mcp-cffa9d1822","title":"Aestheta: Design taste, as an API","description":"A design-knowledge API and MCP server for AI agents and developers. 324 aesthetics, plus tools to compose briefs, grade UI, and export tokens.","pageUrl":"https://www.mcpbundles.com/skills/aestheta-mcp-cffa9d1822","connectPath":"importable","connectAction":"import_server","catalogListing":false,"bundleSlug":null,"listingKind":"remote_mcp","kind":"provider","transportUrl":"https://aestheta.ai/mcp","hostedMcpUrl":null,"toolCount":24,"toolInventoryStatus":"observed","refreshedAt":"2026-11-03T13:26:00.516172+00:00","registryName":"ai.aestheta/aestheta-mcp-cffa9d1822","registryVersion":"2026.11.3","registryEligible":true,"tools":[{"name":"list_aesthetics","description":"List the design encyclopedia (203+ aesthetics: brands, YC companies, app design languages, styles, color themes). Returns slug/name/kind/summary; palettes via get_design_brief. Optionally filter by kind.","inputSchema":{"type":"object","properties":{"kind":{"enum":["brand","yc","app","style","theme","component"],"type":"string"}}},"logicalName":"list_aesthetics","displayName":"list_aesthetics","title":"list_aesthetics","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"name":"search_aesthetics","description":"Search aesthetics by free text across name, slug, and summary (e.g. \"warm editorial serif\", \"fintech\", \"playful gradient\"). Returns the best matches with palettes.","inputSchema":{"type":"object","required":["query"],"properties":{"query":{"type":"string"}}},"logicalName":"search_aesthetics","displayName":"search_aesthetics","title":"search_aesthetics","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"name":"semantic_search","description":"Hybrid retrieval over the encyclopedia: structured facet FILTERS (kind, theme dark/light, hue family, type serif/sans/mono/display) combined with lexical ranking across summary, voice, principles and palette names. Use this (not search_aesthetics) when an agent needs aesthetics matching real criteria, e.g. {query:\"trustworthy fintech\", theme:\"dark\"}. Returns ranked matches with derived facets + palettes.","inputSchema":{"type":"object","required":["query"],"properties":{"k":{"type":"number"},"hue":{"type":"string"},"kind":{"enum":["brand","yc","app","style","theme","component"],"type":"string"},"type":{"enum":["serif","sans","mono","display"],"type":"string"},"query":{"type":"string"},"theme":{"enum":["dark","light"],"type":"string"}}},"logicalName":"semantic_search","displayName":"semantic_search","title":"semantic_search","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"name":"compose_brief","description":"THE synthesis tool: produce a UNIQUE, buildable starter design spec for a request by blending the best-matching encyclopedia aesthetics. Retrieves matching design DNA, harmonizes a token scaffold (bg/surface/ink/muted/accent with verified contrast), unions principles and avoid-lists, and attaches the craft taste-kit + conditional craft skills + a critique checklist. Set variants 1-3 for alternative directions. Output is a starter to FINALIZE (abstract, do not lift) then build via add_aesthetic o","inputSchema":{"type":"object","required":["request"],"properties":{"k":{"type":"number"},"hue":{"type":"string"},"kind":{"enum":["brand","yc","app","style","theme","component"],"type":"string"},"type":{"enum":["serif","sans","mono","display"],"type":"string"},"theme":{"enum":["dark","light"],"type":"string"},"request":{"type":"string"},"variants":{"type":"number"}}},"logicalName":"compose_brief","displayName":"compose_brief","title":"compose_brief","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"name":"grade_ui","description":"THE output-QA tool: grade a webpage's design quality. Pass a URL or raw HTML; it renders the page (desktop + mobile), runs accessibility (axe) + computed-style + craft checks, and returns a 0-100 score, per-dimension scores (BRAND/A11Y/HIER/TYPO/COMP/RESP/POLISH), and a ranked list of SPECIFIC fixes. Optionally pass a brief (a compose_brief result) to grade BRAND-match against its intended tokens. The companion to compose_brief: generate → grade → fix → regrade. Renders in a headless browser so","inputSchema":{"type":"object","properties":{"url":{"type":"string"},"html":{"type":"string"},"brief":{"type":"object"}}},"logicalName":"grade_ui","displayName":"grade_ui","title":"grade_ui","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"name":"lint_against_brief","description":"Grade a page (url or html) AGAINST a brief and return brand-adherence plus token-swap fixes (which off-brand colors to replace with which brand tokens). The autonomous generate → grade → fix → regrade primitive. Pass a compose_brief result (or {specs:[{tokens,...}]}) as `brief`.","inputSchema":{"type":"object","required":["brief"],"properties":{"url":{"type":"string"},"html":{"type":"string"},"brief":{"type":"object"}}},"logicalName":"lint_against_brief","displayName":"lint_against_brief","title":"lint_against_brief","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"name":"export_tokens","description":"Paste-ready design tokens for any encyclopedia aesthetic by slug: CSS custom properties, a Tailwind theme.extend block, and W3C DTCG JSON, plus palette + fonts.","inputSchema":{"type":"object","required":["slug"],"properties":{"slug":{"type":"string"}}},"logicalName":"export_tokens","displayName":"export_tokens","title":"export_tokens","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"name":"shader_background","description":"Get a drop-in, self-contained animated WebGL shader-gradient background (shadergradient.co vibe) with a vibrant palette. Pass a preset name (miami-neon, aurora, sunset-fire, plasma, electric-candy, ultraviolet, lava-citrus, deep-space, mint-magenta, tropic) OR a custom colors array of 2 to 4 hex strings. Returns paste-ready code (a <canvas> plus inline GLSL, no frameworks or build). Use it to give a hero or landing page a bold, modern animated background. Keep text contrast over it (overlay a tr","inputSchema":{"type":"object","properties":{"speed":{"type":"number"},"colors":{"type":"array","items":{"type":"string"}},"preset":{"type":"string"}}},"logicalName":"shader_background","displayName":"shader_background","title":"shader_background","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"name":"list_visual_recipes","description":"List the VISUAL-RECIPE library: paste-ready generative hero backgrounds an agent can drop into a page (one real-3D Three.js lit surface + five vanilla-WebGL GLSL drop-ins). Returns each recipe's slug, name, family (surface-3d/gradient/flow/particles/raymarch), engine (webgl | three@0.160.0), perf (light/medium/heavy), palette_arity, default_token_map, and tunable params. Call this first, then get_visual_recipe for a paste-ready snippet, or compose_hero_visual to let the encyclopedia pick + theme","inputSchema":{"type":"object","properties":{}},"logicalName":"list_visual_recipes","displayName":"list_visual_recipes","title":"list_visual_recipes","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"name":"get_visual_recipe","description":"Get a SELF-CONTAINED, paste-ready generative-visual snippet (a <canvas> plus inline GLSL, or a <script type=module> + pinned three@0.160.0 importmap for the 3D recipe) for a given recipe slug (from list_visual_recipes). Resolve colors from any ONE of: an explicit `colors` hex array, an `aesthetic` slug (pulls that aesthetic's encyclopedia tokens), or a `brief` (a compose_brief result; uses specs[0].tokens). Numeric `params` are clamped server-side. Every snippet ships a filmic grain/vignette fin","inputSchema":{"type":"object","required":["slug"],"properties":{"slug":{"type":"string"},"brief":{"type":"object"},"colors":{"type":"array","items":{"type":"string"}},"params":{"type":"object"},"aesthetic":{"type":"string"}}},"logicalName":"get_visual_recipe","displayName":"get_visual_recipe","title":"get_visual_recipe","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"name":"compose_hero_visual","description":"THE one-call hero-visual composer: describe the page in plain words (`request`) and it composes a design brief from the encyclopedia, reads its facets (theme/hue/temp), HEURISTICALLY PICKS the best-fit recipe (dark+premium → lit silk surface; liquid/futuristic desktop → raymarch blob; data/network language → particle field; printed/editorial → ember dither; bright/light → aurora or mesh gradient), fills the colors from the brief's tokens, and returns the emitted paste-ready snippet PLUS { recipe","inputSchema":{"type":"object","properties":{"brief":{"type":"object"},"mobile":{"type":"boolean"},"params":{"type":"object"},"recipe":{"type":"string"},"request":{"type":"string"},"aesthetic":{"type":"string"}}},"logicalName":"compose_hero_visual","displayName":"compose_hero_visual","title":"compose_hero_visual","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"name":"list_craft_skills","description":"List the taste/craft layer: the constant kit (always applied for taste), conditional skills (triggered by request/facets), and the critique checklist. Each with a when-to-apply line. These add craft on top of an aesthetic; fetch full rules via get_craft_skill.","inputSchema":{"type":"object","properties":{}},"logicalName":"list_craft_skills","displayName":"list_craft_skills","title":"list_craft_skills","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"name":"get_craft_skill","description":"Full rules markdown for one craft/critique skill (names come from compose_brief.craft or list_craft_skills). Apply while finalizing a spec to keep it on-craft and not-slop.","inputSchema":{"type":"object","required":["name"],"properties":{"name":{"type":"string"}}},"logicalName":"get_craft_skill","displayName":"get_craft_skill","title":"get_craft_skill","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"name":"get_design_brief","description":"THE extraction tool: everything needed to produce new work in an aesthetic — exact color palette (names + hexes), fonts, the full design-skill markdown (worldview, rules, avoid-list), and paths/URLs of reference pages. Use this before mass-producing anything in a given design language.","inputSchema":{"type":"object","required":["slug"],"properties":{"slug":{"type":"string"}}},"logicalName":"get_design_brief","displayName":"get_design_brief","title":"get_design_brief","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"name":"get_palette","description":"Just the color palette ({name, hex} list) for one aesthetic.","inputSchema":{"type":"object","required":["slug"],"properties":{"slug":{"type":"string"}}},"logicalName":"get_palette","displayName":"get_palette","title":"get_palette","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"name":"list_doc_templates","description":"List the canonical DESIGN-DOCUMENT templates Aestheta can scaffold (PRD, design brief, UI spec, design-system docs, brand guidelines, component spec, RFC, UX research plan, content guide, a11y spec, design review, vibe/aesthetic brief). Returns slug/name/when_to_use/section-headings. Call this first when you need to write any design doc.","inputSchema":{"type":"object","properties":{}},"logicalName":"list_doc_templates","displayName":"list_doc_templates","title":"list_doc_templates","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"name":"get_doc_template","description":"Full structure of one design-doc template: every section with its purpose, guidance (LLM-followable prompts), and a worked example. Use to write the doc yourself, or call compose_design_doc to also pre-fill the design foundation from the encyclopedia.","inputSchema":{"type":"object","required":["slug"],"properties":{"slug":{"type":"string"}}},"logicalName":"get_doc_template","displayName":"get_doc_template","title":"get_doc_template","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"name":"compose_design_doc","description":"Generate a fill-ready markdown design doc: the chosen template's section scaffold PLUS a \"Design foundation\" pre-filled with REAL encyclopedia values (palette, design tokens, type, principles) matched to your brief, so you never invent colors/fonts. You then write each section. The best starting point whenever an agent needs to produce a design doc.","inputSchema":{"type":"object","required":["request"],"properties":{"hue":{"type":"string"},"kind":{"enum":["brand","yc","app","style","theme","component"],"type":"string"},"type":{"type":"string"},"theme":{"enum":["dark","light"],"type":"string"},"request":{"type":"string"},"template":{"type":"string"}}},"logicalName":"compose_design_doc","displayName":"compose_design_doc","title":"compose_design_doc","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"name":"get_skill_markdown","description":"Raw skills/<slug>.md design-skill document (frontmatter + prose worldview). The canonical design doc for the aesthetic.","inputSchema":{"type":"object","required":["slug"],"properties":{"slug":{"type":"string"}}},"logicalName":"get_skill_markdown","displayName":"get_skill_markdown","title":"get_skill_markdown","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"name":"get_page_source","description":"Raw HTML source of an aesthetic's page — a complete reference implementation of the design language. file: \"showcase\" (landing page built IN the aesthetic), \"docs\" (catalog: swatches/type/rules), or \"onboarding\" (apps).","inputSchema":{"type":"object","required":["slug","file"],"properties":{"file":{"enum":["showcase","docs","onboarding"],"type":"string"},"slug":{"type":"string"}}},"logicalName":"get_page_source","displayName":"get_page_source","title":"get_page_source","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"name":"random_aesthetic","description":"A random design brief, optionally filtered by kind — for mass-production pipelines that want variety (\"give me a style to build the next page in\").","inputSchema":{"type":"object","properties":{"kind":{"enum":["brand","yc","app","style","theme","component"],"type":"string"}}},"logicalName":"random_aesthetic","displayName":"random_aesthetic","title":"random_aesthetic","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"name":"add_aesthetic","description":"Create or update an aesthetic in the encyclopedia (idempotent by slug). Requires: slug (kebab-case), name, kind (brand|yc|app|style|theme|component), summary (40-500 chars), palette (3-16 {name,hex}), files {\"index.html\": full self-contained showcase HTML, \"docs.html\": catalog HTML, optional \"onboarding.html\"}, optional skill_md prose (NO frontmatter — generated server-side). Pages must be fully static, built IN the aesthetic, anti-slop. On success the entry is live in the Orrery immediately.","inputSchema":{"type":"object","required":["slug","name","kind","summary","palette","files"],"properties":{"kind":{"enum":["brand","yc","app","style","theme","component"],"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"files":{"type":"object","properties":{"docs.html":{"type":"string"},"index.html":{"type":"string"},"onboarding.html":{"type":"string"}}},"palette":{"type":"array","items":{"type":"object","required":["name","hex"],"properties":{"hex":{"type":"string"},"name":{"type":"string"}}}},"summary":{"type":"string"},"skill_md":{"type":"string"}}},"logicalName":"add_aesthetic","displayName":"add_aesthetic","title":"add_aesthetic","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"name":"delete_aesthetic","description":"Remove an aesthetic from the encyclopedia entirely (pages, skill doc, manifest, Orrery). Irreversible.","inputSchema":{"type":"object","required":["slug"],"properties":{"slug":{"type":"string"}}},"logicalName":"delete_aesthetic","displayName":"delete_aesthetic","title":"delete_aesthetic","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"name":"encyclopedia_stats","description":"Counts by kind + service health of the ingest API.","inputSchema":{"type":"object","properties":{}},"logicalName":"encyclopedia_stats","displayName":"encyclopedia_stats","title":"encyclopedia_stats","annotations":{"untrustedContentHint":true,"readOnlyHint":true}}],"toolSource":"directory_preview","agentAction":"both","installLinks":[{"id":"cursor","label":"Cursor","href":"cursor://anysphere.cursor-deeplink/mcp/install?name=Aestheta-Design-taste-as-an-API&config=eyJ1cmwiOiAiaHR0cHM6Ly9hZXN0aGV0YS5haS9tY3AifQ%3D%3D"},{"id":"vscode","label":"VS Code","href":"vscode:mcp/install?%7B%22name%22%3A%22Aestheta-Design-taste-as-an-API%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Faestheta.ai%2Fmcp%22%7D"},{"id":"vscode-insiders","label":"VS Code Insiders","href":"vscode-insiders:mcp/install?%7B%22name%22%3A%22Aestheta-Design-taste-as-an-API%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Faestheta.ai%2Fmcp%22%7D"},{"id":"claude-web","label":"Claude.ai","href":"https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Aestheta%3A+Design+taste%2C+as+an+API&connectorUrl=https%3A%2F%2Faestheta.ai%2Fmcp"},{"id":"codex","label":"Codex","copyText":"codex mcp add \"Aestheta-Design-taste-as-an-API\" --url \"https://aestheta.ai/mcp\""},{"id":"chatgpt","label":"ChatGPT","href":"https://www.mcpbundles.com/docs/integrations/chatgpt"}],"catalogUrl":"https://www.mcpbundles.com/api/directory/v1/servers/aestheta-mcp-cffa9d1822","callUrl":"https://www.mcpbundles.com/api/directory/v1/servers/aestheta-mcp-cffa9d1822/tools/{tool}","mcpServerUrl":"https://aestheta.ai/mcp","liveCatalogUrl":"https://www.mcpbundles.com/api/directory/v1/servers/aestheta-mcp-cffa9d1822?live=1"}