Yapay Zeka Ajanları için MCP Sunucusu

Blocklens, yapay zeka ajanlarının konuşma sırasında on-chain analitiği doğrudan sorgulamasını sağlayan bir MCP sunucusu sunar. API yanıtlarını kopyalayıp yapıştırmak yerine, ajanınız mevcut araçları keşfeder ve onları otonom biçimde çağırır.

MCP nedir?

Model Context Protocol (MCP), yapay zeka uygulamalarının harici veri kaynaklarına ve araçlara nasıl bağlanacağını tanımlayan, Anthropic tarafından oluşturulmuş açık bir standarttır. Bunu evrensel bir adaptör gibi düşünün — MCP uyumlu herhangi bir ajan (Claude, Cursor, Windsurf vb.) özel entegrasyon kodu olmadan herhangi bir MCP sunucusuna bağlanabilir.

MCP ile ajan yalnızca veriyi okumakla kalmaz — hangi araçların mevcut olduğunu keşfedebilir, parametrelerini anlayabilir ve onları doğru argümanlarla çağırabilir. Bu, etkileşimleri API çağrılarını elle hazırlamaktan çok daha doğal hâle getirir.

Uzaktan Erişim (Kurulum Gerektirmez)

Bağlanmanın en hızlı yolu, barındırdığımız MCP uç noktası üzerindendir — kurulacak paket, yerel kurulum yok.

Claude.ai

Ayarlar → Bağlayıcılar bölümüne gidin
Yeni bir bağlayıcı eklemek için + öğesine tıklayın
URL'yi yapıştırın: https://mcp.blocklens.co
Client ID ve Client Secret alanlarını boş bırakın → Ekle'ye tıklayın
İstendiğinde API anahtarınızla yetkilendirin

Claude Desktop

Bunu claude_desktop_config.json dosyanıza ekleyin:

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

ChatGPT

Geliştirici Modu'nu etkinleştirin: Ayarlar → Genel → Geliştirici Modu
Ayarlar → Geliştirici → MCP Sunucuları bölümüne gidin
Sunucu Ekle'ye tıklayın, "Blocklens" adını ve URL'yi girin: https://mcp.blocklens.co
İstendiğinde API anahtarınızla yetkilendirin

Cursor / Windsurf

Ayarlar → MCP Sunucuları bölümünü açın
Şu URL ile bir uzak sunucu ekleyin: https://mcp.blocklens.co
İstendiğinde API anahtarınızla yetkilendirin

Cursor için ayrıca .cursor/mcp.json dosyasına da ekleyebilirsiniz:

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

Herhangi Bir MCP HTTP İstemcisi

Streamable HTTP taşımasını kullanarak https://mcp.blocklens.co adresine POST yapın. Sunucu, MCP protokolünün tamamını destekler — araç keşfi, çağırma ve akışlı yanıtlar.

Kurulum gerekmez

Uzak uç nokta, npm paketiyle aynı 19 aracı sağlar. Tarayıcıda çalışır, hiçbir yerel bağımlılık gerektirmez ve demo modunu hazır olarak destekler.

Kimlik Doğrulama

MCP sunucusu iki erişim modunu destekler:

Ücretsiz Erişim (API Anahtarı Yok)

Ücretsiz katman metriklerine erişmek için kimlik bilgisi olmadan bağlanın: fiyatlar, holder arzı, değerleme, ETF toplamı, coindays ve blockchain verisi. 60 güne kadar geçmiş.

Tam Erişim (API Anahtarı ile)

Pro ve Enterprise katmanları dâhil tüm metriklerin kilidini açın. İlk bağlandığınızda, API anahtarınızı gireceğiniz bir Blocklens yetkilendirme sayfası belirir. Bu, güvenli bir OAuth akışı kullanır — Client ID veya Secret gerekmez.

API anahtarınızı blocklens.co/api-mcp adresinden alın.

Neden Blocklens + MCP?

Blocklens, on-chain analitik için yerel MCP desteği sağlayarak yapay zeka ajanlarının metrikleri özel entegrasyon olmadan doğrudan sorgulamasına olanak tanır.

Bunun pratikteki anlamı:

