# Brandfetch — how to use (mcp.ai)

Connect your Brandfetch account and use 7 tools for images and design straight from your AI agent. Connect with your own API key. Brandfetch offers an API that retrieves company logos, brand colors, and other visual assets, helping marketers and developers maintain consistent branding across apps.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_brandfetch?ms=1787293440000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `brandfetch_get_brand_info`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/brandfetch`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/brandfetch/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/brandfetch/get/brand/info` — Retrieves brand information including logos, colors, fonts, and company details using a domain, Brand ID, ISIN, or stock ticker. Logo data may be absent for some domains — do not assume logos are alwa
  - body: { identifier: string }
- `POST https://api.mcp.ai/api/brandfetch/get/graphql/version` — Tool to retrieve the Brandfetch GraphQL API version. Use when you need to check the current API version via the GraphQL endpoint.
  - body: { query?: string }
- `POST https://api.mcp.ai/api/brandfetch/get/taxonomy` — Tool to retrieve Brandfetch's taxonomy via GraphQL API. Use this to get a complete list of industries, countries, and geographic regions used in Brandfetch's classification system. The taxonomy includ
  - body: { query?: string }
- `POST https://api.mcp.ai/api/brandfetch/get/transaction/info` — This tool converts payment transaction labels into detailed merchant brand information. It takes a transaction label (like what you see on your credit card statement) and returns comprehensive brand d
  - body: { countryCode: string, transactionLabel: string }
- `POST https://api.mcp.ai/api/brandfetch/list/subscribable/events` — Tool to retrieve all available webhook event types that can be subscribed to via the Brandfetch GraphQL API. Returns event names and descriptions for webhook configuration. Available events include br
- `POST https://api.mcp.ai/api/brandfetch/list/webhooks` — Tool to retrieve a list of all webhooks via GraphQL API. Use when you need to query webhook configurations and their statuses in the Brandfetch system.
  - body: { query?: string }
- `POST https://api.mcp.ai/api/brandfetch/search/brands` — Searches for brands by name and returns matching brand information including URLs and icons, enabling rich autocomplete experiences. Use this tool first to resolve a vague name or ticker to a precise 
  - body: { name: string }

## Example prompts
- "What can I do in Brandfetch?"
- "Show me a summary of my Brandfetch account"

## More
- Page: https://mcp.ai/brandfetch
- Agent spec (llms.txt): https://mcp.ai/brandfetch/llms.txt
- Postman collection: https://mcp.ai/brandfetch/postman.json
