> ## 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.

The MCP server is available at:

```
https://mcp.brandfetch.io/mcp
```

## Authentication

The Brandfetch MCP server uses OAuth. When you add the server, your MCP client opens a browser window where you sign in with your Brandfetch account. If you don't have an account yet, [sign up for free](https://developers.brandfetch.com/register); the free plan includes 100 requests per month.

<Accordion title="My client doesn't support OAuth">
  If your MCP client doesn't support OAuth, or you're running in a non-interactive environment (CI, scripted agents), you can generate an MCP token in the [Keys and MCP section of the Developer Dashboard](https://developers.brandfetch.com/dashboard/keys) and send it as a bearer token:

  ```json theme={null}
  {
    "url": "https://mcp.brandfetch.io/mcp",
    "headers": {
      "Authorization": "Bearer YOUR_MCP_TOKEN"
    }
  }
  ```

  Treat the token like a password — don't share or commit it.
</Accordion>

## Setup

<Tabs>
  <Tab title="Claude">
    In Claude Desktop or [claude.ai](https://claude.ai), go to **Settings → Connectors → Add custom connector** and enter:

    * **Name**: `Brandfetch`
    * **URL**: `https://mcp.brandfetch.io/mcp`

    Click **Add**, then **Connect** — a browser window opens to sign in with your Brandfetch account.
  </Tab>

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

    ```bash theme={null}
    claude mcp add brandfetch --transport http https://mcp.brandfetch.io/mcp
    ```

    Then run `/mcp` inside Claude Code, select **brandfetch**, and follow the authentication prompt to sign in.
  </Tab>

  <Tab title="VS Code">
    Use the Command Palette and look for **MCP: Add Server**, choose **HTTP**, 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"
        }
      }
    }
    ```

    When the server starts, VS Code prompts you to sign in to Brandfetch.
  </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"
    ```

    Or run the CLI command:

    ```bash theme={null}
    codex mcp add brandfetch --url https://mcp.brandfetch.io/mcp
    ```

    Then sign in with:

    ```bash theme={null}
    codex mcp login brandfetch
    ```
  </Tab>

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

    ```json theme={null}
    {
      "mcpServers": {
        "brandfetch": {
          "url": "https://mcp.brandfetch.io/mcp"
        }
      }
    }
    ```

    Click **Login** next to the server entry to sign in with your Brandfetch account.
  </Tab>

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

    ```json theme={null}
    {
      "mcpServers": {
        "brandfetch": {
          "url": "https://mcp.brandfetch.io/mcp"
        }
      }
    }
    ```

    Windsurf prompts you to sign in to Brandfetch when the server connects.
  </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).