brandfetch MCP

Servidor MCP para conectarse a los servicios de Brandfetch

Documentación

Servidor MCP de Brandfetch

El Protocolo de Contexto de Modelo oficial servidor para Brandfetch. Proporciona a los asistentes de IA acceso a búsqueda de marcas, datos de empresas, logotipos y recursos de diseño, y contexto de marca listo para LLM desde la API de Brandfetch.

Aprende más: https://brandfetch.com/developers/mcp
Documentación completa: https://docs.brandfetch.com/mcp/overview

Herramientas

Herramienta	Descripción
`brand_search`	Busca marcas por nombre utilizando el índice de búsqueda de Brandfetch.
`get_brand`	Consulta datos completos de la marca por dominio, correo electrónico, ticker, ISIN o símbolo criptográfico; renderiza la tarjeta de marca interactiva en hosts de MCP Apps.
`get_brand_data`	Los mismos datos de marca sin tarjeta — para muros de logotipos, trabajo con múltiples marcas y datos que alimentan contenido generado.
`enrich_transaction`	Identifica una marca de comerciante a partir de una cadena de tarjeta de crédito o extracto bancario.
`get_brand_context`	Obtén contexto de marca listo para LLM para un dominio — voz, audiencia, posicionamiento, estilo.
`build_logo_urls`	Construye URLs del CDN de Logotipos de Brandfetch para una o más marcas (sin llamada a la API).
`send_feedback`	Reporta errores, datos de marca incorrectos o desactualizados, o capacidades faltantes a Brandfetch.

Tarjeta de marca interactiva (MCP Apps)

En hosts que admiten la extensión MCP Apps (claude.ai, Claude Desktop, ...), los resultados de get_brand se renderizan como una tarjeta de marca interactiva: vista previa del logotipo, selector de formato (SVG/PNG/WebP/...), acciones de descarga y copiar URL. Los hosts sin soporte de Apps recurren al resultado JSON de herramienta regular. get_brand_data devuelve los mismos datos de marca sin la tarjeta, por lo que un muro de logotipos de seis marcas son seis llamadas de datos en lugar de seis tarjetas; el modelo elige entre las dos según sus descripciones. La fuente del widget vive en ui/ y es servida por el servidor como el recurso ui://brandfetch/brand-card.html.

Inicio rápido (servidor alojado)

La forma más fácil de usar este servidor es conectarse al endpoint alojado por Brandfetch — sin instalación, sin infraestructura:

https://mcp.brandfetch.io/mcp

La autenticación utiliza un token MCP de Brandfetch (un token de portador bf1.). Genera uno desde la página Keys and MCP en el panel de Brandfetch, o conéctate vía OAuth desde un cliente que lo admita.

Claude Desktop / Claude Code

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

Cursor

Agrega a ~/.cursor/mcp.json (o al .cursor/mcp.json del proyecto):

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

Los clientes que admiten OAuth pueden en su lugar apuntar a https://mcp.brandfetch.io/mcp sin token y completar el flujo de autorización en el navegador.

Errores de cuota

get_brand, get_brand_data, enrich_transaction y get_brand_context consumen créditos de API de tu plan; brand_search y build_logo_urls no lo hacen y siguen funcionando cuando tus créditos se agotan.

429 "Cuota de API agotada" — tu clave ha utilizado todos sus créditos de API. Verifica el uso o mejora en el panel de Brandfetch.
403 "Prohibido" — la clave no tiene créditos de API disponibles o carece de acceso a ese endpoint. La clave en sí puede ser válida, así que verifica tu plan y el estado de la clave en el panel antes de rotarla.

Autoalojamiento

Este es un servidor MCP HTTP (streamable-http) construido con FastMCP. Puedes ejecutar tu propia instancia con Docker.

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

El servidor entonces escucha en http://localhost:8080/mcp. Apunta tu cliente MCP a esa URL y envía tus credenciales de Brandfetch como un token Bearer.

El Dockerfile incluye el AWS Lambda Web Adapter y algunas variables de entorno AWS_LWA_*. Son inertes fuera de AWS Lambda y pueden ignorarse (o eliminarse) para un despliegue simple en contenedor/host.

Ejecución sin Docker

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

Desarrollo

Requiere uv y Python 3.11.

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

Licencia

MIT