Gerçek zamanlı on-chain sorgular — Yapay zeka ajanınıza "Bitcoin şu anda aşırı değerli mi?" diye sorun; MVRV, realized cap ve daha fazlasını kontrol etmek için get_holder_valuation çağrısını yapacaktır
Elle API işi yok — Ajan araçları otomatik olarak keşfeder ve yanıtları sizin için biçimlendirir
Konuşma hızında araştırma — Birden fazla sorguyu birbirine bağlayın: fiyatı kontrol edin, ardından arzı, ardından kârlılığı, hepsini tek bir konuşmada
Otomatik raporlama — Ajanınızın canlı verilerle haftalık on-chain sağlık raporları üretmesini sağlayın

Yerel Kurulum (Alternatif)

En basit kurulum için Uzaktan Erişim bölümüne bakın — paket veya yerel yapılandırma gerekmez.

Kurulum

npm install -g blocklens-mcp-server

Claude Desktop

Bunu Claude Desktop yapılandırma dosyanıza (claude_desktop_config.json) ekleyin:

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

Yapılandırma dosyası konumu:

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

Kaydettikten sonra Claude Desktop'ı yeniden başlatın. Mevcut MCP araçları altında "blocklens" girişini görmelisiniz.

Cursor / Windsurf

MCP ayarlarınıza (.cursor/mcp.json veya eşdeğeri) ekleyin:

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

Demo Modu (API Anahtarı Yok)

MCP sunucusunu API anahtarı olmadan deneyebilirsiniz. Demo modunda:

Çalışır: list_metrics, search_metrics, get_metric, get_categories ve temel (grade 0) metrikler için 60 güne kadar geçmişe sahip veri uç noktaları
API anahtarı gerektirir: Kâr metrikleri (SOPR, realized P/L), genişletilmiş geçmiş, enterprise katmanı metrikleri

Demo modunda çalıştırmak için yapılandırmanızdan BLOCKLENS_API_KEY'i çıkarmanız yeterlidir:

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

Mevcut Araçlar

MCP sunucusu, Blocklens analitik paketinin tamamını kapsayan 19 araç sunar: piyasa verisi, holder arzı, değerleme, kârlılık, yaş kohortları, UTXO geçmişi, coin days, ETF analitiği, blockchain istatistikleri, döngü sınırları ve grafik oluşturma. Birleşik bir TypeScript kod tabanı üzerine inşa edilmiştir.

Katman Gereksinimleri

