MCP Tool Reference

9 tools. One design workflow.

Alcheon exposes MCP-compatible tools your AI coding assistant calls for real design DNA from production websites. Tiered from discovery to generation.

Tier 1 — Discovery
list_sites search_sites recommend_sites
Tier 2 — Analysis
get_site_overview get_layout_blueprint get_component_examples
Tier 3 — Generation
synthesize_brief get_section_inspiration
Tier 1 — Discovery

Start here. These tools let you explore what's in the data store before you build anything.

list_sites

List all scraped sites in the data store.

Returns every site slug currently stored in Alcheon, with optional filtering by category. Use this to discover what's available before calling recommend_sites or synthesize_brief.

A formatted list of site slugs with their categories and URLs.
MCP call
// List all sites
list_sites()
Next: Pass a slug to get_site_overview or synthesize_brief.
search_sites

Filter sites by specific design criteria.

Searches the data store by design attributes rather than by project intent. Use when you need sites with a particular visual property (dark theme, Inter font, glassmorphism) rather than AI-curated recommendations.

Name Type Req Description
query string optional Free-text search across aesthetic family, vibe, tone of voice, and originality notes. E.g. "playful", "neobrutalist", "developer-focused".
aesthetic string optional Filter by aesthetic family. E.g. "minimal", "brutalist", "luxe", "playful", "corporate", "editorial".
colorTone "dark" | "light" | "warm" | "cool" optional Filter by overall color temperature or brightness.
hasGradients boolean optional Only show sites that use gradients (true) or do not (false).
industry string optional Filter by industry/category. E.g. "SaaS", "Dev Tools", "AI", "Design", "Fintech", "CMS", "E-commerce".
font string optional Filter by font family name. E.g. "Inter", "Geist", "Satoshi".
Matching site slugs with the relevant attribute highlighted.
MCP call
// Free-text search
search_sites({ query: "dark developer-focused" })

// Structured filters
search_sites({
  industry: "SaaS",
  colorTone: "dark",
  hasGradients: true,
  font: "Inter"
})
Next: Pass results to get_site_overview or synthesize_brief.
recommend_sites

AI-powered: pick the best sites for your project.

The primary starting point for a design workflow. Describe what you're building and Alcheon selects the 3–5 most relevant reference sites, with rationale for each pick. Avoids recently used combinations automatically.

Name Type Req Description
intent string required Describe what you're building: product type, audience, mood, any hard constraints. The more specific, the better the picks.
count number optional Number of sites to recommend. Min: 1, Max: 10. Default: 5.
contrast boolean optional When true, selects sites that oppose each other on a key design axis. Returns a named contrast axis to pass to synthesize_brief. Use after a repetition warning or when you want something unexpected.
Ranked site slugs with rationale. In contrast mode: slugs + a named contrastAxis string.
MCP call
// Standard recommendation
recommend_sites({
  intent: "A dark SaaS dashboard for developer monitoring.
           Target: backend engineers. Dense, data-rich.",
  count: 4
})

// Contrast mode — get opposing sites
recommend_sites({
  intent: "A wellness habit tracker for mindful living",
  contrast: true
})
Next: Pass slugs to synthesize_brief.
Tier 2 — Analysis

Inspect individual sites. Use these when you need to understand a specific site's patterns before or instead of full synthesis.

get_site_overview

Full design DNA for a single site.

Returns the complete extracted design profile for one site: color palette, typography, spacing, motion, section architecture, component patterns, hover philosophy, and more. Use when you want to understand a specific reference before deciding whether to include it in synthesis.

Name Type Req Description
slug string required The site slug to inspect. Use list_sites to find available slugs.
Full structured design profile including palette, typography, gradients, sections, components, and motion system.
MCP call
get_site_overview({ slug: "linear_app" })
Next: Use findings to inform which sites to pass to synthesize_brief.
get_layout_blueprint

Get a statistically-derived section blueprint for a page type.

Returns an ordered section blueprint based on patterns across all scraped sites (no AI synthesis). Use this to understand common section order and composition for landing, pricing, about, docs, dashboard, or blog pages.

Name Type Req Description
pageType "landing" | "pricing" | "about" | "docs" | "dashboard" | "blog" required The page type to generate a blueprint for.
sectionCount number optional Target number of sections. Min: 3, Max: 15. If omitted, derived from data.
Ordered recommended sections with frequency, background treatment, spacing guidance, and common components.
MCP call
get_layout_blueprint({
  pageType: "pricing",
  sectionCount: 7
})
Next: Use the section order to inform synthesize_brief intent, or call get_section_inspiration for one specific section.
get_component_examples

Find sites using a specific component pattern.

Searches across all scraped sites for examples of a given component (cards, modals, nav patterns, pricing tables, etc.) and returns the sites that implement it most distinctively, with notes on their approach.

