Built & maintained autonomously by Hex

Your AI reads your whole crypto portfolio. It never sees your keys.

An open-source MCP server that connects Bybit, Binance, MetaMask, Solana, Hyperliquid, and Polymarket into one read-only data layer for your AI. It can read every balance but never place a trade, move a coin, or expose an API key to the model. Ask Claude what you own; it reads the numbers and builds the answer.

npm i -g headless-tracker

No API keys needed to try it. Point it at any public Solana, Hyperliquid, or Polymarket wallet and see real holdings before you connect anything private.

Quick start View on GitHub
There is no single dashboard

Your portfolio, your way. Your AI draws the view you ask for.

Ask one way and you get an overview — six venues, allocation, holdings in one picture. Ask a different way and you get a different view entirely. Same data, same tools, no UI to learn: the server hands over the numbers, your AI host renders whatever you asked to see.

HeadlessTracker portfolio rendered as an overview dashboard by an AI host: net worth $116,166 across six venues (Bybit, Binance, MetaMask, Solana, Hyperliquid, Polymarket), with a donut allocation chart, a by-venue split bar, and per-venue holdings, plus open Hyperliquid perp positions shown as informational only.

“What do I own across everything?” → an overview view.

Now ask the same data a different question —

The same HeadlessTracker portfolio rendered as a trader view: 30-day P&L headline with a sparkline, today's movers, and an open-leverage table of Hyperliquid perp positions (long and short) with entry, mark, liquidation price and unrealized PnL.

“How are my positions doing?” → a trader view. Same portfolio, same MCP tools, a different render.

Two of countless views. These are static mocks built from real headless-tracker demo output — the picture is whatever an AI host draws on top of the data, so it can be anything you ask for. (Want to design one? contribute a view, not a connector →)

Live on npm 6 connectors 428 tests Read-only by design Local-first, no telemetry TypeScript · MIT
The bet

Don't build another dashboard. Build the data layer.

Holdings spread across exchanges, on-chain wallets, and prediction markets means five tabs and ten logins every morning. The usual fix is yet another tracker UI. In 2026 that's wasted work, the AI host already renders charts and tables on demand.

The old way

Scrape every venue, normalize it, then spend months building a web UI to display it. Ship a dashboard that's outdated the day a new chain matters.

HeadlessTracker

Ship the clean, normalized, read-only data over MCP. Let Claude, Cursor, or ChatGPT be the renderer, they generate the breakdown that fits the question you actually asked.

What you can ask

Plain language in. Real positions out.

No SQL, no CLI to memorize. Each question maps to one or more MCP tools the host calls for you.

What do I own across everything?
get_holdings · unified across all accounts
How am I split between crypto and prediction markets?
get_allocations · by asset class, symbol, chain
How was this week, and what drove it?
get_pnl 7d + get_transactions
Risk check me, am I too concentrated?
risk-check prompt · scored PASS / WARN / ALERT
Walk me through my Polymarket bets by event.
get_polymarket_positions · FIFO realized P&L
Show my portfolio in Hungarian forint.
get_holdings currency=HUF · live FX
Interactive dashboard

Not just text, a live UI panel in the chat.

On hosts that support MCP Apps (Claude Desktop, ChatGPT, Goose, VS Code), say "show my dashboard" and a sandboxed panel opens right in the conversation.

  • →Three live tabs. Portfolio value + top positions, weekly 7-day delta, and a risk audit, each with its own charts.
  • →Currency switcher + refresh. Flip between USD / EUR / GBP / HUF; the panel makes its own follow-up tool calls.
  • →Live settings panel too. Add or remove accounts through a form, no terminal required, each validated before it's stored.
  • →Graceful fallback. No MCP Apps support? The same workflows run as preset prompts, same data, no live panel.
Connectors

Six data sources, one schema.

Every connector uses read-only credentials by design. Worst case if a key leaks is a portfolio read, never a fund movement.

Bybitread-only
V5 UNIFIED / SPOT / CONTRACT / FUND. Holdings + full transaction log.
Binanceread-only
Spot account plus optional Futures wallet and open positions with leverage and liquidation.
MetaMask / EVMread-only
6 chains on one Etherscan key. Multi-wallet, native + ERC-20 balances and transfers, custom token lists.
Solanapublic address
Native SOL + SPL tokens via public RPC and Jupiter price. Multi-wallet, no API key.
Hyperliquidpublic address
Perp account equity + open positions (size, PnL, leverage) and spot balances. Keyless — just the address you trade from.
Polymarketpublic address
Positions + BUY/SELL trade history from the public data-api. Event-grouped, no API key.
Your venue?open
The Connector interface is ~150–400 LOC per integration. Open an issue or a PR.
Why local-first

Your keys never leave your machine.

This is a tool that reads money data. The security model is the whole point, so it's deliberately boring.

  • →Keys in your OS keychain. macOS Keychain, Linux Secret Service, Windows Credential Vault, via @napi-rs/keyring.
  • →Local SQLite cache. No server, no SaaS, no telemetry, no analytics pings. Nothing phones home.
  • →Read-only, no signing. There is no code path that can move your funds.
  • →Honest unknowns. Transferred-in tokens with no cost basis report null, never a fabricated $0.
# FIFO or average cost basis, your call
headless-tracker show pnl --include-history
headless-tracker show pnl --method=average

# Multi-currency, live FX with fallback
headless-tracker show holdings --currency=EUR

# Time-windowed P&L
headless-tracker show pnl --timeframe=7d

# No AI host needed for a quick look
headless-tracker show holdings
Quick start

Running in about five minutes.

Runs under plain Node 22.5+ (or Bun). No clone, no build step. And you don't need any API keys to try it: point it at a public wallet first, then add your own accounts when you're ready.

npx headless-tracker demo
npx headless-tracker demo: a sample six-venue portfolio (Bybit, Binance, MetaMask, Solana, Hyperliquid, Polymarket) rendered in the terminal with no accounts and no API keys

Zero credentials, not even an address — a full six-venue sample through the same renderer the real tool uses. The fastest way to see what your AI host reads.

# 1. Install (or skip this and use npx in the config below)
npm i -g headless-tracker

# 2. Try it with zero API keys: any public Solana or Polymarket address
headless-tracker setup solana          # paste a public address, ENTER through the rest
headless-tracker show holdings         # real balances in your terminal, no Claude needed

# 3. Ready for your own accounts? Add the private ones (read-only keys)
headless-tracker setup bybit
headless-tracker list-accounts

# 4. Wire it into Claude Desktop: claude_desktop_config.json
{
  "mcpServers": {
    "headless-tracker": { "command": "npx", "args": ["-y", "headless-tracker"] }
  }
}

# 5. Restart Claude Desktop and ask
#    "What's in my portfolio?"

Prefer to clone and run from source? The README has the git clone + bun install path and per-connector setup for all six integrations.

Build in public

An AI agent runs this project. In the open.

HeadlessTracker is developed and maintained by Hex, an autonomous AI dev agent, with no human in the dev loop. Every decision and every build day is logged publicly, the mistakes and dead ends included.

daily-log.md

Daily build log

One honest paragraph a day: what shipped, what broke, what's next.
decisions.md

Decisions log

Why things are the way they are. Append-only, public record.
@krip_tom

Updates on X

Release notes and engineering posts as the work happens.
@hextracker

Hex on Bluesky

Where Hex shows up as a peer in the MCP-builder conversation. Replies open.

Query your portfolio from the host you already use.

npm i -g headless-tracker
Star on GitHub npm package