What is the Awwwards MCP server?
awwwards-mcp is a free, open-source MCP server that gives an AI agent design references from Awwwards. It searches sites by color, tag or technology, returns palette and tech stack details, and can capture, map and score any live page, not only Awwwards sites.
awwwards-mcp gives a coding agent a visual reference loop sourced from Awwwards. You ask in plain language for something like dark 3D portfolio sites, and the agent gets real screenshots inline plus structured details for each site.
The README says every capture, census and verification tool also runs on any URL. That turns it from an inspiration search into a tool for studying and rebuilding a live page section by section.
What changes in your agent's output
- Design decisions start from cited references: palette, technologies, design elements and award history for each site.
- A band map lists a page's sections with tag, background, offset and height, which gives the agent a build plan.
- Motion tools record scroll and hover behavior and fingerprint animation libraries such as GSAP.
- A verify tool scores a build against the original for structure and motion, not visual fidelity.
Core install and browser install
The plain npx route is the core path with no browser. Tools that capture or record pages return an install hint there, so the README gives a separate global install with Playwright for the browser-enabled tools.
Who awwwards-mcp is for
Best for
- Front-end developers and designers who want references and measured detail before building a hero or a footer.
- Teams extracting a palette and stack from a reference site with Design Extract MCP alongside it.
- Builders who want a free alternative to paid inspiration libraries, as the README frames it, perhaps with Dembrandt MCP for brand details.
Not for
- Republishing or bulk copying Awwwards screenshots. The README restricts use to personal design inspiration.
- Commercial reuse without your own review of the Awwwards terms.
- A complete element corpus. The README says the corpus is partial after the gallery crawl was retired.
Use it with UiChemy
Use awwwards-mcp to find and study a reference. UiChemy then turns your own design into a WordPress site: Figma to WordPress converts it, and Composer edits the page. Click Get Started on uichemy.com.
Connect Awwwards MCP: Design Inspiration and Site Analysis for AI Agents to your AI client
npx -y awwwards-mcpCheck Node.js
The README requires Node 22.13 or newer. Run
node -vto confirm.Add the server
For Claude Code run
claude mcp add awwwards -- npx -y awwwards-mcp. For Codex CLI runcodex mcp add awwwards -- npx -y awwwards-mcp, or use the TOML above.Other clients
OpenCode and ZCode have their own JSON formats in the README. Any MCP client can run the same npx command.
Add browser tools if needed
npxruns without Playwright, so capture and motion tools return an install hint. Follow the README's global side-by-side install to enable them.Index the gallery
The README recommends building the local index, so search is fast and works offline.
Client configuration
[mcp_servers.awwwards]
command = "npx"
args = ["-y", "awwwards-mcp"]Endpoints and ports
npx -y awwwards-mcpNo API key or accountDaily npm checkOptional auto-update with AWWWARDS_AUTO_UPDATE=1https://awwwards-mcp.vercel.appLinked from the READMEWhat you can do with it
- Natural-language searchFull-text search with stemming and BM25 ranking finds sites by tag, color or technology.
- Design DNAPalette, tech stack, design elements and awards for each site.
- Any-URL analysisCapture, band mapping and motion census work on sites outside Awwwards too.
- Design briefsPick two to five sites and a goal and get a cited Markdown and JSON brief.
- Motion evidenceFilmstrips, easing vocabulary and scroll triggers show how an effect is built.
- Build verificationScore a rebuild for band structure and motion, then iterate.
- Offline after indexingA local index serves search without network calls.
- Project outputThe README describes converting a recreated page into a Vite, Astro or Next.js project.
Tools it exposes
search_sites
Searches by color, tags, technology, award type or free text.
get_site_details
Returns palette, technologies, elements, awards and description for a site.
compare_sites
Compares the design DNA and jury scores of two or three sites.
create_design_brief
Turns selected sites and a project goal into a cited build brief.
capture_live_site
Takes a full-page screenshot of any live URL.
analyze_page_structure
Maps a page's sections, with tag, background, offset and height per band.
record_site_motion
Records a short motion video of scroll and hover behavior.
get_motion_dna
Fingerprints the animation libraries and scroll model of a live URL.
analyze_scroll_map
Lists scroll-driven animations on a page with triggers, easing and duration.
search_elements
Searches the element corpus for footers, heroes, pricing sections and more.
verify_build
Scores a build against a reference for structure and motion.
Frequently asked questions
What is awwwards-mcp?
It is a free, open-source MCP server that gives AI coding agents design inspiration from Awwwards. It searches sites, returns design details and screenshots, and can capture, map and analyze any live URL for studying or rebuilding a page.
How do I install awwwards-mcp?
With Node 22.13 or newer, run npx -y awwwards-mcp through your client's MCP config, for example with claude mcp add awwwards or codex mcp add awwwards. Browser tools need the separate global install described in the README.
Does it need an API key?
No. The README describes the core server as fully offline and free, with no API key or account needed. It checks the npm registry once a day for updates and prints a notice, not an automatic change.
Does it only work with Awwwards sites?
No. Its capture, structure, motion and verification tools run on any URL you give it, including your own staging site. Only the search and design DNA tools depend on the Awwwards index.
What are its limits?
The README says the element corpus is partial, and that verify_build scores structure and motion, not visual fidelity. Capture timing can also change scores between runs, so treat a result as evidence for a diff.
Can I reuse the screenshots in my own site?
The README says the tool is meant for personal design inspiration. Awwwards screenshots remain the property of Awwwards and the credited creators, so do not bulk scrape them or republish them anywhere.
Which AI agents does it support?
The README states that any MCP-compatible coding agent can use it and gives setup for Claude Code, Codex CLI, OpenCode and ZCode. Others can run the same npx command in their MCP config. For browser debugging instead, see Chrome DevTools MCP.


