INSANE0777/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
| Tool | What it does |
| searchsites | Search by color, tags, technology, award type or free-text query; e.g. award: "soty", award: "nominees", award: "ecommerce" (winners), or a technology alias like technology: "nextjs" which canonicalizes to the live slug. Multi-word queries match against the local FTS5 index and rank BM25 (title hits lead); zero results come with loose-match and taxonomy-tag hints. Default full results include each site's screenshot; use responseMode: "compact" for concise cards and inline previews of only the first two results on the requested page. |
| getsitedetails | Design DNA for one site: palette, technologies, elements, awards, description. Batch (slugs, up to 10) is compact enrichment for a shortlist — compactSiteDetails per slug (lists as counts, ≤500-char description, awards), cached/fetched/error status, no inline images. |
| comparesites | Compare 2–3 sites' design DNA and jury scores as text-only JSON. Uses cached details or fetches missing detail pages. |
| createdesignbrief | Turn 2–5 selected site slugs plus a required project goal into a deterministic, cited build brief. Uses cached detail/element evidence and cached Motion DNA first, fetches only missing details, returns Markdown plus versioned JSON, and runs browser band analysis only with includeStructure: true. |
| getindexstatus | Read local index count, crawl progress, last success/error, lock state and freshness without network requests. |
| getindexstats | Aggregate metrics over the local cache only (zero network). All-time: site count, element count and technology/tag frequency (items[].tag). Windowed by windowDays (default 90, 1–3650): cached details, palette colour frequency and jury score stats (n/avg/median) from at most the 500 most recently fetched detail rows, plus Motion DNA library frequency. Coverage is labelled "locally cached subset" on every metric; windowDays/detailsCached/detailParseCap appear only on the windowed metrics, while sites/elements/technologies are explicitly all-time. top caps each frequency list (default 10, 1–50). Aggregates only — no site slugs or titles. Personal, non-commercial use. |