Katman	Araçlar
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`
Metriğe bağlı	`render_chart` — ücretsiz metrikler anahtar olmadan oluşturulur; Pro/Enterprise metrikleri ilgili katmanı gerektirir

`list_metrics`

Free

Mevcut tüm on-chain metrikleri açıklamaları, kategorileri ve katman gereksinimleriyle birlikte listeler.

Parametreler: Yok

Kullanım senaryosu: Hangi verilerin mevcut olduğunu keşfetmek için buradan başlayın. Diğer araçlar için ihtiyaç duyacağınız metrik kimlikleriyle birlikte tam kataloğu döndürür.

Örnek yanıt (kısaltılmış):

[
  {
    "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"
      }
    }
  }
]

Parametreli metrikler

Bazı metrikler ek parametreler gerektirir (ör. exchange, ticker, id). Varsayılan değerler için params alanına, parametre açıklamaları ve mevcut değer uç noktaları için params_schema alanına bakın.

`get_prices`

Free

Günlük OHLC fiyatlarını (USD cinsinden açılış/yüksek/düşük/kapanış), piyasa değerini ve 24 saatlik işlem hacmini alın.

Parametre	Tür	Varsayılan	Açıklama
`symbol`	string	`"BTC"`	Kripto para sembolü
`days`	integer	`30`	Günlük veri noktası sayısı (1–10.000)
`start_date`	string	—	Başlangıç tarihi (`YYYY-MM-DD`). `days`'i geçersiz kılar.
`end_date`	string	—	Bitiş tarihi (`YYYY-MM-DD`). Varsayılan olarak bugündür.

Kullanım senaryosu: Herhangi bir analiz için fiyat bağlamı. Mevcut fiyatın on-chain temellerle gerekçelendirilip gerekçelendirilmediğini değerlendirmek için değerleme metrikleriyle eşleştirin.

`get_holder_supply`

Free

LTH/STH arz dağılımını alın: Uzun Vadeli Holder arzı (>155 gün tutulan), Kısa Vadeli Holder arzı (<155 gün tutulan) ve toplam dolaşımdaki arz. Tüm değerler BTC cinsindendir.

Parametre	Tür	Varsayılan	Açıklama
`days`	integer	`30`	Günlük veri noktası sayısı (1–10.000)
`start_date`	string	—	Başlangıç tarihi (`YYYY-MM-DD`)
`end_date`	string	—	Bitiş tarihi (`YYYY-MM-DD`)

Kullanım senaryosu: Birikim ve dağıtımı izleyin. Artan LTH arzı = inanç / birikim. Artan STH arzı = yeni para girişi / önümüzdeki olası dağıtım.

`get_holder_valuation`

Free

Bitcoin değerleme metriklerini alın: Realized Cap, Realized Price, LTH/STH Realized Cap ve Price, MVRV oranı ve Gerçekleşmemiş K/Z.

Parametre	Tür	Varsayılan	Açıklama
`days`	integer	`30`	Günlük veri noktası sayısı (1–10.000)
`start_date`	string	—	Başlangıç tarihi (`YYYY-MM-DD`)
`end_date`	string	—	Bitiş tarihi (`YYYY-MM-DD`)

Kullanım senaryosu: Temel değerleme çerçevesi. MVRV > 3,5 tarihsel olarak aşırı ısınmaya işaret eder; MVRV < 1 düşük değerlemeye işaret eder. Piyasa yapısını ölçmek için LTH ve STH realized fiyatlarını karşılaştırın.

`get_holder_profit`

Pro

Bitcoin kârlılık metriklerini alın: LTH/STH Realized P/L (USD) ve SOPR (Spent Output Profit Ratio). Pro katmanı API anahtarı gerektirir.

Parametre	Tür	Varsayılan	Açıklama
`days`	integer	`30`	Günlük veri noktası sayısı (1–10.000)
`start_date`	string	—	Başlangıç tarihi (`YYYY-MM-DD`)
`end_date`	string	—	Bitiş tarihi (`YYYY-MM-DD`)

Kullanım senaryosu: Coinlerin kârla mı yoksa zararla mı hareket ettiğini anlayın. SOPR > 1, holder'ların kârla sattığı anlamına gelir; SOPR < 1, zararla satış yapıldığı anlamına gelir (genellikle teslimiyete ya da dip oluşumuna işaret eder).

`get_cohort_metrics`

Pro

Yaş kohortu metriklerini alın: belirli bir UTXO yaş aralığı için arz (BTC), realized cap (USD) ve realized price (USD). HODL Waves analizi için kullanılır.

Parametre	Tür	Varsayılan	Açıklama
`cohort`	enum	gerekli	Yaş aralığı (aşağıya bakın)
`days`	integer	`30`	Günlük veri noktası sayısı (1–10.000)
`start_date`	string	—	Başlangıç tarihi (`YYYY-MM-DD`)
`end_date`	string	—	Bitiş tarihi (`YYYY-MM-DD`)

Geçerli kohortlar: 24h, 1d_1w, 1w_1m, 1m_3m, 3m_6m, 6m_12m, 1y_2y, 2y_3y, 3y_5y, 5y_7y, 7y_10y, 10y_plus

Kullanım senaryosu: Belirli yaş gruplarına derinlemesine inin. Örneğin, 3m_6m kohortunun büyüyüp büyümediğini (olgunlaşan yeni birikim) veya 10y_plus coinlerinin nihayet hareket edip etmediğini (uzun süredir uykuda olan arzın uyanması) kontrol edin.

`get_utxo_history`

Pro

UTXO setinin yaş kohortuna göre dağılımını alın. Belirli bir tarihte her kohort için token miktarlarını (BTC) ve USD değerlerini gösterir.

Parametre	Tür	Varsayılan	Açıklama
`date_processed`	string	—	Belirli anlık görüntü tarihi (`YYYY-MM-DD`)
`cohort_start`	string	—	Kohort tarih aralığının başlangıcı
`cohort_end`	string	—	Kohort tarih aralığının bitişi
`days`	integer	`1000`	Kayıt sayısı (1–50.000)

Kullanım senaryosu: Coin uykusunu ve birikim örüntülerini analiz edin. Uykudaki arz hareket ettiğinde, bu genellikle önemli fiyat hareketlerinin habercisidir.

`get_latest_metrics`

Free

Tüm metrik kategorilerinde (fiyat, arz, değerleme, kâr) en güncel anlık görüntüyü tek bir çağrıda alın.

Parametreler: Yok

Kullanım senaryosu: Hızlı piyasa görünümü. Tek bir çağrı, tüm temel metriklerin mevcut durumunu verir — günlük kontroller veya daha derin bir analize başlamak için idealdir.

`search_metrics`

Free

Mevcut metrikleri adlar, açıklamalar ve kimlikler üzerinden anahtar kelimeyle arayın.

Parametre	Tür	Varsayılan	Açıklama
`query`	string	gerekli	Arama terimi (ör. `"realized price"`, `"MVRV"`, `"supply"`)

Kullanım senaryosu: Kabaca ne aradığınızı bildiğiniz ancak tam kimliği bilmediğiniz durumlarda doğru metriği bulun. Eşleşen metrikleri uç noktaları ve katman gereksinimleriyle birlikte döndürür.

`get_metric`

Free

Tek bir metriğin kimliğine göre tam tanımını alın; ad, açıklama, kategori, uç nokta, birim ve erişim katmanı dâhil.

Parametre	Tür	Varsayılan	Açıklama
`metric_id`	string	gerekli	Metrik tanımlayıcısı (ör. `"lth_supply"`, `"price"`, `"sth_sopr"`)

Kullanım senaryosu: Veriyi çekmeden önce bir metriğin tam olarak ne ölçtüğünü, nasıl hesaplandığını ve hangi katmanın gerektiğini öğrenin. Metrik ek parametreler gerektirdiğinde (ör. exchange, ticker, id), yanıt params ve params_schema içerir.

`get_categories`

Free

Tüm metrik kategorilerini, sayılarıyla ve her kategorideki metrik kimlikleriyle birlikte listeler.

Parametreler: Yok

Kullanım senaryosu: Temaya göre (fiyat, arz, değerleme, kâr) düzenlenmiş, mevcut verilerin yapılandırılmış bir görünümünü elde edin.

`get_coindays`

Free

Coin Days metriklerini alın: Coin Days Destroyed (CDD), liveliness, vaultedness ve dormancy. Bu metrikler, coinlerin harcanmadan önce ne kadar süre tutulduğunu ölçerek inanç ve aktivite örüntülerini ortaya koyar.

Parametre	Tür	Varsayılan	Açıklama
`days`	integer	`30`	Günlük veri noktası sayısı (1–10.000)
`start_date`	string	—	Başlangıç tarihi (`YYYY-MM-DD`)
`end_date`	string	—	Bitiş tarihi (`YYYY-MM-DD`)

Kullanım senaryosu: Uzun süredir uykuda olan coinlerin ne zaman hareket etmeye başladığını saptayın. Yüksek CDD sıçramaları genellikle büyük fiyat hareketlerinin habercisidir. Artan liveliness = eski coinlerin harcanması; artan vaultedness = coinlerin uzun vadeli saklanmak üzere kilitlenmesi.

`get_etf_data`

Free

Bitcoin ETF toplam verilerini alın: toplam holdingler (BTC), AUM (USD), günlük net akışlar, kümülatif akışlar, ETF baskınlığı ve ETF realized price.

Parametre	Tür	Varsayılan	Açıklama
`days`	integer	`30`	Günlük veri noktası sayısı (1–10.000)
`start_date`	string	—	Başlangıç tarihi (`YYYY-MM-DD`)
`end_date`	string	—	Bitiş tarihi (`YYYY-MM-DD`)

Kullanım senaryosu: ETF akışları üzerinden kurumsal talebi izleyin. Artan AUM ve pozitif net akışlar kurumsal birikime işaret eder. ETF holder'larının kârda olup olmadığını ölçmek için ETF realized price'ı spot fiyatla karşılaştırın.

`get_blockchain`

Free

Blockchain metriklerini alın: blok yüksekliği veya günlük çıkarılan blok sayısı.

Parametre	Tür	Varsayılan	Açıklama
`metric`	enum	gerekli	`"block_height"` veya `"blocks_mined"`
`days`	integer	`30`	Günlük veri noktası sayısı (1–10.000)
`start_date`	string	—	Başlangıç tarihi (`YYYY-MM-DD`)
`end_date`	string	—	Bitiş tarihi (`YYYY-MM-DD`)

Kullanım senaryosu: Ağ sağlığını ve madencilik aktivitesini izleyin. Günlük çıkarılan blok sayısının ~144'ten sapması, hashrate değişikliklerine veya zorluk ayarlamalarına işaret edebilir.

`get_dat_aggregate`

Free

Digital Asset Treasuries toplam verilerini alın: kurumlar ve hükümetler tarafından tutulan toplam BTC, şirket sayısı, net akışlar, kamu/özel/hükümet dağılımı.

Parametre	Tür	Varsayılan	Açıklama
`days`	integer	`30`	Günlük veri noktası sayısı (1–10.000)
`start_date`	string	—	Başlangıç tarihi (`YYYY-MM-DD`)
`end_date`	string	—	Bitiş tarihi (`YYYY-MM-DD`)

Kullanım senaryosu: Kurumsal Bitcoin benimsenmesini izleyin. Kurumsal ve devlet hazinelerindeki artan toplam BTC, büyüyen kurumsal inanca işaret eder.

Varlık türüne göre (hükümet, kamu, özel) realized price (BTC başına maliyet temeli) için, dat_rp_total, dat_rp_public, dat_rp_government, dat_rp_private metrikleriyle veya dat-realized-price-by-type şablonuyla render_chart kullanın.

`get_dat_registry`

Free

İzlenen tüm Digital Asset Treasury varlıklarını (şirketler, fonlar, hükümetler) ad, ticker, varlık türü ve ülke dâhil meta verilerle listeler.

Parametreler: Yok

Kullanım senaryosu: Hangi varlıkların Bitcoin tuttuğunu keşfedin. Varlık başına veriyi get_dat_entity ile sorgulamak için döndürülen id alanını kullanın.

`get_dat_entity`

Pro

Varlık başına Digital Asset Treasury verilerini alın: BTC holdingleri, AUM, net akış, kümülatif akış, pazar payı, realized price (BTC başına ortalama maliyet) ve toplam maliyet temeli.

Parametre	Tür	Varsayılan	Açıklama
`id`	integer	gerekli	Varlık/şirket kimliği (`get_dat_registry`'den)
`days`	integer	`365`	Günlük veri noktası sayısı (1–10.000)
`start_date`	string	—	Başlangıç tarihi (`YYYY-MM-DD`)
`end_date`	string	—	Bitiş tarihi (`YYYY-MM-DD`)

Kullanım senaryosu: Belirli bir varlığın Bitcoin stratejisini analiz edin — holding büyümesini izleyin, gerçekleşmemiş K/Z için realized price'ı piyasa fiyatıyla karşılaştırın, birikim örüntülerini takip edin.

Örnek: get_dat_entity({ id: 1 }), 762 bin BTC holdingi ve 75.694 $ realized price dâhil Strategy (eski adıyla MicroStrategy) verilerini döndürür.

`get_cycle_boundaries`

Free

Bitcoin halving döngüsü sınırlarını alın: her halving dönemi için başlangıç tarihi, bitiş tarihi, gün cinsinden süre ve döngü numarası.

Parametreler: Yok

Kullanım senaryosu: Karşılaştırmalı analiz için döngü fazlarını belirleyin. Tüm döngülerin Gün 0'da başladığı döngü performansı grafiklerini üst üste bindirmek için render_chart ve x_axis: "day_offset" ile kullanın.

Örnek yanıt (kısaltılmış):

[
  { "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`

