brandfetch MCP

Servidor MCP para conectar aos serviços da Brandfetch

Documentação

Servidor MCP Brandfetch

O Model Context Protocol oficial para Brandfetch. Ele dá aos assistentes de IA acesso a busca de marcas, dados de empresas, logotipos e recursos de design, e contexto de marca pronto para LLM a partir da API Brandfetch.

Saiba mais: https://brandfetch.com/developers/mcp
Documentação completa: https://docs.brandfetch.com/mcp/overview

Ferramentas

Ferramenta	Descrição
`brand_search`	Busque marcas por nome usando o índice de busca da Brandfetch.
`get_brand`	Consulte dados completos da marca por domínio, e-mail, ticker, ISIN ou símbolo de criptomoeda; renderiza o cartão de marca interativo em hosts MCP Apps.
`get_brand_data`	Os mesmos dados da marca sem cartão — para murais de logotipos, trabalhos com várias marcas e dados que alimentam conteúdo gerado.
`enrich_transaction`	Identifique uma marca de comerciante a partir de uma string de cartão de crédito ou extrato bancário.
`get_brand_context`	Obtenha contexto de marca pronto para LLM para um domínio — voz, público, posicionamento, estilo.
`build_logo_urls`	Construa URLs do CDN de Logotipos da Brandfetch para uma ou mais marcas (sem chamada de API).
`send_feedback`	Reporte bugs, dados de marca incorretos ou desatualizados, ou recursos ausentes à Brandfetch.

Cartão de marca interativo (MCP Apps)

Em hosts que suportam a extensão MCP Apps (claude.ai, Claude Desktop, ...), os resultados de get_brand são renderizados como um cartão de marca interativo: pré-visualização do logotipo, seletor de formato (SVG/PNG/WebP/...), ações de download e copiar URL. Hosts sem suporte a Apps usam o resultado JSON padrão da ferramenta. get_brand_data retorna os mesmos dados da marca sem o cartão, então um mural de logotipos com seis marcas é seis chamadas de dados em vez de seis cartões; o modelo escolhe entre os dois pelas descrições. O código-fonte do widget está em ui/ e é servido pelo servidor como o recurso ui://brandfetch/brand-card.html.

Início rápido (servidor hospedado)

A maneira mais fácil de usar este servidor é conectar-se ao endpoint hospedado pela Brandfetch — sem instalação, sem infraestrutura:

https://mcp.brandfetch.io/mcp

A autenticação usa um token MCP da Brandfetch (um token bearer bf1.). Gere um na página Keys and MCP no dashboard da Brandfetch, ou conecte-se via OAuth a partir de um cliente que suporte.

Claude Desktop / Claude Code

{
  "mcpServers": {
    "brandfetch": {
      "type": "http",
      "url": "https://mcp.brandfetch.io/mcp",
      "headers": {
        "Authorization": "Bearer bf1.YOUR_TOKEN"
      }
    }
  }
}

Cursor

Adicione ao ~/.cursor/mcp.json (ou ao .cursor/mcp.json do projeto):

{
  "mcpServers": {
    "brandfetch": {
      "url": "https://mcp.brandfetch.io/mcp",
      "headers": {
        "Authorization": "Bearer bf1.YOUR_TOKEN"
      }
    }
  }
}

Clientes que suportam OAuth podem, em vez disso, apontar para https://mcp.brandfetch.io/mcp sem token e concluir o fluxo de autorização no navegador.

Erros de cota

get_brand, get_brand_data, enrich_transaction e get_brand_context consomem créditos de API do seu plano; brand_search e build_logo_urls não consomem e continuam funcionando quando seus créditos acabarem.

429 "API quota exhausted" — sua chave usou todos os créditos de API. Verifique o uso ou faça upgrade no dashboard da Brandfetch.
403 "Forbidden" — a chave não tem créditos de API disponíveis ou não tem acesso a esse endpoint. A chave em si pode ser válida, então verifique seu plano e o status da chave no dashboard antes de rotacioná-la.

Auto-hospedagem

Este é um servidor MCP HTTP (streamable-http) construído com FastMCP. Você pode executar sua própria instância com Docker.

docker build -t brandfetch-mcp-server .
docker run --rm -p 8080:8080 brandfetch-mcp-server

O servidor então escuta em http://localhost:8080/mcp. Aponte seu cliente MCP para essa URL e envie suas credenciais da Brandfetch como um token Bearer.

O Dockerfile inclui o AWS Lambda Web Adapter e algumas variáveis de ambiente AWS_LWA_*. Elas são inertes fora do AWS Lambda e podem ser ignoradas (ou removidas) para uma implantação simples em contêiner/host.

Executando sem Docker

uv sync
uv run uvicorn src.main:app --host 0.0.0.0 --port 8080

Desenvolvimento

Requer uv e Python 3.11.

uv sync                 # install dependencies
uv run pytest           # run the tests
uv run ruff check .     # lint
uv run ruff format .    # format

Licença

MIT