Skip to content
appsgit

Awwwards MCP

Awwwards MCP is an MCP server that adds developer tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Free, open-source MCP server that gives AI coding agents (Claude Code, Codex, Cursor, OpenCode, ZCode…) design inspiration from award-winning… It has 788 GitHub stars, is released under the MIT license and runs locally with npx -y awwwards-mcp.

github.com/INSANE0777/Awwwards-mcp (opens in a new tab)

Data as of from the GitHub API; description from the project's repository. Report an error

Install Awwwards MCP

Generated from the server's published package. Replace your-value with your own values.

Claude Desktop

claude_desktop_config.json
{
  "mcpServers": {
    "awwwards-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "awwwards-mcp"
      ]
    }
  }
}

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

Claude Code

claude mcp add --transport stdio awwwards-mcp -- npx -y awwwards-mcp

Cursor

.cursor/mcp.json
{
  "mcpServers": {
    "awwwards-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "awwwards-mcp"
      ]
    }
  }
}

Project file; use ~/.cursor/mcp.json to enable it in every project.

VS Code

.vscode/mcp.json
{
  "servers": {
    "awwwards-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "awwwards-mcp"
      ]
    }
  }
}

Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

Tools (40)

Parsed from the Tools section of the README; check the repository for the current list.

  • search_sites

    Search by color, tags, technology, award type or free-text query; e.g.

  • get_site_details

    Design DNA for one site: palette, technologies, elements, awards, description.

  • compare_sites

    Compare 2–3 sites' design DNA and jury scores as text-only JSON. Uses cached details or fetches missing detail pages.

  • create_design_brief

    Turn 2–5 selected site slugs plus a required project goal into a deterministic, cited build brief.

  • get_index_status

    Read local index count, crawl progress, last success/error, lock state and freshness without network requests.

  • get_index_stats

    Aggregate metrics over the local cache only (zero network). All-time: site count, gallery element count…

  • get_site_elements

    Component-level visuals for one site: each element's poster image inline (3D models, video content, mobile layouts,…

  • list_categories

    Every filter the agent can search by (200+ tags, 27 colors). A legacy cache without technology facets is refreshed on…

  • get_collections

    Browse Awwwards' curated and member collections. No slug lists collections (paginated, ~32 per page, owner/ref on…

  • search_directory

    Browse the Awwwards directory of agencies, studios and freelancers: name, profile slug, location, website and award…

  • get_annual_categories

    Official Annual Awards categories (Site of the Year, Agency of the Year, …) with nominee counts from Awwwards' public…

  • get_annual_nominees

    Nominees in one Annual Awards category, hydrated on demand at 1 request/second (default 10, max 20).

  • get_annual_nominee

    One Annual Awards nominee in full — site: date, description, designBy, country, images/videos; agency: location,…

  • capture_live_site

    Optional: fresh full-page screenshot of any live URL. Waits for load + a settle window with a pre-scroll capped at 80…

  • analyze_page_structure

    Section band map of any page (live URL or local file:// build): tag, background, offset, height per band.

  • record_site_motion

    Optional: short motion-through video of a live URL — preloader, scroll-triggered and hover/cursor animations.

  • search_elements

    Search the element corpus (footer, hero, pricing, 404…) by free text: cached source:"gallery" records plus…

  • get_element

    One element record: title, category, author, built-with stack, related elements and its media URL (image or video)…

  • get_motion_dna

    Runtime motion fingerprint of a live URL: animation libraries, render engines, ScrollTrigger stats (trigger count,…

  • analyze_scroll_map

    Per-element scroll-motion census of any URL: selector path, trigger source (gsap-scrolltrigger / native css scroll &…

  • analyze_hover_census

    Hover-interaction census: extracts :hover rules from stylesheets, then samples up to 20 interactive elements…

  • analyze_bundle

    Bundle forensics for a live page: fetches the page once, downloads its script chunks (script tags, inline scripts, and…

  • analyze_network_capture

    Offline API-surface evidence from a local HAR 1.2 file (a browser DevTools export): requests grouped by method +…

  • audit_url

    Runtime + static performance evidence for any live URL — never a grade.

  • analyze_accessibility

    Accessibility evidence from a live page — explicitly not a WCAG pass/fail.

  • build_project

    Convert a single-file exact rebuild (any local .html, e.g. the rebuild flow's full-page-exact.html) into a runnable…

  • verify_build

    Score a build against a reference site: band-map compare (Dice score) + motion-fingerprint diff (trigger mix,…

  • verify_flow

    Step-aligned interaction-flow comparison: runs the same 1–6 scroll/click/wait steps on a build and a reference URL…

  • capture_component

    Optional: serialize one page component (CSS selector, default header) into a portable component-pack-v1 JSON pack —…

  • export_design_tokens

    Deterministic design-token export from one computed-style capture: colors, typography, spacing, radii, shadows and…

  • analyze_images

    Image-delivery evidence for a live page: totals by format, loading split (lazy/eager/missing), srcset/sizes coverage,…

  • capture_pose_3d

    Hero canvas reference frames → pose-grid-v1; runs on any URL. Samples the page's largest canvas at up to 10 scroll…

  • capture_scene_3d

    Two strict ops. op:"capture" writes a scene-evidence-v1 pack for a WebGL/canvas page: up to 10 checkpoints (scroll…

  • build_pose_stub

    Pose grid → offline three.js+GSAP replay skeleton. Renders a pose-grid-v1 grid as a standalone scroll-scrubbed stub…

  • analyze_stack

    Fingerprint any page's stack from one polite HTML fetch (no browser): framework…

  • build_gsap_stub

    Captured motion evidence → runnable single-file GSAP+ScrollTrigger stub: one timeline per scroll-census anim (trigger,…

  • build_motion_manifest

    Build a motion.manifest.json scaffold from measured evidence: an analyzepagestructure result (bands) + an…

  • build_scene_stub

    Offline Vite + Three.js scaffold from a capturescene3d pack (full profile only).

  • search_motion

    Search previously captured motion-DNA scans by library, scroll model or easing vocabulary — find references by how a…

  • new_winners

    Poll today's freshly-crowned winners (SOTD / Developer Award / Honorable Mention) against a persisted baseline.

About 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.

  • ai-agents
  • awwwards
  • claude-code
  • codex
  • coding-agent
  • cursor
  • design-inspiration
  • mcp
  • mcp-server
  • opencode

FAQ

Awwwards MCP FAQ

Still curious? Email info@appsgit.com.

How do I install the Awwwards MCP MCP server?

Add the command npx -y awwwards-mcp to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.

Is Awwwards MCP free?

The server is open source under the MIT license, so running it is free. It does not declare any required API key.

Is Awwwards MCP actively maintained?

The most recent commit was on Nov 12, 2026. The latest release is v1.19.0, published Nov 11, 2026. appsgit only lists MCP servers with a commit in the last six months.