Metriğe bağlı

Bir Bitcoin on-chain analitik grafiğini PNG görseli veya SVG vektör grafiği olarak oluşturun. Görseli konuşma içinde satır içi döndürür. Tek metrikleri, birden çok metriği, şablonları ve tam özelleştirmeyi destekler.

Parametre	Tür	Varsayılan	Açıklama
`metric`	string	—	Tek metrik kimliği (ör. `"price"`, `"lth_supply"`)
`metrics`	array	—	Dizgi veya yapılandırma nesneleri olarak birden çok metrik
`template`	string	—	Grafik şablonu (ör. `"mvrv_ratio"`, `"holder_supply"`)
`days`	integer	`365`	Geçmiş gün sayısı (7–3.650)
`start_date`	string	—	Başlangıç tarihi (`YYYY-MM-DD`)
`end_date`	string	—	Bitiş tarihi (`YYYY-MM-DD`)
`overlay`	`"price"`	—	BTC fiyat katmanı ekle
`theme`	`"light"` / `"dark"`	`"light"`	Renk teması
`width`	integer	`1200`	Piksel cinsinden görsel genişliği
`height`	integer	`600`	Piksel cinsinden görsel yüksekliği
`title`	string	otomatik	Grafik başlığı
`style`	`"line"` / `"area"` / `"bar"`	otomatik	Varsayılan grafik stili
`scale`	`"linear"` / `"log"`	`"linear"`	Y ekseni ölçeği
`y_axes`	array	—	Dikey bölgeler içeren özel Y eksenleri. Her nesne: `{ id, side, scale?, format?, range?, domain_min?, domain_max?, no_padding? }`. Bkz. Snapshot API — Özel Y Eksenleri.
`x_axis`	`"date"` / `"day_offset"`	`"date"`	X ekseni modu. Döngü performansı katmanları için `"day_offset"` kullanın. Tüm `metrics`'in aynı `cycle_ath_`, `cycle_low_` veya `cycle_halving_*` ailesinden olmasını gerektirir.
`heatmap_id`	`"cost-basis-distribution"`	—	Çizgi grafiği yerine bir heatmap oluştur. `metric` / `metrics` / `template` ile karşılıklı olarak dışlayıcıdır. Bkz. Heatmap Oluşturma.
`heatmap_period`	`"3m"` / `"6m"` / `"1y"` / `"2y"` / `"3y"` / `"5y"` / `"all"`	`"1y"`	Heatmap gruplama için zaman penceresi.
`heatmap_color_scale`	`"viridis"` / `"plasma"` / `"inferno"` / `"magma"` / `"cividis"`	`"viridis"`	Heatmap hücreleri için renk paleti.
`heatmap_y_scale`	`"linear"` / `"log"`	`"linear"`	Heatmap fiyat aralıkları için Y ekseni ölçeği.
`params`	object	—	Parametreli metrikler için çağrı başına parametreler (ör. `{ exchange: "binance" }`, `{ ticker: "IBIT" }`). Metriğin `params_schema`'sı zorunlu bir alan tanımladığında gereklidir.
`format`	`"png"` / `"svg"` / `"json"`	`"png"`	Çıktı biçimi. `"png"` bir raster görsel döndürür, `"svg"` ölçeklenebilir bir vektör grafiği döndürür (sunum slaytlarına veya basılı belgelere gömmek için idealdir), `"json"` yalnızca grafik meta verilerini döndürür (oluşturma yok).

