Brandfetch

You can run the Brandfetch Brand MCP Server to query brand data, fetch logos, colors, and brand details from Brandfetch, and manage usage with a local SQLite store. This lets AI assistants reliably access brand information through MCP endpoints with a built-in fallback strategy and usage tracking.

How to use

Interact with the Brandfetch MCP Server from your MCP client to perform actions like getting full brand details, searching brands by keyword, fetching SVG/PNG logos, and retrieving color palettes. The server prioritizes fast domain-based logo lookups and uses Brand API fallbacks only when needed, with usage tracking to prevent quota overruns.

Common actions you can perform include retrieving a complete brand profile for a domain, listing brands that match a keyword, obtaining a logo in light or dark themes, and obtaining the color palette used by a brand. The server is designed to be easy to wire into your Claude Desktop or any MCP-enabled client. You’ll supply your Brandfetch API keys for both the Logo and Brand endpoints and then start the MCP server to begin querying.

How to install

Prerequisites you need to prepare before starting are Python 3.10 or newer and Brandfetch API keys for both Logo and Brand endpoints.

Install and run the server locally using Python with the development environment.

uv venv && source .venv/bin/activate
uv pip install -e ".[dev]"
cp .env.example .env  # then add both BRANDFETCH_CLIENT_ID and BRANDFETCH_API_KEY
python manual_test.py

If you prefer Docker, you can build and run the container with your keys set at runtime.

docker build -t brandfetch-mcp .
docker run --rm \
  -e BRANDFETCH_CLIENT_ID=paste_logo_key \
  -e BRANDFETCH_API_KEY=paste_brand_key \
  brandfetch-mcp

To wire the server into Claude Desktop, provide the MCP configuration snippet with your keys and run it so Claude can connect to the MCP server.

{
  "mcpServers": {
    "brandfetch": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/brandfetch_mcp", "run", "mcp-brandfetch"],
      "env": { 
        "BRANDFETCH_CLIENT_ID": "paste_logo_key",
        "BRANDFETCH_API_KEY": "paste_brand_key"
      }
    }
  }
}

Additional configuration and usage notes

Project includes a Python-based MCP server implementation and a client for Brandfetch. The server exposes endpoints to get full brand details, perform keyword searches, fetch logos, and retrieve color palettes. It uses a persistent SQLite store to monitor usage and prevent quota overages, with a warning system when limits are approached.

Health checks can be performed via standard MCP endpoints once the server is running. Typical health checks include verifying server readiness and performing a sample brand lookup.

Troubleshooting and notes

If you encounter a 401 Unauthorized error, ensure you have a valid Brand API key for Brand API access (the Logo API key alone will not authorize Brand API calls). Check that both keys are correctly provided in the environment configuration.

If you do not see the hammer icon in Claude Desktop after wiring the MCP server, verify that the JSON configuration uses absolute paths and that the server process started successfully. Review logs for any startup errors.

If import or environment issues occur, activate the Python virtual environment and reinstall development dependencies with uv pip install -e ".[dev]".

Tools available through the MCP server

get_brand_details — Retrieve a full brand profile for a specified domain.

search_brands — Perform a keyword search to find brands matching your query.

get_brand_logo — Get the SVG/PNG logo assets, with support for light and dark themes.

get_brand_colors — Retrieve curated color palettes and brand metadata.

get_logo_url — Look up a fast logo URL by domain for quick access.

Security and access

Keep your Brandfetch API keys secure. Do not expose keys in client-side code or public repositories. Use environment variables and secret management when deploying in production.

Available tools

get_brand_details

Fetches the full brand profile for a given domain, including logos, colors, and metadata.

search_brands

Performs a keyword-based search to find brands that match your query.

get_brand_logo

Returns the brand logo assets (SVG/PNG) in light/dark themes.

get_brand_colors

Provides color palettes and related metadata for a brand.

get_logo_url

Obtains a fast URL for the domain logo lookup.

usage_tracking

SQLite-based quota management to persist usage and warn on approaching limits.