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 | {
"listChanged": true
} |
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_brandA | 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 overlap as brand reads: get_brand, get_brand_fonts, and get_brand_colors are essentially the same lookup with locally filtered subsets, and search_brands retrieves brand data differently. The detailed descriptions help distinguish download_brand_logos vs get_logo_url and the local-only tools, but an agent could still misselect among the read variants.
Nearly every tool follows a clean verb_noun pattern (get_brand, prefetch_brand, search_brands, list_accounts, download_brand_logos, compare_brands, enrich_transaction). Conventions are uniform snake_case throughout with no mixing.
14 tools is well within the appropriate range and each tool maps to a distinct capability (schema preview, reads, search, logos, comparison, accounts). The count feels scoped to a real brand-data API surface.
The surface covers brand retrieval, context, search, fonts/colors/logos, comparison, transaction enrichment, accounts, and schema/preview operations, forming a fairly complete lifecycle. Minor gaps exist such as no explicit multi-item pagination tool, but workarounds are available.