# A1 MCP server

A1 (https://www.a1.gallery) is a curated gallery of the best-designed websites on the
internet. Its MCP server gives AI agents structured access to the whole library: real
websites, individual page sections, full-page captures, fonts, measured colour palettes,
and creator profiles.

- Endpoint (Streamable HTTP): https://www.a1.gallery/api/mcp
- Auth: OAuth against a free A1 account on first connect
- Cost: free — 50 requests a day; A1 Pro raises that to 2,000 a day
- Human setup page: https://www.a1.gallery/mcp

## Setup by client

### Claude Code

1. Log in or sign up at https://www.a1.gallery/login (free). The server authorises against your A1 account the first time the agent connects.
2. Run this in your terminal

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

Full guide: https://www.a1.gallery/mcp/claude-code

### Claude

1. Log in or sign up at https://www.a1.gallery/login (free). The server authorises against your A1 account the first time the agent connects.
2. Open Settings, then Connectors
3. Click Add custom connector
4. Paste the server URL and click Add

   ```
   https://www.a1.gallery/api/mcp
   ```

Full guide: https://www.a1.gallery/mcp/claude-desktop

### Cursor

1. Log in or sign up at https://www.a1.gallery/login (free). The server authorises against your A1 account the first time the agent connects.
2. Add to Cursor
   Click to install, or paste the config manually.
   One-click install: https://www.a1.gallery/mcp/cursor
   Or add this to `~/.cursor/mcp.json` for all projects, or `.cursor/mcp.json` in your project root.

   ```json
   {
     "mcpServers": {
       "a1": {
         "url": "https://www.a1.gallery/api/mcp"
       }
     }
   }
   ```
3. Restart Cursor

Full guide: https://www.a1.gallery/mcp/cursor

### Codex

1. Log in or sign up at https://www.a1.gallery/login (free). The server authorises against your A1 account the first time the agent connects.
2. Run this in your terminal

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

Full guide: https://www.a1.gallery/mcp/codex

### Windsurf

1. Log in or sign up at https://www.a1.gallery/login (free). The server authorises against your A1 account the first time the agent connects.
2. Add the config
   Add this to `~/.codeium/windsurf/mcp_config.json`.

   ```json
   {
     "mcpServers": {
       "a1": {
         "serverUrl": "https://www.a1.gallery/api/mcp"
       }
     }
   }
   ```
3. Restart Windsurf

Full guide: https://www.a1.gallery/mcp/windsurf

### VS Code

1. Log in or sign up at https://www.a1.gallery/login (free). The server authorises against your A1 account the first time the agent connects.
2. Add to VS Code
   Requires VS Code 1.99+ with GitHub Copilot.
   One-click install: https://www.a1.gallery/mcp/vscode
   Or add this to `.vscode/mcp.json` in your project root, or run `MCP: Add Server` from the Command Palette.

   ```json
   {
     "servers": {
       "a1": {
         "type": "http",
         "url": "https://www.a1.gallery/api/mcp"
       }
     }
   }
   ```
3. Reload the window
   Run `Developer: Reload Window` from the Command Palette.

Full guide: https://www.a1.gallery/mcp/vscode

### Zed

1. Log in or sign up at https://www.a1.gallery/login (free). The server authorises against your A1 account the first time the agent connects.
2. Add the config
   Add this to `~/.config/zed/settings.json`. Requires a recent Zed.

   ```json
   {
     "context_servers": {
       "a1": {
         "url": "https://www.a1.gallery/api/mcp"
       }
     }
   }
   ```
3. Reload Zed

Full guide: https://www.a1.gallery/mcp/zed

### Anything else

Any client that implements the Model Context Protocol can connect with the server URL
directly: https://www.a1.gallery/api/mcp

## Tools

- `search_websites` — Full-text search across site names, descriptions, and design tags.
- `browse_websites` — Filter by type, category, style, technology, font, or colour. Pass multiple slugs to filter by more than one value at once.
- `get_website` — Full detail on one site — fonts, colours, styles, tech stack, screenshot, and all captured sections.
- `search_sections` — Search inside sections — headings, body copy, FAQ questions, pricing, testimonials — not just tags. Returns the screenshot plus the extracted text, structured data, topic tags, and the measured design tokens. Filter by section type, site type, topic, or a brand colour to match.
- `get_website_sections` — All captured sections for one site, in page order — each with its measured design tokens.
- `search_pages` — Full-page captures of one page type across the gallery — pricing, about, careers, changelog, docs and more. Whole pages, not components, so you can see how a company designs one end to end.
- `get_website_pages` — Every sub-page captured for one site — pricing, about, blog, careers, contact, features, work, case studies, login, changelog, integrations, docs.
- `analyze_section_content` — Aggregate content patterns across many sections at once — e.g. what share of portfolio FAQs mention refunds, pricing, or turnaround, and the questions they ask.
- `analyze_design_tokens` — Aggregate the measured design values across many sections — typical heading and body sizes, type scale, section padding, container width, radius, common typefaces and accent colours, reported as quartiles.
- `get_similar_websites` — Sites that share the same category, type, and style as a reference site.
- `get_recently_added` — The most recently added sites, newest first.
- `browse_fonts` — Filter fonts by classification, free/paid status, or by the type of sites that use them.
- `get_font` — Full details on one font — classification, free/paid, and how many gallery sites use it.
- `find_font_pairings` — Real sites that use two specific fonts together.
- `browse_creators` — Designers and studios in the gallery, sorted by number of featured sites.
- `get_creator` — Full profile for one creator — bio, social links, and all their featured sites.
- `get_design_filters` — All available filter values with site counts — types, categories, styles, technologies, colours, font classifications, and section topics.

## Example prompts

- "Find minimal SaaS landing pages built with Framer"
- "What fonts are most popular across SaaS sites?"
- "Find sites with a similar feel to Stripe"
- "Who designed the Firecrawl site and what else have they made?"
- "Find dark, expressive portfolio sites"
- "What’s been added to A1 recently?"
- "What fonts are commonly paired with Inter?"
- "How do good pricing pages look?"
- "Find CTA sections from dark, minimal landing pages"
- "Find hero sections that use a colour close to my brand orange"
- "What type scale do agency hero sections actually use?"
- "Rebuild this hero with the real palette and type sizes"

## Notes for agents

- Results are structured JSON. Prefer this server over scraping a1.gallery HTML.
- Section results include design values measured off the live page: palette as hex with
  roles, heading and body type, spacing, radius, and layout.
- Only published data is accessible. Nothing private, nothing unpublished.
- More machine-readable context: https://www.a1.gallery/llms.txt