# Brand API
Source: https://docs.logokit.com/api-reference/brand-API

GET /brands/{identifier}
The Brand API provides comprehensive data about companies, including their address, domain, founding year, and number of employees. It's designed for developers looking to integrate reliable brand information into their applications, making it easier to enhance user experiences with up-to-date brand insights.

<Info>
  Brand API endpoints are available only for paid plans. If you are on a free
  plan, you can [upgrade here](https://logokit.com/pricing).
</Info>

### Authentication

Brand API endpoint is authenticated using Bearer token in the `Authorization` header of your request. Make sure to keep
this **secret API token** secure and do not share it publicly. You can find yours in
[your account](https://logokit.com/account/api-tokens).

```http theme={null}
Authorization: Bearer: <secret-api-token>
```

## Rate Limiting

Similar to the Logo API, the Brand API implements rate limiting based on user subscription plans.
To get more information about the rate limits, please refer to the [pricing page](https://logokit.com/pricing).

## Examples

<AccordionGroup>
  <Accordion title="Retrieve brand information for a stock ticker">
    Let's say you want to retrieve the brand information for the NASDAQ's ticker `AAPL`.
    You can do this by using the following URL:

    ```bash Request theme={null}
    curl "https://api.logokit.com/brands/AAPL" \
         --header "Authorization: Bearer: <secret-api-token>"
    ```

    ```json Response theme={null}
    {
      "name": "Apple",
      "domain": "apple.com",
      "long_name": "Apple Inc.",
      "short_description": "Apple Inc. designs, manufactures, and markets smartphones, computers, tablets, wearables, and accessories, and offers digital content, cloud, and subscription services to customers worldwide.",
      "long_description": "Apple Inc. designs, manufactures, and markets smartphones, personal computers, tablets, wearables, and accessories worldwide. The company offers iPhone, Mac, iPad, AirPods, Apple TV, Apple Watch, Beats products, and HomePod. It also provides AppleCare support, cloud services, and operates platforms such as the App Store for digital content distribution. Apple offers subscription-based services including Apple Arcade, Apple Fitness+, Apple Music, Apple News+, Apple TV+, Apple Card, and Apple Pay. Its customers include consumers, small and mid-sized businesses, education, enterprise, and government sectors globally.",
      "website": "https://www.apple.com",
      "logo": "https://img.logokit.com/apple.com",
      "colors": [
        "#000000",
        "#f5f5f7",
        "#ffffff"
      ],
      "founded_year": 1977,
      "issued_currency": "USD",
      "number_of_employees": "150,000-200,000",
      "social_media": {
        "facebook": "https://www.facebook.com/apple",
        "x": "https://x.com/apple",
        "instagram": "https://www.instagram.com/apple/",
        "linkedin": "https://www.linkedin.com/company/apple",
        "youtube": "https://www.youtube.com/apple",
        "pinterest": "https://www.pinterest.com/apple",
        "tiktok": "https://www.tiktok.com/@apple",
        "reddit": null,
        "snapchat": null,
        "discord": null,
        "tumblr": null,
        "vimeo": null
      },
      "address": {
        "address1": "One Apple Park Way",
        "address2": "",
        "city": "Cupertino",
        "state": "CA",
        "zip": "95014",
        "country": "US"
      },
      "gics_sector": "Information Technology",
      "gics_industry_group": "Technology Hardware & Equipment",
      "gics_industry": "Technology Hardware, Storage & Peripherals",
      "gics_sub_industry": "Technology Hardware, Storage & Peripherals"
    }
    ```
  </Accordion>
</AccordionGroup>

## Parameters


# Crypto Logo API
Source: https://docs.logokit.com/api-reference/crypto-logo-API

GET /crypto/{symbol}
Crypto Logo API allows you to retrieve logos based on cryptocurrency symbols, providing both high-quality images and fallback options when a logo is not available.

## Basic Usage

Crypto Logo API works through hotlinking logos of different cryptocurrencies directly into your app or website. Simply use an image tag, and the logos will load directly from our global CDN. This approach ensures you always display the most current logo versions without managing logo files yourself. Since our service is designed for hotlinking, please note that caching or storing the logo images locally is not supported.

This HTML snippet demonstrates how to retrieve a logo for `BTC` (Bitcoin):

```html theme={null}
<img src="https://img.logokit.com/crypto/BTC?token=<publishable-api-token>" alt="BTC logo (identification only, no affiliation)" />
```

<Frame>
  <img alt="BTC logo (identification only, no affiliation)" />
</Frame>

## Limitations

<Info>
  Our Free Logo API plan is limited to 64x64px logos and require an
  [attribution](/attribution) link. [Upgrade ](https://logokit.com/pricing) to a
  paid plan for high resolution logos, increased rate limits and no attribution.
</Info>

## Examples

<AccordionGroup>
  <Accordion title="Retrieve logo for Ethereum cryptocurrency">
    Let's say you want to retrieve the logo for Ethereum (`ETH`). You can
    do this by using the following URL:

    ```html theme={null}
    <img src="https://img.logokit.com/crypto/ETH?token=<publishable-api-token>" alt="ETH logo (identification only, no affiliation)" />
    ```

    <Frame>
      <img alt="ETH logo (identification only, no affiliation)" />
    </Frame>
  </Accordion>

  <Accordion title="Get light monogram fallback for non-existent logo">
    If you want to receive a light variant of the monogram fallback when the logo is not available, you can
    use the `fallback` parameter in the URL and set it to `monogram-light`. This is useful for
    light-themed applications where you want a fallback with a light background.

    ```md Request theme={null}
    https://img.logokit.com/crypto/INVALID?fallback=monogram-light&token=<publishable-api-token>
    ```

    This will return a light monogram image generated from the first three letters of the cryptocurrency symbol with a light background, perfect for light-themed interfaces.

    <Frame>
      <img alt="INV logo" />
    </Frame>
  </Accordion>

  <Accordion title="Get 404 HTTP response for non-existent logo">
    If you want to receive a 404 HTTP response when the logo is not available, you can
    use the `fallback` parameter in the URL and set it to `404`. This is useful for
    handling cases where the logo is not found, and you want to handle it in your
    application.

    ```md Request theme={null}
    https://img.logokit.com/crypto/INVALID?fallback=404&token=<publishable-api-token>
    ```

    ```bash HTTP Response theme={null}
      404 Not Found
    ```
  </Accordion>
</AccordionGroup>


# Logo API
Source: https://docs.logokit.com/api-reference/logo-API

GET /{domain}
Logo API allows you to retrieve logos based on a domain, providing both high-quality images and fallback options when a logo is not available.

## Basic Usage

The Logo API works through hotlinking company logos directly into your app or website. Simply use an image tag, and the logos will load directly from our global CDN. This approach ensures you always display the most current logo versions without managing logo files yourself. Since our service is designed for hotlinking, please note that caching or storing the logo images locally is not supported.

This HTML snippet demonstrates how to retrieve a logo for `apple.com`:

```html theme={null}
<img src="https://img.logokit.com/apple.com?token=<publishable-api-token>" alt="Apple logo (identification only, no affiliation)" />
```

<Frame>
  <img alt="" />
</Frame>

## Limitations

<Info>
  Our Free Logo API plan is limited to 64x64px logos and require an
  [attribution](/attribution) link. [Upgrade ](https://logokit.com/pricing) to a
  paid plan for high resolution logos, increased rate limits and no attribution.
</Info>

## Examples

<AccordionGroup>
  <Accordion title="Retrieve logo for Nvidia">
    Let's say you want to retrieve the logo for the Nvidia. You can
    do this by using the following URL:

    ```html theme={null}
    <img src="https://img.logokit.com/nvidia.com?token=<publishable-api-token>" alt="NVIDIA logo (identification only, no affiliation)" />
    ```

    <Frame>
      <img alt="" />
    </Frame>
  </Accordion>

  <Accordion title="Get 404 HTTP response for non-existent logo">
    If you want to receive a 404 HTTP response when the logo is not available, you can
    use the `fallback` parameter in the URL and set it to `404`. This is useful for
    handling cases where the logo is not found, and you want to handle it in your
    application.

    ```md Request theme={null}
    https://img.logokit.com/invalid.com?fallback=404&token=<publishable-api-token>
    ```

    ```bash HTTP Response theme={null}
      404 Not Found
    ```
  </Accordion>

  <Accordion title="Get light monogram fallback for non-existent logo">
    If you want to receive a light variant of the monogram fallback when the logo is not available, you can
    use the `fallback` parameter in the URL and set it to `monogram-light`. This is useful for
    light-themed applications where you want a fallback with a light background.

    ```md Request theme={null}
    https://img.logokit.com/invalid.com?fallback=monogram-light&token=<publishable-api-token>
    ```

    This will return a light monogram image generated from the first letter of the domain with a light background, perfect for light-themed interfaces.

    <Frame>
      <img alt="" />
    </Frame>
  </Accordion>
</AccordionGroup>

## Parameters


# Stock Logo API
Source: https://docs.logokit.com/api-reference/stock-logo-API

GET /ticker/{symbol}
Stock Logo API allows you to retrieve logos based on a stock exchange ticker, providing both high-quality images and fallback options when a logo is not available.

## Basic Usage

Stock Logo API works through hotlinking stock ticker logos directly into your app or website. Simply use an image tag, and the logos will load directly from our global CDN. This approach ensures you always display the most current logo versions without managing logo files yourself. Since our service is designed for hotlinking, please note that caching or storing the logo images locally is not supported.

This snippet demonstrates how to retrieve a logo for stock ticker `AAPL`:

```html theme={null}
<img src="https://img.logokit.com/ticker/AAPL?token=<publishable-api-token>" alt="AAPL logo (identification only, no affiliation)" />
```

<Frame>
  <img />
</Frame>

<Note>
  By default, only the most popular exchanges are enabled on a new account. If you require access to additional exchanges, please contact us to enable them for you.
</Note>

## Supported Ticker Formats

The API supports a wide range of ticker formats across different exchanges and identification schemes. If no exchange or composite code is specified, `US` is assumed. For example, all of the following identifiers can be used to retrieve the logo for specified companies:

### Apple Inc

* Standard Exchange Tickers: `AAPL` / `AAPL:US`
* Example Exchange-Specific Tickers: `APC.DE`, `APC.F`, `APC:GR`, `AAPL34.SA`, `AAPL34:BZ`
* Identification Numbers:
  * CUSIP `037833100`
  * SEDOL `2046251`
  * ISIN `US0378331005`
  * WKN `865985`

### Roche Holding AG (voting, non-voting, ADR)

* Standard Exchange Tickers: `RO:SW`, `ROG:SW`, `RHHBY` / `RHHBY:US`
* Example Exchange-Specific Tickers: `ROGN:MM`, `RHO6.F`
* Identification Numbers:
  * CUSIP `S71103881`, `S71089189`, `771195104`
  * SEDOL `7110388`, `7108918`, `BYZHCK7`
  * ISIN `CH0012032113`, `CH0012032048`, `US7711951043`
  * WKN `851311`, `855167`, `891106`

<Note>
  We continuously expand our coverage of global exchanges and ticker formats. If you need support for specific exchanges or identification schemes not currently available, please reach out to us.
</Note>

## Limitations

<Info>
  Our Free Logo API plan is limited to 64x64px logos and require an [attribution](/attribution) link. [Upgrade ](https://logokit.com/pricing) to a paid plan for high resolution logos, increased rate limits and no attribution.
</Info>

## Examples

<AccordionGroup>
  <Accordion title="Retrieve logo for Nvidia stock ticker">
    To retrieve the logo for the NASDAQ's ticker `NVDA`, you can
    use the following URL:

    ```html theme={null}
    <img src="https://img.logokit.com/ticker/NVDA?token=<publishable-api-token>" alt="NVDA logo (identification only, no affiliation)" />
    ```

    <Frame>
      <img alt="NVDA logo (identification only, no affiliation)" />
    </Frame>
  </Accordion>

  <Accordion title="Retrieve logo for Vanguard Total Stock Market Index Fund ETF using its ISIN">
    For the Vanguard Total Stock Market Index Fund ETF using its ISIN `US9229087690`, you can use the following URL:

    ```html theme={null}
    <img src="https://img.logokit.com/ticker/US9229087690?token=<publishable-api-token>" alt="Vanguard Total Stock Market Index Fund ETF logo (identification only, no affiliation)" />
    ```

    <Frame>
      <img alt="Vanguard Total Stock Market Index Fund ETF logo (identification only, no affiliation)" />
    </Frame>
  </Accordion>

  <Accordion title="Retrieve logo for Vanguard FTSE All-World UCITS ETF using its ticker">
    When you need the logo for the Vanguard FTSE All-World UCITS ETF using its ticker `VWRL` traded on the London Stock Exchange, you can use the following URL:

    ```html theme={null}
    <img src="https://img.logokit.com/ticker/VWRL:LN?token=<publishable-api-token>" alt="Vanguard FTSE All-World UCITS ETF logo (identification only, no affiliation)" />
    ```

    <Frame>
      <img alt="Vanguard Total Stock Market Index Fund ETF logo (identification only, no affiliation)" />
    </Frame>
  </Accordion>

  <Accordion title="Retrieve logo for USD currency for positions and spot rates">
    To get the logo for the USD currency, use the following URL:

    ```html theme={null}
    <img src="https://img.logokit.com/ticker/USD:CUR?token=<publishable-api-token>" alt="USD" />
    ```

    <Frame>
      <img alt="USD" />
    </Frame>
  </Accordion>

  <Accordion title="Retrieve logo for USD to EUR FX rate">
    Here's how to retrieve the logo for the USD to EUR FX rate using the following URL:

    ```html theme={null}
    <img src="https://img.logokit.com/ticker/USDEUR:CUR?token=<publishable-api-token>" alt="USD to EUR FX rate" />
    ```

    <Frame>
      <img alt="USD to EUR FX rate" />
    </Frame>
  </Accordion>

  <Accordion title="Get light monogram fallback for non-existent logo">
    If you want to receive a light variant of the monogram fallback when the logo is not available, you can
    use the `fallback` parameter in the URL and set it to `monogram-light`. This is useful for
    light-themed applications where you want a fallback with a light background.

    ```md Request theme={null}
    https://img.logokit.com/ticker/INVALID?fallback=monogram-light&token=<publishable-api-token>
    ```

    This will return a light monogram image generated from the first three letters of the ticker symbol with a light background, perfect for light-themed interfaces.

    <Frame>
      <img alt="INV logo" />
    </Frame>
  </Accordion>

  <Accordion title="Get 404 HTTP response for non-existent logo">
    If you want to receive a 404 HTTP response when the logo is not available, you can
    use the `fallback` parameter in the URL and set it to `404`. This is useful for
    handling cases where the logo is not found, and you want to handle it in your
    application.

    ```md Request theme={null}
    https://img.logokit.com/ticker/INVALID?fallback=404&token=<publishable-api-token>
    ```

    ```bash HTTP Response theme={null}
      404 Not Found
    ```
  </Accordion>
</AccordionGroup>

## Parameters


# Attribution (Free Plan)
Source: https://docs.logokit.com/attribution

As part of our commitment to providing valuable logo services to everyone, we offer a generous free plan with essential features. In return, we simply ask that free plan users include a small attribution link to LogoKit on pages where our logos appear.

**We give you creative freedom** in how you style and position this attribution to seamlessly blend with your website's design. While we're flexible about the presentation, we do ask that the attribution link:

* **Remains visible to your website visitors**
* **Isn't hidden behind overlays or obstructions**
* **Can be properly indexed by search engines**

This small acknowledgment helps us continue offering free logo services while growing our community. Here's a simple example you can customize to match your site's look and feel:

```markup Example attribution link theme={null}
 <a href="https://logokit.com" title="Logo API">Logos provided by LogoKit.com</a>
```


# Authentication
Source: https://docs.logokit.com/authentication

Authentication is a crucial aspect of using the LogoKit APIs. It ensures that only authorized users can access the API endpoints, providing a secure environment for retrieving branding assets and information. This page outlines how authentication works for both the Logo API and Brand API, detailing the differences between the two.

## Logo API Authentication

* **Method:** Query Parameter
* **Token Type:** Publishable API Token

To authenticate requests made to the Logo API, you need to include your publishable API token as a query parameter in the request URL. They are prefixed with `pk_` and are safe to expose in client-side code. Here's is an example:

```md Request theme={null}
https://img.logokit.com/apple.com?token=<publishable-api-token>
```

Where to Find Your Publishable API Token in the Dashboard:

1. Log in to your [LogoKit account](https://logokit.com/account).
2. Navigate to the [API Tokens section](https://logokit.com/account/api-tokens).
3. Your publishable token will be listed under Logo API Tokens.

## Brand API Authentication

* **Method:** HTTP Header
* **Token Type:** Secret API Token

Brand API endpoints are authenticated using Bearer token authentication. You must provide a valid API token in the `Authorization` header of your request. This token is used to verify your identity and grant access to the API. Make sure to keep this secret API token secure and do not share it publicly. You can find yours in [your account](https://logokit.com/account/api-tokens) under Brand API Tokens. Brand API tokens are prefixed with `sk_` and should be kept secret. Here is an example of how to include it in your request:

```bash Request theme={null}
curl "https://api.logokit.com/brands/<identifier>" \
     --header "Authorization: Bearer: <secret-api-token>"
```


# Free vs Paid Plans
Source: https://docs.logokit.com/free-vs-paid-plans

Learn about the differences between free and paid plans for the Logo and Brand API, including limitations and access to features.

## Logo API

The Logo API is available for both free and paid plans. However, the logos served with a free API token are limited to 64x64 pixels. If you need higher resolution logos, you can upgrade to a paid plan.

<Info>
  Free plan users are limited to 64x64px logos. If you need higher resolution
  logos, please [upgrade here](https://logokit.com/pricing).
</Info>

## Brand API

<Info>
  Free plan users do not have access to the Brand API. If you need access to the
  Brand API, please [upgrade here](https://logokit.com/pricing).
</Info>


# Introduction
Source: https://docs.logokit.com/introduction

Welcome to LogoKit – reliable Logo API for Brands, Stocks, ETFs & more. Seamlessly integrate logo images and brand data into your application in seconds.

<img alt="Hero Light" />

<img alt="Hero Dark" />

## Why Choose LogoKit?

Built for developers who need reliable access to logo images and brand data, LogoKit lets you fetch professional logos for any company by domain, brand name, or stock ticker with a simple API call.

We provide both visual assets and structured brand information, making it perfect for financial applications, business directories, job boards, onboarding experiences, client portals, or anywhere you need consistent company branding.

LogoKit handles the heavy lifting so you can focus on building great features for your users.
Get started with a few lines of code and watch your application instantly become more polished and professional.

## Use Cases

1. **Website Integration**: Automatically display logos for various brands on your website.
2. **Brand Insights**: Gather detailed information about companies to enhance user experience.
3. **Dynamic Branding**: Change logos dynamically based on user input or domain changes.

## API Reference

Explore our APIs to see how they can fit into your projects:

<CardGroup>
  <Card title="Logo API" icon="image" href="/api-reference/logo-API">
    Retrieve logos based on a domain or stock exchange ticker
  </Card>

  <Card title="Brand API" icon="code" href="/api-reference/brand-API">
    Get comprehensive data about companies and brands, including their address,
    social media links, corporate, and industry information.
  </Card>
</CardGroup>


# Install in your client
Source: https://docs.logokit.com/mcp/install

Connect the LogoKit MCP server to Claude Desktop, Claude Code, Cursor, VS Code, Codex, Windsurf, ChatGPT, and any other MCP-compatible client.

<Info>
  Replace `sk_pa_YOUR_KEY` with your secret API key from the [API Tokens
  dashboard](https://logokit.com/account/api-tokens). All clients use the same
  endpoint and Bearer authentication — only the location of the config file
  changes.
</Info>

## Universal config

Most clients read MCP servers from a JSON file. The config is the same shape everywhere:

```json theme={null}
{
  "mcpServers": {
    "logokit": {
      "url": "https://mcp.logokit.com/mcp",
      "headers": {
        "Authorization": "Bearer sk_pa_YOUR_KEY"
      }
    }
  }
}
```

Per-client locations and shortcuts are below.

## Claude Code

Use the `claude mcp add` CLI command:

```bash theme={null}
claude mcp add --transport http logokit \
  https://mcp.logokit.com/mcp \
  --header "Authorization: Bearer sk_pa_YOUR_KEY"
```

Add `--scope user` to make the server available across all projects.

## Cursor

<Steps>
  <Step title="Open MCP settings">
    Cursor → Settings → MCP, or open the Command Palette and run **"MCP: Add
    Server"**.
  </Step>

  <Step title="Paste the config">
    Paste the [universal config](#universal-config) into the editor and save.
  </Step>

  <Step title="Restart Cursor">
    Restart Cursor — the `logokit` server appears in the MCP list with two
    tools available.
  </Step>
</Steps>

You can also use a one-click install link from the [LogoKit MCP landing page](https://logokit.com/mcp).

## Claude Desktop

Edit your Claude Desktop config file:

* **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
* **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

Add the `logokit` entry to the `mcpServers` object (merge with any existing entries), then restart Claude Desktop:

```json theme={null}
{
  "mcpServers": {
    "logokit": {
      "url": "https://mcp.logokit.com/mcp",
      "headers": {
        "Authorization": "Bearer sk_pa_YOUR_KEY"
      }
    }
  }
}
```

## VS Code

VS Code supports remote MCP servers via GitHub Copilot Chat (and other MCP-compatible extensions).

<Steps>
  <Step title="Open the MCP config">
    Run **"MCP: Add Server"** from the Command Palette, or create a
    `.vscode/mcp.json` file in your workspace.
  </Step>

  <Step title="Paste the config">
    Use the [universal config](#universal-config).
  </Step>

  <Step title="Reload the window">
    Reload the VS Code window — the `logokit` tools become available to
    Copilot Chat.
  </Step>
</Steps>

## Codex

OpenAI Codex CLI reads MCP servers from `~/.codex/config.toml`. Add a TOML entry:

```toml theme={null}
[mcp_servers.logokit]
url = "https://mcp.logokit.com/mcp"

[mcp_servers.logokit.headers]
Authorization = "Bearer sk_pa_YOUR_KEY"
```

Restart any active Codex session for the change to take effect.

## Windsurf

Edit the Windsurf MCP config file (Settings → Cascade → MCP, or `~/.codeium/windsurf/mcp_config.json`), then restart Windsurf:

```json theme={null}
{
  "mcpServers": {
    "logokit": {
      "url": "https://mcp.logokit.com/mcp",
      "headers": {
        "Authorization": "Bearer sk_pa_YOUR_KEY"
      }
    }
  }
}
```

## ChatGPT

ChatGPT (Pro / Team / Enterprise) supports remote MCP servers via the **Connectors** UI:

<Steps>
  <Step title="Open Connectors">
    Settings → Connectors → **Add MCP server**.
  </Step>

  <Step title="Enter the endpoint">
    URL: `https://mcp.logokit.com/mcp`
  </Step>

  <Step title="Add the header">
    Header name: `Authorization` · Value: `Bearer sk_pa_YOUR_KEY`
  </Step>
</Steps>

## Other clients

LogoKit MCP works with any client that supports remote MCP over HTTP — including Continue, Cline, Zed, and others. Use the [universal config](#universal-config) and consult your client's documentation for where the MCP config file lives.

## Verify the connection

Once installed, the server registers two tools:

* `get_brand_by_domain(domain)`
* `get_brand_by_ticker(symbol)`

Try a quick prompt like *"Pull stripe.com using LogoKit"* or *"What company is ticker NVDA?"* — your assistant should call the relevant tool and return structured Brand Data.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Unauthorized / 401 error">
    The MCP server only accepts **secret** API keys (`sk_pa_…` or `sk_en_…`).
    Publishable keys (`pk_*`) are rejected. Generate a secret key in the
    [API Tokens dashboard](https://logokit.com/account/api-tokens).
  </Accordion>

  <Accordion title="Daily request limit reached">
    MCP calls share the daily quota of your Brand Data API plan. Limits reset
    at midnight UTC. [Upgrade your plan](https://logokit.com/pricing) for a
    higher quota.
  </Accordion>

  <Accordion title="Tools don't appear after install">
    Most clients require a full restart (not just a reload) after adding an MCP
    server. If the tools still don't show, check the client's MCP log — most
    clients surface connection errors there.
  </Accordion>

  <Accordion title="`No brand found` error">
    Brand coverage is constantly expanding. If a specific brand is missing,
    [report it from your dashboard](https://logokit.com/account) and we'll
    prioritize it.
  </Accordion>
</AccordionGroup>


# MCP Server
Source: https://docs.logokit.com/mcp/overview

Connect Claude, Cursor, ChatGPT, and other AI assistants to LogoKit's company database over the Model Context Protocol.

<Info>
  The LogoKit MCP server is available on **Startup, Scale, and Enterprise**
  plans. It uses the same secret API key as the Brand Data API — [upgrade
  here](https://logokit.com/pricing) if you are on the free plan.
</Info>

## What it is

LogoKit MCP is a hosted [Model Context Protocol](https://modelcontextprotocol.io) server that exposes LogoKit's brand database to AI assistants. Your agent can look up any company by domain or by financial identifier (ticker, ISIN, CUSIP, SEDOL, WKN) and receive structured Brand Data — logo URL, brand colors, social profiles, headquarters, founding year, employee range, and GICS classification.

* **Endpoint:** `https://mcp.logokit.com/mcp`
* **Transport:** Streamable HTTP (JSON-RPC 2.0)
* **Protocol version:** `2024-11-05`
* **Authentication:** Bearer secret key (`sk_pa_…` or `sk_en_…`)

## Authentication

Pass your secret API key in the `Authorization` header:

```http theme={null}
Authorization: Bearer sk_pa_YOUR_KEY
```

Only secret keys are accepted — publishable keys (`pk_*`) are rejected because MCP traffic is run by your agent, not an end-user's browser. Find your secret key in the [API Tokens dashboard](https://logokit.com/account/api-tokens).

## Tools

The MCP server exposes two tools. Both return the same Brand Data record.

### `get_brand_by_domain`

Look up a brand by its canonical website domain. Subdomains and `www.` prefixes are normalized automatically.

| Argument | Type   | Required | Description                                     |
| -------- | ------ | -------- | ----------------------------------------------- |
| `domain` | string | yes      | Website domain — e.g. `stripe.com`, `apple.com` |

```json Example call theme={null}
{
  "name": "get_brand_by_domain",
  "arguments": { "domain": "stripe.com" }
}
```

### `get_brand_by_ticker`

Look up a brand by a financial security identifier. Accepts stock tickers, ISIN, CUSIP, SEDOL, and WKN — case-insensitive.

| Argument | Type   | Required | Description                                                                                       |
| -------- | ------ | -------- | ------------------------------------------------------------------------------------------------- |
| `symbol` | string | yes      | Ticker (`AAPL`), ISIN (`US0378331005`), CUSIP (`037833100`), SEDOL (`2046251`), or WKN (`865985`) |

```json Example call theme={null}
{
  "name": "get_brand_by_ticker",
  "arguments": { "symbol": "NVDA" }
}
```

## Response shape

A successful tool call returns the Brand Data record as both pretty-printed text content and structured content:

```json theme={null}
{
  "name": "Apple",
  "domain": "apple.com",
  "long_name": "Apple Inc.",
  "website": "https://www.apple.com",
  "logo": "https://img.logokit.com/apple.com",
  "colors": ["#000000", "#f5f5f7", "#ffffff"],
  "founded_year": 1977,
  "number_of_employees": "150,000-200,000",
  "social_media": {
    "x": "https://x.com/apple",
    "linkedin": "https://www.linkedin.com/company/apple"
  },
  "address": {
    "address1": "One Apple Park Way",
    "city": "Cupertino",
    "state": "CA",
    "zip": "95014",
    "country": "US"
  },
  "gics_sector": "Information Technology",
  "gics_industry": "Technology Hardware, Storage & Peripherals"
}
```

<Tip>
  Empty and missing fields are **omitted** from the response. Absence does not
  imply the brand lacks the attribute — it means LogoKit doesn't have the value
  populated yet. Your agent should present the returned data as-is and avoid
  speculating about missing fields.
</Tip>

## Errors

Errors follow the JSON-RPC 2.0 spec. Common cases:

| Code     | Meaning                                                                 |
| -------- | ----------------------------------------------------------------------- |
| `-32001` | Unauthorized — missing/invalid key, banned, inactive, or quota exceeded |
| `-32601` | Method not found                                                        |
| `-32602` | Invalid arguments (unknown tool, missing required arg)                  |
| `-32700` | Parse error — invalid JSON                                              |
| `-32603` | Internal server error                                                   |

When a brand cannot be found, the tool call returns an `isError: true` result with a descriptive message rather than a JSON-RPC error — so the agent can recover gracefully and ask the user for a different identifier.

## Usage and quotas

MCP requests count against your Brand Data API quota. You can monitor your usage in the [developer dashboard](https://logokit.com/account/api-tokens).

Plan limits are 25K and 100K requests/day for Startup and Scale respectively. Token status (`active`, `usage_exceeded`, `banned`) is enforced on every request — see [Rate Limits](/rate-limits) for details.

## Next step

<Card title="Install in your client" icon="plug" href="/mcp/install">
  Copy-pasteable configs for Claude Desktop, Claude Code, Cursor, VS Code,
  Codex, Windsurf, ChatGPT, and any other MCP-compatible client.
</Card>


# Migrate from Clearbit
Source: https://docs.logokit.com/migrate-from-clearbit

A step-by-step guide to migrate from Clearbit to LogoKit

## Why migrate?

Clearbit’s Logo API will be deprecated and shut down by December 1, 2025, which means any existing integrations using their service will stop working.
Logokit offers a free drop-in replacement for Clearbit’s logo service.

## Clearbit vs. LogoKit

LogoKit supports all the features offered by Clearbit, plus additional capabilities that set us apart. In addition to providing fast and reliable access to company logos and brand assets, we offer stock logos from all major global exchanges, including NYSE, NASDAQ, TSE, LSE, SZSE, Euronext, Deutsche Boerse, and more. Our structured Brand Detail API lets you retrieve up-to-date, detailed brand information with a single call, making it easy to access everything you need in one place.

## Migration

<Steps>
  <Step title="Create your LogoKit account">
    If you don’t already have a LogoKit account, create one.

    <Card title="Sign-up for a free LogoKit account" href="https://logokit.com/sign-up">
      Create a free account
    </Card>
  </Step>

  <Step title="Grab your API tokens">
    In the dashboard open [Account → API
    Tokens](https://logokit.com/account/api-tokens).

    **Publishable token** is safe to embed in public pages and CDN URLs, while **Secret token** should be kept private and used for server-side requests.
  </Step>

  <Step title="Replace the Clearbit URL with LogoKit">
    **Old Clearbit CDN**

    ```html theme={null}
      <img src="https://logo.clearbit.com/stripe.com" />
    ```

    **Drop-in replacement with LogoKit**

    ```html theme={null}
      <img src="https://img.logokit.com/stripe.com?token=<publishable-api-token>" alt="Stripe logo (identification only, no affiliation)" />
    ```

    Nothing else in your HTML changes—just replace the domain and append your
    token.
  </Step>

  <Step title="Call the Brand API (optional)">
    If you previously enriched companies via Clearbit’s Enrichment API, call LogoKit’s Brand API instead:

    ```bash theme={null}
    curl -H "Authorization: Bearer <secret-api-token>" \
         "https://api.logokit.com/brands/stripe.com"
    ```

    The response includes the company’s name and details, including their address,
    social media links, corporate, and industry information.
  </Step>

  <Step title="Test & deploy">
    Open a test page or run your suite and confirm that:

    * Logos render for every domain you expect.
    * No requests hit `logo.clearbit.com` in your network tab.\
      Once everything looks good, ship to production well before December 1 2025.
  </Step>
</Steps>

## API Reference

<CardGroup>
  <Card title="Logo API" icon="image" href="/api-reference/logo-API">
    Retrieve logos by domain or stock-ticker and optionally set size or format.
  </Card>

  <Card title="Brand API" icon="code" href="/api-reference/brand-API">
    Full company profile – headquarters, founding year, employee count, and
    more.
  </Card>
</CardGroup>

***

**Have questions or need help with the migration?**

Drop us a line at [support@logokit.com](mailto:support@logokit.com).

***

*Migrated in minutes—before your users ever notice the change.*


# Quick Start Guide
Source: https://docs.logokit.com/quick-start

A step-by-step guide to get started with LogoKit APIs

<Steps>
  <Step title="Create an Account">
    Visit our [sign-up page](https://logokit.com/sign-up) to create an account.
    You can sign up using your email or Google account. Once you have signed up,
    you will have access to your account dashboard.
  </Step>

  <Step title="Obtain API Tokens">
    After signing up, you can find your API tokens in your [account
    settings](https://logokit.com/account/api-tokens). Make sure to keep your
    secret API token secure and do not share it publicly.
  </Step>

  <Step title="Integrate with Your Application">
    ```md Logo API Request theme={null}
    https://img.logokit.com/<identifier>?token=<publishable-api-token>
    ```

    ```bash Brand API Request theme={null}
    curl "https://api.logokit.com/brands/<identifier>" \
         --header "Authorization: Bearer: <secret-api-token>"
    ```
  </Step>
</Steps>

## API Reference

You can find detailed information about our APIs in the API Reference section. Here are the two main APIs you will be using:

<CardGroup>
  <Card title="Logo API" icon="image" href="/api-reference/logo-API">
    Retrieve logos based on a domain or stock exchange ticker
  </Card>

  <Card title="Brand API" icon="code" href="/api-reference/brand-API">
    Get comprehensive data about companies, including their address, founding
    year, and number of employees and more
  </Card>
</CardGroup>


# Rate Limits
Source: https://docs.logokit.com/rate-limits

Rate limiting is enforced based on the user's plan. Keep this in mind to avoid hitting your limits during development. To get more information about the rate limits, please refer to the [pricing page](https://logokit.com/pricing).

## Rate Limit Responses

When you exceed your rate limits, the API will respond with a `429 Too Many Requests` status code. This response indicates that you've reached your plan's limit for the current time period.

## Monitoring Your Usage

You can monitor your API usage at any time by visiting your [account dashboard](https://logokit.com/account). The dashboard provides detailed insights into:

* Current usage statistics
* Remaining quota
* Historical usage patterns
* Rate limit thresholds

## Rate Limit Notifications

To help you manage your API usage effectively, we provide proactive notifications when you're approaching your rate limits.
These notifications help you plan ahead and upgrade your plan if needed, ensuring uninterrupted service for your applications.


# API Status
Source: https://docs.logokit.com/support/api-status





# Report Inaccurate Data
Source: https://docs.logokit.com/support/report-inaccurate-data