Lithium Vault

lithium-vault-mcp

AI エージェントにリチウム／バッテリーメタル採掘の一次資料データ（生産量、AISC、埋蔵量、所有権、ロイヤルティ、オフテイク契約、企業財務）を提供するMCPサーバーです。40社の生産者と49鉱山のデータを収録し、すべての数値はSEC／ASX／TSX／SEDAR／cninfoへの提出書類から抽出され、為替レートで米ドルに換算されています。

データはLithium Research Vault（agentic.marketに掲載）から取得しています。各ツール呼び出しの料金は、x402を通じてご自身のウォレットからUSDCでリクエストごとに支払います。当社側のサブスクリプションやAPIキーは不要です。

ツール

ツール	価格	戻り値
lithium_vault_summary	$0.02	最新の生産量、数量加重AISC、実現価格、現金／負債／EBITDA／FCF、埋蔵量、最大株主、出典となる提出書類をまとめた1行の概要
lithium_vault_raw	$0.05	生産量、AISC、埋蔵量、所有権、ロイヤルティ、オフテイク契約、財務データの全期間分を含む、構造化された全行データ
lithium_vault_comparables	$0.20	コストカーブのパーセンタイルと最も近い同業他社、資源規模の順位、追跡対象全体に対する貸借対照表の健全性順位（すべての数値に出典を明記）
lithium_vault_verdict	$0.05	コストカーブ上の位置、貸借対照表の健全性、許認可／開発段階、リスク、強み、データの不足を、出典付きで平易に説明します。事実のみを扱い、投資助言ではありません
lithium_spodumene_history	$0.05	市場全体を対象とする、SC6スポジュメン精鉱の過去のベンチマーク価格系列（日次／週次／月次）。企業の指定は不要です

lithium_vault_summary、lithium_vault_raw、lithium_vault_comparables、lithium_vault_verdict では、それぞれentity（ALB、SQM、PILBF、ATUSFのようなティッカー、またはGreenbushes、 Pilgangoora、Grota do Ciriloのような鉱山名）とlevel（companyまたはmine）を指定します。指定したentityがVaultにない場合は400が返され、課金されません。

lithium_spodumene_historyでは企業を指定しません。市場全体を対象とする単一の価格系列です。任意の入力項目はinterval（daily | weekly | monthly、既定値はdaily）、from、to（YYYY-MM-DD）です。日次履歴の全期間を取得するには、これら3つをすべて省略してください。

前提条件

Base上にUSDCを保有する、資金を入金済みのCoinbase CDPウォレットが必要です。ご自身のウォレットをご用意ください。サーバーはそのウォレットから呼び出しごとの料金を支払い、ガス代はCDPが負担します。CDP APIの認証情報はportal.cdp.coinbase.comで取得してください。

インストールと設定

Claude Desktop

claude_desktop_config.jsonに追加します。

{
  "mcpServers": {
    "lithium-vault": {
      "command": "npx",
      "args": ["-y", "lithium-vault-mcp"],
      "env": {
        "CDP_API_KEY_ID": "your-cdp-api-key-id",
        "CDP_API_KEY_SECRET": "your-cdp-api-key-secret",
        "CDP_WALLET_SECRET": "your-cdp-wallet-secret",
        "X402_MAX_PRICE": "0.25"
      }
    }
  }
}

Claude Code

claude mcp add lithium-vault \
  --env CDP_API_KEY_ID=... \
  --env CDP_API_KEY_SECRET=... \
  --env CDP_WALLET_SECRET=... \
  --env X402_MAX_PRICE=0.25 \
  -- npx -y lithium-vault-mcp

設定

環境変数	既定値	用途
CDP_API_KEY_ID / CDP_API_KEY_SECRET / CDP_WALLET_SECRET	—	必須。 支払いに使用するCDPウォレットです。
CDP_ACCOUNT_NAME	lithium-vault-mcp	支払いに使用するCDPアカウント名（自動作成されます）。
X402_MAX_PRICE	0.25	安全上限。 サーバーは支払い前に提示価格を確認し、この上限を超える呼び出しを拒否します。そのため、設定を誤っても過払いは発生しません。
VAULT_BASE_URL	https://clink-lithium-vault.fly.dev	テスト時のみ上書きしてください。

仕組み

your agent → MCP tool call → this server → [x402 402 → pay USDC from your wallet → retry] → vault → data

サーバーはエンドポイントの提示価格を最初に読み取り、支払いを承認する前にX402_MAX_PRICEを適用します。お支払いいただくのは、各ティアの固定料金（$0.02／$0.05／$0.20）のみです。各ツールの料金は上のツール一覧をご覧ください。既定値のX402_MAX_PRICE（0.25）は、$0.20のlithium_vault_comparablesティアを含むすべてのツールをカバーします。

ライセンス

MIT