Kullanım senaryosu: Herhangi bir metriği doğrudan konuşma içinde görselleştirin. Ajan, satır içinde görünen bir grafik görseli döndürür — tarayıcı veya dashboard açmaya gerek yoktur.

Örnek çağrılar:

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

Bazı metrikler parametre gerektirir (exchange veya ticker gibi). metrics dizisini yapılandırma nesneleriyle kullanırken, metrik tanımından params'ı dâhil edin.

Grafik oluşturma seçeneklerinin tam belgeleri için Snapshot API bölümüne bakın.

Örnek İstemlerle Kullanım Senaryoları

Blocklens MCP sunucusu bağlandıktan sonra yapay zeka ajanınıza verebileceğiniz somut istemler aşağıdadır.

Piyasa Değerleme Analizi

"Bitcoin şu anda aşırı değerli mi? MVRV oranını kontrol et ve LTH ile STH realized fiyatlarını mevcut spot fiyatla karşılaştır."

Ajan, get_holder_valuation ve get_prices çağrılarını yapacak, ardından mevcut piyasa değerinin toplam maliyet temelinin üzerinde mi yoksa altında mı olduğunu değerlendirmek için verileri sentezleyecektir.

HODL Waves Araştırması

"Yaş kohortları arasındaki arz dağılımının geçen yıl boyunca nasıl değiştiğini göster. Uzun vadeli holder'lar birikim mi yapıyor yoksa dağıtım mı?"

