A1 Gallery

Search 1,145 real website designs by style, font, colour, section and measured design tokens.

Documentation

A1 Gallery

A1 Gallery MCP server

Curated design references, inside your AI agent.

Docs · Gallery · Privacy


A1 is a hand-curated gallery of real website designs. This MCP server puts it inside your coding agent, so you can ask for a reference and get structured JSON back instead of pasting screenshots and describing what you want.

Every site is captured at full length, split into its interior pages and its individual sections, then measured. You get the type sizes, spacing, radius, container width and palette taken off the rendered page — not guessed from a picture.

In the gallery right now: 1,165 sites · 3,209 captured sections · 2,860 full-page captures · 571 fonts · 517 designers and studios.

Endpoint

URLhttps://www.a1.gallery/api/mcp
TransportStreamable HTTP
AuthOAuth 2.1 with PKCE, dynamic client registration
Registry namegallery.a1/a1-gallery
Tools21 — 19 read-only, 2 that change your own boards

Access is free with an A1 account — 50 tool calls a day. A1 Pro raises that to 2,000 a day with a higher per-minute allowance.

Install

Your client opens a browser to sign in the first time it connects. Per-client instructions with one-click install links are at a1.gallery/mcp.

Claude Code — plugin

The plugin in this repository bundles the server with three skills, three slash commands and a research sub-agent. It teaches the agent how to use the gallery, which the bare connector does not.

/plugin install a1-gallery --marketplace bryntay/a1-mcp

On Claude Code before 2.1.275, add the marketplace first:

claude plugin marketplace add bryntay/a1-mcp
claude plugin install a1-gallery

Then run /mcp and authenticate. See Plugin below for what it adds.

Claude Code — connector only

claude mcp add --transport http a1 --scope user https://www.a1.gallery/api/mcp

Then run /mcp and sign in when it prompts.

Codex CLI

codex mcp add a1 --url https://www.a1.gallery/api/mcp

Cursor and Claude Desktop

{
  "mcpServers": {
    "a1": {
      "url": "https://www.a1.gallery/api/mcp"
    }
  }
}

VS Code (1.99+ with GitHub Copilot)

{
  "servers": {
    "a1": {
      "type": "http",
      "url": "https://www.a1.gallery/api/mcp"
    }
  }
}

Windsurf

{
  "mcpServers": {
    "a1": {
      "serverUrl": "https://www.a1.gallery/api/mcp"
    }
  }
}

Zed (0.168+)

{
  "context_servers": {
    "a1": {
      "url": "https://www.a1.gallery/api/mcp"
    }
  }
}

What you can ask for

  • "Find three brutalist law firm sites and show me their heroes."
  • "What type scale do agency heroes actually use?" — quartiles across every site, not one example.
  • "Show me pricing pages that mention usage-based billing." — full-text search inside the page copy.
  • "What do portfolio FAQs say about refunds?" — extracted Q&A pairs with frequencies.
  • "Rebuild this pricing section." — palette, type, spacing and radius as measured values.
  • "Save the three best ones to a board called Client X." — goes straight to your A1 boards.

Tools

19 tools are read-only and annotated readOnlyHint: true. Two board tools, save_to_board and remove_from_board, change the signed-in person’s own boards and nothing else.

Websites

ToolWhat it does
search_websitesKeyword search across names, descriptions and taxonomy. Resolves aliases — "SaaS", "fintech", "brutalist" map to real taxonomy terms.
browse_websitesFilter-only browsing by type, category, style, technology or colour.
get_websiteEverything for one site: fonts, colours, styles, technologies, creator, sections.
get_similar_websitesInspiration clusters around a given site.
get_recently_addedNewest additions, publish-date descending.
get_design_filtersThe full taxonomy with counts — use it to build valid filters.

Sections

ToolWhat it does
search_sectionsSearch inside section copy — headings, FAQ answers, pricing text, testimonials. Returns the screenshot, the extracted structure and the measured tokens.
get_website_sectionsEvery captured section for one site, in page order.
analyze_section_contentAggregate content patterns across many sections — topic distribution, most common verbatim FAQ questions.
analyze_design_tokensAggregate measured values — p25/median/p75 for heading size, body size, scale ratio, padding, container width, radius, plus common typefaces and accent colours.

Pages

ToolWhat it does
search_pagesOne page type across the whole gallery — every pricing page, every about page. Full-text searchable.
get_website_pagesThe sub-pages captured for one site.

Fonts and creators

ToolWhat it does
browse_fontsFonts by classification, licence, or the category of site using them.
get_fontOne font — classification, licence, description, usage count.
find_font_pairingsReal-world examples of two fonts used together.
browse_creatorsDesigners and studios, filterable by category or style.
get_creatorOne creator: bio, links, featured work.

Boards

ToolWhat it does
list_boardsThe signed-in person’s own A1 boards: name, item count, link, last change.
get_boardThe websites on one of their boards, newest first, paged.
save_to_boardSaves websites by slug to one of their boards, found by id or name. A new name makes a new board. Free plan limits apply.
remove_from_boardRemoves websites from one board. They stay in the person’s saves and other boards.

List tools page with offset, and return total, hasMore and nextOffset.

Full descriptions, parameters and response shapes come back from tools/list.

Plugin

Installing the connector gives an agent 21 tools. It does not tell the agent that analyze_design_tokens answers "how big should this be" better than five screenshots, or that a lowSample flag means stop generalising. The plugin carries that.

Skills

SkillFires when
design-referenceA design question needs evidence — type scale, spacing, palette, or what sites of a kind actually do. Routes to the aggregate tools first, examples second.
section-rebuildRecreating a hero, pricing table or FAQ. Builds from the measured designTokens rather than reading values off the screenshot.
setupFirst connection, or a 401 account_required. Walks through OAuth and the quotas.

Commands

CommandWhat it does
/a1-gallery:referenceReal sites matching a design brief, rephrased into the gallery's taxonomy.
/a1-gallery:tokensMeasured values for a section type, reported as p25–p75 ranges.
/a1-gallery:pairingsSites using a font or a font pairing.

Sub-agent

design-researcher handles open briefs that need several searches — an aggregate pass, a couple of targeted searches, then the values to build with. It returns a brief and never edits files.

Why aggregates use quartiles

analyze_design_tokens reports p25, median and p75 rather than an average. Design values are long-tailed — one site with a 180px hero heading drags the mean somewhere useless.

Narrow slices thin out fast. Ask for pricing sections on shops and you may be looking at a handful of examples. When that happens the response carries lowSample: true and reports raw counts instead of percentages, so the agent can say "here are four examples" rather than inventing a norm.

Notes

Site descriptions and section copy are third-party website content. The tool descriptions flag them as untrusted external data.

This repository holds the manifest and the docs. The server itself is closed-source and hosted at a1.gallery.

Support

Issues and questions: open an issue or email hello@a1.gallery.