Docs · 35 tools · v1.7.3
Status → Search → Fetch → Install.
Every free thing on Aura, one call away. Four calls and you have production markup — then the Bridge and Award layers take you from “free and fast” to “looks award-adjacent.” Free only; assets need a Terms §4 check before commercial use.
01
Status
aura_statusCatalogue health plus live free counts (2,495 components, 193 skills, 30,688 assets, 725 design systems) and a version check against npm. Start every session here — if the catalogue is stale, you'll know before you search.
// no args
aura_status()
// → counts + cache freshness + update notice02
Search
aura_search_allOne call across all four surfaces in parallel — slim rows with facets, full rows on demand. Narrow with aura_search_components / skills / assets / design_systems, aura_categories, aura_recommend or aura_related. Default search falls back with suggestions; pass exact_match:true for an honest empty.
aura_search_all("dark pricing glass")
// → top hits per surface + page URLs
aura_search_all("hover glow button", { exact_match: true })03
Fetch
aura_get_componentFull HTML/Tailwind source + preview + page URL. Skills return the whole SKILL.md; systems return DESIGN.md tokens + preview HTML. full:true skips chunk windows, and aura_bundle / aura_bulk_fetch pull 2–8 items per call — per-item errors never fail the batch.
aura_get_component(732, { full: true })
aura_bundle([732, 1364])
aura_bulk_fetch(["design_system", 1779])04
Install
aura_scaffold_pagePaste-ready plans: aura_install_component / skill / asset (deps, file map, fonts, Terms §4 license note), aura_use_design_system (tokens first, then markup), aura_prompt (2-pass brief) and aura_scaffold_page (tokens + system preview + markup in dependency order).
aura_use_design_system("midnight-glass")
aura_scaffold_page("pricing", { tokens_first: true })The rules of the house.
Five guarantees the server enforces on every call, so agents can trust results without re-checking.
Free only, always
Every search, fetch and install is hard-filtered to the free catalogue upstream — pro items never leak into results.
Honest empties
Default search falls back and says so. exact_match:true returns a truthful zero instead of padding — keep it on for verification.
Slim rows, full on demand
Lists carry facets and characters counts, not bodies. Bodies arrive from fetch tools (full:true, or chunk windows).
Guarded award fetches
Scheme + literal host policy, bounded DNS check, streamed size caps, redirects re-validated. 404 → NOT_FOUND, 429 → no retry.
Labeled evidence
Award results mark live-browser vs static-html evidence, always list evidence gaps and carry a confidence score. Missing data is never proof.
The Bridge — references, fresh docs, icons.
Inspo references, fresh docs, free icons and version checks — the v1.7 layer. Inspo calls are planning-only (no fetch); every hit keeps its license and upstream link.
aura_inspo_recommendBrief → Inspo + Aura call plan. Strict macro gate, palette priority, no fetch.
aura_inspo_componentsInspo component filter → Aura category search + scaffold hint.
aura_inspo_referenceOne Inspo JSX + one Aura component → scoped adapt plan: swaps and files.
aura_inspo_systemInspo tokens vs an Aura DESIGN system → A/B/blend with one system_choice.
aura_inspo_compare2–4 slim Inspo sites → house style + closest Aura system/component queries.
aura_docs_planFresh-docs lookup plan: library + need → Context7 resolve/query + Aura apply steps.
aura_docs_checkPasted code vs fresh docs: verdict current or needs-update, look-preserving fixes.
aura_iconOne free icon as ready SVG — Font Awesome + HackerNoon pixel lib, license on every hit.
aura_versionRunning vs npm-published version, with update_available notice.
Award intelligence — read the winners, then build.
Ranked references, design DNA, blueprints and audits — new in v1.7.2. One loop: rank refs, inspect the DNA, blueprint the build, audit the result, study the motion — all backed by a local corpus you control.
aura_award_searchRanked Awwwards refs across sites, categories, elements or motion — every reason names your word.
aura_award_inspectSource-backed design DNA: palette, tech, elements, awards — with rule-based ideas.
aura_design_blueprintGoal + 2–5 refs → brief, tokens_css, section-matched free components and next_calls.
aura_visual_auditScreenshots and band maps when Chrome runs; labeled static-html estimates otherwise.
aura_motion_studyRuntime motion scans and bounded frame studies — searchable by library or easing.
aura_award_indexLocal award corpus: status, rebuild, resume, refresh, winners and watches.
What the award tools need
- The core loop works with nothing installed — search, inspect and blueprint are pure HTTP + parsing.
- Chrome is optional: live captures, band maps and structure scans via AURA_CHROME_PATH.
- ffmpeg is optional: bounded .webm frame studies via AURA_FFMPEG_PATH.
- Corpus lives in ~/.aura-mcp/awards · polite ~1 req/s · nothing auto-crawls.
- aura_award_index rebuilds ≤ 20 pages per call (maxPages) and resumes unfinished cycles.
Prompts that work.
Copy one, paste it into your agent, watch the loop run.
Call aura_status, then find free glass pricing sections and scaffold one.Use aura_award_search for glassy SaaS refs, then aura_design_blueprint and match free Aura components.Plan fresh Next.js docs with aura_docs_plan, then apply the Aura tokens with aura_use_design_system.