A1 Gallery

---

A1 é uma galeria selecionada à mão de designs de sites reais. Este servidor MCP a coloca dentro do seu agente de codificação, para que você possa pedir uma referência e receber JSON estruturado de volta, em vez de colar capturas de tela e descrever o que você quer.

Cada site é capturado em comprimento total, dividido em suas páginas internas e suas seções individuais, e depois medido. Você obtém os tamanhos de fonte, espaçamentos, raio, largura do contêiner e paleta extraídos da página renderizada — não adivinhados a partir de uma imagem.

Na galeria agora: 1.165 sites · 3.209 seções capturadas · 2.860 capturas de página inteira · 571 fontes · 517 designers e estúdios.

Endpoint

URL	https://www.a1.gallery/api/mcp
Transporte	HTTP Streamable
Autenticação	OAuth 2.1 com PKCE, registro dinâmico de clientes
Nome no registro	gallery.a1/a1-gallery
Ferramentas	17, todas somente leitura

O acesso é gratuito com uma conta A1 — 50 chamadas de ferramenta por dia. A1 Pro aumenta isso para 2.000 por dia, com uma cota maior por minuto.

Instalação

Seu cliente abre um navegador para você fazer login na primeira conexão. Instruções por cliente com links de instalação em um clique estão em a1.gallery/mcp.

Claude Code — plugin

O plugin neste repositório agrupa o servidor com três skills, três comandos de barra e um sub-agente de pesquisa. Ele ensina o agente a usar a galeria, o que o conector básico não faz.

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

Em seguida, execute /mcp e autentique-se. Veja Plugin abaixo para saber o que ele adiciona.

Claude Code — apenas conector

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

Em seguida, execute /mcp e faça login quando solicitado.

Codex CLI

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

Cursor e Claude Desktop

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

VS Code (1.99+ com 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"
    }
  }
}

O que você pode pedir

• "Encontre três sites de escritórios de advocacia brutalistas e mostre-me os heróis deles."
• "Qual escala tipográfica os heróis de agências realmente usam?" — quartis em todos os sites, não apenas um exemplo.
• "Mostre-me páginas de preços que mencionam cobrança baseada em uso." — busca em texto completo dentro do conteúdo da página.
• "O que os FAQs de portfólios dizem sobre reembolsos?" — pares de perguntas e respostas extraídos com frequências.
• "Reconstrua esta seção de preços." — paleta, tipografia, espaçamento e raio como valores medidos.

Ferramentas

Todas as 17 ferramentas são somente leitura e anotadas como readOnlyHint: true.

Sites

Ferramenta	O que faz
search_websites	Busca por palavras-chave em nomes, descrições e taxonomia. Resolve aliases — "SaaS", "fintech", "brutalista" mapeiam para termos reais da taxonomia.
browse_websites	Navegação somente com filtros por tipo, categoria, estilo, tecnologia ou cor.
get_website	Tudo sobre um site: fontes, cores, estilos, tecnologias, criador, seções.
get_similar_websites	Clusters de inspiração em torno de um site específico.
get_recently_added	Adições mais recentes, data de publicação decrescente.
get_design_filters	A taxonomia completa com contagens — use-a para construir filtros válidos.

Seções

Ferramenta	O que faz
search_sections	Busca dentro do conteúdo das seções — títulos, respostas de FAQ, textos de preços, depoimentos. Retorna a captura de tela, a estrutura extraída e os tokens medidos.
get_website_sections	Todas as seções capturadas de um site, em ordem de página.
analyze_section_content	Padrões de conteúdo agregados em muitas seções — distribuição de tópicos, perguntas de FAQ verbatim mais comuns.
analyze_design_tokens	Valores medidos agregados — p25/mediana/p75 para tamanho de título, tamanho do corpo, proporção de escala, padding, largura do contêiner, raio, além de tipografias comuns e cores de destaque.

Páginas

Ferramenta	O que faz
search_pages	Um tipo de página em toda a galeria — todas as páginas de preços, todas as páginas "sobre". Pesquisável em texto completo.
get_website_pages	As subpáginas capturadas de um site.

Fontes e criadores

Ferramenta	O que faz
browse_fonts	Fontes por classificação, licença ou categoria do site que as usa.
get_font	Uma fonte — classificação, licença, descrição, contagem de uso.
find_font_pairings	Exemplos do mundo real de duas fontes usadas juntas.
browse_creators	Designers e estúdios, filtráveis por categoria ou estilo.
get_creator	Um criador: biografia, links, trabalhos em destaque.

Descrições completas, parâmetros e formatos de resposta vêm de tools/list.

Plugin

Instalar o conector dá ao agente 17 ferramentas. Ele não informa ao agente que analyze_design_tokens responde "quão grande isso deveria ser" melhor do que cinco capturas de tela, ou que um sinalizador lowSample significa parar de generalizar. O plugin carrega isso.

Skills

Skill	Dispara quando
design-reference	Uma pergunta de design precisa de evidências — escala tipográfica, espaçamento, paleta ou o que sites de um tipo realmente fazem. Roteia primeiro para as ferramentas agregadas, depois para exemplos.
section-rebuild	Recriar um herói, tabela de preços ou FAQ. Constrói a partir do designTokens medido, em vez de ler valores da captura de tela.
setup	Primeira conexão ou um 401 account_required. Explica o OAuth e as cotas.

Comandos

Comando	O que faz
/a1-gallery:reference	Sites reais que correspondem a um briefing de design, reformulados na taxonomia da galeria.
/a1-gallery:tokens	Valores medidos para um tipo de seção, relatados como intervalos p25–p75.
/a1-gallery:pairings	Sites que usam uma fonte ou uma combinação de fontes.

Sub-agente

design-researcher lida com briefings abertos que precisam de várias buscas — uma passada agregada, algumas buscas direcionadas e depois os valores para construir. Ele retorna um briefing e nunca edita arquivos.

Por que os agregados usam quartis

analyze_design_tokens relata p25, mediana e p75 em vez de uma média. Os valores de design têm cauda longa — um site com um título de herói de 180px arrasta a média para algum lugar inútil.

Fatias estreitas diminuem rapidamente. Peça seções de preços em lojas e você pode estar olhando para um punhado de exemplos. Quando isso acontece, a resposta carrega lowSample: true e relata contagens brutas em vez de porcentagens, para que o agente possa dizer "aqui estão quatro exemplos" em vez de inventar uma norma.

Notas

Descrições de sites e conteúdo de seções são conteúdo de terceiros. As descrições das ferramentas os sinalizam como dados externos não confiáveis.

Este repositório contém o manifesto e a documentação. O servidor em si é de código fechado e hospedado em a1.gallery.

Suporte

Problemas e perguntas: abra uma issue ou envie um e-mail para hello@a1.gallery.