aura-components-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| AURA_RETRIES | No | Optional tuning environment variable. Number of retries. | 2 |
| AURA_MAX_LIMIT | No | Optional tuning environment variable. Maximum result limit. | 25 |
| AURA_CODE_CHARS | No | Optional tuning environment variable. Character limit for code content. | 12000 |
| AURA_TIMEOUT_MS | No | Optional tuning environment variable. Request timeout in milliseconds. | 12000 |
| AURA_CACHE_TTL_MS | No | Optional tuning environment variable. Cache TTL in milliseconds (0 disables). | 60000 |
| AURA_CONTENT_CHARS | No | Optional tuning environment variable. Character limit for content. | 12000 |
| AURA_DEFAULT_LIMIT | No | Optional tuning environment variable. Default result limit. | 10 |
| AURA_FREE_ONLY_DEFAULT | No | Optional tuning environment variable. Whether results default to free-only. | true |
| AURA_SUPABASE_ANON_KEY | No | If Aura rotates its public key, set AURA_SUPABASE_ANON_KEY and rebuild; nothing else changes. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| aura_statusA | Catalogue health plus free counts (components, skills, assets, design systems). Free only, no login. Start here. |
| aura_search_componentsA | Search free Aura UI components (2,495). Text over title and description, optional category tag, theme dark|light filter, negative_theme exclusion, min_views floor, sorts. Slim rows by default (excerpt + fetch pointer, no full code; slim:false for full). exact_match:true skips fallbacks (honest empty). |
| aura_get_componentA | Full free component detail with HTML/Tailwind source, preview image, page URL. Numeric id or slug. Chunk param pages large code (see code_info). full:true returns full code (ignores chunk). |
| aura_search_skillsA | Search free Aura agent skills (192). Metadata only, slim by default; use aura_get_skill for the full SKILL.md content. exact_match:true skips fallbacks. |
| aura_get_skillC | Full free agent-skill content (SKILL.md body) plus source_url and page URL. Skill id. Chunk param pages large bodies (see content_info). |
| aura_search_assetsC | Search free Aura assets (images and video). Keywords, media_type image or video. Slim rows by default. exact_match:true skips fallbacks. |
| aura_search_design_systemsA | Search free Aura DESIGN.md systems (725). Metadata + snippets, slim by default; use aura_get_design_system for content. exact_match:true skips fallbacks. |
| aura_get_design_systemB | Full free DESIGN.md content plus preview_html, tokens, and page URL. System id or slug. Chunk param pages large preview_html (see preview_info). |
| aura_search_allA | One call across components, skills, assets, and design systems in parallel. Free only. Slim rows by default (excerpts, no blobs). Each surface runs its own fallback pipeline, so mixed outcomes are normal (skills may fall back while components go honestly empty) — read isFallback/no_match per surface, not once globally. |
| aura_recommendB | Starter kit for a goal: top 3 free hits per surface with page URLs and rationale. Slim rows + commercial-use note. Empty components auto-retry once via suggested_queries, then editorial picks. |
| aura_install_componentB | Paste-ready setup for a free component: dependency list, setup steps, file map, fonts. Goes beyond the official Aura MCP, which only reads project source. |
| aura_install_skillC | Save-and-load plan for a free skill: where to put SKILL.md per client plus upstream source. |
| aura_use_design_systemC | Apply a free DESIGN.md system: token starter CSS plus copy order (tokens first, then markup). |
| aura_bundleB | Bulk-fetch 2-8 component details in one call (ids or slugs). Per-item errors never fail the batch. |
| aura_scaffold_pageB | One ordered page build: DESIGN.md tokens.css + system preview + component markup in dependency order, combined deps + files[]. Merges install_* + use_* in a single turn. components accepts string|number|{id}|{slug} refs, e.g. ["732","1364"] or [{id:"732"}] or [{slug:"..."}]; full:true returns full bodies. |
| aura_relatedB | More-like-this: 3 related items for a component/skill/design-system by tag + text overlap. Discovery never dead-ends. |
| aura_bulk_fetchA | Bulk-fetch 2-8 details in one call for components, design_systems, or assets. Alias-friendly name for aura_bundle. Per-item errors never fail the batch. |
| aura_install_assetC | Legal drop-in plan for an asset: direct download URL, preview URL, license (all-rights-reserved per Aura Terms §4 — check page before commercial use), suggested file path. |
| aura_categoriesA | The 13 component categories with live free counts. Pick one, then search within it. |
| aura_promptA | Need-based design prompt in 2 passes: Pass 1 (goal only) returns draft + 6 questions (theme, sections, system, assets, macrostructure, vibe — mode folds into theme); ask the user via native question UI, then Pass 2 (goal + answers) returns copy-paste final_prompt + plan order + suggested calls starting at inspo.recommend. Always confirm with user before scaffolding. |
| aura_inspo_recommendA | Map a brief onto Inspo + Aura calls (pure, no fetch). Strict macro gate: without macrostructure returns need_macro:true — run inspo.recommend first, never scaffold generic. With macro returns inspo_call + 3 aura_calls + palette priority (brand > Inspo > Aura). |
| aura_inspo_componentsC | Map an Inspo component filter onto Aura search (pure). evidence.type hero|pricing|features|cta|nav|footer|testimonial|logo-cloud|faq|stat plus style/macrostructure/mode. Returns inspo.find_components call + aura_search + scaffold_hint (tokens first, weight s|m). |
| aura_inspo_referenceB | Adapt one Inspo reference JSX onto one Aura component (pure). evidence {type, id} + aura_component {id|slug}. Returns inspo.get_reference_jsx + aura_get_component calls plus scoped adapt_plan (token swaps, css scope, files). |
| aura_inspo_systemB | Resolve Inspo tokens vs Aura DESIGN system (pure). inspo_tokens {palette, fonts, background?, text?, brand_hex?} + aura_system slug. Returns option A (Inspo) vs B (Aura fetch) vs C (blend) plus one system_choice question payload (A-inspo|B-aura|C-blend) and contrast warning. Tokens first. |
| aura_inspo_compareC | Triangulate a house style from 2-4 slim Inspo sites (pure). evidence[] of {slug, palette?, fonts?, macrostructure?, mode?} — slim keys only, no autopsy. Returns inspo.compare call + closest Aura system/component queries. |
| aura_docs_planB | Plan a fresh-docs lookup (pure, no fetch). library + need -> Context7 resolve/query plan (trusted: tailwind, gsap, lenis, iconify) + apply steps for Aura files + docs stamp slot. The agent calls Context7, Aura shapes the rest. |
| aura_docs_checkB | Check pasted code against fresh docs (pure). library + code_excerpt (under 20000 chars, excerpts not full pages) + optional docs_note -> verdict current|needs-update, look-preserving fixes, version-pin needs_check. Fresh API wins, look stays identical. |
| aura_iconA | Fetch one free icon as ready-to-paste SVG (live). name in kebab-case (bolt, arrow-down). source auto|fontawesome|pixel, style auto|solid|regular|brands. Auto-fallback across styles then libraries; every hit carries license + credit (CC BY 4.0, credit always) plus a font/CSS alternative. 24h icon cache. |
| aura_versionA | Running vs npm-published version (live, hourly cache). Returns update_available + notice telling the agent to prefer latest (npm i -g aura-components-mcp@latest) when behind. Never fails — offline registries return latest:null. aura_status already carries this verdict on every call. |
| aura_award_searchB | Search award-winning website references (Awwwards). Modes: sites (ranked refs with preview links), categories (real taxonomy from the index/source), elements (hero/nav/pricing/footer examples), motion (previously recorded motion studies). Local index first, one polite live refresh when empty. |
| aura_award_inspectB | Inspect award refs: site_details (palette/tech/awards/evidence), site_elements (section visuals with media URLs), element (one gallery record), compare_sites (2-3 refs: shared vs gaps, missing marked unknown). |
| aura_design_blueprintC | Evidence-backed build plan from 2-5 award refs + goal: Markdown brief + versioned JSON, mapped to real free Aura components/systems (free-only enforced, failures marked unavailable). Never copies third-party source. |
| aura_visual_auditB | Capture/analyze a reference or your build. Modes: capture (real browser screenshot), structure (section band map: live-dom or static-html), compare (reference vs build mismatches). Needs Chrome for live capture; honest BROWSER_UNAVAILABLE otherwise. Loopback only with allowLocal:true. |
| aura_motion_studyB | Evidence-backed motion guidance. Modes: inspect (live runtime scan: libs/easing/scroll), record (bounded frame study; .webm only when ffmpeg present), search (stored studies by library/easing/scroll). Never claims unobserved library state. |
| aura_award_indexB | Local award corpus: status (counts/freshness/lock), rebuild/resume/refresh (bounded polite crawl), new_winners (baseline then delta), watch_add/list/remove (studio/tag/url watches). Never auto-crawls on startup. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 35 tools
Four family clusters (aura_inspo_*, aura_award_*, aura_search/get pairs) are mostly distinct, and descriptions do a lot of boundary-setting. However aura_bulk_fetch is an explicit alias of aura_bundle, and install vs scaffold vs use_design_system overlap enough that an agent could misselect. With 35 tools, several boundaries (recommend vs search_all, install_component vs scaffold_page) require careful reading.
Every tool uses the aura_ prefix in lowercase snake_case, with clear verb_noun names (aura_search_components, aura_get_component, aura_install_skill). Minor deviations are noun-only names (aura_status, aura_categories, aura_icon, aura_version) and namespace prefixes (inspo/award/docs), but the convention stays readable and predictable overall.
35 tools is well above the 25+ threshold, and the surface sprawls across roughly a dozen sub-domains (components, skills, assets, systems, awards, motion, docs, inspo, audit). The redundant aura_bundle/aura_bulk_fetch alias confirms some tools do not each earn a distinct place.
Coverage is broad and coherent for a read-only catalog: search+get+install for components/skills/systems/assets, plus aggregators (search_all, recommend, related, bundle), awards, motion, docs, and visual audit. Minor gaps like no dedicated asset detail/detail-get tool exist, but core discovery-to-scaffold workflows are complete.