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.
The Brandfetch MCP server exposes Brandfetch’s brand data tools to any AI assistant that supports the Model Context Protocol (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
The MCP server is available at:
https://mcp.brandfetch.io/mcp?apiKey=YOUR_API_KEY&clientId=YOUR_CLIENT_ID
Your API key is passed as a URL query parameter. Avoid sharing or committing this URL — treat it like a password.
Setup
Claude Desktop
Claude Code
VS Code
Codex
Cursor
Windsurf
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:{
"mcpServers": {
"brandfetch": {
"url": "https://mcp.brandfetch.io/mcp?apiKey=YOUR_API_KEY&clientId=YOUR_CLIENT_ID"
}
}
}
Run the following command to add the Brandfetch MCP server to your project:claude mcp add brandfetch --transport http "https://mcp.brandfetch.io/mcp?apiKey=YOUR_API_KEY&clientId=YOUR_CLIENT_ID"
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:{
"servers": {
"brandfetch": {
"type": "http",
"url": "https://mcp.brandfetch.io/mcp?apiKey=YOUR_API_KEY&clientId=YOUR_CLIENT_ID"
}
}
}
Add the following to ~/.codex/config.toml (or .codex/config.toml inside your project):[mcp_servers.brandfetch]
url = "https://mcp.brandfetch.io/mcp?apiKey=YOUR_API_KEY&clientId=YOUR_CLIENT_ID"
codex mcp add brandfetch --url "https://mcp.brandfetch.io/mcp?apiKey=YOUR_API_KEY&clientId=YOUR_CLIENT_ID"
Open Cursor Settings → MCP and add a new server:{
"mcpServers": {
"brandfetch": {
"url": "https://mcp.brandfetch.io/mcp?apiKey=YOUR_API_KEY&clientId=YOUR_CLIENT_ID"
}
}
}
Open your Windsurf MCP configuration file and add:{
"mcpServers": {
"brandfetch": {
"url": "https://mcp.brandfetch.io/mcp?apiKey=YOUR_API_KEY&clientId=YOUR_CLIENT_ID"
}
}
}
| 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.
