# aura-components-mcp > Every free thing on Aura, one call away. aura-components-mcp v1.7.3 is a free, zero-dependency MCP server (MIT, by swastiksingh-dev, not affiliated with Aura). It fronts the Aura catalogue: 2,495 components, 193 skills, 30,688 assets, 725 design systems — plus Awwwards-grade award intelligence — through 35 exact tools. Tools return free items only, slim rows by default, full source on fetch. - Site: [aura-components-mcp.vercel.app](https://aura-components-mcp.vercel.app/) - Repo: [swastiksingh-dev/Aura-Components-MCP](https://github.com/swastiksingh-dev/Aura-Components-MCP) - npm: [aura-components-mcp](https://www.npmjs.com/package/aura-components-mcp) ## Fast facts (for citation) - What: a free MCP server that puts the free Aura catalogue inside AI agents — search, fetch, install and scaffold. - Version: 1.7.3 · License: MIT (server code) · Price: free, no account, no keys, no paid tiers. - Requirements: Node >= 22 · zero runtime dependencies · stdio transport. - Catalogue: 2,495 components · 193 skills · 30,688 assets · 725 design systems — free items only. - Tools: 35 across Find, Fetch, Install & Build, Bridge, Award Intelligence. - Health check: call `aura_status` (expects the counts above + the version). - Last reviewed: 2026-10-18. ## Install (always newest) ```bash npx -y aura-components-mcp@latest ``` Requires Node >= 22 (CI matrix 22.x / 24.x). Zero runtime dependencies. ## Configure per client ### Claude Code (fastest: CLI, no restart) ```bash claude mcp add aura-components -- npx -y aura-components-mcp@latest ``` Manual project file `.mcp.json`: ```json { "mcpServers": { "aura-components": { "command": "npx", "args": ["-y", "aura-components-mcp@latest"] } } } ``` Verify: `claude mcp list`. Project `.mcp.json` needs one interactive approval. ### Cursor (fastest: one-click link) Cursor install link (name=aura-components, base64 stdio config): ```text cursor://anysphere.cursor-deeplink/mcp/install?name=aura-components&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImF1cmEtY29tcG9uZW50cy1tY3BAbGF0ZXN0Il19 ``` Manual: `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (project), same `mcpServers` block as Claude Code. Toggle in Customize sidebar, else restart. ### VS Code (note: key is `servers`, not `mcpServers`) ```bash code --add-mcp "{\"name\":\"aura-components\",\"command\":\"npx\",\"args\":[\"-y\",\"aura-components-mcp@latest\"]}" ``` Manual `.vscode/mcp.json`: ```json { "servers": { "aura-components": { "type": "stdio", "command": "npx", "args": ["-y", "aura-components-mcp@latest"] } } } ``` Accept the trust dialog, start via `MCP: List Servers`. No restart needed. ### Codex (`~/.codex/config.toml`) ```toml [mcp_servers.aura-components] command = "npx" args = ["-y", "aura-components-mcp@latest"] ``` ### OpenCode (`opencode.json`) ```json { "mcp": { "aura-components": { "type": "local", "command": ["npx", "-y", "aura-components-mcp@latest"], "enabled": true } } } ``` ### Windsurf File `~/.codeium/windsurf/mcp_config.json`, `mcpServers` block (same as Claude Code). Add via Cascade panel → MCPs icon → Install → View Raw Config. ### Roo Code Settings → MCP Servers → Edit Global MCP — paste the `mcpServers` block into `mcp_settings.json`, then toggle the server on. ### Cline Panel → MCP Servers icon → Configure tab → Configure MCP Servers, paste the `mcpServers` block (may include `"disabled": false, "autoApprove": []`). CLI wizard alternative: `cline mcp`. Per-server restart/toggle, no full restart. ## Pricing Free, full stop. The server is MIT open source and scoped to the free catalogue; there are no tiers, trials or accounts. Catalogue art remains all-rights-reserved per Aura Terms §4 — check the `page_url` each tool returns before commercial use. Machine-readable copy: [pricing.md](https://aura-components-mcp.vercel.app/pricing.md). ## Verify it works Call `aura_status` — expect 2,495 components, 193 skills, 30,688 assets, 725 design systems, version v1.7.3. ## The loop (beginner rule) ```text status → search-all → get-one → install-one ``` ```text aura_status aura_search_all "dark cinematic portfolio" aura_get_component 732 aura_install_component 732 ``` Never fetch everything up front: lists stay tiny, details load for finalists. ## The award loop (v1.7.2+, six tools) ```text aura_award_search "glassy saas" → aura_award_inspect aura_design_blueprint { goal, refs } → aura_visual_audit → aura_motion_study ``` Ranked references carry match reasons; blueprints return brief, tokens_css, section-matched free Aura components and next_calls. Chrome and ffmpeg are optional — without them, estimates are labeled static-html, never presented as live captures. The local corpus lives under ~/.aura-mcp/awards with polite fetching (~1 req/s, page caps 1–20). ## All 35 tools (5 groups) Find (9): aura_status, aura_search_components, aura_search_skills, aura_search_assets, aura_search_design_systems, aura_search_all, aura_recommend, aura_categories, aura_related. Fetch (5): aura_get_component, aura_get_skill, aura_get_design_system, aura_bundle, aura_bulk_fetch (2–8 ids per call). Install & Build (6): aura_install_component, aura_install_skill, aura_install_asset, aura_use_design_system, aura_prompt, aura_scaffold_page. Bridge (9): aura_inspo_recommend, aura_inspo_components, aura_inspo_reference, aura_inspo_system, aura_inspo_compare, aura_docs_plan, aura_docs_check, aura_icon, aura_version. Award Intelligence (6): aura_award_search, aura_award_inspect, aura_design_blueprint, aura_visual_audit, aura_motion_study, aura_award_index. ## Pages - [Home](https://aura-components-mcp.vercel.app/) — start here - [Tools](https://aura-components-mcp.vercel.app/tools) — all 35, exact names - [Flow](https://aura-components-mcp.vercel.app/flow) — how it works + with/without comparison - [Awards](https://aura-components-mcp.vercel.app/awards) — award intelligence explainer - [Showcase](https://aura-components-mcp.vercel.app/showcase) — glass themes + starter kit - [Setup](https://aura-components-mcp.vercel.app/setup) — per-client configs - [Docs](https://aura-components-mcp.vercel.app/docs) — status → search → fetch → install - [FAQ](https://aura-components-mcp.vercel.app/faq) - [Versions](https://aura-components-mcp.vercel.app/versions) — live npm feed - [License](https://aura-components-mcp.vercel.app/license) - [llms.txt](https://aura-components-mcp.vercel.app/llms.txt) — this file - [pricing.md](https://aura-components-mcp.vercel.app/pricing.md) — machine-readable ## Site notes for agents - The site supports dark and light themes (toggle persists via localStorage). ## License notes for agents - Server code: MIT. Catalogue art (components, skills, systems, assets): all-rights-reserved per Aura Terms §4 — prototype freely, confirm the `page_url` every tool returns before commercial use. - Catalogue credit: Aura / Meng To.