On-Chain Bitcoin- & Ethereum-Forensik für AI-Assistenten
Was ist MCP? Das Model Context Protocol ist der offene Standard (Anthropic, Nov 2024), mit dem AI-Assistenten externe Tools direkt aufrufen — kein Copy-Paste, keine manuelle API. Einmal verbunden, kann Claude oder Cursor unsere Whale-Daten direkt im Chat abfragen.
Verbinde Claude, Cursor, ChatGPT oder einen beliebigen MCP-Client mit Echtzeit-Whale-Transaktionsdaten, Per-Adress-MVRV (Profit/Loss-Status jeder Wallet) und kanonischen Meiklejohn-Clustern (Wallet-Gruppierung via Common-Input-Ownership) — 30 spezialisierte Tools, Click-to-Install, kein API-Key-Copy-Paste.
Warum dieser MCP statt Glassnode's MCP?
Glassnode (kommerzieller On-Chain-Analytics-Anbieter) hat ebenfalls einen MCP-Server — der ist hervorragend für aggregierte Markt-Metriken. Wir ergänzen, was dort fehlt: Per-Adress-Forensik, Multi-Chain-Abdeckung, Click-to-Install OAuth und eine redaktionelle Doktrin für AI-Zitate.
Per-Adress-MVRV
Berechne Realized Cost vs. Marktwert für jede einzelne Adresse anhand ihrer UTXO-Historie. Glassnode bietet nur aggregierten Netzwerk-MVRV.
Kanonische Meiklejohn-Cluster
3,85 Mio. Cluster aus 1,68 Mio. Multi-Input-Transaktionen aufgebaut. Identifiziere Wallet-Familien, Custodians und Exchange-Pools — Glassnode-MCP liefert keine Cluster-Daten.
OAuth Click-to-Install
Mit einem Klick in claude.ai hinzufügen. Free-Tier auto-genehmigt; Premium-Tier loggt via Telegram, Google oder Email ein. Kein API-Key-Copy-Paste, keine Env-Var-Verwaltung.
Multi-Chain (BTC + ETH)
Glassnodes MCP ist BTC-only. Wir liefern Ethereum-Whale-Daten parallel zu Bitcoin — ein MCP-Server, zwei Chains.
Redaktionelle AI-Richtlinie
Redaktionelle Doktrin-Resource (swiss-whale://docs/doctrine) weist AI-Clients an, unsere Daten getreu zu zitieren — deskriptive Beobachtungen, niemals Trading-Signale.
Free-Tier dauerhaft
1.000 Calls/Tag, 90 Tage Token-TTL, keine Kreditkarte. Glassnode verlangt API-Credits selbst für grundlegende Exploration.
27 Tools in 6 Kategorien
Alle Tools sind read-only. Wo angegeben Tier-gated. Beliebig kombinierbar via natürlichsprachliche Prompts im MCP-Client.
📍 Adress-Forensik 6
whale_lookup(address)FreeVollprofil: Volume Index, Entity-Label, Holdings, Frequenz, Exchange-Anteil.
whale_address_mvrv(address)FreePer-Adress-MVRV mit kreuz-validierter Balance + Data-Quality-Flag für High-Rotation-Vaults.
whale_address_cluster(address)FreeKanonisches Meiklejohn-Cluster (3,85 Mio. gesamt). Fallback auf Co-Occurrence bei Pure-Receivers.
whale_address_history(address, limit, days)PremiumVollständige chronologische TX-Historie mit USD-zur-TX-Zeit-Preisen zur Cost-Basis-Rekonstruktion.
whale_top_holders(limit, min_btc, confidence)FreeTop-Non-Exchange-Whales nach geschätzten Holdings, Confidence-gefiltert.
whale_dormant_wakeups(days, min_age_years)FreeLang-dormante Adressen, die gerade aktiv werden.
🔗 Transaktions-Ebene 3
whale_recent(min_btc, flow_type, hours, limit)FreeAktuelle qualifizierende Whale-Moves mit Cluster- und Entity-Kontext.
whale_tx_detail(txid)FreeEinzelne TX mit Block, Fee, Sender/Empfänger, Flow-Typ.
whale_entity_search(query)FreeSuche in 1.100+ Entity-Labels (Binance, Kraken, Coinbase, Custodians).
📊 Aggregierte Metriken 8
whale_cohort_breakdown(days)FreeMega/Major/Standard/Small × Flow-Typ-Counts.
whale_exchange_flows(days)FreeTäglicher In/Out/Netto-BTC-Flow über alle getaggten Exchange-Adressen.
whale_hodl_wave(days)FreeUTXO-Alters-Verteilung über die Whale-Supply.
whale_sopr(days)FreeWhale-spezifischer SOPR (UTXOs ≥ 100 BTC).
whale_miner_balances(days)FreeBTC-Bestände der Mining-Pools im Zeitverlauf.
whale_frequency_context(btc, flow)Free„N-ter ähnlicher Move diese Woche"-Kontext.
whale_btc_price(hours, granularity)FreeBTC-Preis + Whale-Event-Overlay.
whale_btc_indicators()FreePi Cycle Top Distance + Stock-to-Flow Ist-Zustand.
🌐 Markt-Kontext 3
whale_top_coins(symbol?)Free16 Coins: Preis, 24h-Änderung, Sparkline.
whale_fear_greed(days)FreeFear-&-Greed-Index, Tagesdaten von alternative.me.
whale_dominance(days)FreeBTC- und ETH-Marktkapitalisierungs-Dominanz-Trends.
📊 Benchmarks (vs. traditionelle Assets) 2
whale_benchmark_prices(symbols, days)FreeTägliche Schlusskurse für SPY / GLD / AGG / SP500 / NASDAQ (via yfinance — Yahoo-Finance-Datenquelle, S&P seit 1993).
whale_benchmark_compare(period_days, baseline)FreeKumulative Return-Vergleiche: BTC vs. S&P 500 / Gold / 70/30-Portfolio (monatliche Rebalance) über jede Zeitspanne.
Ξ Ethereum (Glassnode-MCP ist BTC-only) 2
whale_eth_recent(min_eth, hours, limit)FreeAktuelle ETH-Whale-Transaktionen mit Whale-Typ-Klassifikation.
whale_eth_cohort_breakdown(days)FreeETH-Whale-Moves nach Betrag × Typ.
⚙ Meta & Tier-aware 2
whale_my_status()FreeZeigt deinen Tier, Scopes, Rate-Limit, Capabilities.
whale_export_csv(table, days, min_btc, limit)ResearchBulk-CSV-Export aus whale_trades / eth_whale_trades / whale_outputs (max 100k Zeilen).
Plus 7 read-only Resources: swiss-whale://help/getting-started, swiss-whale://help/glossary, swiss-whale://help/comparison, swiss-whale://docs/methodology, swiss-whale://docs/doctrine, swiss-whale://ledger/latest, swiss-whale://openapi.
Installation in 30 Sekunden
Wähle deinen Client. Der Free-Tier benötigt kein Signup. Premium-Tiers (Telegram-, Google- oder Email-Login) schalten höhere Rate-Limits und Premium-Tools frei.
Für jeden MCP-fähigen Client mit stdio-Transport — wrappt unseren HTTP-Endpunkt über die npm-mcp-remote-Bridge:
npx -y mcp-remote https://mcp.btcwhalealerts.com/mcp
Funktioniert mit Claude Desktop, Zed, Continue, JetBrains AI und jedem Client, der MCP-Server automatisch via npx erkennt. Benötigt Node.js ≥ 18. Das mcp-remote-Paket übernimmt OAuth automatisch — beim ersten Run öffnet sich dein Browser für den Consent-Flow, danach wird der Bearer-Token lokal gecached.
https://mcp.btcwhalealerts.com/mcp. Verbinden klicken.In claude_desktop_config.json (oder settings.json bei neueren Plugin-Versionen) einfügen:
{
"mcpServers": {
"swiss-whale": {
"url": "https://mcp.btcwhalealerts.com/mcp",
"transport": "streamable-http"
}
}
}
Dateipfad:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
Claude Desktop komplett beenden (System-Tray → Beenden), dann neu starten.
In ~/.cursor/mcp.json (global) oder .cursor/mcp.json (Projekt) einfügen:
{
"mcpServers": {
"swiss-whale": {
"url": "https://mcp.btcwhalealerts.com/mcp"
}
}
}
Cursor lädt die MCP-Config automatisch neu; falls nicht, Cursor neu starten.
In ~/.continue/config.json unter experimental.modelContextProtocolServers einfügen:
{
"experimental": {
"modelContextProtocolServers": [
{
"name": "swiss-whale",
"transport": {
"type": "streamable-http",
"url": "https://mcp.btcwhalealerts.com/mcp"
}
}
]
}
}
In Zeds settings.json unter context_servers einfügen:
{
"context_servers": {
"swiss-whale": {
"command": {
"path": "npx",
"args": ["mcp-remote", "https://mcp.btcwhalealerts.com/mcp"]
}
}
}
}
mcp-remote wrappt unseren HTTP-Transport für reine stdio-Clients.
Direktes JSON-RPC 2.0 über HTTP. Anonymer Free-Tier:
# 1. Initialize a session
curl -i -X POST https://mcp.btcwhalealerts.com/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize",
"params":{"protocolVersion":"2025-06-18",
"capabilities":{},
"clientInfo":{"name":"curl","version":"1"}}}'
# Capture mcp-session-id from the response headers.
# 2. Acknowledge initialization
curl -X POST https://mcp.btcwhalealerts.com/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "mcp-session-id: $SESSION_ID" \
-d '{"jsonrpc":"2.0","method":"notifications/initialized"}'
# 3. List tools
curl -X POST https://mcp.btcwhalealerts.com/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "mcp-session-id: $SESSION_ID" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'
# 4. Call a tool
curl -X POST https://mcp.btcwhalealerts.com/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "mcp-session-id: $SESSION_ID" \
-d '{"jsonrpc":"2.0","id":3,"method":"tools/call",
"params":{"name":"whale_btc_indicators","arguments":{}}}'
Für Premium/Research zuerst den OAuth-Flow über /oauth/authorize abschließen, dann Authorization: Bearer <token> bei nachfolgenden Calls mitschicken.
Workflow-Cookbook
Echte verkettete Workflows, die du heute in Claude oder Cursor einfügen kannst. Jedes Beispiel zeigt den realen Output, den wir beim Bauen dieses Servers bekommen haben.
🔍 Custodian-Wallet identifizieren
Ziel: herausfinden, welche Exchange oder Institution eine mysteriöse Whale-Adresse kontrolliert.
Tool:
whale_lookup → entity_label „Bitfinex", is_exchange true, exchange_share 99,87 %.
Tool:
whale_address_cluster → method=canonical, cluster_size=131.729 Adressen, cluster_total_btc=599.066.
Tool:
whale_lookup auf jeden → alle „Bitfinex" via Cluster-inferred Propagation. Entity bestätigt.
Takeaway: Drei Calls, vollständige Attribution. Glassnode-MCP kann das nicht — sie haben kein Cluster-Tool.
💰 Per-Adress-MVRV mit Data-Quality-Awareness berechnen
Ziel: Sitzt dieses Whale-Wallet im Profit oder nahe der Cost-Basis?
Tool:
whale_address_mvrv → Balance 1.173.567 BTC, MVRV 1,056, _data_quality.status „scaled_to_cache".
Takeaway: MVRV ≈ 1 heißt: Adresse sitzt auf Cost-Basis — kein Distribution-Druck. Das Tool flaggt auch die eigene Data-Quality, sodass die AI den Caveat korrekt zitieren kann.
🛌 Dormante Whales identifizieren, die aufwachen
Ziel: Lang-dormante Adressen erkennen, die gerade aktiv geworden sind.
Tool:
whale_dormant_wakeups(days=30, min_age_years=5)Beispiel-Zeile: 3CgKHXR17eh2xCj2RGnH... — 6,1 Jahre dormant, 129.534 BTC, gerade bewegt.
Tool:
whale_address_mvrv → realized_cost_usd aus 2018 erworbenen Coins — wahrscheinlich enorme unrealized Gains.
📈 Distribution-Zone-Risiko erkennen
Ziel: Distribuieren oder akkumulieren Whales aktuell?
Tools:
whale_btc_indicators + whale_sopr(days=90) + whale_cohort_breakdown(days=7)
Ξ BTC- vs. ETH-Whale-Aktivität vergleichen
Ziel: Auf welcher Chain sind Whales diese Woche aktiver?
whale_cohort_breakdown(days=7) + whale_eth_cohort_breakdown(days=7)Vergleichen: Mega-Bucket-Counts, Flow-Typ-Ratios, Total-BTC vs Total-ETH (USD-normalisiert).
Takeaway: Glassnode-MCP kann diesen Vergleich nicht — sie sind BTC-only. Multi-Chain-Analyse ist bei unserem MCP ein Single-Prompt-Anliegen.
📦 Bulk-Export für akademische Forschung Research
Ziel: 100.000 Whale-Transaktionen für Offline-Statistik-Analyse ziehen.
Tool:
whale_export_csv(table="whale_trades", days=30, min_btc=100, limit=100000)Liefert CSV-String mit txid, timestamp, total_btc, main_sender, main_recipient, fee, fee_rate, score.
Zitation: Im Methodenteil ergänzen: „On-Chain-Daten von Swiss Whale Intelligence (btcwhalealerts.com), abgerufen via MCP-Server."
📊 BTC vs. traditionelle Assets — ehrlicher Benchmark-Vergleich
Ziel: BTCs Performance gegen die Assets stellen, mit denen ein Privatbankberater tatsächlich vergleichen würde.
Tool:
whale_benchmark_compare(period_days=365, baseline="BTC")
Takeaway: Echter, unbearbeiteter Output dieses Servers — BTC lag auf 12 Monate bei −18 %, während Gold und das 70/30-Portfolio beide positive Returns hatten. Doktrin: Berichten was passiert ist, nicht was passieren sollte. Ehrlicher Vergleich baut Glaubwürdigkeit auf, nicht Hype-Framings. Daten via yfinance, Tagesschluss, Dividenden-bereinigte ETF-Serien.
🐍 Jupyter Notebook Templates — in 5 Minuten lauffähig
Ziel: REST-API-Daten ins Notebook ziehen, mit öffentlichen Marktdaten joinen, Research-Artefakt zum Einbauen in einen Report erzeugen.
whale_flow_analysis.ipynb— täglicher Exchange-Net-Flow + Entity-Breakdown + Intent-Verteilung + Sentiment-Join (30-Tage-Fenster).address_profile_mvrv.ipynb— beliebige Whale-Adresse wählen, Fenster-limitierte Cost-Basis-Kurve rekonstruieren, Mini-MVRV gegen aktuellen BTC-Preis.exchange_reserves_timeseries.ipynb— Reserven-Kurven pro Exchange (Binance / Coinbase / Bitfinex / Kraken / OKX), 90-Tage-Fenster, BTC-Preis-Overlay, Regime-Detection.
Stack: pandas + matplotlib + requests + yfinance. Self-contained: SWI_TOKEN-Env-Var setzen, alle Zellen ausführen, Plots da. Doktrin-clean — jeder Abschnitt flaggt, ob es eine Beobachtung oder Heuristik ist. Akademische Forschende: Free-Research-Tier via [email protected].
Tier-Vergleich
Free-Tier deckt die meisten Exploration-Use-Cases ab. Premium ergänzt höhere Caps und Address-History. Research-Tier ist für institutionellen, akademischen oder Production-Use.
| Free (anonym) | Intelligence (Telegram / Google / Email Login) | Research (kostenpflichtig) | |
|---|---|---|---|
| Preis | 0 CHF | 90-Tage-Trial · dann 49 CHF/Monat | 149 CHF/month |
| Rate-Limit | 1.000 Calls / 24 h | 10.000 Calls / 24 h | 100.000 Calls / 30 Tage |
| Token-TTL | 90 Tage | 365 Tage | 365 Tage |
| History-Lookback | 7 Tage | 365 Tage | 3.650 Tage (10 Jahre) |
whale_address_history | ✗ | ✓ | ✓ |
whale_export_csv | ✗ | ✗ | ✓ 100k Zeilen / Aufruf |
| Auth-Methode | Anonym (Auto-Approve) | Telegram / Google / Email Login | Stripe-verifizierter Bearer |
| Audit-Log | Ja (per Token) | Ja (per Token) | Ja + downloadbar |
| Jederzeit widerrufbar | ✓ | ✓ | ✓ |
🎓 Akademische Forschende an .edu / .ac.uk / EPFL / ETH / uni-*-Domains erhalten den Research-Tier kostenlos. Schreib an [email protected] von deiner institutionellen Adresse.
Stripe-Checkout öffnet sich nach einer Telegram-Nachricht. Aktive MCP-Tokens werden binnen Sekunden nach Zahlung auf den neuen Tier hochgestuft.
📘 Redaktionelle Doktrin für AI-Zitate
Dies ist ein Informationsdienst, kein Trading-Tool. Der MCP exponiert eine strukturierte Doktrin-Resource (swiss-whale://docs/doctrine), die AI-Clients automatisch lesen. Beim Zitieren unserer Daten werden AI-Assistenten angewiesen:
- Deskriptive Beobachtungen liefern („28. ähnlicher Move diese Woche", „Exchange-Outflow von N BTC"), niemals präskriptive Trading-Signale.
- Die Begriffe „Trading-Signal", „Buy-Signal", „Sell-Signal", „Smart Money", „Swiss precision", „garantiert" vermeiden.
- Den
volume_index_calibrated-Score als methodisch-transparentes deskriptives Label behandeln, nicht als Profitabilitäts-Prädiktor. - Bullish/Bearish nur als beobachteten Marktzustand mit Quellenangabe framen, niemals als Prognose.
Das ist die Reading-Aid-Positionierung: Die AI gibt Usern eine getreue Zusammenfassung der On-Chain-Realität, keine Anlageberatung. Volle Doktrin via deinen MCP-Client oder unter /llms.txt.
Häufige Fragen
Was ist MCP und warum sollte mich das interessieren?
Was unterscheidet uns von Glassnodes MCP-Server?
swiss-whale://help/comparison.Ist der Free-Tier wirklich für immer kostenlos?
Wie melde ich mich für Premium an?
Wie aktuell sind die Daten?
Kann ich das für akademische Forschung nutzen?
Ist das Anlageberatung?
DSGVO / revDSG-Compliance?
/oauth/revoke.Was, wenn mein AI-Client kein MCP unterstützt?
npx mcp-remote https://mcp.btcwhalealerts.com/mcp für stdio-only Clients (Zed, ältere Claude-Desktop-Versionen, etc.).