# BrandKit API and MCP Logos, colours, fonts and company details for any domain, through one API. One request returns a company's logos, colours, fonts, social links and details. The first request for a brand builds it from the live site (10 to 40 seconds); after that it is served from the cache for 30 days. Free: 1,000 successful requests per calendar month (UTC) per account, 60 requests a minute per key, up to 10 keys. No card. Create a key at https://brandkit.superlabs.co/sign-in. ## Authentication Send the key in the `X-API-Key` header. `Authorization: Bearer ` and a `?key=` query parameter also work. ```sh curl -H "X-API-Key: bk_…" https://api.brandkit.superlabs.co/v1/brands/stripe.com ``` ## Get a brand `GET https://api.brandkit.superlabs.co/v1/brands/{domain}` - `domain`: a bare domain (`stripe.com`), a `www` host or a URL-encoded full URL. - `refresh=true`: rebuild now instead of using the cache, at most once per 10 minutes per domain. `X-Cache: HIT` means the brand came from the cache; `MISS` means it was just built. ### Response fields - `name`, `domain`, `description` (one or two sentences), `about` (two to four neutral paragraphs), `industry`. - `logos[]`: `type` is `logo` (wordmark or lockup), `symbol` (square mark) or `icon` (favicon, touch or manifest icon). `theme` is the logo's own colour: `light` needs a dark background, `dark` a light one. `formats[]` holds `src`, `format` (svg, png…), `width`, `height`, `size`. `source` says where the file was found. - `colors[]`: `hex`, `type` (`brand`, `accent`, `dark`, `light`), `brightness`, `sources` (logo, theme-color, manifest, css-variable, button, link). - `logos[].filled`: `true` when the file paints its own background (an app icon or badge); show it as it is. - `display`: `background`, `text`, `mutedText`, `accent` and `tinted`: colours for showing the brand on a page of its own, readable together. `tinted` means the brand colour was too mid-tone for text, so `background` is a pale tint of it and the brand colour is the `accent`. - `fonts[]`: `name`, `type` (`title`, `body`, `other`), `origin` (`google`, `custom`, `system`). - `links[]`: official social profiles, `name` and `url`. - `company`: `legalName`, `foundingDate`, `headquarters`, `email`, `telephone`, `address`, and `revenue` (`amount`, ISO 4217 `currency`, `year`; the latest annual figure, only when it is from the last three years; never estimated). - `verified`: the site was confirmed as the brand's official site. `rendered`: the brand was read from the fully loaded page. ## Get a logo `GET https://cdn.brandkit.superlabs.co/logo/{domain}?key=pk_…&theme=dark&type=logo&format=svg` Answers with the best matching image file itself (SVG, PNG…, with an ETag and a one-day cache), so the URL works as an `` src. Never put a secret `bk_` key in a web page: use the account's publishable key (`pk_`, from the dashboard). It can only load logos and can be limited to the account's own sites. Logos of brands already in BrandKit are free with a publishable key (up to 1,200 a minute per key); a brand built for the first time counts as one request. From a server, `/v1/brands/{domain}/logo` also accepts the secret key. ```html Stripe ``` - `theme`: the background it will be shown on. `dark` returns a light or colourful logo; `light` a dark or colourful one. - `type`: `logo`, `symbol` or `icon`. When a brand has no file of that type, `symbol` falls back to the icon, `icon` to the symbol, and both to the logo; `logo` falls back to the symbol, then the icon. - `format`: `svg`, `png`, `ico`, `webp`… ## MCP server BrandKit is also a remote MCP server (streamable HTTP) at `https://api.brandkit.superlabs.co/mcp`. Authenticate with the same API key, in the `X-API-Key` or `Authorization: Bearer` header. Each tool call counts as one request. Tools: - `get_brand(domain, refresh?)`: the full brand, as above. - `get_logo(domain, theme?, type?, format?)`: the URL of the best logo file. Claude Code: ```sh claude mcp add --transport http brandkit https://api.brandkit.superlabs.co/mcp --header "X-API-Key: bk_…" ``` Cursor, VS Code and other clients (`mcp.json`): ```json { "mcpServers": { "brandkit": { "url": "https://api.brandkit.superlabs.co/mcp", "headers": { "X-API-Key": "bk_…" } } } } ``` ## Limits and errors Responses carry `X-Quota-Limit`, `X-Quota-Remaining` and `X-Quota-Reset`. Errors are JSON: `{"error": "…", "code": "…"}`. - 401 `missing_api_key` / `invalid_api_key`: no key, or a deleted or expired one. - 429 `rate_limited`: more than 60 requests a minute on the key; retry after `Retry-After` seconds. - 403 `origin_not_allowed`: the publishable key is limited to other sites. - 429 `quota_exceeded`: the monthly quota is used up. Need more: https://brandkit.superlabs.co/contact?topic=more-usage - 400: the domain is not valid. 404: no logo matches the filters. - 502: the site could not be fetched or blocked automated access. 503 `unavailable`: retry shortly. ## FAQ ### Is BrandKit really free? Yes. Every account gets 1,000 successful requests each calendar month, with no card. Failed requests don't count, and the allowance resets on the 1st (UTC). ### How accurate is the data? Every brand comes from the company's own official website and is checked before it's served, so you get the brand's real logos and colours, not partner badges, icons or look-alikes. ### How fresh is the data? A brand is built the first time anyone asks for it and cached for 30 days. Add ?refresh=true to rebuild it sooner, at most once every 10 minutes per domain. ### What if a brand isn't in BrandKit yet? There is no fixed list. Any public domain works: the first request for a new brand takes a little longer, then it comes back instantly. ### Can I use BrandKit from Claude, Cursor or another AI agent? Yes. BrandKit is a remote MCP server at https://api.brandkit.superlabs.co/mcp with get_brand and get_logo tools. Connect it with your API key. ### Our company's data is wrong. Can we fix it? Yes. Report it from the brand page, or write to us through the contact page under “Your company’s data” and we’ll correct it. ### Can I use the logos? Logos and names belong to their owners. BrandKit serves them so you can identify companies in your product, as you would with a link preview.