Headless Tracker MCP Server

↑ 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.). It runs locally over stdio via the published package.

People connecting finance tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-06-21 · ★ 5 · #122 OF 283 MAINTAINED FINANCE · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install Headless Tracker

before you install - you'll need

Set HT_SETUP_ETHERSCAN_KEY, HT_SETUP_API_KEY before connecting.

Claude Code

claude mcp add tamaspetki-headlesstracker -- npx -y headless-tracker

Claude Desktop / Cursor / VS Code - add to config

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

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package headless-tracker - unscoped; check the name against the project README before installing

registry namespace io.github.tamasPetki is GitHub-verified and matches the repo owner

03 · What Headless Tracker can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v1.0.14 · 2026-06-14

Fixes silent $0 Solana pricing and adds non-interactive setup for scripted/headless onboarding. · Fixed · Solana token prices were silently returning $0 because the Jupiter Price API v2 endpoint was retired. now…

v1.0.12 · 2026-06-07

Makes every tool parameter self-describing to the AI agents that call them. · Changed · Every tool input parameter now carries a machine-readable description in its JSON Schema. All 38 parameters across the 15 tools…

v1.0.11 · 2026-06-07

Recovers automatically from a transient network blip instead of failing the account. · Fixed · A transient network error is now retried once before failing. A connector that hit a momentary network failure (a dropped…

04 · Who maintains Headless Tracker

headless-tracker is maintained by tamaspetki. It's the only MCP server we track from this author; the repo dates to Apr 2026.

05 · Facts

category
finance - ranked #122 of 283 actively-maintained finance servers as of 2026-08-25.
release cadence
9 releases in the last 90 days (latest 2026-06-14)
registry
io.github.tamasPetki/headless-tracker (active, first published 2026-06-02 · 15 versions)
packages
npm:headless-tracker

06 · Headless Tracker FAQ

What is Headless Tracker?

↑ 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.). It runs locally over stdio via the published package.

Is Headless Tracker still maintained?

Yes - as of 2026-08-25, its last commit was 2026-06-21 and it shipped 9 releases in the last 90 days. We re-verify nightly.

How do I install Headless Tracker?

Run `npx -y headless-tracker`. The README documents 2 environment variables (HT_SETUP_ETHERSCAN_KEY, HT_SETUP_API_KEY) to set first. Set HT_SETUP_ETHERSCAN_KEY, HT_SETUP_API_KEY before connecting. You can also paste the ready-made client config above.

Does Headless Tracker run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Headless Tracker

More finance MCP servers · Stock Research MCP · AkTools Pro MCP Server · Gold MCP · Yookassa MCP

More TypeScript MCP servers · Tampermonkey MCP · Aidemo · Datadog MCP · Taskade MCP Server · Plumb MCP · see all