tamaspetki avatar

Headless Tracker

tamaspetki/headlesstracker

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 tools

Public 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

npm version

🤖 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.


View the full README on GitHub

Details

Repository
github.com/tamaspetki/headlesstracker
Categories
Web & Browser Automation, Finance & Commerce
Package
headless-tracker
Transport
STDIO
Registry
MCP registry, active

Related Web & Browser Automation MCP servers

View all
1pedro-rivas avatarAndroid Puppeteer Mcppedro-rivas/android-puppeteer-mcpMCP server for Android automation with UI interaction, screenshots, and device control4stars
2vola-trebla avatarPlaywright Trace Decoder Mcpvola-trebla/playwright-trace-decoder-mcpMCP server for unpacking and analyzing Playwright trace.zip archives1stars
3aj-ua avatarWordPress Headlessaj-ua/wp-headless-mcpRead WordPress content, ACF fields, and Yoast SEO data, and safely edit drafts.0stars
4apexflowlabsllc avatarApex Flow 3D Scraperapexflowlabsllc/apex-flow-web-scraperScrape, crawl and monitor public pages as Markdown with change tracking and source receipts.0stars
5hubertgajewski avatarPlaywright Report Mcphubertgajewski/playwright-report-mcpRun Playwright tests and surface structured results for AI agents doing test failure analysis.0stars
6br0ski777 avatarWeb Scraper to Markdown APIbr0ski777/web-scraper-x402Extract clean markdown from any URL. Removes boilerplate. For RAG pipelines. x402.0stars