English Français العربية

io.github.ciinkwia/lithium-vault-mcp

Registre officiel Autres

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « 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
Configuration 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>"
            }
        }
    }
}

Variables d'environnement

  • CDP_API_KEY_ID obligatoire secret Coinbase CDP API key ID for the wallet that pays the per-call USDC fee
  • CDP_API_KEY_SECRET obligatoire secret Coinbase CDP API key secret
  • CDP_WALLET_SECRET obligatoire 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)

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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

Questions fréquentes

Qu'est-ce que io.github.ciinkwia/lithium-vault-mcp ?

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

Comment installer io.github.ciinkwia/lithium-vault-mcp ?

Il s'exécute sur votre machine. Dans 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. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.ciinkwia/lithium-vault-mcp ?

Oui. Il attend CDP_API_KEY_ID, CDP_API_KEY_SECRET, CDP_WALLET_SECRET, à renseigner dans sa configuration.

io.github.ciinkwia/lithium-vault-mcp est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.ciinkwia/lithium-vault-mcp ?

Il est publié par ciinkwia. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.