# headless-tracker

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6
- Author: tamasPetki
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/tamasPetki/HeadlessTracker
- Updated: 2026-09-23
- HTML: https://affpapa.org/en/nevibecode/mcp/headless-tracker

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add headless-tracker -- npx -y headless-tracker
```

### Codex

**Platform CLI**
```bash
codex mcp add headless-tracker -- npx -y headless-tracker
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "headless-tracker": {
            "command": "npx",
            "args": [
                "-y",
                "headless-tracker"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "headless-tracker": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "headless-tracker"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add headless-tracker npx -y headless-tracker
```

## When to use it
- 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
- What do I own across everything?
- Refresh Bybit and tell me my BTC P&L

## Similar
- [emblem-portfolio-tracker](https://affpapa.org/en/nevibecode/skills/emblem-portfolio-tracker.md) — skill · 8900 installs
- [thesis-tracker](https://affpapa.org/en/nevibecode/skills/anthropics-thesis-tracker.md) — skill · 1200 installs
- [messari-btc-eth-tracker-teneo](https://affpapa.org/en/nevibecode/skills/messari-btc-eth-tracker-teneo.md) — skill · 525 installs
- [gmgn-portfolio](https://affpapa.org/en/nevibecode/skills/gmgn-portfolio.md) — skill · 17600 installs
- [okx-cex-portfolio](https://affpapa.org/en/nevibecode/skills/okx-cex-portfolio.md) — skill · 10100 installs
- [risk-management](https://affpapa.org/en/nevibecode/skills/agiprolabs-risk-management.md) — skill · 634 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md