headless-tracker — Claude Code MCP server: crypto portfolio, no keys
A read-only MCP server that pulls your crypto holdings from exchanges, wallets and prediction markets and hands the numbers to your AI host. Your keys stay out of the model.
claude mcp add headless-tracker -- npx -y headless-trackerWhat headless-tracker does
The server talks to your accounts in read-only mode, normalises everything into one schema and exposes it as MCP tools. You ask Claude what you hold and how it is split; the host draws the chart or table itself. There is no tracker UI to open — this is the data layer.
Six connectors ship with it: Bybit, Binance Spot and Futures, MetaMask across chains and wallets, Solana, Hyperliquid and Polymarket. On top of that come 15 MCP tools, three prompt views (portfolio-dashboard, weekly-review, risk-check), an interactive panel with Portfolio, Weekly and Risk tabs, and a CLI for terminal queries. It runs on plain Node or Bun.
Solana, Hyperliquid and Polymarket are read from public addresses, so any wallet you can already see works with no credentials at all. Secrets for the other connectors sit in your OS keychain and never reach the model's context. No orders, withdrawals or transfers — it reads the numbers and cannot touch the money. Not financial advice.
What it helps with
- see exchange, wallet and prediction-market balances in one place
- break the portfolio down by asset class
- work out P&L from transaction history
- check open Hyperliquid positions from an address alone
- query holdings from the terminal without an AI host
Example prompts for the agent
- What do I own across everything?
- Refresh Bybit and tell me my BTC P&L
How to install headless-tracker
Platform CLI
claude mcp add headless-tracker -- npx -y headless-trackerPlatform CLI
codex mcp add headless-tracker -- npx -y headless-trackerConfig file
{
"mcpServers": {
"headless-tracker": {
"command": "npx",
"args": [
"-y",
"headless-tracker"
]
}
}
}Config file
{
"servers": {
"headless-tracker": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"headless-tracker"
]
}
}
}Platform CLI
gemini mcp add headless-tracker npx -y headless-trackerStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about headless-tracker
How do I install headless-tracker in Claude Code?
Run claude mcp add headless-tracker -- npx -y headless-tracker.
What does headless-tracker do?
It aggregates your crypto portfolio from six venues into a single schema and serves it to an AI host over MCP. The host renders whatever view you ask for.
Does it need my exchange API keys?
Solana, Hyperliquid and Polymarket only need a public address. The other connectors take a read-only key, which is kept in your OS keychain rather than in the model's context.
