> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brandfetch.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Brandfetch MCP

> Connect Brandfetch to AI assistants

The Brandfetch MCP server exposes Brandfetch's brand data tools to any AI assistant that supports the [Model Context Protocol](https://modelcontextprotocol.io) (MCP) — including Claude, Cursor, Windsurf, Gemini CLI, and others. Once configured, the assistant can search for brands, retrieve logos, brand assets, and firmographics data.

## Get your credentials

<Tip>
  You can copy the URL and Keys directly using [the Keys and MCP section of the
  Developer Dashboard](https://developers.brandfetch.com/dashboard/keys)
</Tip>

The MCP server is available at:

```
https://mcp.brandfetch.io/mcp?apiKey=YOUR_API_KEY&clientId=YOUR_CLIENT_ID
```

You'll need an API key and your **Client ID**. Both of them are available in the [Developer Dashboard](https://developers.brandfetch.com).

<Warning>
  Your API key is passed as a query parameter. Avoid sharing or committing this URL, treat it like a password.
</Warning>

## Setup

<Tabs>
  <Tab title="Claude Desktop">
    Open your Claude Desktop configuration file:

    * **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
    * **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

    Add the following entry under `mcpServers`:

    ```json theme={null}
    {
      "mcpServers": {
        "brandfetch": {
          "url": "https://mcp.brandfetch.io/mcp?apiKey=YOUR_API_KEY&clientId=YOUR_CLIENT_ID"
        }
      }
    }
    ```

    Restart Claude Desktop to apply the change.
  </Tab>

  <Tab title="Claude Code">
    Run the following command to add the Brandfetch MCP server to your project:

    ```bash theme={null}
    claude mcp add brandfetch --transport http "https://mcp.brandfetch.io/mcp?apiKey=YOUR_API_KEY&clientId=YOUR_CLIENT_ID"
    ```
  </Tab>

  <Tab title="VS Code">
    Use the command Palette and look for **MCP: Add server**, then use the URL above.

    Or create or open `.vscode/mcp.json` in your project and add:

    ```json theme={null}
    {
      "servers": {
        "brandfetch": {
          "type": "http",
          "url": "https://mcp.brandfetch.io/mcp?apiKey=YOUR_API_KEY&clientId=YOUR_CLIENT_ID"
        }
      }
    }
    ```
  </Tab>

  <Tab title="Codex">
    Add the following to `~/.codex/config.toml` (or `.codex/config.toml` inside your project):

    ```toml theme={null}
    [mcp_servers.brandfetch]
    url = "https://mcp.brandfetch.io/mcp?apiKey=YOUR_API_KEY&clientId=YOUR_CLIENT_ID"
    ```

    Or run the CLI command:

    ```bash theme={null}
    codex mcp add brandfetch --url "https://mcp.brandfetch.io/mcp?apiKey=YOUR_API_KEY&clientId=YOUR_CLIENT_ID"
    ```
  </Tab>

  <Tab title="Cursor">
    Open **Cursor Settings → MCP** and add a new server:

    ```json theme={null}
    {
      "mcpServers": {
        "brandfetch": {
          "url": "https://mcp.brandfetch.io/mcp?apiKey=YOUR_API_KEY&clientId=YOUR_CLIENT_ID"
        }
      }
    }
    ```
  </Tab>

  <Tab title="Windsurf">
    Open your Windsurf MCP configuration file and add:

    ```json theme={null}
    {
      "mcpServers": {
        "brandfetch": {
          "url": "https://mcp.brandfetch.io/mcp?apiKey=YOUR_API_KEY&clientId=YOUR_CLIENT_ID"
        }
      }
    }
    ```
  </Tab>
</Tabs>

## Available tools

| Tool                 | Description                                                                                                                                   |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `brand_search`       | Search for brands by name — useful when the domain is unknown or ambiguous.                                                                   |
| `get_brand`          | Retrieve full brand data (logos, colors, fonts, company info) by domain, ticker, ISIN, or crypto symbol.                                      |
| `get_brand_context`  | Get LLM-ready brand context for a domain — voice, audience, positioning, and style. Use when generating content or reasoning about brand fit. |
| `enrich_transaction` | Identify a merchant brand from a raw credit card or bank statement string.                                                                    |
| `build_logo_urls`    | Construct Brandfetch CDN logo URLs for one or more brands without making an API call.                                                         |

## Usage and quotas

MCP requests count against your Brand API quotas. You can monitor your usage in the [Developer Dashboard](https://developers.brandfetch.com).