Brandfetch MCP Server

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

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 Dockerfile bundles the AWS Lambda Web Adapter and a few AWS_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

License

MIT