Ajan, days: 365 ile birden çok kohort için get_cohort_metrics çağrılarını yapacak, ardından birikim ve dağıtım örüntülerini belirlemek için her yaş aralığındaki eğilimleri analiz edecektir.

Haftalık On-Chain Rapor

"Fiyat hareketini, arz dinamiklerini, holder kârlılığını ve MVRV'yi kapsayan haftalık bir Bitcoin on-chain sağlık raporu oluştur."

Ajan, bir anlık görüntü için get_latest_metrics çağrısını yapacak, ardından 7 günlük eğilimler için get_prices, get_holder_supply, get_holder_valuation ve get_holder_profit'e inerek yapılandırılmış bir özet üretecektir.

Döngü Fazı Belirleme

"Realized cap eğilimi mevcut piyasa fazı hakkında ne söylüyor? Realized cap büyüme oranını önceki aylarla karşılaştır."

Ajan, daha uzun bir zaman penceresiyle get_holder_valuation çağrısını yapacak ve birikim, yükseliş, dağıtım veya düşüş aşamasında olup olmadığımızı belirlemek için realized cap yörüngesini analiz edecektir.

Teslimiyet Tespiti

"Son 30 günde STH SOPR'nin 1'in altına düşüp düşmediğini kontrol et — bu, kısa vadeli holder'ların zararla sattığını gösterir."

