Valo.IA (ValoTCG)

Valo.IA — トレーディングカード価格情報の MCP サーバー

AI エージェントにトレーディングカードの価値を尋ねると、出典と日付が明記された回答が得られます。 Valo.IA は、ValoTCG を支えるホスト型の MCP サーバーです。14 種のゲームにわたる 540,000 件以上のカード情報を収録し、欧州の実勢価格（Cardmarket、EUR）、米国市場価格、eBay での実際の販売価格、鑑定済みカードの販売実績と PSA 登録枚数、未開封商品、過去 365 日間の価格推移を提供します。設定を 1 行追加し、API キーを 1 つ用意するだけで、エージェントが市場アナリストのようにコレクション、ショップの在庫、または単体の開封カードの価格を算出します。

対応ゲーム： Pokémon · One Piece Card Game · Disney Lorcana · Yu-Gi-Oh! · Magic: The Gathering · Dragon Ball Super Card Game (Masters) · Dragon Ball Super Card Game Fusion World · Union Arena · Riftbound: League of Legends TCG · Cyberpunk Trading Card Game · Naruto Mythos TCG · Flesh and Blood · Gundam Card Game · Star Wars: Unlimited。各ゲームでカードが印刷されている言語（英語、フランス語、日本語、中国語）に対応しています。ソースごとの最新の対応状況は https://valotcg.com/developers/coverage で確認できます。

エージェントに選ばれる理由

• すべての価格に、出典、通貨、日付が明記されています。複数の価格を混ぜた数値や、知らないうちの通貨換算はなく、ソースに情報がない場合は推測せずに status: "missing" を返します。

• 鑑定済みと未鑑定を同じ呼び出しで確認できます。未鑑定価格と並べて、PSA 9 および PSA 10 の eBay 中央値（過去 30 日間と 90 日間）、さらにグレードごとの PSA と CCC の登録枚数を取得できるため、鑑定に出す価値があるか判断できます。

• すぐに使える回答を提供します。price_summary は信頼度と直近の変動を添えて推奨価格を返し、top_movers と top_priced はセット全体をランキングし、compare_prices は 10 枚のカードを横並びで比較します。

• ツール利用を念頭に設計されています。読み取り専用で冪等なツールが 16 種あり、レスポンスにはクレジット使用量が含まれます。エラーは請求対象外で、試用できる無料の Sandbox キーもあります。

• エンドポイント： https://api.valotcg.com/mcp（Streamable HTTP、ステートレス、JSON レスポンス）

• レジストリ名： com.valotcg/valo-ia

• 認証： Authorization: Bearer <Valo.Data API key> — キーなしでも initialize と tools/list は動作します。ツールの呼び出しにはキーが必要です

• ドキュメント： https://valotcg.com/developers/docs · 製品ページ： https://valotcg.com/developers/ia

このリポジトリには、サーバーの公開メタデータ（server.json）、セットアップ手順、使用例が含まれています。サーバー本体は ValoTCG のインフラストラクチャで稼働しているため、ここからインストールやビルドを行う必要はありません。

クイックスタート

1. https://valotcg.com/developers/account で無料の Sandbox キーを作成します（クレジットカード不要）。キーの形式は vd_test_…（Sandbox）または vd_live_…（有料プラン）です。
2. MCP サーバーをクライアントに追加します。

Claude Code

claude mcp add --transport http valotcg https://api.valotcg.com/mcp \
  --header "Authorization: Bearer $VALO_DATA_API_KEY"

Cursor、VS Code、Windsurf などの JSON 設定対応クライアント

{
  "mcpServers": {
    "valotcg": {
      "type": "streamable-http",
      "url": "https://api.valotcg.com/mcp",
      "headers": {
        "Authorization": "Bearer vd_live_…"
      }
    }
  }
}

3. 「151 のフランス語版、リザードンex 199/165 の現在の Cardmarket 価格は？」 のようにエージェントに尋ねます。エージェントは identify_card を呼び出した後、get_card_prices または price_summary を呼び出します。

ツール

16 個のツールはすべて読み取り専用で、冪等性があります。各呼び出しでは Valo.Data クレジットが消費されます（クレジットの消費量は tools/list にツールごとに記載されています）。エラーによる課金はありません。

ツール	機能
list_games	上記の 14 種類のゲーム、それぞれのカード言語とデータソースごとのカバレッジを一覧表示します。無料です。
list_editions	ゲームのセットと拡張版を、名称またはセットコードで検索します。
search_cards	カードを名称（FR/EN）、番号、エディション、言語、レアリティで検索します。
get_card	カード 1 枚の情報（名称、番号、レアリティ、画像、Cardmarket および米国市場の ID）を取得します。
get_card_prices	カードの現在価格をデータソースごとに取得します。各価格には日付が付きます。任意で、鑑定済みカードの中央値と PSA/CCC の登録枚数も取得できます。
get_cards_batch	1 回の呼び出しで、最大 100 枚のカードまたは未開封商品を取得します。
get_price_history	カードについて、1 つのデータソースの日次履歴を最大 365 日分取得します。観測された日ごとに 1 件のデータポイントが返されます。
search_sealed	未開封商品（ブースターパック、ディスプレイ、ETB、ボックス）を検索します。
get_sealed_prices	未開封商品の現在価格をデータソースごとに取得します。
identify_card	「dracaufeu 199 151 fr」のような自由入力テキストからカードを特定します。
price_summary	カードまたは未開封商品の推奨価格、信頼性、最近の変動を取得します。
compare_prices	最大 10 点のカードと未開封商品の価格概要を並べて表示します。
top_movers	ゲームまたはエディションの、7 日、30 日、90 日間における最大の価格上昇または下落を取得します。
top_priced	ゲーム、エディション、または言語の、最も価値の高いカードまたは未開封商品を取得します。
edition_overview	エディションの注目カード、未開封商品、価格カバレッジを表示します。
scan_card	写真からカードを認識し、Valo.Data の ID を返します（Vision スコープを持つキーのみ）。

見積もりが存在しない場合は、status: "missing" と金額 null が返され、架空の数値が示されることはありません。すべての価格には、データソース、通貨、観測日が付いています。通貨間の換算は行いません。

動作と制限

• initialize と tools/list はキーなしで応答するため、ディレクトリやクライアントはサーバーを確認できます。有効なキーなしで tools/call を呼び出すと、キーのページを示すツールエラー（invalid_api_key。課金なし）が返されます。
• /mcp への GET と DELETE は 405 を返します。サーバーはステートレスで、SSE ストリームやセッションはありません。
• カバレッジはゲームによって異なります。最新のマトリックスは https://valotcg.com/developers/coverage で確認できます。
• Sandbox キーはプロトタイピングと非商用利用向けです。有料プランには商用ライセンスが含まれます。価格は税抜きで、VAT は適用されません（フランス税法 art. 293 B）。プラン：https://valotcg.com/developers/pricing。

リンク

• 公式 MCP Registry：https://registry.modelcontextprotocol.io/v0.1/servers?search=com.valotcg/valo-ia
• Glama：https://glama.ai/mcp/connectors/com.valotcg/valo-ia
• mcptry：https://mcptry.com/servers/com.valotcg/valo-ia
• REST API（同じキー、同じデータ）：https://valotcg.com/developers/api/pokemon
• お問い合わせ：[email protected]

ライセンス

このリポジトリ内のファイルは MIT ライセンスで公開されています（LICENSE を参照）。Valo.IA サービス自体の利用には、API 利用規約が適用されます。