{
  "markdown": "# Brandfetch MCP Server\n\nThe official [Model Context Protocol](https://modelcontextprotocol.io) server for\n[Brandfetch](https://brandfetch.com). It gives AI assistants access to brand\nsearch, company data, logos and design assets, and LLM-ready brand context from\nthe Brandfetch API.\n\nFull documentation: **https://docs.brandfetch.com/mcp/overview**\n\n## Tools\n\n| Tool                 | Description                                                                     |\n| -------------------- | ------------------------------------------------------------------------------- |\n| `brand_search`       | Search for brands by name using Brandfetch's search index.                      |\n| `get_brand`          | Look up full brand data by domain, stock ticker, ISIN, or crypto symbol.        |\n| `enrich_transaction` | Identify a merchant brand from a credit-card or bank-statement string.          |\n| `get_brand_context`  | Get LLM-ready brand context for a domain — voice, audience, positioning, style. |\n| `build_logo_urls`    | Construct Brandfetch Logo CDN URLs for one or more brands (no API call).        |\n| `send_feedback`      | Report bugs, wrong or stale brand data, or missing capabilities to Brandfetch.  |\n\n## Quick start (hosted server)\n\nThe easiest way to use this server is to connect to the Brandfetch-hosted\nendpoint — no install, no infrastructure:\n\n```\nhttps://mcp.brandfetch.io/mcp\n```\n\nAuthentication uses a Brandfetch MCP token (a `bf1.` bearer token). Generate one\nfrom the **Keys and MCP** page in the\n[Brandfetch dashboard](https://developers.brandfetch.com), or connect via OAuth\nfrom a client that supports it.\n\n### Claude Desktop / Claude Code\n\n```json\n{\n  \"mcpServers\": {\n    \"brandfetch\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.brandfetch.io/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer bf1.YOUR_TOKEN\"\n      }\n    }\n  }\n}\n```\n\n### Cursor\n\nAdd to `~/.cursor/mcp.json` (or the project `.cursor/mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"brandfetch\": {\n      \"url\": \"https://mcp.brandfetch.io/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer bf1.YOUR_TOKEN\"\n      }\n    }\n  }\n}\n```\n\nClients that support OAuth can instead point at `https://mcp.brandfetch.io/mcp`\nwith no token and complete the authorization flow in the browser.\n\n## Quota errors\n\n`get_brand`, `enrich_transaction`, and `get_brand_context` consume API credits\nfrom your plan; `brand_search` and `build_logo_urls` don't and keep working\nwhen your credits run out.\n\n- **429 \"API quota exhausted\"** — your key has used all of its API credits.\n  Check usage or upgrade in the [Brandfetch dashboard](https://developers.brandfetch.com).\n- **403 \"Forbidden\"** — the key has no available API credits or lacks access\n  to that endpoint. The key itself may be valid, so check your plan and key\n  status in the dashboard before rotating it.\n\n## Self-hosting\n\nThis is an HTTP (streamable-http) MCP server built with\n[FastMCP](https://github.com/jlowin/fastmcp). You can run your own instance with\nDocker.\n\n```bash\ndocker build -t brandfetch-mcp-server .\ndocker run --rm -p 8080:8080 brandfetch-mcp-server\n```\n\nThe server then listens on `http://localhost:8080/mcp`. Point your MCP client at\nthat URL and send your Brandfetch credentials as a `Bearer` token.\n\n> The `Dockerfile` bundles the [AWS Lambda Web Adapter](https://github.com/awslabs/aws-lambda-web-adapter)\n> and a few `AWS_LWA_*` environment variables. These are inert outside of AWS\n> Lambda and can be ignored (or removed) for a plain container/host deployment.\n\n### Running without Docker\n\n```bash\nuv sync\nuv run uvicorn src.main:app --host 0.0.0.0 --port 8080\n```\n\n## Development\n\nRequires [uv](https://docs.astral.sh/uv/) and Python 3.11.\n\n```bash\nuv sync                 # install dependencies\nuv run pytest           # run the tests\nuv run ruff check .     # lint\nuv run ruff format .    # format\n```\n\n## License\n\n[MIT](./LICENSE)\n",
  "bytes": 3915,
  "sha": "e68d7d2e658282149cbb5493dc3bc5e12b59f851146dfd12af1cecbcb76ec836",
  "repo_slug": "brandfetch/brandfetch-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_brandfetch_brandfetch_423f6a72/readme"
}