tamasPetki/HeadlessTracker

> 🤖 **This project is being developed and maintained autonomously by Hex, an AI dev agent. Decisions log: decisions.md · Daily build log: daily-log.md · Hex on Bluesky · Solo team. No human in the dev loop.**
> ⚠️ **Not financial advice.** HeadlessTracker is a portfolio data aggregation tool. For informational purposes only. See DISCLAIMER.md for full text.
> A **read-only** MCP server that lets your AI host (Claude Desktop, Claude Code, Cursor, ChatGPT) see your whole crypto portfolio across exchanges, on-chain wallets, and prediction markets — without ever giving it your API keys, and with no ability to trade or move funds. It reads the numbers; it can't touch the money.
↑ What your AI host renders from HeadlessTracker's data — one question, six venues, one view. The server returns the numbers; the host draws the picture. (Sample data; the visual is what a host renders on top of the tool output.)
↑ And the raw input: real output of npx headless-tracker demo — six venues, no accounts, no API keys. Then ask your AI host about it.
↑ Same data, a different question. Ask “how are my positions doing?” and your AI renders a trader view instead. There is no single dashboard — the host draws the one you ask for. (Templates coming: contribute a view, not a connector.)
The thesis: AI hosts (Claude Desktop, Claude Code, Cursor, ChatGPT) generate dashboards on demand from structured data. Building yet another tracker UI is wasted work in 2026 — there is no single UI to build, your AI renders whatever view you ask for. Build the data layer; let the AI host be the renderer.
**Status:** Production-ready and live on npm (version badge above). Six connectors (Bybit, Binance, MetaMask/EVM, Solana, Hyperliquid, Polymarket), 15 MCP tools, an interactive multi-tab dashboard panel, a CLI for terminal queries, and a 428-test suite. Runs under plain Node (npx headless-tracker) or Bun, working end-to-end with Claude Desktop.
Full feature list
- **6 connectors:** Bybit, Binance Spot+Futures, MetaMask multi-chain + multi-wallet, Solana multi-wallet, Hyperliquid (perp + spot, address-only), Polymarket
- **15 MCP tools:** 6 data + 7 account/token management + 2 MCP App panels
- **3 MCP prompts (views):** portfolio-dashboard, weekly-review, risk-check — see TEMPLATES.md, and contribute a view
- **Interactive dashboard MCP App:** 3 tabs (Portfolio / Weekly / Risk) with donut + bar charts, currency switcher, refresh button
- **Live Settings MCP App** for setup and admin
- **CLI portfolio queries:** show holdings / pnl / transactions (no Claude required)
- **Custom ERC-20 token lists**; FIFO + Average Cost on transaction history
- **Multi-currency display** (USD/EUR/GBP/HUF); CoinGecko + Jupiter spot and historical prices
- **Time-windowed PnL** (--timeframe=24h|7d|30d|ytd)
- **428-test suite**; runs under plain Node or Bun
- **Read-only & local-first:** no orders/withdrawals/transfers; 4 of 6 connectors need only a public address; secrets live in your OS keychain and never enter the model's context — see SECURITY.md
See ROADMAP.md for what's done, what's next, and what's intentionally out of scope.
What it does
Connects to your accounts (read-only), normalizes everything into a single schema, exposes it as MCP tools. Then you ask Claude (or any MCP host):
- "What do I own?"
- "How is my portfolio split between crypto and prediction markets?"
- "Show my Polymarket positions grouped by event."
- "Refresh Bybit and tell me my BTC P&L."
The AI host generates the chart, the table, the breakdown. You don't build a UI.
Try it in 60 seconds (no API keys)
**The zero-setup version — one command, no accounts, no keys, not even an address.** See a full sample portfolio (five venues; crypto + cash + prediction markets) rendered exactly as your AI host receives it:
It also prints the plain-English questions you'd ask Claude ("what do I own across everything?", "how is it split?") mapped to the MCP tool that answers each. When you want **your own** numbers, it's the same loop with a real address or read-only key:
You shouldn't have to hand a new tool your exchange keys just to find out whether it's any good. Solana, Hyperliquid, and Polymarket read **public on-chain addresses**, so you can point HeadlessTracker at any wallet you can see (your own included) with zero credentials. (Hyperliquid is fully keyless — perp positions, account equity, and spot balances all read from just the address you trade from.)