Back to Browse
Free
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
4.8
Use Caution4.8High RiskThis is a well-architected MCP server for accessing lithium mining data via a paid API layer. Code quality is high with proper separation of concerns, clear abstractions, and thoughtful error handling. The authentication model is appropriate: credentials are required (CDP wallet keys) and handled through environment variables. No code injection vulnerabilities, malicious patterns, or dangerous operations detected. Permissions match the server's purpose (network HTTP to vault, environment variable access for wallet credentials, no filesystem/shell access). Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.
7 files analyzed · 7 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:
Coinbase CDP API key ID for the wallet that pays the per-call USDC feeRequired
Environment variable: CDP_API_KEY_ID
Coinbase CDP API key secretRequired
Environment variable: CDP_API_KEY_SECRET
Coinbase CDP wallet secretRequired
Environment variable: CDP_WALLET_SECRET
Named CDP account to pay from (default: lithium-vault-mcp)
Environment variable: CDP_ACCOUNT_NAME
Override the vault endpoint base URL (default: https://clink-lithium-vault.fly.dev)
Environment variable: VAULT_BASE_URL
Max USD price per call the server will pay before refusing (default: 0.25)
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_story | $0.20 | LLM narrative, every sentence cited to a primary filing URL |
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.
137
Stars
484
Installs
8.0
Security
4.8
Local
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
-
Stars
65
Installs
10.0
Security
4.6
Local
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
120.0K
Stars
22
Installs
6.0
Security
5.0
Local