Server data from the Official MCP Registry
Primary-source lithium & battery-metals mining data (AISC, reserves, filings) via x402.
About
Primary-source lithium & battery-metals mining data (AISC, reserves, filings) via x402.
Security Report
A well-architected MCP server for lithium mining data with thoughtful security practices. Authentication and authorization are properly implemented via Coinbase CDP wallet credentials and x402 payment protocol. Code is clean with appropriate input validation, error handling, and price-ceiling safeguards. Permissions match the server's purpose (network access for vault API calls, environment variables for wallet credentials). No critical vulnerabilities detected. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.
7 files analyzed · 9 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: CDP_API_KEY_ID
Environment variable: CDP_API_KEY_SECRET
Environment variable: CDP_WALLET_SECRET
Environment variable: CDP_ACCOUNT_NAME
Environment variable: VAULT_BASE_URL
Environment variable: X402_MAX_PRICE
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-ciinkwia-lithium-vault-mcp": {
"env": {
"CDP_API_KEY_ID": "your-cdp-api-key-id-here",
"VAULT_BASE_URL": "your-vault-base-url-here",
"X402_MAX_PRICE": "your-x402-max-price-here",
"CDP_ACCOUNT_NAME": "your-cdp-account-name-here",
"CDP_WALLET_SECRET": "your-cdp-wallet-secret-here",
"CDP_API_KEY_SECRET": "your-cdp-api-key-secret-here"
},
"args": [
"-y",
"lithium-vault-mcp"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub 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
| Tool | Price | Returns |
|---|---|---|
lithium_vault_summary | $0.02 | One-row headline: latest production, volume-weighted AISC, realized price, cash/debt/EBITDA/FCF, reserves, top holder, source filing |
lithium_vault_raw | $0.05 | Full structured rows: every period of production, AISC, reserves, ownership, royalties, offtakes, financials |
lithium_vault_comparables | $0.20 | Cost-curve percentile + nearest peers, resource-size rank, and balance-sheet survival rank vs the whole tracked universe — every figure cited |
Each takes 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.
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 var | Default | Purpose |
|---|---|---|
CDP_API_KEY_ID / CDP_API_KEY_SECRET / CDP_WALLET_SECRET | — | Required. Your CDP wallet — the wallet that pays. |
CDP_ACCOUNT_NAME | lithium-vault-mcp | Named CDP account to pay from (auto-created). |
X402_MAX_PRICE | 0.25 | Safety ceiling. The server checks the advertised price before paying and refuses any call above this, so a misconfiguration can never overpay. |
VAULT_BASE_URL | https://clink-lithium-vault.fly.dev | Override 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).
License
MIT
Reviews
No reviews yet
Be the first to review this server!
More Security MCP Servers
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
FinAgent
Freeby mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.
Google Workspace MCP
Freeby Taylorwilsdon · Productivity
Control Gmail, Calendar, Docs, Sheets, Drive, and more from your AI