MCP-Server für KI-Agenten

Blocklens stellt einen MCP-Server bereit, mit dem KI-Agenten direkt während eines Gesprächs On-Chain-Analytik abfragen können. Anstatt API-Antworten zu kopieren und einzufügen, entdeckt Ihr Agent die verfügbaren Tools und ruft sie eigenständig auf.

Was ist MCP?

Model Context Protocol (MCP) ist ein von Anthropic geschaffener offener Standard, der definiert, wie KI-Anwendungen mit externen Datenquellen und Tools verbunden werden. Stellen Sie es sich als universellen Adapter vor — jeder MCP-kompatible Agent (Claude, Cursor, Windsurf usw.) kann sich ohne eigenen Integrationscode mit jedem MCP-Server verbinden.

Mit MCP liest der Agent nicht nur Daten — er kann entdecken, welche Tools verfügbar sind, ihre Parameter verstehen und sie mit den richtigen Argumenten aufrufen. Das macht Interaktionen weitaus natürlicher als das manuelle Erstellen von API-Aufrufen.

Remote-Zugriff (keine Installation erforderlich)

Der schnellste Weg zur Verbindung führt über unseren gehosteten MCP-Endpunkt — keine zu installierenden Pakete, keine lokale Einrichtung.

Claude.ai

Gehen Sie zu Einstellungen → Connectors
Klicken Sie auf +, um einen neuen Connector hinzuzufügen
Fügen Sie die URL ein: https://mcp.blocklens.co
Lassen Sie Client-ID und Client-Secret leer → klicken Sie auf Hinzufügen
Autorisieren Sie mit Ihrem API-Schlüssel, wenn Sie dazu aufgefordert werden

Claude Desktop

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "blocklens": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.blocklens.co"]
    }
  }
}

ChatGPT

Aktivieren Sie den Entwicklermodus: Settings → General → Developer Mode
Gehen Sie zu Settings → Developer → MCP Servers
Klicken Sie auf Add Server, geben Sie als Namen „Blocklens“ und als URL https://mcp.blocklens.co ein
Autorisieren Sie mit Ihrem API-Schlüssel, wenn Sie dazu aufgefordert werden

Cursor / Windsurf

Öffnen Sie Settings → MCP Servers
Fügen Sie einen Remote-Server mit der URL https://mcp.blocklens.co hinzu
Autorisieren Sie mit Ihrem API-Schlüssel, wenn Sie dazu aufgefordert werden

Für Cursor können Sie auch Folgendes zu .cursor/mcp.json hinzufügen:

{
  "mcpServers": {
    "blocklens": {
      "url": "https://mcp.blocklens.co"
    }
  }
}

Beliebiger MCP-HTTP-Client

Senden Sie ein POST an https://mcp.blocklens.co über den Streamable HTTP-Transport. Der Server unterstützt das vollständige MCP-Protokoll — Tool-Entdeckung, -Aufruf und Streaming-Antworten.

Keine Installation erforderlich

Der Remote-Endpunkt stellt dieselben 19 Tools wie das npm-Paket bereit. Er funktioniert im Browser, benötigt keine lokalen Abhängigkeiten und unterstützt den Demo-Modus von Haus aus.

Authentifizierung

Der MCP-Server unterstützt zwei Zugriffsmodi:

Kostenloser Zugriff (kein API-Schlüssel)

Verbinden Sie sich ohne jegliche Anmeldedaten, um auf Metriken der kostenlosen Stufe zuzugreifen: Preise, Holder-Supply, Bewertung, ETF-Aggregat, Coin Days und Blockchain-Daten. Bis zu 60 Tage Verlauf.

Vollzugriff (mit API-Schlüssel)

Schalten Sie alle Metriken einschließlich der Pro- und Enterprise-Stufen frei. Bei der ersten Verbindung erscheint eine Blocklens-Autorisierungsseite, auf der Sie Ihren API-Schlüssel eingeben. Dies nutzt einen sicheren OAuth-Ablauf — es werden keine Client-ID und kein Secret benötigt.

Holen Sie sich Ihren API-Schlüssel unter blocklens.co/api-mcp.

Warum Blocklens + MCP?

Blocklens bietet native MCP-Unterstützung für On-Chain-Analytik und ermöglicht KI-Agenten, Metriken ohne eigene Integration direkt abzufragen.

Was das in der Praxis bedeutet:

