Lithium Vault Mcp

io.github.ciinkwiaPublished by GitHub account ciinkwiav0.4.0Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyFinanceData & Analytics

Overview

AI-generated overview

A local MCP server that gives an assistant primary-source lithium and battery-metals mining data, paid per call in USDC from the user's own Coinbase wallet.

What you can do
Retrieve a one-row headline per company or mine: production, AISC, realized price, cash, debt, EBITDA, FCF, reserves and top holder, with the source filing cited. Pull full structured rows covering every period of production, AISC, reserves, ownership, royalties, offtakes and financials. Compare an entity against the tracked universe with cost-curve percentile, nearest peers, resource-size rank and balance-sheet survival rank. Get a cited plain-language read on cost position, survival, development stage, risks, strengths and data gaps. Fetch the market-wide SC6 spodumene concentrate benchmark price history at daily, weekly or monthly intervals.
When to use it
Useful when an assistant needs cited lithium or battery-metals figures for producers and mines, such as cost-curve comparisons, reserve and ownership checks, or spodumene price history, and the user is willing to pay small per-call fees from a funded crypto wallet.
Requirements
Runs locally via npx, so Node.js is needed. Requires a funded Coinbase CDP wallet holding USDC on Base, plus the CDP_API_KEY_ID, CDP_API_KEY_SECRET and CDP_WALLET_SECRET credentials. Optional settings: CDP_ACCOUNT_NAME, X402_MAX_PRICE (default 0.25 USD) and VAULT_BASE_URL. Network access to the vault endpoint is required.
Before you install
Every tool call spends real USDC from the user's wallet, from 0.02 to 0.20 USD per call, so repeated agent use costs money. Three CDP secrets are stored in the client configuration and grant payment authority over the wallet; keep them out of shared files. X402_MAX_PRICE caps the price per call but does not limit how many calls are made. Data is facts only and explicitly not investment advice.

Installation

In SourceWeft

  1. Open Lithium Vault Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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:

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

sh
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

Source: README.md at commit 6d80f34

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.4.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts