Awwwards MCP server
io.github.insane0777/awwwards-mcp·v1.12.0·333 starsFree MCP server giving AI agents design inspiration from Awwwards: search award-winning sites with inline screenshots and extract design DNA.
333 stars1.1k downloads/wk
Reviews
Write oneNobody has reviewed Awwwards MCP yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Awwwards MCP tools (26, 1 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
analyze_bundleBundle forensics for a live page: fetch it once, download its script chunks (script tags, inline scripts, and modulepreload/preload-as-script hints; bounded: ≤40 chunks, 10MB, 1 request/second), save them locally, optionally de-obfuscate with webcrack if installed, and grep keywords across the code. Returns chunk paths + match lines so an agent can read the actual animation mechanism instead of gu
analyze_hover_census:hover interaction census of a live page: counts hover rules, samples up to 20 interactive elements, and reports which CSS properties change on hover with transition duration and easing. Use it to reproduce micro-interactions and verify interaction-state coverage. On mobile the hover loop is skipped and a note is returned. compact=true returns a token-diet summary. Runs on any URL — does not fetch
analyze_page_structureExtract a page's section band map (tag, label, background color, offset, height per band) via a headless browser. Works on live URLs and file:// paths — use it to compare a reference site's structure against your local build.
analyze_scroll_mapPer-element motion census of a live page: what animates, its CSS properties, duration, delay, easing, and what triggered it (GSAP ScrollTrigger, native CSS scroll()/view() timelines, data attributes, SMIL/SVG). Includes svgStrokes list for stroke draw-in effects. Runs on any URL you give it (builds, references) — does not fetch awwwards.com. Run twice (with reducedMotion) to audit prefers-reduced-
analyze_stackFingerprint a page's framework (Next.js/Astro/Nuxt/Remix/SvelteKit/WordPress/Webflow/Framer), CSS framework (Tailwind/Bootstrap), and marker libs from fetched HTML — runs on any URL, one polite request, no browser
build_gsap_stubGenerate a runnable GSAP+ScrollTrigger timeline stub from captured motion evidence (scroll census anims + optional pose grid camera anchors) — pure build from provided JSON, no page fetches
build_pose_stubRender a captured pose grid (pose-grid-v1 from capture_pose_3d) as a standalone scroll-scrubbed three.js stub page: frames preloaded inline, camera path interpolated between snapshot scroll ratios, prefers-reduced-motion static fallback, optional census-derived st/pin/ease suggestions. Pure build — no page fetches, no awwwards.com access.
build_projectConvert a single-file exact rebuild (any local .html, e.g. the rebuild flow's full-page-exact.html) into a runnable Vite, Astro or Next.js project: sections become components, CSS splits per section, gsap timelines re-wire in the framework idiom (useEffect + gsap.context on Next), assets carried. Reads a local file and writes the project dir. Pairs with verify_build: build → convert → verify.
capture_componentSerialize a page component (structure, computed-style tokens, animations) into a portable pack for rebuild tooling. compact=true returns a token-diet summary. Runs on any URL — does not fetch awwwards.com.
capture_live_siteTake a fresh full-page screenshot of a live website URL using a headless browser. Requires the optional playwright dependency.
capture_pose_3dCapture a page's WebGL/canvas 3D pose grid: samples the largest canvas (toDataURL, viewport-screenshot fallback) at up to 10 scroll steps with per-step scroll ratios, for reconstructing scroll-driven 3D camera paths. Runs on any URL — does not fetch awwwards.com. Requires the optional playwright dependency.
compare_sitesCompare the design DNA of 2–3 Awwwards sites: titles, live URLs, palettes, technologies, elements, awards and jury scores. Text only; missing details are fetched and cached. For your own build vs a reference, use verify_build instead.
create_design_briefwrite actionSynthesize a cited design direction from 2–5 Awwwards references
get_elementGet one Awwwards element in full: title, author, built-with stack, media URLs, related elements and the parent award-winning project. Use search_elements first for ids.
get_index_statusRead offline index status: cached site count, progress, last successful finish and error, lock state and freshness. No live requests.
get_motion_dnaGet the Motion DNA of a website: animation stack, ScrollTrigger/pin/scrub counts, easing vocabulary and duration distribution. Live captures append a `censusSummary` block (per-source scroll-census counts) from the same single launch. Serves the corpus first; live-captures unseen URLs (headless browser required).
get_site_detailsGet the design DNA of one Awwwards site: color palette, technologies, design elements, awards, description and inline screenshot. compact=true returns a token-diet summary.
get_site_elementsGet the design-element highlights of one Awwwards site: component-level visuals (3D models, video content, mobile layouts, microcopy) with poster images inline and video URLs.
list_categoriesList the filter taxonomy available on Awwwards: color hexes and tag/technology slugs usable with search_sites.
new_winnersPoll today's new Awwwards winners as a delta against the previous poll: new-entrant cards since the last call (first call seeds the baseline and reports no delta). Poll daily for a winners feed; pairs with watch_site for structured monitoring.
record_site_motionRecord a short motion-through video of a live website — preloader, scroll-triggered and hover/cursor animations — and return an inline filmstrip JPEG plus the .webm path. Requires the optional playwright and ffmpeg-static dependencies. Also writes a Motion Evidence Sheet (keyframes with census-stamped captions, diff masks, cursor-trail overlay, timeline strip) beside the filmstrip.
search_elementsSearch Awwwards' curated element gallery — award-grade UI components (footers, menus, loaders, transitions, micro-interactions…).
search_motionSearch captured Motion DNA records: find sites that pin sections, scrub scroll-driven animation, or run a given animation library. Corpus only — live-capture happens via get_motion_dna.
search_sitesSearch award-winning websites on Awwwards. Returns site cards with inline screenshots, live URLs, awards and tags.
verify_buildCompare a built site against a reference (an Awwwards winner, a client's old site, any URL): band-structure match + motion fingerprint similarity, with a pass/warn/fail verdict and evidence lines. Closes the design loop: build → verify → fix → re-verify. Reference can be an award site found via search_sites, compared read-only via compare_sites.
watch_siteLongitudinal watchlist over Awwwards listings: track a studio (e.g. 'ToyFight'), a tag/technology slug (e.g. 'webgl'), or a site URL-slug for changes and new entries. add/list/remove; the delta is reported by watch_site list after new_winners or search_sites refreshes the listing.
Public scan report
scanner v0.1.10 · 2026-10-25 · same rubric, same numbers if you re-run it
- Code scan40 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 0 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Awwwards MCP compares
Against every graded design MCP server, from our own scans and uptime checks. Updated after each scan run.
What its tools let an agent do: 24 read · 2 create
Install Awwwards MCP in Claude Code, Cursor or VS Code
Runs npx -y awwwards-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add awwwards-mcp -- npx -y awwwards-mcp
What the publisher says
From the Awwwards MCP repository's README, as published. We do not edit it. Read it on GitHub
awwwards-mcp
Free, open-source MCP server that gives AI agents design inspiration from Awwwards — the Mobbin-style visual reference loop, sourced from the web's best award-winning websites.
Your agent searches in natural language ("dark 3D portfolio sites", "soft pastel e-commerce"), sees real screenshots inline, and pulls the design DNA of any site: color palette, tech stack, design elements, award history. Then it goes past inspiration: point it at any link and it band-maps the page, censuses scroll and hover motion (keyframes, measured scrub curves), fingerprints the framework, captures canvas pose grids, and reads the site's bundles when a mechanism is unclear. From that evidence it recreates the page section by section, then converts the build into a runnable Vite, Astro or Next.js project with a measured motion manifest and per-section hooks. Close the loop with verifybuild** (band + motion scoring, measured perf) and generate GSAP timelines from the captured motion.
And it's not just Awwwards websites — every capture, census, and verification tool runs on any URL. Just give it any site link and tell it to recreate: band-map it, study its motion, rebuild section by section, and score your build against the original.
Free-text queries run on a porter-stemmed, prefix-matching FTS5 index with BM25 ranking — "magazines" now finds Magazine-tagged sites (68 on the live index), best matches first, where the old substring path returned zero. Multi-word queries keep AND semantics: every token must hit the same site.
Tools
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Awwwards MCP: common questions
- Is Awwwards MCP server safe?
- Yes, by our scan: it is graded A (92/100). Read the Awwwards MCP safety report
- How do I install Awwwards MCP?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Awwwards MCP need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Awwwards MCP maintained?
- The last commit was 8 days ago (2026-10-25). The latest release is v1.12.0.