メインコンテンツまでスキップ

AI エージェント向け MCP サーバー

Blocklens は、AI エージェントが会話中に直接オンチェーン分析を照会できる MCP サーバー を提供しています。API レスポンスをコピー&ペーストする代わりに、エージェントが利用可能なツールを自動的に検出し、自律的に呼び出します。

MCP とは?

Model Context Protocol(MCP)は、Anthropic が策定したオープン標準で、AI アプリケーションが外部のデータソースやツールに接続する方法を定義します。汎用アダプターのようなものだと考えてください。MCP 対応のエージェント(Claude、Cursor、Windsurf など)であれば、カスタムの統合コードなしに任意の MCP サーバーへ接続できます。

MCP を使うと、エージェントは単にデータを読むだけでなく、どのツールが利用可能かを検出し、そのパラメータを理解して、適切な引数で呼び出すことができます。これにより、手動で API 呼び出しを組み立てるよりもはるかに自然なやり取りが実現します。

リモートアクセス(インストール不要)

最も手軽に接続する方法は、ホスト型の MCP エンドポイントを利用することです。インストールするパッケージも、ローカルのセットアップも必要ありません。

Claude.ai

  1. 設定 → コネクタ に移動します
  2. + をクリックして新しいコネクタを追加します
  3. URL を貼り付けます: https://mcp.blocklens.co
  4. Client ID と Client Secret は 空欄のまま にして 追加 をクリックします
  5. プロンプトが表示されたら、API キーで認証します

Claude Desktop

claude_desktop_config.json に次の内容を追加します:

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

ChatGPT

  1. デベロッパーモード を有効にします: 設定 → 一般 → デベロッパーモード
  2. 設定 → デベロッパー → MCP サーバー に移動します
  3. サーバーを追加 をクリックし、名前に「Blocklens」、URL に https://mcp.blocklens.co を入力します
  4. プロンプトが表示されたら、API キーで認証します

Cursor / Windsurf

  1. 設定 → MCP サーバー を開きます
  2. URL https://mcp.blocklens.co でリモートサーバーを追加します
  3. プロンプトが表示されたら、API キーで認証します

Cursor の場合は、.cursor/mcp.json に追加することもできます:

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

任意の MCP HTTP クライアント

Streamable HTTP トランスポートを使って https://mcp.blocklens.co に POST します。サーバーは MCP プロトコルの全機能(ツールの検出、呼び出し、ストリーミングレスポンス)をサポートしています。

インストール不要

リモートエンドポイントは npm パッケージと同じ 19 個のツールを提供します。ブラウザ上で動作し、ローカルの依存関係を必要とせず、デモモードにそのまま対応しています。

認証

MCP サーバーは 2 つのアクセスモードをサポートしています:

無料アクセス(API キー不要)

認証情報なしで接続し、無料ティアのメトリクスにアクセスできます: 価格、ホルダー供給量、バリュエーション、ETF 集計、コインデイズ、ブロックチェーンデータ。履歴は最大 60 日分です。

フルアクセス(API キーあり)

Pro および Enterprise ティアを含むすべてのメトリクスのロックを解除します。初回接続時に Blocklens の認証ページが表示されるので、そこで API キーを入力します。これはセキュアな OAuth フローを使用しており、Client ID や Secret は不要です。

API キーは blocklens.co/api-mcp で取得できます。

なぜ Blocklens + MCP なのか?

Blocklens はオンチェーン分析向けに ネイティブな MCP サポート を提供しており、AI エージェントがカスタム統合なしに直接メトリクスを照会できます。

これが実際にどう役立つかというと:

  • リアルタイムのオンチェーン照会 — AI エージェントに「今ビットコインは割高ですか?」と尋ねると、get_holder_valuation を呼び出して MVRV、実現キャップ(Realized Cap)などを確認します
  • 手動の API 作業が不要 — エージェントがツールを自動的に検出し、レスポンスを整形してくれます
  • 会話の速度でリサーチ — 複数の照会を連鎖させて、価格を確認し、次に供給量、さらに収益性まで、すべて 1 つの会話で行えます
  • レポートの自動化 — ライブデータを使った週次のオンチェーン健全性レポートを、エージェントに自動で作成させることができます

ローカルインストール(代替手段)

最もシンプルなセットアップについては リモートアクセス を参照してください。パッケージもローカル設定も不要です。

インストール

npm install -g blocklens-mcp-server

Claude Desktop

Claude Desktop の設定ファイル(claude_desktop_config.json)に次の内容を追加します:

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

