{
  "markdown": "# lithium-vault-mcp\n\nAn [MCP](https://modelcontextprotocol.io) 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.\n\nData comes from the **Lithium Research Vault** ([listed on agentic.market](https://agentic.market/services/clink-lithium-vault-fly-dev)). Each tool call is paid per request in USDC over [x402](https://x402.org) **from your own wallet** — no subscription, no API key on our side.\n\n## Tools\n\n| Tool | Price | Returns |\n|------|-------|---------|\n| `lithium_vault_summary` | $0.02 | One-row headline: latest production, volume-weighted AISC, realized price, cash/debt/EBITDA/FCF, reserves, top holder, source filing |\n| `lithium_vault_raw` | $0.05 | Full structured rows: every period of production, AISC, reserves, ownership, royalties, offtakes, financials |\n| `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 |\n\nEach 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**.\n\n## Prerequisites\n\nA 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](https://portal.cdp.coinbase.com).\n\n## Install & configure\n\n### Claude Desktop\n\nAdd to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"lithium-vault\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"lithium-vault-mcp\"],\n      \"env\": {\n        \"CDP_API_KEY_ID\": \"your-cdp-api-key-id\",\n        \"CDP_API_KEY_SECRET\": \"your-cdp-api-key-secret\",\n        \"CDP_WALLET_SECRET\": \"your-cdp-wallet-secret\",\n        \"X402_MAX_PRICE\": \"0.25\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```sh\nclaude mcp add lithium-vault \\\n  --env CDP_API_KEY_ID=... \\\n  --env CDP_API_KEY_SECRET=... \\\n  --env CDP_WALLET_SECRET=... \\\n  --env X402_MAX_PRICE=0.25 \\\n  -- npx -y lithium-vault-mcp\n```\n\n## Configuration\n\n| Env var | Default | Purpose |\n|---------|---------|---------|\n| `CDP_API_KEY_ID` / `CDP_API_KEY_SECRET` / `CDP_WALLET_SECRET` | — | **Required.** Your CDP wallet — the wallet that pays. |\n| `CDP_ACCOUNT_NAME` | `lithium-vault-mcp` | Named CDP account to pay from (auto-created). |\n| `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. |\n| `VAULT_BASE_URL` | `https://clink-lithium-vault.fly.dev` | Override only for testing. |\n\n## How it works\n\n```\nyour agent → MCP tool call → this server → [x402 402 → pay USDC from your wallet → retry] → vault → data\n```\n\nThe 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).\n\n## License\n\nMIT\n",
  "bytes": 3249,
  "sha": "f3e22d4791df7eccf7c917e0b4a70ce680bf1f0834155c0ce7bfb354708a417a",
  "repo_slug": "ciinkwia/lithium-vault-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_ciinkwia_lithium_vault_mcp_190f5e1a/readme"
}