lithium-vault-mcp
Uses Coinbase CDP wallet to pay for each data request via the x402 protocol, with USDC on Base.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
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
Tool | Price | Returns |
| $0.02 | One-row headline: latest production, volume-weighted AISC, realized price, cash/debt/EBITDA/FCF, reserves, top holder, source filing |
| $0.05 | Full structured rows: every period of production, AISC, reserves, ownership, royalties, offtakes, financials |
| $0.20 | Cost-curve percentile + nearest peers, resource-size rank, and balance-sheet survival rank vs the whole tracked universe — every figure cited |
| $0.05 | A cited, plain-language read: cost-curve position, balance-sheet survival, permitting/dev stage, risks, strengths, and data gaps — facts only, not investment advice |
| $0.05 | Historical 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.
Related MCP server: Verilex Data
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-mcpConfiguration
Env var | Default | Purpose |
| — | Required. Your CDP wallet — the wallet that pays. |
|
| Named CDP account to pay from (auto-created). |
|
| Safety ceiling. The server checks the advertised price before paying and refuses any call above this, so a misconfiguration can never overpay. |
|
| Override only for testing. |
How it works
your agent → MCP tool call → this server → [x402 402 → pay USDC from your wallet → retry] → vault → dataThe 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
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Market and on-chain crypto data for AI agents. Pay per call in USDC on Base (x402).
21 paid tools: US macro data, SEC EDGAR filings, on-chain EVM reads. Settled in USDC on Base.
49 crypto intelligence APIs. Whale tracking, DeFi yields, alpha signals. Pay in USDC on Base.
24 pay-per-call data APIs over x402 (USDC on Base), plus a free search tool.
Related MCP Servers
- AlicenseAqualityBmaintenanceEight crypto and DeFi data tools for AI agents: prices, gas, one ParaSwap route quote, GoPlus token security and top-holder samples, DefiLlama yields, Hyperliquid/dYdX funding, and observed wallet balances. Inspect prices free; pay 0.001–0.008 USDC per call on Base through x402. No API key or subscription.887 npmMIT
- AlicenseBqualityDmaintenanceQuery 20 structured datasets from AI agents — healthcare providers (9M NPI records), SEC EDGAR filings, PACER federal courts, USPTO patents and trademarks, OFAC sanctions screening, crypto whale wallets, DeFi liquidation signals, Polymarket smart money, economic indicators (FRED/BLS), federal contracts, NOAA weather, and OTC shell risk scoring. Pay per query, no subscriptions751MIT
- AlicenseAqualityDmaintenanceExposes 177 crypto market intelligence endpoints to AI agents with automatic USDC micropayments from the user's wallet, enabling pay-per-call access without subscriptions.5958 npmMIT
- AlicenseNot gradedqualityCmaintenanceProvides real-time crypto market data for AI agents, including derivatives, liquidations, options, macro, and market regime detection, with pay-per-call via x402 micropayments on Base.106 npmMIT