Name Type Req Description
component string required The component type to search for. E.g. "card", "modal", "pricing table", "feature grid", "testimonial carousel".
maxResults number optional Maximum number of examples to return. Min: 1, Max: 20. Default: 8.
Sites using this component, with descriptions of their implementation approach.
MCP call
get_component_examples({
  component: "pricing table",
  maxResults: 3
})
Next: Pass a slug to get_section_inspiration for targeted AI design guidance, or synthesize_brief to build the full page.
Tier 3 — Generation

The core outputs. These tools generate design briefs, CSS token sets, and section-level design guidance — call them after discovery.

synthesize_brief

Generate a compact design directive + CSS token set from reference sites.

The primary generation tool. Pass 1–10 site slugs and a project intent; Alcheon produces a compact directive-format brief (PALETTE / FONTS / SECTIONS / HERO / TYPOGRAPHY / SPACING / COMPONENTS / MOTION / ICONS / AVOID / NOTES) plus a ready-to-paste CSS :root {} token set. A repetition guard prevents reusing the same site combinations — if triggered, it suggests alternatives.

Name Type Req Description
sites string[] required Array of site slugs to draw from. Min: 1, Max: 10. Use list_sites or recommend_sites to find slugs.
intent string required A description of the UI you're designing: product type, audience, mood, constraints.
emphasize string[] optional Design aspects to emphasize from the reference sites. E.g. ["gradient_hero", "dark_sections", "typography"].
avoid string[] optional Patterns to consciously avoid. E.g. ["stats_section", "hamburger_nav", "dark_hero"].
existingTokens string optional Your current CSS :root { } custom properties. When provided, the brief extends your existing design system rather than generating a new one.
theme "light" | "dark" optional Hard constraint on background mode. The brief always produces a palette in this mode regardless of what the reference sites use. Detect by reading the user's CSS before calling.
contrastAxis string optional Activates contrast mode. Name the design axis on which the reference sites oppose each other (e.g. "spacing density", "colour temperature"). The brief assigns each pole to different surfaces rather than finding consensus.
includeTokens boolean optional Whether to include the CSS :root {} token set in the output. Defaults to true. Set to false when extending an existing design system to reduce output size and leave more context budget for code generation.
force boolean optional Bypass the repetition guard. Only use if the user explicitly requested these specific sites.
Compact directive brief (300–500 words) + synthesized CSS token set + attribution + pattern map divergences.
MCP call
// Standard synthesis
synthesize_brief({
  sites: ["stripe_com", "linear_app", "vercel_com"],
  intent: "A dark monitoring dashboard for DevOps teams.",
  emphasize: ["code_blocks", "dark_sections"],
  avoid: ["stats_section"]
})

// Contrast mode (from recommend_sites contrast output)
synthesize_brief({
  sites: ["zara_com", "ugmonk_com"],
  intent: "A product configurator for DTC brands",
  contrastAxis: "Editorial Generosity"
})

// Extend existing design system
synthesize_brief({
  sites: ["prisma_io"],
  intent: "A pricing page for our existing SaaS product",
  existingTokens: `
    --color-primary: #533AFD;
    --font-sans: Inter, sans-serif;
  `
})
Next: Implement each section's HTML+CSS using the directive brief as a spec. Use get_section_inspiration for deeper guidance on any specific section.
get_section_inspiration

Generate targeted AI design guidance for one section.

Section-level generation tool. Produces a focused brief for one section/component type (hero, pricing, FAQ, testimonials, etc.) using real examples from selected or all sites.

Name Type Req Description
sectionType string required Section/component type. E.g. "hero", "pricing", "FAQ", "feature grid", "CTA banner".
context string optional Optional project context to tailor recommendations. E.g. "A dark developer tool landing page".
sites string[] optional Optional list of specific site slugs to draw from. If omitted, searches all sites.
maxExamples number optional Maximum number of real-world examples to include. Min: 1, Max: 15. Default: 6.
AI-written section brief with layout, color treatment, structure, spacing, and content guidance.
MCP call
get_section_inspiration({
  sectionType: "pricing",
  context: "B2B DevOps product with a dark UI",
  sites: ["linear_app", "stripe_com"],
  maxExamples: 5
})
Next: Implement the section HTML+CSS from the brief, or call synthesize_brief for full-page direction + token set.
Admin

Add new sites to the data store. Requires a valid API key with scraping credits.

scrape_site

Scrape a new site and add it to Alcheon's data store.

Launches a full pipeline scrape of the given URL: screenshots, deep CSS analysis, design DNA extraction, token generation, and database storage. Once complete, the site's slug is available to all other tools. Costs 1 credit per scrape.

Name Type Req Description
url string required The full URL to scrape. E.g. "https://linear.app". Must be a public webpage.
force boolean optional Set to true to re-scrape a site that already exists in the data store.
The generated site slug, confirmation of storage, and a summary of extracted design data.
MCP call
scrape_site({ url: "https://linear.app" })
// Returns slug: "linear_app"
Next: The slug is immediately usable in all other tools.

Ready to start?

Get an API key and connect Alcheon to your AI coding assistant in under 5 minutes.