AI 에이전트를 위한 MCP 서버
Blocklens는 AI 에이전트가 대화 중에 온체인 분석 데이터를 직접 조회할 수 있도록 MCP 서버를 제공합니다. API 응답을 복사해 붙여넣는 대신, 에이전트가 사용 가능한 도구를 스스로 발견하고 자율적으로 호출합니다.
MCP란 무엇인가요?
Model Context Protocol(MCP)은 Anthropic이 만든 오픈 표준으로, AI 애플리케이션이 외부 데이터 소스 및 도구에 연결되는 방식을 정의합니다. 범용 어댑터라고 생각하면 됩니다 — MCP 호환 에이전트(Claude, Cursor, Windsurf 등)라면 어떤 것이든 별도의 통합 코드 없이 어떤 MCP 서버에든 연결할 수 있습니다.
MCP를 사용하면 에이전트는 단순히 데이터를 읽는 데 그치지 않고, 어떤 도구가 있는지 발견하고, 그 매개변수를 이해하며, 올바른 인자로 호출할 수 있습니다. 덕분에 수동으로 API 호출을 작성하는 것보다 훨씬 자연스러운 상호작용이 가능합니다.
원격 접속 (설치 불필요)
가장 빠른 연결 방법은 호스팅된 MCP 엔드포인트를 사용하는 것입니다 — 설치할 패키지도, 로컬 설정도 필요 없습니다.
Claude.ai
- 설정 → 커넥터로 이동합니다
- **+**를 클릭해 새 커넥터를 추가합니다
- URL을 붙여넣습니다:
https://mcp.blocklens.co - Client ID와 Client Secret은 비워둔 채 → 추가를 클릭합니다
- 메시지가 표시되면 API 키로 인증합니다
Claude Desktop
claude_desktop_config.json에 다음을 추가합니다:
{
"mcpServers": {
"blocklens": {
"command": "npx",
"args": ["mcp-remote", "https://mcp.blocklens.co"]
}
}
}
ChatGPT
- 개발자 모드를 활성화합니다: 설정 → 일반 → 개발자 모드
- 설정 → 개발자 → MCP Servers로 이동합니다
- Add Server를 클릭하고 이름에 "Blocklens", URL에
https://mcp.blocklens.co를 입력합니다 - 메시지가 표시되면 API 키로 인증합니다
Cursor / Windsurf
- Settings → MCP Servers를 엽니다
- URL이
https://mcp.blocklens.co인 원격 서버를 추가합니다 - 메시지가 표시되면 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 서버는 두 가지 접근 모드를 지원합니다:
무료 접속 (API 키 없음)
자격 증명 없이 연결하여 무료 등급 지표에 접근할 수 있습니다: 가격, holder supply, 밸류에이션, ETF 집계, coindays, 블록체인 데이터. 최대 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 작업 불필요 — 에이전트가 도구를 자동으로 발견하고 응답을 보기 좋게 정리해 줍니다
- 대화 흐름 그대로 이어지는 리서치 — 여러 조회를 연쇄적으로 연결합니다: 가격을 확인하고, 그다음 공급량을, 그다음 수익성을, 모두 하나의 대화 안에서 진행합니다
- 자동화된 리포팅 — 에이전트가 실시간 데이터로 주간 온체인 건전성 리포트를 생성하도록 할 수 있습니다
로컬 설치 (대안)
가장 간단한 설정은 원격 접속을 참고하세요 — 패키지나 로컬 설정이 필요 없습니다.
설치
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_metrics,search_metrics,get_metric,get_categories, 그리고 기본(grade 0) 지표에 대한 최대 60일치 히스토리 데이터 엔드포인트 - API 키 필요: 수익성 지표(SOPR, realized P/L), 확장 히스토리, enterprise 등급 지표
데모 모드로 실행하려면 설정에서 BLOCKLENS_API_KEY를 생략하기만 하면 됩니다:
{
"mcpServers": {
"blocklens": {
"command": "npx",
"args": ["-y", "blocklens-mcp-server"]
}
}
}
사용 가능한 도구
MCP 서버는 Blocklens 분석 제품군 전체를 아우르는 19개 도구를 노출합니다: 시장 데이터, holder supply, 밸류에이션, 수익성, 연령 코호트, UTXO 히스토리, coin days, ETF 분석, 블록체인 통계, 사이클 경계, 차트 렌더링. 통합된 TypeScript 코드베이스 위에 구축되었습니다.
등급 요구 사항
| 등급 | 도구 |
|---|---|
| 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 |
| 지표에 따라 다름 | render_chart — 무료 지표는 키 없이 렌더링되며, Pro/Enterprise 지표는 해당 등급이 필요합니다 |
list_metrics
Free
설명, 카테고리, 등급 요구 사항과 함께 사용 가능한 모든 온체인 지표를 나열합니다.
매개변수: 없음
활용 사례: 어떤 데이터가 제공되는지 파악하려면 여기서 시작하세요. 다른 도구에 필요한 지표 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"
}
}
}
]
일부 지표는 추가 매개변수(예: exchange, ticker, id)가 필요합니다. 기본값은 params 필드를, 매개변수 설명과 사용 가능한 값 엔드포인트는 params_schema를 확인하세요.
get_prices
Free
일별 OHLC 가격(USD 기준 시가/고가/저가/종가), 시가총액, 24시간 거래량을 가져옵니다.
| 매개변수 | 타입 | 기본값 | 설명 |
|---|---|---|---|
symbol | string | "BTC" | 암호화폐 심볼 |
days | integer | 30 | 일별 데이터 포인트 수 (1–10,000) |
start_date | string | — | 시작일 (YYYY-MM-DD). days를 덮어씁니다. |
end_date | string | — | 종료일 (YYYY-MM-DD). 기본값은 오늘입니다. |
활용 사례: 모든 분석에 필요한 가격 맥락입니다. 밸류에이션 지표와 함께 사용하여 현재 가격이 온체인 펀더멘털로 정당화되는지 평가하세요.
get_holder_supply
Free
LTH/STH 공급 구성을 가져옵니다: 장기 보유자(Long-Term Holder) 공급(155일 초과 보유), 단기 보유자(Short-Term Holder) 공급(155일 미만 보유), 그리고 총 유통 공급량. 모든 값은 BTC 단위입니다.
| 매개변수 | 타입 | 기본값 | 설명 |
|---|---|---|---|
days | integer | 30 | 일별 데이터 포인트 수 (1–10,000) |
start_date | string | — | 시작일 (YYYY-MM-DD) |
end_date | string | — | 종료일 (YYYY-MM-DD) |
활용 사례: 축적과 분산을 추적합니다. LTH 공급 증가 = 확신 / 축적. STH 공급 증가 = 신규 자금 유입 / 향후 분산 가능성.
get_holder_valuation
Free
비트코인 밸류에이션 지표를 가져옵니다: Realized Cap, Realized Price, LTH/STH Realized Cap 및 Price, MVRV 비율, 미실현 손익(Unrealized P/L).
| 매개변수 | 타입 | 기본값 | 설명 |
|---|---|---|---|
days | integer | 30 | 일별 데이터 포인트 수 (1–10,000) |
start_date | string | — | 시작일 (YYYY-MM-DD) |
end_date | string | — | 종료일 (YYYY-MM-DD) |
활용 사례: 핵심 밸류에이션 프레임워크입니다. 역사적으로 MVRV > 3.5는 과열을, MVRV < 1은 저평가를 시사합니다. LTH와 STH의 realized price를 비교하여 시장 구조를 가늠하세요.
get_holder_profit
Pro
비트코인 수익성 지표를 가져옵니다: LTH/STH 실현 손익(Realized P/L, USD)과 SOPR(Spent Output Profit Ratio). Pro 등급 API 키가 필요합니다.
| 매개변수 | 타입 | 기본값 | 설명 |
|---|---|---|---|
days | integer | 30 | 일별 데이터 포인트 수 (1–10,000) |
start_date | string | — | 시작일 (YYYY-MM-DD) |
end_date | string | — | 종료일 (YYYY-MM-DD) |
활용 사례: 코인이 이익으로 이동하는지 손실로 이동하는지 파악합니다. SOPR > 1은 보유자가 이익을 보며 매도함을, SOPR < 1은 손실을 보며 매도함(흔히 항복 또는 바닥 형성의 신호)을 의미합니다.
get_cohort_metrics
Pro
연령 코호트 지표를 가져옵니다: 특정 UTXO 연령 구간에 대한 공급량(BTC), realized cap(USD), realized price(USD). HODL Waves 분석에 사용됩니다.
| 매개변수 | 타입 | 기본값 | 설명 |
|---|---|---|---|
cohort | enum | 필수 | 연령 구간 (아래 참조) |
days | integer | 30 | 일별 데이터 포인트 수 (1–10,000) |
start_date | string | — | 시작일 (YYYY-MM-DD) |
end_date | string | — | 종료일 (YYYY-MM-DD) |
유효한 코호트: 24h, 1d_1w, 1w_1m, 1m_3m, 3m_6m, 6m_12m, 1y_2y, 2y_3y, 3y_5y, 5y_7y, 7y_10y, 10y_plus
활용 사례: 특정 연령 그룹을 심층 분석합니다. 예를 들어 3m_6m 코호트가 성장하고 있는지(신규 축적분이 성숙 중), 혹은 10y_plus 코인이 드디어 이동하고 있는지(오래 잠들어 있던 공급이 깨어나는 중) 확인하세요.
get_utxo_history
Pro
연령 코호트별 UTXO 세트 구성을 가져옵니다. 특정 날짜에 각 코호트의 토큰 수량(BTC)과 USD 가치를 보여줍니다.
| 매개변수 | 타입 | 기본값 | 설명 |
|---|---|---|---|
date_processed | string | — | 특정 스냅샷 날짜 (YYYY-MM-DD) |
cohort_start | string | — | 코호트 날짜 범위의 시작 |
cohort_end | string | — | 코호트 날짜 범위의 끝 |
days | integer | 1000 | 레코드 수 (1–50,000) |
활용 사례: 코인 휴면 및 축적 패턴을 분석합니다. 휴면 공급이 이동하면 흔히 중요한 가격 움직임에 선행합니다.
get_latest_metrics
Free
모든 지표 카테고리(가격, 공급, 밸류에이션, 수익)에 걸친 가장 최근 스냅샷을 한 번의 호출로 가져옵니다.
매개변수: 없음
활용 사례: 빠른 시장 개요입니다. 한 번의 호출로 모든 핵심 지표의 현재 상태를 확인할 수 있어, 일일 점검이나 심층 분석의 시작점으로 이상적입니다.
search_metrics
Free
이름, 설명, ID 전반에서 키워드로 사용 가능한 지표를 검색합니다.
| 매개변수 | 타입 | 기본값 | 설명 |
|---|---|---|---|
query | string | 필수 | 검색어 (예: "realized price", "MVRV", "supply") |
활용 사례: 찾는 것이 대략 무엇인지는 알지만 정확한 ID를 모를 때 적합한 지표를 찾습니다. 일치하는 지표를 해당 엔드포인트 및 등급 요구 사항과 함께 반환합니다.
get_metric
Free
ID로 단일 지표의 전체 정의를 가져옵니다 — 이름, 설명, 카테고리, 엔드포인트, 단위, 접근 등급 포함.
| 매개변수 | 타입 | 기본값 | 설명 |
|---|---|---|---|
metric_id | string | 필수 | 지표 식별자 (예: "lth_supply", "price", "sth_sopr") |
활용 사례: 데이터를 가져오기 전에 지표가 정확히 무엇을 측정하는지, 어떻게 계산되는지, 어떤 등급이 필요한지 조회합니다. 지표에 추가 매개변수(예: exchange, ticker, id)가 필요한 경우 응답에 params와 params_schema가 포함됩니다.
get_categories
Free
각 카테고리의 개수 및 포함된 지표 ID와 함께 모든 지표 카테고리를 나열합니다.
매개변수: 없음
활용 사례: 테마별(가격, 공급, 밸류에이션, 수익)로 정리된 사용 가능한 데이터의 구조화된 개요를 얻습니다.
get_coindays
Free
Coin Days 지표를 가져옵니다: Coin Days Destroyed(CDD), liveliness, vaultedness, dormancy. 이들 지표는 코인이 소비되기 전까지 얼마나 오래 보유되었는지를 측정하여 확신과 활동 패턴을 드러냅니다.
| 매개변수 | 타입 | 기본값 | 설명 |
|---|---|---|---|
days | integer | 30 | 일별 데이터 포인트 수 (1–10,000) |
start_date | string | — | 시작일 (YYYY-MM-DD) |
end_date | string | — | 종료일 (YYYY-MM-DD) |
활용 사례: 오래 휴면 상태였던 코인이 이동하기 시작하는 시점을 감지합니다. 높은 CDD 급등은 흔히 주요 가격 움직임에 선행합니다. liveliness 상승 = 오래된 코인이 소비됨; vaultedness 상승 = 장기 보유를 위해 코인이 잠금됨.
get_etf_data
Free
비트코인 ETF 집계 데이터를 가져옵니다: 총 보유량(BTC), AUM(USD), 일별 순유입, 누적 유입, ETF 점유율, ETF realized price.
| 매개변수 | 타입 | 기본값 | 설명 |
|---|---|---|---|
days | integer | 30 | 일별 데이터 포인트 수 (1–10,000) |
start_date | string | — | 시작일 (YYYY-MM-DD) |
end_date | string | — | 종료일 (YYYY-MM-DD) |
활용 사례: ETF 자금 흐름을 통해 기관 수요를 추적합니다. AUM 상승과 양(+)의 순유입은 기관 축적을 시사합니다. ETF realized price를 현물 가격과 비교하여 ETF 보유자가 이익 상태인지 가늠하세요.
get_blockchain
Free
블록체인 지표를 가져옵니다: 블록 높이 또는 일별 채굴 블록 수.
| 매개변수 | 타입 | 기본값 | 설명 |
|---|---|---|---|
metric | enum | 필수 | "block_height" 또는 "blocks_mined" |
days | integer | 30 | 일별 데이터 포인트 수 (1–10,000) |
start_date | string | — | 시작일 (YYYY-MM-DD) |
end_date | string | — | 종료일 (YYYY-MM-DD) |
활용 사례: 네트워크 건전성과 채굴 활동을 모니터링합니다. 일별 채굴 블록 수가 약 144개에서 벗어나면 해시레이트 변화나 난이도 조정을 나타낼 수 있습니다.
get_dat_aggregate
Free
Digital Asset Treasuries 집계 데이터를 가져옵니다: 기관 및 정부가 보유한 총 BTC, 기업 수, 순유입, 공공/민간/정부 구분.
| 매개변수 | 타입 | 기본값 | 설명 |
|---|---|---|---|
days | integer | 30 | 일별 데이터 포인트 수 (1–10,000) |
start_date | string | — | 시작일 (YYYY-MM-DD) |
end_date | string | — | 종료일 (YYYY-MM-DD) |
활용 사례: 기관의 비트코인 채택을 추적합니다. 기업 및 국가 자금의 총 BTC 증가는 기관의 확신이 커지고 있음을 시사합니다.
엔티티 유형별(정부, 공공, 민간) realized price(BTC당 원가 기준)는 dat_rp_total, dat_rp_public, dat_rp_government, dat_rp_private 지표 또는 dat-realized-price-by-type 템플릿과 함께 render_chart를 사용하세요.
get_dat_registry
Free
추적 중인 모든 Digital Asset Treasury 엔티티(기업, 펀드, 정부)를 이름, 티커, 엔티티 유형, 국가를 포함한 메타데이터와 함께 나열합니다.
매개변수: 없음
활용 사례: 어떤 엔티티가 비트코인을 보유하고 있는지 파악합니다. 반환된 id 필드를 사용하여 get_dat_entity로 엔티티별 데이터를 조회하세요.
get_dat_entity
Pro
엔티티별 Digital Asset Treasury 데이터를 가져옵니다: BTC 보유량, AUM, 순유입, 누적 유입, 시장 점유율, realized price(BTC당 평균 원가), 총 cost basis.
| 매개변수 | 타입 | 기본값 | 설명 |
|---|---|---|---|
id | integer | 필수 | 엔티티/기업 ID (get_dat_registry에서) |
days | integer | 365 | 일별 데이터 포인트 수 (1–10,000) |
start_date | string | — | 시작일 (YYYY-MM-DD) |
end_date | string | — | 종료일 (YYYY-MM-DD) |
활용 사례: 특정 엔티티의 비트코인 전략을 분석합니다 — 보유량 증가를 추적하고, 미실현 손익을 위해 realized price를 시장 가격과 비교하며, 축적 패턴을 모니터링합니다.
예시: get_dat_entity({ id: 1 })는 762K BTC 보유량과 $75,694 realized price를 포함한 Strategy(이전 MicroStrategy) 데이터를 반환합니다.
get_cycle_boundaries
Free
비트코인 반감기 사이클 경계를 가져옵니다: 각 반감기 에포크의 시작일, 종료일, 기간(일수), 사이클 번호.
매개변수: 없음
활용 사례: 비교 분석을 위해 사이클 단계를 식별합니다. render_chart 및 x_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 벡터 그래픽으로 렌더링합니다. 이미지를 대화에 인라인으로 반환합니다. 단일 지표, 다중 지표, 템플릿, 그리고 전체 커스터마이징을 지원합니다.
| 매개변수 | 타입 | 기본값 | 설명 |
|---|---|---|---|
metric | string | — | 단일 지표 ID (예: "price", "lth_supply") |
metrics | array | — | 문자열 또는 설정 객체로 된 다중 지표 |
template | string | — | 차트 템플릿 (예: "mvrv_ratio", "holder_supply") |
days | integer | 365 | 히스토리 일수 (7–3,650) |
start_date | string | — | 시작일 (YYYY-MM-DD) |
end_date | string | — | 종료일 (YYYY-MM-DD) |
overlay | "price" | — | BTC 가격 오버레이 추가 |
theme | "light" / "dark" | "light" | 색상 테마 |
width | integer | 1200 | 이미지 너비(픽셀) |
height | integer | 600 | 이미지 높이(픽셀) |
title | string | auto | 차트 제목 |
style | "line" / "area" / "bar" | auto | 기본 차트 스타일 |
scale | "linear" / "log" | "linear" | Y축 스케일 |
y_axes | array | — | 수직 구역이 있는 커스텀 Y축. 각 객체: { id, side, scale?, format?, range?, domain_min?, domain_max?, no_padding? }. Snapshot API — Custom Y-Axes를 참조하세요. |
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 Rendering을 참조하세요. |
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축 스케일. |
params | object | — | 매개변수화된 지표를 위한 호출별 매개변수 (예: { 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
일부 지표는 매개변수(예: exchange 또는 ticker)가 필요합니다. 설정 객체와 함께 metrics 배열을 사용할 때는 지표 정의의 params를 포함하세요.
차트 렌더링 옵션에 대한 전체 문서는 Snapshot API를 참조하세요.
예시 프롬프트가 있는 활용 사례
다음은 Blocklens MCP 서버가 연결된 후 AI 에이전트에게 줄 수 있는 구체적인 프롬프트입니다.
시장 밸류에이션 분석
"비트코인이 현재 고평가되어 있나요? MVRV 비율을 확인하고 LTH와 STH의 realized price를 현재 현물 가격과 비교해 주세요."
에이전트는 get_holder_valuation과 get_prices를 호출한 다음, 데이터를 종합하여 현재 시장 가치가 종합 cost basis보다 높은지 낮은지 평가합니다.
HODL Waves 리서치
"지난 1년 동안 연령 코호트별 공급 분포가 어떻게 변했는지 보여주세요. 장기 보유자가 축적하고 있나요, 분산하고 있나요?"
에이전트는 여러 코호트에 대해 days: 365로 get_cohort_metrics를 호출한 다음, 각 연령 구간의 추세를 분석하여 축적 대 분산 패턴을 식별합니다.
주간 온체인 리포트
"가격 흐름, 공급 역학, 보유자 수익성, MVRV를 다루는 주간 비트코인 온체인 건전성 리포트를 생성해 주세요."
에이전트는 스냅샷을 위해 get_latest_metrics를 호출한 다음, 7일 추세를 위해 get_prices, get_holder_supply, get_holder_valuation, get_holder_profit을 파고들어 구조화된 요약을 만들어 냅니다.
사이클 단계 식별
"realized cap 추세가 현재 시장 단계에 대해 무엇을 시사하나요? realized cap 증가율을 이전 몇 달과 비교해 주세요."
에이전트는 더 긴 시간 범위로 get_holder_valuation을 호출하고 realized cap 궤적을 분석하여 우리가 축적, 상승(markup), 분산, 하락(markdown) 중 어느 단계에 있는지 식별합니다.
항복 감지
"지난 30일 동안 STH SOPR이 1 아래로 떨어졌는지 확인해 주세요 — 이는 단기 보유자가 손실을 보며 매도하고 있음을 나타냅니다."
에이전트는 days: 30으로 get_holder_profit을 호출하고 STH SOPR 값을 검토하여 항복 이벤트를 표시합니다.
접근 등급
| 등급 | MCP 접근 | 히스토리 | 지표 | 일일 요청 수 |
|---|---|---|---|---|
| Demo (키 없음) | 가능 | 60일 | 기본 (grade 0) | 무제한 |
| Pro ($50/월) | 가능 | 무제한 | 전체 (grade 0–1) | 10,000 |
| Enterprise ($900/월) | 가능 | 무제한 | 전체 (grade 0–2) | 100,000 |
MCP 서버는 모든 등급에서 동작합니다. 데모 모드는 구독 전에 도구를 탐색하기에 좋은 방법입니다. 전체 접근을 잠금 해제하려면 API 키를 발급받으세요.
API 키 발급받기
blocklens.co/api-mcp를 방문하여 API 키를 생성하고 구독 등급 및 사용량을 확인하세요.
리소스
- 원격 MCP 엔드포인트: mcp.blocklens.co
- npm 패키지: blocklens-mcp-server
- 소스 코드: GitHub
- llms.txt: docs.blocklens.co/llms.txt
- AI 플러그인 매니페스트: docs.blocklens.co/.well-known/ai-plugin.json
- Snapshot API 문서: Chart Snapshot API
- API 레퍼런스: 대화형 API 문서
- API 키 발급: blocklens.co/api-mcp
- MCP 프로토콜: modelcontextprotocol.io