headless-tracker

finance MCP Server

MCP server for crypto portfolio tracking. No dashboard UI — AI hosts render on demand. Bybit, Binance, MetaMask, Solana, Polymarket.

VerifiedInstall Ready
financefinance
4 views3 stars0 forksv0.13.2MIT

Why This Matters

Discovered via github-topic:model-context-protocol and last synced 3mo ago.

VerifiedInstall Ready
Source
github-topic:model-context-protocol
Stars
3
Last synced
3mo ago
Install
Instructions detected

Install

1. Install the package

npx headless-tracker

2. Add to claude_desktop_config.json

{
  "mcpServers": {
    "headless-tracker": {
      "command": "npx",
      "args": [
        "headless-tracker"
      ]
    }
  }
}

Config file location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) / %APPDATA%\Claude\claude_desktop_config.json (Windows)

15
Tools
0
Resources
0
Prompts
Standard I/O
Transport

Available Tools (15)

weekly-review

7-day window delta + biggest movers + recent trades + one observation. Approximation caveat surfaced honestly (current basket at historical prices, NOT trades within the window).

get_allocations

Group-by breakdown (asset class / connector / chain / symbol)

7d

30d

get_pnl

Aggregate profit/loss summary

Prompt

What it does

portfolio-dashboard

Calls `get_holdings` + `get_allocations` + `get_pnl` + `get_polymarket_positions` in parallel and renders a complete multi-section dashboard (HTML artifact when supported).

get_transactions

Transaction history with `since` filter

risk-check

Concentration / venue / stablecoin reserve / prediction-market overweight / chain concentration. Each dimension scored PASS / WARN / ALERT with the actual percentages.

refresh_data

Force cache invalidation

Connector

Auth

Binance

API key + secret

Polymarket

Proxy wallet address (no API key)

Tool

Purpose

get_holdings

Current holdings across all accounts

get_polymarket_positions

Polymarket-specialized, event-grouped