How do I install the headlesstracker mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `HT_SETUP_ETHERSCAN_KEY`, `HT_SETUP_API_KEY`, `HT_SETUP_API_SECRET` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Headlesstracker MCP Server

Read-only MCP server: let your AI read your whole crypto portfolio across exchanges, on-chain wallets, and prediction markets -- never your API keys

Local serverstdio

What is the Headlesstracker MCP Server?

Read-only MCP server: let your AI read your whole crypto portfolio across exchanges, on-chain wallets, and prediction markets -- never your API keys, and it can't

What it actually does

↑ What your AI host renders from HeadlessTracker's data — one question, six venues, one view. The server returns the numbers; the host draws the picture. (Sample data; the visual is what a host renders on top of the tool output.)

"What do I own?"
"How is my portfolio split between crypto and prediction markets?"
"Show my Polymarket positions grouped by event."
"Refresh Bybit and tell me my BTC P&L."

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
get_holdings	Current holdings across all accounts
get_pnl	Aggregate profit/loss summary
get_polymarket_positions	Polymarket-specialized, event-grouped
get_transactions	Transaction history with since filter
get_allocations	Group-by breakdown (asset class / connector / chain / symbol)
refresh_data	Force cache invalidation
setup_connector	Configure a connector by writing read-only credentials to the OS keychain
list_accounts	List configured accounts without exposing credentials
add_wallet_address	Add another wallet address to an existing MetaMask or Solana account
remove_account	Delete an account and its credentials from the keychain
add_custom_token	Track a project-specific ERC-20 token on a MetaMask account
remove_custom_token	Stop tracking a custom ERC-20 token (public on-chain data, no keychain)
list_custom_tokens	List the custom ERC-20 tokens tracked per MetaMask account
render_dashboard	Interactive dashboard panel: holdings, P&L, allocations, prediction markets
render_settings	Settings panel: a GUI alternative to the CLI setup flow

How to install the Headlesstracker MCP Server

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

From the project documentation. Replace placeholders and example paths before connecting.

Frequently asked questions

Read-only MCP server: let your AI read your whole crypto portfolio across exchanges, on-chain wallets, and prediction markets -- never your API keys, and it can't Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.