Brandfetch

Brandfetch MCP サーバー

Brandfetch の公式 Model Context Protocol サーバーです。 AI アシスタントが Brandfetch API からブランド検索、企業データ、ロゴやデザインアセット、LLM 向けのブランドコンテキストにアクセスできるようにします。

• 詳細はこちら：https://brandfetch.com/developers/mcp
• ドキュメント全文：https://docs.brandfetch.com/mcp/overview

ツール

ツール	説明
brand_search	Brandfetch の検索インデックスを使って、名前からブランドを検索します。
get_brand	ドメイン、メールアドレス、ティッカー、ISIN、または暗号資産のシンボルからブランドの全データを検索します。MCP Apps ホストでは、インタラクティブなブランドカードを表示します。
get_brand_data	カードを表示せずに同じブランドデータを返します。生成コンテンツに使うデータや、1 つのブランドの全レコードを取得する場合に便利です。
get_brands	1 回の呼び出しで最大 25 件のブランドを、カードなしのコンパクトなレコードとして取得します。ロゴ一覧、比較表、企業リストに便利です。
enrich_transaction	クレジットカードや銀行明細の文字列から、加盟店のブランドを特定します。
get_brand_context	ドメインの LLM 向けブランドコンテキスト（トーン、オーディエンス、ポジショニング、スタイル）を取得します。
build_logo_urls	1 つ以上のブランドの Brandfetch Logo CDN URL を生成します（API 呼び出しなし）。
send_feedback	バグ、誤りや古いブランドデータ、不足している機能を Brandfetch に報告します。

インタラクティブなブランドカード（MCP Apps）

MCP Apps 拡張機能に対応しているホスト（claude.ai、Claude Desktop など）では、get_brand の結果がインタラクティブなブランドカードとして表示されます。ロゴのプレビュー、形式の切り替え（SVG/PNG/WebP/...）、ダウンロード、URL のコピー操作を利用できます。Apps に対応していないホストでは、通常の JSON ツール結果が返されます。get_brand_data はカードなしで同じブランドデータを返します。また、get_brands は 1 回の呼び出しで複数のブランドを取得するため、6 ブランドのロゴ一覧を表示する場合、6 枚のカードではなく 1 回の一括呼び出しで済みます。モデルは、それぞれの説明に基づいて 3 つのツールから選択します。ウィジェットのソースは ui/ にあり、サーバーから ui://brandfetch/brand-card.html リソースとして配信されます。

クイックスタート（ホスト型サーバー）

このサーバーを利用する最も簡単な方法は、Brandfetch がホストするエンドポイントに接続することです。インストールやインフラは不要です。

https://mcp.brandfetch.io/mcp

認証には Brandfetch MCP トークン（bf1. ベアラートークン）を使用します。Brandfetch ダッシュボードの Keys and MCP ページで生成するか、OAuth に対応したクライアントから接続してください。

Claude Desktop / Claude Code

{
  "mcpServers": {
    "brandfetch": {
      "type": "http",
      "url": "https://mcp.brandfetch.io/mcp",
      "headers": {
        "Authorization": "Bearer bf1.YOUR_TOKEN"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json（またはプロジェクトの .cursor/mcp.json）に追加します。

{
  "mcpServers": {
    "brandfetch": {
      "url": "https://mcp.brandfetch.io/mcp",
      "headers": {
        "Authorization": "Bearer bf1.YOUR_TOKEN"
      }
    }
  }
}

OAuth に対応したクライアントは、トークンを指定せずに https://mcp.brandfetch.io/mcp を指定し、ブラウザーで認証フローを完了することもできます。

クォータエラー

get_brand、get_brand_data、get_brands、enrich_transaction、get_brand_context はプランの API クレジットを消費します。brand_search と build_logo_urls はクレジットを消費せず、クレジットがなくなっても引き続き使用できます。get_brands は返すブランド 1 件につき 1 クレジットを消費します。それ以外の結果はすべて無料です。

• 429 "API quota exhausted" — API クレジットをすべて使い切っています。 Brandfetch ダッシュボードで使用状況を確認するか、プランをアップグレードしてください。
• 429 "Not enough API credits left for this batch" — get_brands が、残りのクレジット数を超えるブランドを要求しました。クレジットは消費されていません。要求するブランド数を減らしてください。
• 403 "Batch lookups need a paid plan or prepaid credits" — 無料プランでは get_brands を利用できません。get_brand_data を使うと、同じブランドを 1 件ずつ取得できます。
• 403 "Forbidden" — API クレジットが残っていないか、そのエンドポイントへのアクセス権がありません。キー自体は有効な可能性があるため、キーをローテーションする前にダッシュボードでプランとキーの状態を確認してください。

セルフホスティング

これは、FastMCP で構築された HTTP（streamable-http）MCP サーバーです。 Docker を使って独自のインスタンスを実行できます。

docker build -t brandfetch-mcp-server .
docker run --rm -p 8080:8080 brandfetch-mcp-server

サーバーは http://localhost:8080/mcp でリッスンします。MCP クライアントの接続先にこの URL を指定し、Brandfetch の認証情報を Bearer トークンとして送信してください。

Dockerfile にはAWS Lambda Web Adapter といくつかの AWS_LWA_* 環境変数が含まれています。これらは AWS Lambda 以外では機能しないため、通常のコンテナ／ホストへのデプロイでは無視するか、削除できます。

Docker を使わずに実行する

uv sync
uv run uvicorn src.main:app --host 0.0.0.0 --port 8080

開発

uv と Python 3.11 が必要です。

uv sync                 # install dependencies
uv run pytest           # run the tests
uv run ruff check .     # lint
uv run ruff format .    # format

ライセンス

MIT