← all repositories
INSANE0777/Awwwards-mcp

An MCP server that teaches your agent taste

Awwwards-mcp gives AI coding agents a Mobbin-style visual reference loop — search award-winning sites, extract their design DNA, then recreate any page section by section.

★519 stars TypeScript Coding AssistantsCreative · Design
Awwwards-mcp
Collecting fresh signals — velocity needs a few days of history.
collecting data…
star history

What it does

It’s a free, no-API-key MCP server that plugs AI coding agents (Claude Code, Codex, Cursor, OpenCode, ZCode) into Awwwards’ catalog of award-winning websites. Your agent searches in natural language — “dark 3D portfolio sites” — sees real screenshots inline, and pulls a site’s design DNA: palette, tech stack, elements, award history. Beyond browsing, it can point at any URL, band-map the page’s sections, census its scroll and hover motion, and rebuild it as a runnable Vite, Astro, or Next.js project.

The interesting bit

The motion tooling is unusually forensic: record_site_motion produces not just a video but a Motion Evidence Sheet — keyframes, frame-diff masks, onion-skin composites, cursor trails — a document a model can actually read. And analyze_scroll_map can re-drive a page through scroll steps to sample real scrub curves, giving the agent a measured motion recipe rather than a guess. A verify_build tool then scores your rebuild against the original’s structure and motion.

Key highlights

  • Free-text search over a local FTS5 index with BM25 ranking and porter stemming — “magazines” finds Magazine-tagged sites, not zero results
  • capture_live_site handles hostile pages: capped pre-scrolls, preloader detection, inner-scroller fallbacks, mobile viewports
  • Works on any URL, not just Awwwards sites — every capture, census, and verification tool is URL-agnostic
  • Batch site details, design briefs with citations, and a directory of agencies/studios with 7-day local caches
  • Runs fully offline for index status and stats; no API key required anywhere

Caveats

  • Several tools (capture, structure analysis, motion recording) need Playwright, and motion recording also needs ffmpeg — heavier than a pure-API MCP server
  • Explicitly personal, non-commercial use; media URLs are reference-only and nothing is downloaded
  • The tool surface is large (20+ tools with many options); the README itself is dense enough to suggest a learning curve

Verdict

If you use an AI agent to build websites and are tired of it defaulting to the same three Tailwind templates, this is worth a look. If you don’t work with visual web design, there’s nothing here for you.

Frequently asked

What is INSANE0777/Awwwards-mcp?
Awwwards-mcp gives AI coding agents a Mobbin-style visual reference loop — search award-winning sites, extract their design DNA, then recreate any page section by section.
Is Awwwards-mcp open source?
Yes — INSANE0777/Awwwards-mcp is open source, released under the MIT license.
What language is Awwwards-mcp written in?
INSANE0777/Awwwards-mcp is primarily written in TypeScript.
How popular is Awwwards-mcp?
INSANE0777/Awwwards-mcp has 519 stars on GitHub.
Where can I find Awwwards-mcp?
INSANE0777/Awwwards-mcp is on GitHub at https://github.com/INSANE0777/Awwwards-mcp.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.