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_status

Catalogue 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.

aura_status
// no args
aura_status()
// → counts + cache freshness + update notice

02

Search

aura_search_all

One 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
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_component

Full 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
aura_get_component(732, { full: true })
aura_bundle([732, 1364])
aura_bulk_fetch(["design_system", 1779])

04

Install

aura_scaffold_page

Paste-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_scaffold_page
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_recommend

Brief → Inspo + Aura call plan. Strict macro gate, palette priority, no fetch.

aura_inspo_components

Inspo component filter → Aura category search + scaffold hint.

aura_inspo_reference

One Inspo JSX + one Aura component → scoped adapt plan: swaps and files.

aura_inspo_system

Inspo tokens vs an Aura DESIGN system → A/B/blend with one system_choice.

aura_inspo_compare

2–4 slim Inspo sites → house style + closest Aura system/component queries.

aura_docs_plan

Fresh-docs lookup plan: library + need → Context7 resolve/query + Aura apply steps.

aura_docs_check

Pasted code vs fresh docs: verdict current or needs-update, look-preserving fixes.

aura_icon

One free icon as ready SVG — Font Awesome + HackerNoon pixel lib, license on every hit.

aura_version

Running 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_search

Ranked Awwwards refs across sites, categories, elements or motion — every reason names your word.

aura_award_inspect

Source-backed design DNA: palette, tech, elements, awards — with rule-based ideas.

aura_design_blueprint

Goal + 2–5 refs → brief, tokens_css, section-matched free components and next_calls.

aura_visual_audit

Screenshots and band maps when Chrome runs; labeled static-html estimates otherwise.

aura_motion_study

Runtime motion scans and bounded frame studies — searchable by library or easing.

aura_award_index

Local 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.
The full award loop, visualised

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.