Brandfetch MCP Server
The official Model Context Protocol server for Brandfetch. It gives AI assistants access to brand search, company data, logos and design assets, and LLM-ready brand context from the Brandfetch API.
Full documentation: https://docs.brandfetch.com/mcp/overview
Tools
| Tool | Description |
|---|---|
brand_search | Search for brands by name using Brandfetch's search index. |
get_brand | Look up full brand data by domain, stock ticker, ISIN, or crypto symbol. |
enrich_transaction | Identify a merchant brand from a credit-card or bank-statement string. |
get_brand_context | Get LLM-ready brand context for a domain — voice, audience, positioning, style. |
build_logo_urls | Construct Brandfetch Logo CDN URLs for one or more brands (no API call). |
get_asset_base64 | Fetch a Brandfetch CDN asset (logo, icon, symbol, image) as base64. |
Quick start (hosted server)
The easiest way to use this server is to connect to the Brandfetch-hosted endpoint — no install, no infrastructure:
https://mcp.brandfetch.io/mcp
Authentication uses a Brandfetch MCP token (a bf1. bearer token). Generate one
from the Keys and MCP page in the
Brandfetch dashboard, or connect via OAuth
from a client that supports it.
Claude Desktop / Claude Code
{
"mcpServers": {
"brandfetch": {
"type": "http",
"url": "https://mcp.brandfetch.io/mcp",
"headers": {
"Authorization": "Bearer bf1.YOUR_TOKEN"
}
}
}
}
Cursor
Add to ~/.cursor/mcp.json (or the project .cursor/mcp.json):
{
"mcpServers": {
"brandfetch": {
"url": "https://mcp.brandfetch.io/mcp",
"headers": {
"Authorization": "Bearer bf1.YOUR_TOKEN"
}
}
}
}
Clients that support OAuth can instead point at https://mcp.brandfetch.io/mcp
with no token and complete the authorization flow in the browser.
Self-hosting
This is an HTTP (streamable-http) MCP server built with FastMCP. You can run your own instance with Docker.
docker build -t brandfetch-mcp-server .
docker run --rm -p 8080:8080 brandfetch-mcp-server
The server then listens on http://localhost:8080/mcp. Point your MCP client at
that URL and send your Brandfetch credentials as a Bearer token.
The
Dockerfilebundles the AWS Lambda Web Adapter and a fewAWS_LWA_*environment variables. These are inert outside of AWS Lambda and can be ignored (or removed) for a plain container/host deployment.
Running without Docker
uv sync
uv run uvicorn src.main:app --host 0.0.0.0 --port 8080
Development
Requires uv and Python 3.11.
uv sync # install dependencies
uv run pytest # run the tests
uv run ruff check . # lint
uv run ruff format . # format