English Français العربية

io.github.ciinkwia/lithium-vault-mcp

السجل الرسمي أخرى

Primary-source lithium & battery-metals mining data (AISC, reserves, filings) via x402.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package lithium-vault-mcp
Claude Code 
claude mcp add lithium-vault-mcp -e 'CDP_API_KEY_ID=<your cdp_api_key_id>' -e 'CDP_API_KEY_SECRET=<your cdp_api_key_secret>' -e 'CDP_WALLET_SECRET=<your cdp_wallet_secret>' -e 'CDP_ACCOUNT_NAME=<CDP_ACCOUNT_NAME>' -e 'VAULT_BASE_URL=<VAULT_BASE_URL>' -e 'X402_MAX_PRICE=<X402_MAX_PRICE>' -- npx -y lithium-vault-mcp@0.4.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "lithium-vault-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "lithium-vault-mcp@0.4.0"
            ],
            "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>",
                "CDP_ACCOUNT_NAME": "<CDP_ACCOUNT_NAME>",
                "VAULT_BASE_URL": "<VAULT_BASE_URL>",
                "X402_MAX_PRICE": "<X402_MAX_PRICE>"
            }
        }
    }
}

متغيرات البيئة

  • CDP_API_KEY_ID إلزامي سري Coinbase CDP API key ID for the wallet that pays the per-call USDC fee
  • CDP_API_KEY_SECRET إلزامي سري Coinbase CDP API key secret
  • CDP_WALLET_SECRET إلزامي سري Coinbase CDP wallet secret
  • CDP_ACCOUNT_NAME Named CDP account to pay from (default: lithium-vault-mcp)
  • VAULT_BASE_URL Override the vault endpoint base URL (default: https://clink-lithium-vault.fly.dev)
  • X402_MAX_PRICE Max USD price per call the server will pay before refusing (default: 0.25)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. lithium-vault-mcp
  2. Tools
  3. Prerequisites
  4. Install & configure
  5. Configuration
  6. How it works
  7. License

lithium-vault-mcp

An MCP server that gives your AI agent primary-source lithium / battery-metals mining data — production, AISC, reserves, ownership, royalties, offtakes, and corporate financials for 40 producers and 49 mines, every figure extracted from SEC / ASX / TSX / SEDAR / cninfo filings and FX-normalized to USD.

Data comes from the Lithium Research Vault (listed on agentic.market). Each tool call is paid per request in USDC over x402 from your own wallet — no subscription, no API key on our side.

Tools

ToolPriceReturns
lithium_vault_summary$0.02One-row headline: latest production, volume-weighted AISC, realized price, cash/debt/EBITDA/FCF, reserves, top holder, source filing
lithium_vault_raw$0.05Full structured rows: every period of production, AISC, reserves, ownership, royalties, offtakes, financials
lithium_vault_comparables$0.20Cost-curve percentile + nearest peers, resource-size rank, and balance-sheet survival rank vs the whole tracked universe — every figure cited
lithium_vault_verdict$0.05A cited, plain-language read: cost-curve position, balance-sheet survival, permitting/dev stage, risks, strengths, and data gaps — facts only, not investment advice
lithium_spodumene_history$0.05Historical SC6 spodumene concentrate benchmark price series (daily/weekly/monthly), market-wide — no entity needed

lithium_vault_summary, lithium_vault_raw, lithium_vault_comparables, and lithium_vault_verdict each take entity (a ticker like ALB, SQM, PILBF, ATUSF, or a mine name like Greenbushes, Pilgangoora, Grota do Cirilo) and level (company or mine). If the entity isn't in the vault you get a 400 and no charge.

lithium_spodumene_history takes no entity — it's a single market-wide price series. Optional inputs: interval (daily | weekly | monthly, default daily), from and to (YYYY-MM-DD). Omit all three for the full daily history.

Prerequisites

A funded Coinbase CDP wallet with USDC on Base. You bring your own wallet; the server pays the per-call fee from it (CDP covers gas). Get CDP API credentials at portal.cdp.coinbase.com.

Install & configure

Claude Desktop

Add to 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

Configuration

Env varDefaultPurpose
CDP_API_KEY_ID / CDP_API_KEY_SECRET / CDP_WALLET_SECRET—Required. Your CDP wallet — the wallet that pays.
CDP_ACCOUNT_NAMElithium-vault-mcpNamed CDP account to pay from (auto-created).
X402_MAX_PRICE0.25Safety ceiling. The server checks the advertised price before paying and refuses any call above this, so a misconfiguration can never overpay.
VAULT_BASE_URLhttps://clink-lithium-vault.fly.devOverride only for testing.

How it works

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

The server reads the endpoint's advertised price first and enforces X402_MAX_PRICE before authorizing any payment. You only ever pay the fixed per-tier price ($0.02 / $0.05 / $0.20 — see the tool table above for which tool costs what). The default X402_MAX_PRICE of 0.25 already covers every tool, including the $0.20 lithium_vault_comparables tier.

License

MIT

الأسئلة الشائعة

ما هو io.github.ciinkwia/lithium-vault-mcp؟

Primary-source lithium & battery-metals mining data (AISC, reserves, filings) via x402.

كيف أثبّت io.github.ciinkwia/lithium-vault-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add lithium-vault-mcp -e 'CDP_API_KEY_ID=<your cdp_api_key_id>' -e 'CDP_API_KEY_SECRET=<your cdp_api_key_secret>' -e 'CDP_WALLET_SECRET=<your cdp_wallet_secret>' -e 'CDP_ACCOUNT_NAME=<CDP_ACCOUNT_NAME>' -e 'VAULT_BASE_URL=<VAULT_BASE_URL>' -e 'X402_MAX_PRICE=<X402_MAX_PRICE>' -- npx -y lithium-vault-mcp@0.4.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.ciinkwia/lithium-vault-mcp إلى مفتاح API؟

نعم. يتطلب CDP_API_KEY_ID, CDP_API_KEY_SECRET, CDP_WALLET_SECRET، وتضبطها في إعداداته.

هل io.github.ciinkwia/lithium-vault-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.ciinkwia/lithium-vault-mcp؟

ينشره ciinkwia. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.