flipzi-mcp

Flipzi MCP サーバー

Claude、Cursor、または任意の MCP クライアントに、トレーディングカードの価格を問い合わせられます。カードの検索、現在価格や売却実績、価格履歴、市場の値動き、ゲーム、セットを確認できます。Flipzi Data API を薄くラップしたローカルのラッパーです。Flipzi API キーはご自身でご用意ください。無料プランではカード情報は不要です。

stdio（npx）を介してお使いのマシン上で動作します。ホストされているものはなく、ネットワーク通信は data.flipzi.io へのリクエストのみです。

ソース：https://github.com/flipzitcg/flipzi-mcp。公開ミラーです。問題の報告はプルリクエストではなく、GitHub の issue としてお寄せください。

1. キーを取得する（無料）

1. アカウントを作成します：https://flipzi.io/account/register?product=data&utm_source=npm&utm_medium=directory&utm_campaign=202610_mcp
2. メールアドレスを確認します。無料キーの利用枠（月500ユニット、毎分5リクエスト）が作成されます。
3. https://flipzi.io/account/keys でキーを作成します（fz_live_ で始まり、一度だけ表示されます）。

2. AI ツールに追加する

Node.js 18 以降が必要です。fz_live_... をご自身のキーに置き換えてください。

Claude Code

claude mcp add --env FLIPZI_API_KEY=fz_live_... --transport stdio flipzi -- npx -y @flipzitcg/mcp

claude mcp list または /mcp で確認します。すべてのプロジェクトで使うには --scope user を追加してください。

Claude Desktop（ワンクリック） — リリース後に、GitHub のリリースから flipzi-mcp.mcpb をダウンロードして開きます。Claude Desktop でマスクされた入力欄にキーを入力します。

Claude Desktop（設定ファイル） — Settings → Developer → Edit Config（macOS の場合は ~/Library/Application Support/Claude/claude_desktop_config.json、Windows の場合は %APPDATA%\Claude\claude_desktop_config.json）を開き、アプリを完全に終了してから再起動します。

{
  "mcpServers": {
    "flipzi": {
      "command": "npx",
      "args": ["-y", "@flipzitcg/mcp"],
      "env": { "FLIPZI_API_KEY": "fz_live_..." }
    }
  }
}

Cursor — 同じブロックを ~/.cursor/mcp.json（すべてのプロジェクト）または .cursor/mcp.json（1つのプロジェクト）に追加します。キーを含むファイルをコミットしないでください。

次のように質問してみましょう：「Umbreon VMAX の現在の価値はいくらですか？」 または flipzi_account を呼び出してプランを確認できます。

ツール

ツール	必要なプラン	ユニット	機能
flipzi_account	任意のキー	0	ご利用のプラン、使用済みの利用枠、プランで利用可能なツール
flipzi_list_games	Free	1	対応ゲーム
flipzi_list_sets	Free	1	ゲームのセット
flipzi_list_set_cards	Free	1	セット内のカード（カード ID を取得）
flipzi_search_cards	Free	1	名前で検索
flipzi_get_card	Free	1	カードの詳細
flipzi_get_price	Free	1	現在価格、市場価格、信頼度（グレーディング済みカードは Pro が必要）
flipzi_get_history	Basic	1	日次の履歴（Basic は30日分、Pro 以上はさらに長期間）
flipzi_get_sold_comps	Pro	1	eBay で購入者が実際に支払った価格
flipzi_get_movers	Ultra	5	ゲーム内で値上がり・値下がりが最も大きいカード
flipzi_get_box_value	Pro	1	未開封ブースターボックスの価格と、封入カードの推定価値を比較します（確認条件を満たす英語版ポケモンのボックスが対象。保証ではなく、価格帯を示します）
flipzi_get_cardmarket_conditions	Ultra	1	言語、仕上げ、Cardmarket のグレード（Mint から Poor）別の Cardmarket 出品価格：最安値と中央値、および読み取り日

必要なプラン情報は推測ではなく、API 独自の仕様（openapi.yaml、バージョンは src/plans.generated.ts）から取得しています。プランと料金：https://flipzi.io/api/pricing/?utm_source=npm&utm_medium=directory&utm_campaign=202610_mcp。**すべてのツールが常に一覧表示されます。**ご利用のプランに含まれないツールを使うと、その旨と利用可能なプランを提示し、アップグレードへのリンクを表示します。利用できないツールの呼び出しにかかるユニットは0です。

利用枠と制限

• 1 回の呼び出しにつき 1 ユニット（movers は 5 ユニット）です。API はアカウントごとに UTC 月単位でカウントします。残りの利用枠は flipzi_account で確認できます。
• 無料プランでは、1 分あたり 5 リクエストが許可されています。短い待ち時間（≤10 s）は 1 回自動で再試行されます。より長い待ち時間は通知されます。
• **セッション予算：**このサーバーは、1 回の実行で FLIPZI_MCP_MAX_UNITS ユニット（デフォルトは 150）を使うと、自動的に停止します。これにより、エージェントのループで月間の利用枠を使い切ることを防ぎます。無制限にするには 0 を設定してください。リセットするにはサーバーを再起動してください。
• 出力は 1 回の呼び出しにつき約 20 KB に制限されています。検索ではデフォルトで 10 件のカードが返されます。

設定（環境変数）

変数	デフォルト
FLIPZI_API_KEY	必須	キーです。表示またはログへの記録はされません。
FLIPZI_MCP_MAX_UNITS	150	1 回の実行あたりのユニット予算。0 = 無制限
FLIPZI_MCP_NO_CLIENT_TAG	未設定	1 を設定すると、以下のクライアントヘッダーの送信を停止します
FLIPZI_API_BASE	https://data.flipzi.io	テスト専用

送信される情報と Flipzi が把握する情報（隠れたテレメトリーはありません）

• リクエストは、他の API クライアントと同様に、キーとともに data.flipzi.io に送信されます。それ以外のネットワーク呼び出し、分析サービス、更新チェック、リモート制御はありません。
• 各リクエストには User-Agent: flipzi-mcp/<version> と X-Flipzi-Client: mcp/<version> が含まれます。Flipzi が記録するのは、呼び出し元が MCP サーバーであること（値は mcp）のみです。これにより、MCP の利用状況を集計し、どのプラン制限付きツールが試されたかを確認できます。オプトアウトするには FLIPZI_MCP_NO_CLIENT_TAG=1 を設定してください。ほかの動作は変わりません。
• このサーバーが出力するリンク（登録、キー、アップグレード）には utm_source=mcp が含まれます。これにより、アカウントがここから作成されたことを Flipzi が把握できます。通常のクエリパラメーターなので、削除できます。
• プロンプト、会話、カードのクエリは、依頼した呼び出しの API パラメーターとして送信される場合を除き、どこにも送信されません。

トラブルシューティング

• 「FLIPZI_API_KEY is not set」 — クライアント設定の env にキーがありません。編集後にクライアントを再起動してください。
• Claude Desktop にツールが表示されない — 完全に終了してから再度開いてください。~/Library/Logs/Claude/mcp-server-flipzi.log（macOS）または %APPDATA%\Claude\logs（Windows）を確認してください。Windows で npx が失敗する場合は、npm をグローバルにインストールしてください（npm install -g npm）。
• 「Not on your plan」 — 想定どおりの動作です。表を参照してください。flipzi_account を実行してください。
• サポートに問い合わせる際は、エラーに含まれる request_id を伝えてください。SUPPORT.md を参照してください。

無料プランには商用利用の許諾はありません。データは情報提供のみを目的としています。API 利用規約を参照してください。MIT ライセンス。