
Headless Tracker
Aggregates crypto holdings across Bybit, Binance, MetaMask, Solana wallets, and Polymarket into a single normalized dataset your AI can query. Exposes 15 MCP tools for portfolio snapshots, PnL calculations, transaction history, and account management. Ships with an interactive dashboard panel (three tabs: portfolio, weekly review, risk audit) that renders live in Claude Desktop or any MCP Apps-compatible host. Supports multi-currency display, FIFO cost basis, and time-windowed performance. Read-only by design: three of five connectors work with public addresses alone, and exchange keys stay in your OS keychain. Useful when you want Claude to answer "what do I own?" or "show me my week" without building yet another portfolio UI yourself.
- GitHub stars
- 6
- tools
- 15
- transport
- STDIO
- last updated
- Jun 18, 2026
Tools
15 toolsPublic tool metadata for what this MCP can expose to an agent.
get_holdingsCurrent holdings across all accounts
Current holdings across all accounts
No parameter schema in public metadata yet.
get_pnlAggregate profit/loss summary
Aggregate profit/loss summary
No parameter schema in public metadata yet.
get_polymarket_positionsPolymarket-specialized, event-grouped positions
Polymarket-specialized, event-grouped positions
No parameter schema in public metadata yet.
get_transactionsTransaction history with since filter
Transaction history with since filter
No parameter schema in public metadata yet.
get_allocationsGroup-by breakdown (asset class / connector / chain / symbol)
Group-by breakdown (asset class / connector / chain / symbol)
No parameter schema in public metadata yet.
refresh_dataForce cache invalidation
Force cache invalidation
No parameter schema in public metadata yet.
setup_connectorConfigure a connector by writing read-only credentials to the OS keychain
Configure a connector by writing read-only credentials to the OS keychain
No parameter schema in public metadata yet.
list_accountsList configured accounts without exposing credentials
List configured accounts without exposing credentials
No parameter schema in public metadata yet.
add_wallet_addressAdd another wallet address to an existing MetaMask or Solana account
Add another wallet address to an existing MetaMask or Solana account
No parameter schema in public metadata yet.
remove_accountDelete an account and its credentials from the keychain
Delete an account and its credentials from the keychain
No parameter schema in public metadata yet.
add_custom_tokenTrack a project-specific ERC-20 token on a MetaMask account
Track a project-specific ERC-20 token on a MetaMask account
No parameter schema in public metadata yet.
remove_custom_tokenStop tracking a custom ERC-20 token (public on-chain data, no keychain)
Stop tracking a custom ERC-20 token (public on-chain data, no keychain)
No parameter schema in public metadata yet.
list_custom_tokensList the custom ERC-20 tokens tracked per MetaMask account
List the custom ERC-20 tokens tracked per MetaMask account
No parameter schema in public metadata yet.
render_dashboardInteractive dashboard panel: holdings, P&L, allocations, prediction markets
Interactive dashboard panel: holdings, P&L, allocations, prediction markets
No parameter schema in public metadata yet.
render_settingsSettings panel: a GUI alternative to the CLI setup flow
Settings panel: a GUI alternative to the CLI setup flow
No parameter schema in public metadata yet.
Sponsors
Readme
headless-tracker
🤖 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.
Details
- Repository
- github.com/tamaspetki/headlesstracker
- Categories
- Web & Browser Automation, Finance & Commerce
- Package
headless-tracker- Transport
- STDIO
- Registry
- MCP registry, active