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; the free plan includes 100 free brand fetches (one-time).My client doesn't support OAuth
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 and send it as a bearer token:Treat the token like a password: don’t share or commit it.
Setup
Pick your client. Each tab covers adding the server, signing in, and checking that it works.- Claude
- ChatGPT
- Claude Code
- Codex
- VS Code
- Cursor
- Devin Desktop
- Gemini CLI
- Grok
- Lovable
- JetBrains
- Other MCP clients
Brandfetch is a verified connector in Claude’s directory. Open Brandfetch in Claude, select Connect to Claude, and sign in with your Brandfetch account.In Claude, Brandfetch also shows an interactive brand card and needs one network setting to download assets. Brandfetch for Claude covers the full setup.
Available tools
Downloading brand assets
When your assistant needs actual image bytes, for example to embed a logo in a generated document (PPTX, DOCX, PDF), save files to disk, or process pixels, the reliable path is to fetch the credentialedsrc URLs returned by get_brand directly from its code-execution environment (curl, requests, fetch). That keeps image bytes out of the conversation entirely.
Running code in a sandbox? Allow
*.brandfetch.io.Many assistants run code in a sandbox that blocks outside domains by default, which stops logos and other assets from downloading. Add *.brandfetch.io to the sandbox’s allowed domains. For Claude, see Brandfetch for Claude.build_logo_urls are display-only under the hotlinking policy and can’t be downloaded programmatically, so always use the src URLs from get_brand, whose ?c= token carries per-request credentials.
If a generated document only needs to display a logo, it doesn’t need the bytes at all: reference the credentialed src URL directly (a linked image in PPTX, an <img> tag in HTML) and let the viewer fetch it. Clients that support MCP resource reads can also stream asset bytes out-of-band via the bf://asset/{domain}/{type} resource links returned by get_brand.
Usage and quotas
MCP requests count against your Brand API quotas. You can monitor your usage in the Developer Dashboard.get_brands uses batch lookups in the Brand API. Each brand it returns uses one API credit. Every other result is free. A brand that is not indexed yet is queued for indexing, so your assistant can ask for it again later. Batch lookups are available on paid plans and with prepaid credits. On the free plan, your assistant fetches brands one at a time with get_brand_data.