Solana Alpha Tracker

Real-time Solana KOL & wallet alpha tracker for AI agents — three-tier watchlist + entry quality scoring + position size anomaly. stdio MCP, 0 demo, MIT.

{
  "mcpServers": {
    "solana-alpha-tracker": {
      "command": "npx",
      "args": ["-y", "solana-alpha-tracker"],
      "env": { "HELIUS_API_KEY": "free at helius.dev (30s)" }
    }
  }
}

Why

Cielo Pro is $59/month. Nansen Smart Money is generic-only. KOLScan has no API. GMGN/Photon/Trojan tax 1% per swap. All paid tools tell you "X bought Y" — none tell you what Y is, how oversized X's bet is, or if 3 KOLs piled in together.

This MCP plugs the gap with 26 tools, all free, all running locally on your machine.

Features

• 3-tier watchlist — my (you add) + verified (38 named KOLs bundled) + performance (auto-discovered top traders). Toggle any tier off for privacy mode.
• Real-time via Helius webhook through automatic Cloudflare Tunnel — < 1 min latency, no public URL setup needed.
• Entry quality — 9 hard-skip checks + 6 weighted score signals. RugCheck-primary (0 key), 0 RPC self-build needed.
• Position size anomaly (独家) — "this buy is 4× wallet's typical size" — no competitor outputs this.
• Cluster detection — when 3+ watched wallets pile into the same token in the same hour.
• Subscriptions — saved filter rules + pending_alerts queue.
• Auto maintenance — daily PnL rerank cron, monthly cull dry-run.

Tools (26)

Group	Tools
Diagnostics	solanaalphatracker_status, solanaalphatracker_setup_guide, webhook_status, webhook_resync
Watchlist	add_watch, bulk_import, remove_watch, list_watches, pnl_rerank_now, cull_stale_watches, toggle_tier
Activity	recent_buys, recent_sells, wallet_activity, cluster_buys, wallet_positions_now
Entry quality	entry_quality_score, position_size_anomaly, wallet_track_record, risk_filters
Subscriptions	subscribe_buys, pending_alerts, unsubscribe_rule
Ranking	top_watches_by_pnl, discover_new_traders
Narrative	alpha_briefing

Use cases

# 1. "@Ansem 5 分钟前买的 $XYZ 能跟吗?"
recent_buys(60, tier="verified")             # find his buy
entry_quality_score(token_address=$XYZ)      # 9 hard-skip + 6 score
position_size_anomaly(@blknoiz06, $XYZ, ...) # how oversized vs typical?

# 2. "现在最高确认度的 alpha?"
cluster_buys(min_count=3)                    # where ≥3 KOLs piled in
# pick top cluster, then:
entry_quality_score(token_address=...)

# 3. "Telegram 群推了一个钱包,先观察"
add_watch(wallet=..., label="TG-tip", group="my-tg-tips")
wallet_track_record(label="TG-tip", days=30)  # is he actually profitable?

# 4. "状态自动跑"
subscribe_buys(rule_name="kol-low-mcap", tier="verified", mcap_max=1_000_000)
# poll later:
pending_alerts(rule_name="kol-low-mcap")     # drains since last call

Setup

Required: HELIUS_API_KEY

Sign up at https://helius.dev (30s, no card). Free tier 1M credits/month.

Optional: SOLANA_TRACKER_API_KEY

Sign up at https://solanatracker.io. Free tier 10K req/month, 1 rps. Enables precise wallet PnL & top-trader discovery; without it those tools fall back to local activity_log accumulation.

Real-time webhook (recommended)

Install cloudflared so the MCP can spin up an automatic public tunnel:

# Mac
brew install cloudflared

# Linux (Debian/Ubuntu via Cloudflare repo)
sudo mkdir -p --mode=0755 /usr/share/keyrings
curl -fsSL https://pkg.cloudflare.com/cloudflare-main.gpg | sudo tee /usr/share/keyrings/cloudflare-main.gpg >/dev/null
echo "deb [signed-by=/usr/share/keyrings/cloudflare-main.gpg] https://pkg.cloudflare.com/cloudflared $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/cloudflared.list
sudo apt update && sudo apt install cloudflared

# Windows
winget install --id Cloudflare.cloudflared

Without cloudflared the MCP runs in webhook=off mode — watchlist + entry quality tools still work, but no real-time activity stream.

Architecture

See docs/architecture.md.

Status

• ✅ 26 tools, all wired, all tested (23 vitest cases passing)
• ✅ 38 verified KOLs bundled (Ansem / Cented / Cupsey / Frank DeGods / Euris / orangie + 32 from kolscan)
• ✅ Helius webhook auto-bootstrap via cloudflared, 1 wallet smoke-tested end-to-end
• ✅ RugCheck + DexScreener + Helius integrations, all with structured fallbacks

License

MIT