設定ファイルの場所:

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

保存後、Claude Desktop を再起動します。利用可能な MCP ツールの一覧に「blocklens」が表示されるはずです。

Cursor / Windsurf

MCP 設定(.cursor/mcp.json またはそれに相当するもの)に追加します:

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

デモモード(API キー不要)

API キーなしでも MCP サーバーを試すことができます。デモモードでは:

  • 利用可能: list_metricssearch_metricsget_metricget_categories、および基本(グレード 0)メトリクスについて最大 60 日分の履歴を持つデータエンドポイント
  • API キーが必要: 利益メトリクス(SOPR、実現損益)、拡張履歴、Enterprise ティアのメトリクス

デモモードで実行するには、設定から BLOCKLENS_API_KEY を省略するだけです:

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

利用可能なツール

MCP サーバーは、Blocklens の分析スイート全体をカバーする 19 個のツールを公開しています: 市場データ、ホルダー供給量、バリュエーション、収益性、年齢コホート、UTXO 履歴、コインデイズ、ETF 分析、ブロックチェーン統計、サイクル境界、チャート描画。統一された TypeScript コードベース上に構築されています。

ティア要件

ティアツール
無料list_metricssearch_metricsget_metricget_categoriesget_latest_metricsget_pricesget_holder_supplyget_holder_valuationget_etf_dataget_coindaysget_blockchainget_cycle_boundaries
Proget_holder_profitget_cohort_metricsget_utxo_history
Proget_dat_entity
メトリクスに依存render_chart — 無料メトリクスはキーなしで描画されます。Pro/Enterprise メトリクスには対応するティアが必要です

list_metrics

無料

利用可能なすべてのオンチェーンメトリクスを、説明、カテゴリ、ティア要件とともに一覧表示します。

パラメータ: なし

ユースケース: まずここから、どのデータが利用可能かを確認します。他のツールで必要となるメトリクス ID を含む完全なカタログを返します。

レスポンス例(抜粋):

[
{
"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"
}
}
}
]
パラメータ付きメトリクス

一部のメトリクスには追加のパラメータ(例: exchangetickerid)が必要です。デフォルト値については params フィールドを、パラメータの説明や利用可能な値のエンドポイントについては params_schema を確認してください。


get_prices

無料

日次の OHLC 価格(始値/高値/安値/終値、USD 建て)、時価総額、24 時間取引高を取得します。

パラメータデフォルト説明
symbolstring"BTC"暗号資産のシンボル
daysinteger30日次データポイントの数(1〜10,000)
start_datestring開始日(YYYY-MM-DD)。days を上書きします。
end_datestring終了日(YYYY-MM-DD)。デフォルトは当日です。

ユースケース: あらゆる分析の価格コンテキストとして使用します。バリュエーションメトリクスと組み合わせて、現在の価格がオンチェーンのファンダメンタルズに見合っているかを評価します。


get_holder_supply

無料

LTH/STH の供給量内訳を取得します: 長期ホルダー供給量(保有期間 >155 日)、短期ホルダー供給量(保有期間 <155 日)、および循環供給量の合計。すべての値は BTC 建てです。