On-Chain-Abfragen in Echtzeit — Fragen Sie Ihren KI-Agenten „Ist Bitcoin gerade überbewertet?“ und er ruft get_holder_valuation auf, um MVRV, Realized Cap und mehr zu prüfen
Keine manuelle API-Arbeit — Der Agent entdeckt Tools automatisch und formatiert die Antworten für Sie
Recherche im Gesprächstempo — Verketten Sie mehrere Abfragen: prüfen Sie Preis, dann Supply, dann Profitabilität, alles in einem Gespräch
Automatisiertes Reporting — Lassen Sie Ihren Agenten wöchentliche On-Chain-Gesundheitsberichte mit Live-Daten erstellen

Lokale Installation (Alternative)

Den einfachsten Einstieg finden Sie unter Remote-Zugriff — keine Pakete oder lokale Konfiguration erforderlich.

Installation

npm install -g blocklens-mcp-server

Claude Desktop

Fügen Sie dies zu Ihrer Claude-Desktop-Konfigurationsdatei (claude_desktop_config.json) hinzu:

{
  "mcpServers": {
    "blocklens": {
      "command": "npx",
      "args": ["-y", "blocklens-mcp-server"],
      "env": {
        "BLOCKLENS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Speicherort der Konfigurationsdatei:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Starten Sie Claude Desktop nach dem Speichern neu. „blocklens“ sollte nun unter den verfügbaren MCP-Tools aufgeführt sein.

Cursor / Windsurf

Fügen Sie dies zu Ihren MCP-Einstellungen (.cursor/mcp.json oder Äquivalent) hinzu:

{
  "mcpServers": {
    "blocklens": {
      "command": "npx",
      "args": ["-y", "blocklens-mcp-server"],
      "env": {
        "BLOCKLENS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Demo-Modus (kein API-Schlüssel)

Sie können den MCP-Server ohne API-Schlüssel ausprobieren. Im Demo-Modus:

Funktioniert: list_metrics, search_metrics, get_metric, get_categories sowie Daten-Endpunkte mit bis zu 60 Tagen Verlauf für grundlegende Metriken (Grade 0)
Erfordert API-Schlüssel: Profit-Metriken (SOPR, Realized P/L), erweiterter Verlauf, Metriken der Enterprise-Stufe

Um im Demo-Modus zu arbeiten, lassen Sie einfach den BLOCKLENS_API_KEY in Ihrer Konfiguration weg:

{
  "mcpServers": {
    "blocklens": {
      "command": "npx",
      "args": ["-y", "blocklens-mcp-server"]
    }
  }
}

Verfügbare Tools

Der MCP-Server stellt 19 Tools bereit, die die gesamte Blocklens-Analytiksuite abdecken: Marktdaten, Holder-Supply, Bewertung, Profitabilität, Alterskohorten, UTXO-Verlauf, Coin Days, ETF-Analytik, Blockchain-Statistiken, Zyklusgrenzen und Chart-Rendering. Aufgebaut auf einer einheitlichen TypeScript-Codebasis.

Stufenanforderungen

Stufe	Tools
Free	`list_metrics`, `search_metrics`, `get_metric`, `get_categories`, `get_latest_metrics`, `get_prices`, `get_holder_supply`, `get_holder_valuation`, `get_etf_data`, `get_coindays`, `get_blockchain`, `get_cycle_boundaries`
Pro	`get_holder_profit`, `get_cohort_metrics`, `get_utxo_history`
Pro	`get_dat_entity`
Abhängig von der Metrik	`render_chart` — kostenlose Metriken werden ohne Schlüssel gerendert; Pro-/Enterprise-Metriken erfordern die entsprechende Stufe

`list_metrics`

Free

Listet alle verfügbaren On-Chain-Metriken mit Beschreibungen, Kategorien und Stufenanforderungen auf.

Parameter: Keine

Anwendungsfall: Beginnen Sie hier, um zu entdecken, welche Daten verfügbar sind. Gibt den vollständigen Katalog mit den Metrik-IDs zurück, die Sie für andere Tools benötigen.

Beispielantwort (gekürzt):

[
  {
    "id": "price",
    "name": "BTC Price",
    "category": "price",
    "unit": "USD",
    "endpoint": "prices",
    "grade": 0
  },
  {
    "id": "lth_supply",
    "name": "LTH Supply",
    "category": "supply",
    "unit": "BTC",
    "endpoint": "holder/supply",
    "grade": 0
  },
  {
    "id": "funding_binance",
    "name": "Binance Funding Rate",
    "category": "exchanges",
    "endpoint": "funding/exchange",
    "grade": 1,
    "params": { "exchange": "binance" },
    "params_schema": {
      "exchange": {
        "type": "string",
        "required": true,
        "description": "Exchange identifier",
        "values_endpoint": "/v1/funding/exchanges"
      }
    }
  }
]

Parametrisierte Metriken

Einige Metriken erfordern zusätzliche Parameter (z. B. exchange, ticker, id). Prüfen Sie das Feld params auf Standardwerte und params_schema auf Parameterbeschreibungen und Endpunkte mit verfügbaren Werten.

`get_prices`

Free

Ruft tägliche OHLC-Preise (Open/High/Low/Close in USD), Marktkapitalisierung und 24-Stunden-Handelsvolumen ab.

Parameter	Typ	Standard	Beschreibung
`symbol`	string	`"BTC"`	Kryptowährungssymbol
`days`	integer	`30`	Anzahl täglicher Datenpunkte (1–10.000)
`start_date`	string	—	Startdatum (`YYYY-MM-DD`). Überschreibt `days`.
`end_date`	string	—	Enddatum (`YYYY-MM-DD`). Standardmäßig heute.

Anwendungsfall: Preiskontext für jede Analyse. Kombinieren Sie ihn mit Bewertungsmetriken, um zu beurteilen, ob der aktuelle Preis durch On-Chain-Fundamentaldaten gerechtfertigt ist.

`get_holder_supply`

Free

Ruft die LTH/STH-Supply-Aufschlüsselung ab: Long-Term-Holder-Supply (länger als 155 Tage gehalten), Short-Term-Holder-Supply (weniger als 155 Tage gehalten) und gesamtes zirkulierendes Angebot. Alle Werte in BTC.

Parameter	Typ	Standard	Beschreibung
`days`	integer	`30`	Anzahl täglicher Datenpunkte (1–10.000)
`start_date`	string	—	Startdatum (`YYYY-MM-DD`)
`end_date`	string	—	Enddatum (`YYYY-MM-DD`)

Anwendungsfall: Verfolgen Sie Akkumulation und Distribution. Steigende LTH-Supply = Überzeugung / Akkumulation. Steigende STH-Supply = neues Kapital strömt ein / mögliche bevorstehende Distribution.

`get_holder_valuation`

Free

Ruft Bitcoin-Bewertungsmetriken ab: Realized Cap, Realized Price, LTH/STH Realized Cap und Price, MVRV-Ratio und Unrealized P/L.

Parameter	Typ	Standard	Beschreibung
`days`	integer	`30`	Anzahl täglicher Datenpunkte (1–10.000)
`start_date`	string	—	Startdatum (`YYYY-MM-DD`)
`end_date`	string	—	Enddatum (`YYYY-MM-DD`)

Anwendungsfall: Zentrales Bewertungsframework. Ein MVRV > 3,5 signalisiert historisch eine Überhitzung; ein MVRV < 1 signalisiert Unterbewertung. Vergleichen Sie die Realized Prices von LTH und STH, um die Marktstruktur einzuschätzen.

`get_holder_profit`

Pro

Ruft Bitcoin-Profitabilitätsmetriken ab: LTH/STH Realized P/L (USD) und SOPR (Spent Output Profit Ratio). Erfordert einen API-Schlüssel der Pro-Stufe.

Parameter	Typ	Standard	Beschreibung
`days`	integer	`30`	Anzahl täglicher Datenpunkte (1–10.000)
`start_date`	string	—	Startdatum (`YYYY-MM-DD`)
`end_date`	string	—	Enddatum (`YYYY-MM-DD`)

Anwendungsfall: Verstehen Sie, ob Coins mit Gewinn oder Verlust bewegt werden. Ein SOPR > 1 bedeutet, dass Holder mit Gewinn verkaufen; ein SOPR < 1 bedeutet Verkauf mit Verlust (signalisiert oft Kapitulation oder Bodenbildung).

`get_cohort_metrics`

Pro

Ruft Alterskohorten-Metriken ab: Supply (BTC), Realized Cap (USD) und Realized Price (USD) für eine bestimmte UTXO-Altersspanne. Wird für die HODL-Waves-Analyse verwendet.

Parameter	Typ	Standard	Beschreibung
`cohort`	enum	erforderlich	Altersspanne (siehe unten)
`days`	integer	`30`	Anzahl täglicher Datenpunkte (1–10.000)
`start_date`	string	—	Startdatum (`YYYY-MM-DD`)
`end_date`	string	—	Enddatum (`YYYY-MM-DD`)

Gültige Kohorten: 24h, 1d_1w, 1w_1m, 1m_3m, 3m_6m, 6m_12m, 1y_2y, 2y_3y, 3y_5y, 5y_7y, 7y_10y, 10y_plus

Anwendungsfall: Tiefgehende Analyse bestimmter Altersgruppen. Prüfen Sie zum Beispiel, ob die Kohorte 3m_6m wächst (neue, heranreifende Akkumulation) oder ob 10y_plus-Coins sich endlich bewegen (lange ruhendes Angebot erwacht).

`get_utxo_history`

Pro

Ruft die Aufschlüsselung des UTXO-Sets nach Alterskohorte ab. Zeigt Token-Mengen (BTC) und USD-Werte für jede Kohorte an einem bestimmten Datum.

Parameter	Typ	Standard	Beschreibung
`date_processed`	string	—	Bestimmtes Snapshot-Datum (`YYYY-MM-DD`)
`cohort_start`	string	—	Beginn des Kohorten-Datumsbereichs
`cohort_end`	string	—	Ende des Kohorten-Datumsbereichs
`days`	integer	`1000`	Anzahl der Datensätze (1–50.000)

Anwendungsfall: Analysieren Sie Coin-Ruhephasen und Akkumulationsmuster. Wenn ruhendes Angebot sich bewegt, geht dies oft signifikanten Preisbewegungen voraus.

`get_latest_metrics`

Free

Ruft den aktuellsten Snapshot über alle Metrik-Kategorien hinweg (Preis, Supply, Bewertung, Profit) in einem einzigen Aufruf ab.

Parameter: Keine

Anwendungsfall: Schneller Marktüberblick. Ein Aufruf liefert Ihnen den aktuellen Stand aller wichtigen Metriken — ideal für tägliche Check-ins oder den Start einer tiefergehenden Analyse.

`search_metrics`

Free

Durchsucht verfügbare Metriken per Stichwort über Namen, Beschreibungen und IDs hinweg.

Parameter	Typ	Standard	Beschreibung
`query`	string	erforderlich	Suchbegriff (z. B. `"realized price"`, `"MVRV"`, `"supply"`)

Anwendungsfall: Finden Sie die richtige Metrik, wenn Sie ungefähr wissen, wonach Sie suchen, aber nicht die genaue ID. Gibt passende Metriken mit ihren Endpunkten und Stufenanforderungen zurück.

`get_metric`

Free

Ruft die vollständige Definition einer einzelnen Metrik anhand ihrer ID ab, einschließlich Name, Beschreibung, Kategorie, Endpunkt, Einheit und Zugriffsstufe.

Parameter	Typ	Standard	Beschreibung
`metric_id`	string	erforderlich	Metrik-Bezeichner (z. B. `"lth_supply"`, `"price"`, `"sth_sopr"`)

Anwendungsfall: Schlagen Sie nach, was eine Metrik genau misst, wie sie berechnet wird und welche Stufe erforderlich ist, bevor Sie die Daten abrufen. Die Antwort enthält params und params_schema, wenn die Metrik zusätzliche Parameter erfordert (z. B. exchange, ticker, id).

`get_categories`

Free

Listet alle Metrik-Kategorien mit Anzahl und den Metrik-IDs in jeder Kategorie auf.

Parameter: Keine

Anwendungsfall: Erhalten Sie einen strukturierten Überblick über die verfügbaren Daten, organisiert nach Themen (Preis, Supply, Bewertung, Profit).

`get_coindays`

Free

Ruft Coin-Days-Metriken ab: Coin Days Destroyed (CDD), Liveliness, Vaultedness und Dormancy. Diese Metriken messen, wie lange Coins gehalten wurden, bevor sie ausgegeben wurden, und offenbaren so Überzeugungs- und Aktivitätsmuster.

Parameter	Typ	Standard	Beschreibung
`days`	integer	`30`	Anzahl täglicher Datenpunkte (1–10.000)
`start_date`	string	—	Startdatum (`YYYY-MM-DD`)
`end_date`	string	—	Enddatum (`YYYY-MM-DD`)

Anwendungsfall: Erkennen Sie, wann lange ruhende Coins anfangen, sich zu bewegen. Hohe CDD-Spitzen gehen oft großen Preisbewegungen voraus. Steigende Liveliness = alte Coins werden ausgegeben; steigende Vaultedness = Coins werden für langfristiges Halten weggeschlossen.

`get_etf_data`

Free

Ruft aggregierte Bitcoin-ETF-Daten ab: Gesamtbestände (BTC), AUM (USD), tägliche Nettozuflüsse, kumulierte Zuflüsse, ETF-Dominanz und ETF Realized Price.

Parameter	Typ	Standard	Beschreibung
`days`	integer	`30`	Anzahl täglicher Datenpunkte (1–10.000)
`start_date`	string	—	Startdatum (`YYYY-MM-DD`)
`end_date`	string	—	Enddatum (`YYYY-MM-DD`)

Anwendungsfall: Verfolgen Sie die institutionelle Nachfrage über ETF-Flüsse. Steigende AUM und positive Nettozuflüsse signalisieren institutionelle Akkumulation. Vergleichen Sie den ETF Realized Price mit dem Spotpreis, um einzuschätzen, ob ETF-Holder im Gewinn sind.

`get_blockchain`

Free

Ruft Blockchain-Metriken ab: Blockhöhe oder pro Tag geschürfte Blöcke.

Parameter	Typ	Standard	Beschreibung
`metric`	enum	erforderlich	`"block_height"` oder `"blocks_mined"`
`days`	integer	`30`	Anzahl täglicher Datenpunkte (1–10.000)
`start_date`	string	—	Startdatum (`YYYY-MM-DD`)
`end_date`	string	—	Enddatum (`YYYY-MM-DD`)

Anwendungsfall: Überwachen Sie die Netzwerkgesundheit und die Mining-Aktivität. Weichen die pro Tag geschürften Blöcke von etwa 144 ab, kann dies auf Änderungen der Hashrate oder Difficulty-Anpassungen hindeuten.

`get_dat_aggregate`

Free

Ruft aggregierte Digital-Asset-Treasuries-Daten ab: gesamte von Institutionen und Regierungen gehaltene BTC, Anzahl der Unternehmen, Nettozuflüsse, Aufschlüsselung nach öffentlich/privat/staatlich.

Parameter	Typ	Standard	Beschreibung
`days`	integer	`30`	Anzahl täglicher Datenpunkte (1–10.000)
`start_date`	string	—	Startdatum (`YYYY-MM-DD`)
`end_date`	string	—	Enddatum (`YYYY-MM-DD`)

Anwendungsfall: Verfolgen Sie die institutionelle Bitcoin-Adoption. Steigende Gesamt-BTC über Unternehmens- und Staatstreasuries hinweg signalisieren wachsende institutionelle Überzeugung.

Für den Realized Price (Cost Basis pro BTC) nach Entitätstyp (staatlich, öffentlich, privat) verwenden Sie render_chart mit den Metriken dat_rp_total, dat_rp_public, dat_rp_government, dat_rp_private oder der Vorlage dat-realized-price-by-type.

`get_dat_registry`

Free

Listet alle erfassten Digital-Asset-Treasury-Entitäten (Unternehmen, Fonds, Regierungen) mit Metadaten auf, darunter Name, Ticker, Entitätstyp und Land.

Parameter: Keine

Anwendungsfall: Entdecken Sie, welche Entitäten Bitcoin halten. Verwenden Sie das zurückgegebene Feld id, um mit get_dat_entity Daten pro Entität abzufragen.

`get_dat_entity`

Pro

Ruft Digital-Asset-Treasury-Daten pro Entität ab: BTC-Bestände, AUM, Nettozufluss, kumulierter Zufluss, Marktanteil, Realized Price (durchschnittliche Kosten pro BTC) und gesamte Cost Basis.

Parameter	Typ	Standard	Beschreibung
`id`	integer	erforderlich	Entitäts-/Unternehmens-ID (aus `get_dat_registry`)
`days`	integer	`365`	Anzahl täglicher Datenpunkte (1–10.000)
`start_date`	string	—	Startdatum (`YYYY-MM-DD`)
`end_date`	string	—	Enddatum (`YYYY-MM-DD`)

Anwendungsfall: Analysieren Sie die Bitcoin-Strategie einer bestimmten Entität — verfolgen Sie das Wachstum der Bestände, vergleichen Sie den Realized Price mit dem Marktpreis für Unrealized P/L und überwachen Sie Akkumulationsmuster.

Beispiel: get_dat_entity({ id: 1 }) gibt Daten zu Strategy (ehemals MicroStrategy) zurück, darunter einen Bestand von 762K BTC und einen Realized Price von 75.694 $.

`get_cycle_boundaries`

Free

Ruft die Grenzen der Bitcoin-Halving-Zyklen ab: Startdatum, Enddatum, Dauer in Tagen und Zyklusnummer für jede Halving-Epoche.

Parameter: Keine

Anwendungsfall: Identifizieren Sie Zyklusphasen für vergleichende Analysen. Verwenden Sie es mit render_chart und x_axis: "day_offset", um Charts zur Zyklus-Performance zu überlagern, bei denen alle Zyklen an Tag 0 beginnen.

Beispielantwort (gekürzt):

[
  { "cycle": 1, "start_date": "2009-01-03", "end_date": "2012-11-28", "duration_days": 1426 },
  { "cycle": 2, "start_date": "2012-11-28", "end_date": "2016-07-09", "duration_days": 1319 },
  { "cycle": 3, "start_date": "2016-07-09", "end_date": "2020-05-11", "duration_days": 1402 },
  { "cycle": 4, "start_date": "2020-05-11", "end_date": "2024-04-20", "duration_days": 1441 },
  { "cycle": 5, "start_date": "2024-04-20", "end_date": null, "duration_days": null }
]

`render_chart`

Abhängig von der Metrik

Rendert einen Bitcoin-On-Chain-Analytik-Chart als PNG-Bild oder SVG-Vektorgrafik. Gibt das Bild inline im Gespräch zurück. Unterstützt einzelne Metriken, mehrere Metriken, Vorlagen und vollständige Anpassung.

Parameter	Typ	Standard	Beschreibung
`metric`	string	—	Einzelne Metrik-ID (z. B. `"price"`, `"lth_supply"`)
`metrics`	array	—	Mehrere Metriken als Strings oder Konfigurationsobjekte
`template`	string	—	Chart-Vorlage (z. B. `"mvrv_ratio"`, `"holder_supply"`)
`days`	integer	`365`	Verlaufstage (7–3.650)
`start_date`	string	—	Startdatum (`YYYY-MM-DD`)
`end_date`	string	—	Enddatum (`YYYY-MM-DD`)
`overlay`	`"price"`	—	BTC-Preis-Overlay hinzufügen
`theme`	`"light"` / `"dark"`	`"light"`	Farbschema
`width`	integer	`1200`	Bildbreite in Pixeln
`height`	integer	`600`	Bildhöhe in Pixeln
`title`	string	auto	Chart-Titel
`style`	`"line"` / `"area"` / `"bar"`	auto	Standard-Chart-Stil
`scale`	`"linear"` / `"log"`	`"linear"`	Skala der Y-Achse
`y_axes`	array	—	Benutzerdefinierte Y-Achsen mit vertikalen Zonen. Jedes Objekt: `{ id, side, scale?, format?, range?, domain_min?, domain_max?, no_padding? }`. Siehe Snapshot-API — Benutzerdefinierte Y-Achsen.
`x_axis`	`"date"` / `"day_offset"`	`"date"`	Modus der X-Achse. Verwenden Sie `"day_offset"` für Overlays zur Zyklus-Performance. Erfordert, dass alle `metrics` aus derselben Familie `cycle_ath_`, `cycle_low_` oder `cycle_halving_*` stammen.
`heatmap_id`	`"cost-basis-distribution"`	—	Rendert eine Heatmap statt eines Liniencharts. Schließt `metric` / `metrics` / `template` gegenseitig aus. Siehe Heatmap-Rendering.
`heatmap_period`	`"3m"` / `"6m"` / `"1y"` / `"2y"` / `"3y"` / `"5y"` / `"all"`	`"1y"`	Zeitfenster für das Heatmap-Binning.
`heatmap_color_scale`	`"viridis"` / `"plasma"` / `"inferno"` / `"magma"` / `"cividis"`	`"viridis"`	Farbpalette für die Heatmap-Zellen.
`heatmap_y_scale`	`"linear"` / `"log"`	`"linear"`	Skala der Y-Achse für die Heatmap-Preis-Bins.
`params`	object	—	Parameter pro Aufruf für parametrisierte Metriken (z. B. `{ exchange: "binance" }`, `{ ticker: "IBIT" }`). Erforderlich, wenn das `params_schema` der Metrik ein Pflichtfeld deklariert.
`format`	`"png"` / `"svg"` / `"json"`	`"png"`	Ausgabeformat. `"png"` gibt ein Rasterbild zurück, `"svg"` gibt eine skalierbare Vektorgrafik zurück (ideal zum Einbetten in Präsentationen oder den Druck), `"json"` gibt nur Chart-Metadaten zurück (kein Rendering).

Anwendungsfall: Visualisieren Sie jede Metrik direkt im Gespräch. Der Agent gibt ein Chart-Bild zurück, das inline erscheint — kein Öffnen eines Browsers oder Dashboards erforderlich.

Beispielaufrufe:

render_chart({ metric: "price" })
render_chart({ template: "mvrv_ratio", days: 730 })
render_chart({ metrics: ["lth_supply", "sth_supply"], style: "area", days: 730 })
render_chart({ metric: "funding_binance" })
render_chart({ metrics: [{ id: "funding_binance", params: { exchange: "binance" } }] })
render_chart({ metrics: ["cycle_ath_1","cycle_ath_2","cycle_ath_3","cycle_ath_4","cycle_ath_5"], x_axis: "day_offset", scale: "log" })
render_chart({ heatmap_id: "cost-basis-distribution", heatmap_period: "1y", theme: "dark" })
render_chart({ template: "mvrv_ratio", format: "svg" })  // vector output

Einige Metriken erfordern Parameter (wie exchange oder ticker). Wenn Sie das metrics-Array mit Konfigurationsobjekten verwenden, fügen Sie params aus der Metrikdefinition hinzu.

Siehe Snapshot-API für die vollständige Dokumentation zu den Optionen für das Chart-Rendering.

Anwendungsfälle mit Beispiel-Prompts

Hier sind konkrete Prompts, die Sie Ihrem KI-Agenten geben können, sobald der Blocklens-MCP-Server verbunden ist.

Marktbewertungsanalyse

„Ist Bitcoin derzeit überbewertet? Prüfe das MVRV-Ratio und vergleiche die Realized Prices von LTH und STH mit dem aktuellen Spotpreis.“

Der Agent ruft get_holder_valuation und get_prices auf und synthetisiert dann die Daten, um zu beurteilen, ob der aktuelle Marktwert über oder unter der aggregierten Cost Basis liegt.

HODL-Waves-Recherche

„Zeig mir, wie sich die Supply-Verteilung über die Alterskohorten im letzten Jahr verändert hat. Akkumulieren oder distribuieren Long-Term-Holder?“

Der Agent ruft get_cohort_metrics für mehrere Kohorten mit days: 365 auf und analysiert dann die Trends in jeder Altersspanne, um Muster von Akkumulation vs. Distribution zu identifizieren.

Wöchentlicher On-Chain-Bericht

„Erstelle einen wöchentlichen Bericht zur On-Chain-Gesundheit von Bitcoin, der Preisbewegung, Supply-Dynamik, Holder-Profitabilität und MVRV abdeckt.“

Der Agent ruft get_latest_metrics für einen Snapshot auf und geht dann für 7-Tage-Trends in get_prices, get_holder_supply, get_holder_valuation und get_holder_profit in die Tiefe, um eine strukturierte Zusammenfassung zu erstellen.

Identifizierung der Zyklusphase

„Was deutet der Trend der Realized Cap auf die aktuelle Marktphase hin? Vergleiche die Wachstumsrate der Realized Cap mit den Vormonaten.“

Der Agent ruft get_holder_valuation mit einem längeren Zeitfenster auf und analysiert die Entwicklung der Realized Cap, um zu erkennen, ob wir uns in Akkumulation, Markup, Distribution oder Markdown befinden.

Kapitulationserkennung

„Prüfe, ob der STH SOPR in den letzten 30 Tagen unter 1 gefallen ist — das deutet darauf hin, dass Short-Term-Holder mit Verlust verkaufen.“

Der Agent ruft get_holder_profit mit days: 30 auf und untersucht die STH-SOPR-Werte, um Kapitulationsereignisse zu kennzeichnen.

Zugriffsstufen

Stufe	MCP-Zugriff	Verlauf	Metriken	Tägliche Anfragen
Demo (kein Schlüssel)	Ja	60 Tage	Grundlegend (Grade 0)	Unbegrenzt
Pro (50 $/Monat)	Ja	Unbegrenzt	Alle (Grade 0–1)	10.000
Enterprise (900 $/Monat)	Ja	Unbegrenzt	Alle (Grade 0–2)	100.000

Der MCP-Server funktioniert mit allen Stufen. Der Demo-Modus ist eine hervorragende Möglichkeit, die Tools vor einem Abonnement zu erkunden. Holen Sie sich einen API-Schlüssel, um den Vollzugriff freizuschalten.

Holen Sie sich Ihren API-Schlüssel

Besuchen Sie blocklens.co/api-mcp, um einen API-Schlüssel zu erstellen und Ihre Abonnementstufe sowie Nutzung einzusehen.

Ressourcen

Remote-MCP-Endpunkt: mcp.blocklens.co
npm-Paket: blocklens-mcp-server
Quellcode: GitHub
llms.txt: docs.blocklens.co/llms.txt
KI-Plugin-Manifest: docs.blocklens.co/.well-known/ai-plugin.json
Snapshot-API-Dokumentation: Chart-Snapshot-API
API-Referenz: Interaktive API-Dokumentation
API-Schlüssel holen: blocklens.co/api-mcp
MCP-Protokoll: modelcontextprotocol.io

Was ist MCP?​

Remote-Zugriff (keine Installation erforderlich)​

Claude.ai​

Claude Desktop​

ChatGPT​

Cursor / Windsurf​

Beliebiger MCP-HTTP-Client​

Authentifizierung​

Kostenloser Zugriff (kein API-Schlüssel)​

Vollzugriff (mit API-Schlüssel)​

Warum Blocklens + MCP?​

Lokale Installation (Alternative)​

Installation​

Claude Desktop​

Cursor / Windsurf​

Demo-Modus (kein API-Schlüssel)​

Verfügbare Tools​

Stufenanforderungen​

list_metrics​

get_prices​

get_holder_supply​

get_holder_valuation​

get_holder_profit​

get_cohort_metrics​

get_utxo_history​

get_latest_metrics​

search_metrics​

get_metric​

get_categories​

get_coindays​

get_etf_data​

get_blockchain​

get_dat_aggregate​

get_dat_registry​

get_dat_entity​

get_cycle_boundaries​

render_chart​

Anwendungsfälle mit Beispiel-Prompts​

Marktbewertungsanalyse​

HODL-Waves-Recherche​

Wöchentlicher On-Chain-Bericht​

Identifizierung der Zyklusphase​

Kapitulationserkennung​

Zugriffsstufen​

Holen Sie sich Ihren API-Schlüssel​

Ressourcen​

Was ist MCP?

Remote-Zugriff (keine Installation erforderlich)

Claude.ai

Claude Desktop

ChatGPT

Cursor / Windsurf

Beliebiger MCP-HTTP-Client

Authentifizierung

Kostenloser Zugriff (kein API-Schlüssel)

Vollzugriff (mit API-Schlüssel)

Warum Blocklens + MCP?

Lokale Installation (Alternative)

Installation

Claude Desktop

Cursor / Windsurf

Demo-Modus (kein API-Schlüssel)

Verfügbare Tools

Stufenanforderungen

`list_metrics`

`get_prices`

`get_holder_supply`

`get_holder_valuation`

`get_holder_profit`

`get_cohort_metrics`

`get_utxo_history`

`get_latest_metrics`

`search_metrics`

`get_metric`

`get_categories`

`get_coindays`

`get_etf_data`

`get_blockchain`

`get_dat_aggregate`

`get_dat_registry`

`get_dat_entity`

`get_cycle_boundaries`

`render_chart`

Anwendungsfälle mit Beispiel-Prompts

Marktbewertungsanalyse

HODL-Waves-Recherche

Wöchentlicher On-Chain-Bericht

Identifizierung der Zyklusphase

Kapitulationserkennung

Zugriffsstufen

Holen Sie sich Ihren API-Schlüssel

Ressourcen