Brandfetch MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| BRANDFETCH_API_KEY | No | Private REST Brand API Bearer key; not an official MCP bf1 token | |
| BRANDFETCH_ACCOUNTS | No | Private named {name,api_key,token_file,client_id} profiles; no global fallback | |
| BRANDFETCH_AUDIT_LOG | No | Optional metadata-only guard log; no transaction guarantee | |
| BRANDFETCH_CLIENT_ID | No | Separate application client ID for search and browser-only hotlinks | |
| BRANDFETCH_READ_ONLY | No | 1/true hides and refuses two operations; reads can still consume quota | |
| BRANDFETCH_TOKEN_FILE | No | Absolute regular owner-only token file, at most 64 KiB; overrides key and cached until restart | |
| BRANDFETCH_DEFAULT_ACCOUNT | No | Exact configured label; first profile by default | |
| BRANDFETCH_ALLOW_DESTRUCTIVE | No | 0/false refuses both confirmed operations | |
| BRANDFETCH_REQUEST_TIMEOUT_MS | No | 100–300000; default 30000; asset timeout at most 5000; no replay | 30000 |
| BRANDFETCH_MIN_REQUEST_INTERVAL_MS | No | 0–10000; default 200; per-profile/process pacing | 200 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_brandB | Current Brand API V2 data through generic or explicit routes. One request; credentialed asset src URLs are redacted from output. Provider reads may spend quota or crawl on a miss. |
| search_brandsB | Search by name with the selected profile client ID in native query c. No Brand API Bearer key sent. One request; no pagination or retries. |
| get_brand_contextA | One Brand Context API request. Context is probabilistic interpretation, not verified company facts. Accepts domain/email/URL; cachedOnly avoids crawling a miss. |
| enrich_transactionA | Resolve the user-requested transaction label into brand data. Sends the label and country to Brandfetch and may consume credits; does not create a charge, bank connection or payment. |
| get_viewerA | GET /v2/viewer using the selected private Brand API key. Returns provider viewer metadata; does not purchase access or expose the key. |
| prefetch_brandB | Explicitly confirmed HEAD request can enqueue a provider crawl. Generic or domain route only. Return 200 indexed / 202 crawl queued; never poll, purchase or resubmit automatically. |
| get_brand_colorsA | One native brand read with only name, domain and colors returned. Filtering is local: provider quota and crawling behavior are unchanged. |
| get_brand_fontsA | One native brand read with only name, domain and fonts returned. Filtering is local: provider quota and crawling behavior are unchanged. |
| compare_brandsA | Read two to five unique identifiers sequentially in one exact profile, preserving input order. Return colors/fonts/logo counts; stop at the first failure with completed results. No retries, cross-account mixing or complete-market claim. |
| get_logo_urlA | Local Logo API URL construction with the selected profile client ID. Direct browser display only; programmatic fetching these hotlinks is prohibited/blocked. No provider call or automatic download. |
| download_brand_logosA | Confirmed one brand lookup plus at most five original credentialed Brand API logo src downloads. Owner-private directory and exclusive files only; cap 5 MiB each, fixed CDN, no redirects/Bearer forwarding/hotlink evasion/retries. Stop on failure, retain and report completed/reserved files. |
| list_accountsB | Local labels, default and credential method availability only. No keys, client IDs, private paths or network. |
| get_operation_schemaB | Complete pinned Brandfetch path/query/body schema and documented response statuses for one of 11 supported native operations. Local only; agent purchases excluded. |
| preview_operationB | Validate one exact native operation request locally, without loading keys/client IDs, contacting Brandfetch, reserving files or claiming provider validation or price. Search c is added from private profile at execution. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 14 tools
Several tools perform the same underlying native brand read: get_brand, get_brand_colors, and get_brand_fonts are explicitly the same provider call with local output filtering, so an agent may struggle to choose between them. get_brand_context, search_brands, and prefetch_brand are reasonably distinct, and the verbose descriptions do help disambiguate, but the overlapping brand-read family caps this score.
Every tool uses a consistent snake_case verb_noun pattern (get_brand, search_brands, enrich_transaction, download_brand_logos, list_accounts). The verb choices are predictable and the pattern holds across all 14 tools with no mixed conventions.
14 tools is within the well-scoped 3-15 range and each nominally earns a place. However, the colors/fonts wrappers and the meta tools (get_operation_schema, preview_operation) feel somewhat padded relative to the core brand-data surface.
The surface covers the brand lifecycle well: lookup, search, context, colors, fonts, logo URL construction, logo download, comparison, transaction enrichment, prefetch, plus schema/preview helpers. Minor gaps exist (no font download, limited account operations), but core workflows are covered.