パラメータデフォルト説明
daysinteger30日次データポイントの数(1〜10,000)
start_datestring開始日(YYYY-MM-DD
end_datestring終了日(YYYY-MM-DD

ユースケース: 蓄積(accumulation)と分配(distribution)を追跡します。LTH 供給量の増加 = 確信/蓄積。STH 供給量の増加 = 新規資金の流入/今後の分配の可能性。


get_holder_valuation

無料

ビットコインのバリュエーションメトリクスを取得します: 実現キャップ(Realized Cap)、実現価格(Realized Price)、LTH/STH の実現キャップと実現価格、MVRV 比率、未実現損益(Unrealized P/L)。

パラメータデフォルト説明
daysinteger30日次データポイントの数(1〜10,000)
start_datestring開始日(YYYY-MM-DD
end_datestring終了日(YYYY-MM-DD

ユースケース: 中核となるバリュエーションのフレームワークです。MVRV > 3.5 は歴史的に過熱を示し、MVRV < 1 は割安を示します。LTH と STH の実現価格を比較して市場構造を見極めます。


get_holder_profit

Pro

ビットコインの収益性メトリクスを取得します: LTH/STH の実現損益(USD)と SOPR(Spent Output Profit Ratio)。Pro ティアの API キーが必要です。

パラメータデフォルト説明
daysinteger30日次データポイントの数(1〜10,000)
start_datestring開始日(YYYY-MM-DD
end_datestring終了日(YYYY-MM-DD

ユースケース: コインが利益で動いているか損失で動いているかを把握します。SOPR > 1 はホルダーが利益で売却していることを意味し、SOPR < 1 は損失で売却していること(しばしば降伏(capitulation)や底値形成を示す)を意味します。


get_cohort_metrics

Pro

年齢コホートのメトリクスを取得します: 特定の UTXO 年齢帯における供給量(BTC)、実現キャップ(USD)、実現価格(USD)。HODL Waves 分析に使用します。

パラメータデフォルト説明
cohortenum必須年齢帯(下記参照)
daysinteger30日次データポイントの数(1〜10,000)
start_datestring開始日(YYYY-MM-DD
end_datestring終了日(YYYY-MM-DD

有効なコホート: 24h1d_1w1w_1m1m_3m3m_6m6m_12m1y_2y2y_3y3y_5y5y_7y7y_10y10y_plus

ユースケース: 特定の年齢グループを深掘りします。例えば、3m_6m コホートが成長しているか(新規蓄積の成熟)、あるいは 10y_plus のコインがついに動き始めているか(長期休眠していた供給の覚醒)を確認します。


get_utxo_history

Pro

年齢コホート別の UTXO セットの内訳を取得します。指定された日付における各コホートのトークン量(BTC)と USD 価値を表示します。

パラメータデフォルト説明
date_processedstring特定のスナップショット日(YYYY-MM-DD
cohort_startstringコホートの日付範囲の開始
cohort_endstringコホートの日付範囲の終了
daysinteger1000レコード数(1〜50,000)

ユースケース: コインの休眠と蓄積パターンを分析します。休眠していた供給が動くとき、それはしばしば大きな価格変動の前兆となります。


get_latest_metrics

無料

すべてのメトリクスカテゴリ(価格、供給量、バリュエーション、利益)にわたる最新のスナップショットを 1 回の呼び出しで取得します。

パラメータ: なし

ユースケース: 市場の概要を素早く把握します。1 回の呼び出しですべての主要メトリクスの現状が得られ、毎日のチェックインやより深い分析の出発点に最適です。


search_metrics

無料

名前、説明、ID 全体にわたって、キーワードで利用可能なメトリクスを検索します。

パラメータデフォルト説明
querystring必須検索語(例: "realized price""MVRV""supply"

ユースケース: 探しているものはおおよそ分かっているが正確な ID は分からないときに、適切なメトリクスを見つけます。一致したメトリクスを、エンドポイントとティア要件とともに返します。


get_metric

無料

単一のメトリクスの完全な定義を ID で取得します。名前、説明、カテゴリ、エンドポイント、単位、アクセスティアを含みます。

パラメータデフォルト説明
metric_idstring必須メトリクス識別子(例: "lth_supply""price""sth_sopr"

ユースケース: データを取得する前に、メトリクスが正確に何を測定し、どのように計算され、どのティアが必要かを調べます。メトリクスが追加のパラメータ(例: exchangetickerid)を必要とする場合、レスポンスには paramsparams_schema が含まれます。


get_categories

無料

すべてのメトリクスカテゴリを、件数と各カテゴリ内のメトリクス ID とともに一覧表示します。

パラメータ: なし

ユースケース: テーマ(価格、供給量、バリュエーション、利益)ごとに整理された利用可能なデータの構造化された概要を取得します。

get_coindays

無料

コインデイズのメトリクスを取得します: Coin Days Destroyed(CDD)、liveliness(活性度)、vaultedness(保管度)、dormancy(休眠度)。これらのメトリクスは、コインが使用される前にどれだけの期間保有されていたかを測定し、確信と活動のパターンを明らかにします。

パラメータデフォルト説明
daysinteger30日次データポイントの数(1〜10,000)
start_datestring開始日(YYYY-MM-DD
end_datestring終了日(YYYY-MM-DD

ユースケース: 長期休眠していたコインが動き始めるタイミングを検出します。CDD の大きなスパイクはしばしば主要な価格変動に先行します。liveliness の上昇 = 古いコインが使用されている。vaultedness の上昇 = コインが長期保有のためにロックされている。


get_etf_data

無料

ビットコイン ETF の集計データを取得します: 保有量合計(BTC)、AUM(USD)、日次純フロー、累積フロー、ETF ドミナンス、ETF 実現価格。

パラメータデフォルト説明
daysinteger30日次データポイントの数(1〜10,000)
start_datestring開始日(YYYY-MM-DD
end_datestring終了日(YYYY-MM-DD

ユースケース: ETF のフローを通じて機関投資家の需要を追跡します。AUM の増加と純フローのプラスは機関投資家による蓄積を示します。ETF 実現価格をスポット価格と比較して、ETF ホルダーが利益状態にあるかを見極めます。


get_blockchain

無料

ブロックチェーンのメトリクスを取得します: ブロック高、または 1 日あたりの採掘ブロック数。

パラメータデフォルト説明
metricenum必須"block_height" または "blocks_mined"
daysinteger30日次データポイントの数(1〜10,000)
start_datestring開始日(YYYY-MM-DD
end_datestring終了日(YYYY-MM-DD

ユースケース: ネットワークの健全性と採掘活動を監視します。1 日あたりの採掘ブロック数が約 144 から乖離する場合、ハッシュレートの変化や難易度調整を示している可能性があります。


get_dat_aggregate

無料

Digital Asset Treasuries(DAT)の集計データを取得します: 機関や政府が保有する BTC の合計、企業数、純フロー、公開企業/非公開企業/政府の内訳。

パラメータデフォルト説明
daysinteger30日次データポイントの数(1〜10,000)
start_datestring開始日(YYYY-MM-DD
end_datestring終了日(YYYY-MM-DD

ユースケース: 機関投資家によるビットコイン採用を追跡します。企業や国家のトレジャリー全体にわたる BTC 合計の増加は、機関投資家の確信の高まりを示します。

エンティティタイプ(政府、公開企業、非公開企業)別の実現価格(BTC あたりのコストベース)については、メトリクス dat_rp_totaldat_rp_publicdat_rp_governmentdat_rp_private、またはテンプレート dat-realized-price-by-type を指定して render_chart を使用してください。


get_dat_registry

無料

追跡対象のすべての Digital Asset Treasury エンティティ(企業、ファンド、政府)を、名前、ティッカー、エンティティタイプ、国などのメタデータとともに一覧表示します。

パラメータ: なし

ユースケース: どのエンティティがビットコインを保有しているかを確認します。返された id フィールドを使って、get_dat_entity でエンティティごとのデータを照会します。


get_dat_entity

Pro

エンティティごとの Digital Asset Treasury データを取得します: BTC 保有量、AUM、純フロー、累積フロー、市場シェア、実現価格(BTC あたりの平均コスト)、コストベース合計。

パラメータデフォルト説明
idinteger必須エンティティ/企業 ID(get_dat_registry から取得)
daysinteger365日次データポイントの数(1〜10,000)
start_datestring開始日(YYYY-MM-DD
end_datestring終了日(YYYY-MM-DD

ユースケース: 特定のエンティティのビットコイン戦略を分析します。保有量の伸びを追跡し、未実現損益のために実現価格を市場価格と比較し、蓄積パターンを監視します。

例: get_dat_entity({ id: 1 }) は、762K BTC の保有量と $75,694 の実現価格を含む Strategy(旧 MicroStrategy)のデータを返します。


get_cycle_boundaries

無料

ビットコインの半減期サイクルの境界を取得します: 各半減期エポックの開始日、終了日、日数での期間、サイクル番号。

パラメータ: なし

ユースケース: 比較分析のためにサイクルのフェーズを特定します。render_chartx_axis: "day_offset" を併用して、すべてのサイクルが Day 0 から始まるサイクルパフォーマンスチャートを重ね合わせます。

レスポンス例(抜粋):

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

メトリクスに依存

ビットコインのオンチェーン分析チャートを PNG 画像 または SVG ベクター画像 として描画します。画像を会話内にインラインで返します。単一メトリクス、複数メトリクス、テンプレート、フルカスタマイズに対応しています。

パラメータデフォルト説明
metricstring単一のメトリクス ID(例: "price""lth_supply"
metricsarray複数のメトリクス(文字列または設定オブジェクト)
templatestringチャートテンプレート(例: "mvrv_ratio""holder_supply"
daysinteger365履歴の日数(7〜3,650)
start_datestring開始日(YYYY-MM-DD
end_datestring終了日(YYYY-MM-DD
overlay"price"BTC 価格のオーバーレイを追加
theme"light" / "dark""light"カラーテーマ
widthinteger1200画像の幅(ピクセル)
heightinteger600画像の高さ(ピクセル)
titlestringautoチャートタイトル
style"line" / "area" / "bar"autoデフォルトのチャートスタイル
scale"linear" / "log""linear"Y 軸のスケール
y_axesarray垂直ゾーン付きのカスタム Y 軸。各オブジェクト: { id, side, scale?, format?, range?, domain_min?, domain_max?, no_padding? }Snapshot API — カスタム Y 軸 を参照。
x_axis"date" / "day_offset""date"X 軸モード。サイクルパフォーマンスのオーバーレイ には "day_offset" を使用します。すべての metrics が同一の cycle_ath_*cycle_low_*、または cycle_halving_* ファミリーである必要があります。
heatmap_id"cost-basis-distribution"折れ線チャートの代わりにヒートマップを描画します。metric / metrics / template とは排他的です。ヒートマップの描画 を参照。
heatmap_period"3m" / "6m" / "1y" / "2y" / "3y" / "5y" / "all""1y"ヒートマップのビニングの時間枠。
heatmap_color_scale"viridis" / "plasma" / "inferno" / "magma" / "cividis""viridis"ヒートマップセルのカラーパレット。
heatmap_y_scale"linear" / "log""linear"ヒートマップの価格ビンの Y 軸スケール。
paramsobjectパラメータ付きメトリクスの呼び出しごとのパラメータ(例: { exchange: "binance" }{ ticker: "IBIT" })。メトリクスの params_schema が必須フィールドを宣言している場合に必要です。
format"png" / "svg" / "json""png"出力形式。"png" はラスター画像を、"svg" はスケーラブルなベクター画像(スライド資料への埋め込みや印刷に最適)を、"json" はチャートのメタデータのみ(描画なし)を返します。

ユースケース: 任意のメトリクスを会話内で直接可視化します。エージェントがインラインで表示されるチャート画像を返すため、ブラウザやダッシュボードを開く必要がありません。

呼び出し例:

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

一部のメトリクスにはパラメータ(exchangeticker など)が必要です。metrics 配列を設定オブジェクトとともに使用する場合は、メトリクス定義から params を含めてください。

チャート描画オプションの完全なドキュメントについては Snapshot API を参照してください。


ユースケースとプロンプト例

Blocklens MCP サーバーを接続したら、AI エージェントに与えられる具体的なプロンプトを以下に示します。

市場バリュエーション分析

「ビットコインは現在割高ですか? MVRV 比率を確認し、LTH と STH の実現価格を現在のスポット価格と比較してください。」

エージェントは get_holder_valuationget_prices を呼び出し、データを統合して、現在の市場価値が総合コストベースを上回っているか下回っているかを評価します。

HODL Waves リサーチ

「過去 1 年間で年齢コホートにわたる供給分布がどのように変化したかを見せてください。長期ホルダーは蓄積していますか、それとも分配していますか?」

エージェントは複数のコホートについて days: 365get_cohort_metrics を呼び出し、各年齢帯のトレンドを分析して蓄積と分配のパターンを特定します。

週次オンチェーンレポート

「価格動向、供給ダイナミクス、ホルダーの収益性、MVRV をカバーする週次のビットコインオンチェーン健全性レポートを作成してください。」

エージェントはスナップショットのために get_latest_metrics を呼び出し、次に 7 日間のトレンドのために get_pricesget_holder_supplyget_holder_valuationget_holder_profit を深掘りして、構造化された要約を作成します。

サイクルフェーズの特定

「実現キャップのトレンドは現在の市場フェーズについて何を示唆していますか? 実現キャップの成長率を過去数か月と比較してください。」

エージェントはより長い時間枠で get_holder_valuation を呼び出し、実現キャップの軌跡を分析して、現在が蓄積(accumulation)、上昇(markup)、分配(distribution)、下落(markdown)のどのフェーズにあるかを特定します。

降伏(キャピチュレーション)の検出

「過去 30 日間で STH SOPR が 1 を下回ったかどうかを確認してください。これは短期ホルダーが損失で売却していることを示します。」

エージェントは days: 30get_holder_profit を呼び出し、STH SOPR の値を調べて降伏イベントを検出します。

アクセスティア

ティアMCP アクセス履歴メトリクス1 日あたりのリクエスト
Demo(キーなし)あり60 日基本(グレード 0)無制限
Pro($50/月)あり無制限すべて(グレード 0〜1)10,000
Enterprise($900/月)あり無制限すべて(グレード 0〜2)100,000

MCP サーバーはすべてのティアで動作します。デモモードは、サブスクライブする前にツールを試すのに最適な方法です。フルアクセスのロックを解除するには API キーを取得 してください。

API キーの取得

blocklens.co/api-mcp にアクセスして API キーを作成し、サブスクリプションのティアと使用状況を確認してください。

リソース