Ajan, days: 30 ile get_holder_profit çağrısını yapacak ve teslimiyet olaylarını işaretlemek için STH SOPR değerlerini inceleyecektir.

Erişim Katmanları

Katman	MCP Erişimi	Geçmiş	Metrikler	Günlük İstek
Demo (anahtar yok)	Evet	60 gün	Temel (grade 0)	Sınırsız
Pro (50 $/ay)	Evet	Sınırsız	Tümü (grade 0–1)	10.000
Enterprise (900 $/ay)	Evet	Sınırsız	Tümü (grade 0–2)	100.000

MCP sunucusu tüm katmanlarla çalışır. Demo modu, abone olmadan önce araçları keşfetmenin harika bir yoludur. Tam erişimin kilidini açmak için bir API anahtarı edinin.

API Anahtarınızı Edinin

Bir API anahtarı oluşturmak ve abonelik katmanınız ile kullanımınızı görüntülemek için blocklens.co/api-mcp adresini ziyaret edin.

Kaynaklar

Uzak MCP uç noktası: mcp.blocklens.co
npm paketi: blocklens-mcp-server
Kaynak kodu: GitHub
llms.txt: docs.blocklens.co/llms.txt
AI eklenti manifesti: docs.blocklens.co/.well-known/ai-plugin.json
Snapshot API belgeleri: Chart Snapshot API
API referansı: Etkileşimli API belgeleri
API anahtarı edinin: blocklens.co/api-mcp
MCP protokolü: modelcontextprotocol.io

MCP nedir?​

Uzaktan Erişim (Kurulum Gerektirmez)​

Claude.ai​

Claude Desktop​

ChatGPT​

Cursor / Windsurf​

Herhangi Bir MCP HTTP İstemcisi​

Kimlik Doğrulama​

Ücretsiz Erişim (API Anahtarı Yok)​

Tam Erişim (API Anahtarı ile)​

Neden Blocklens + MCP?​

Yerel Kurulum (Alternatif)​

Kurulum​

Claude Desktop​

Cursor / Windsurf​

Demo Modu (API Anahtarı Yok)​

Mevcut Araçlar​

Katman Gereksinimleri​

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​

Örnek İstemlerle Kullanım Senaryoları​

Piyasa Değerleme Analizi​

HODL Waves Araştırması​

Haftalık On-Chain Rapor​

Döngü Fazı Belirleme​

Teslimiyet Tespiti​

Erişim Katmanları​

API Anahtarınızı Edinin​

Kaynaklar​

MCP nedir?

Uzaktan Erişim (Kurulum Gerektirmez)

Claude.ai

Claude Desktop

ChatGPT

Cursor / Windsurf

Herhangi Bir MCP HTTP İstemcisi

Kimlik Doğrulama

Ücretsiz Erişim (API Anahtarı Yok)

Tam Erişim (API Anahtarı ile)

Neden Blocklens + MCP?

Yerel Kurulum (Alternatif)

Kurulum

Claude Desktop

Cursor / Windsurf

Demo Modu (API Anahtarı Yok)

Mevcut Araçlar

Katman Gereksinimleri

`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`

Örnek İstemlerle Kullanım Senaryoları

Piyasa Değerleme Analizi

HODL Waves Araştırması

Haftalık On-Chain Rapor

Döngü Fazı Belirleme

Teslimiyet Tespiti

Erişim Katmanları

API Anahtarınızı Edinin

Kaynaklar