Перейти к основному содержимому

MCP-сервер для ИИ-агентов

Blocklens предоставляет MCP-сервер, который позволяет ИИ-агентам запрашивать ончейн-аналитику прямо во время диалога. Вместо копирования и вставки ответов API ваш агент сам находит доступные инструменты и вызывает их автономно.

Что такое MCP?

Model Context Protocol (MCP) — это открытый стандарт, созданный Anthropic, который определяет, как ИИ-приложения подключаются к внешним источникам данных и инструментам. Считайте его универсальным адаптером — любой совместимый с MCP агент (Claude, Cursor, Windsurf и т. д.) может подключиться к любому MCP-серверу без написания кода интеграции.

С MCP агент не просто читает данные — он может обнаруживать, какие инструменты доступны, понимать их параметры и вызывать их с правильными аргументами. Это делает взаимодействие гораздо более естественным, чем ручное составление запросов к API.

Удалённый доступ (установка не требуется)

Самый быстрый способ подключиться — через наш размещённый MCP-эндпоинт: ни пакетов для установки, ни локальной настройки.

Claude.ai

  1. Перейдите в Settings → Connectors
  2. Нажмите +, чтобы добавить новый коннектор
  3. Вставьте URL: https://mcp.blocklens.co
  4. Оставьте Client ID и Client Secret пустыми → нажмите Add
  5. Авторизуйтесь с помощью своего API-ключа, когда появится запрос

Claude Desktop

Добавьте это в ваш файл claude_desktop_config.json:

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

ChatGPT

  1. Включите Developer Mode: Settings → General → Developer Mode
  2. Перейдите в Settings → Developer → MCP Servers
  3. Нажмите Add Server, введите имя «Blocklens» и URL: https://mcp.blocklens.co
  4. Авторизуйтесь с помощью своего API-ключа, когда появится запрос

Cursor / Windsurf

  1. Откройте Settings → MCP Servers
  2. Добавьте удалённый сервер с URL: https://mcp.blocklens.co
  3. Авторизуйтесь с помощью своего API-ключа, когда появится запрос

Для Cursor вы также можете добавить запись в .cursor/mcp.json:

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

Любой MCP HTTP-клиент

Отправляйте POST-запросы на https://mcp.blocklens.co, используя транспорт Streamable HTTP. Сервер поддерживает полный протокол MCP — обнаружение инструментов, их вызов и потоковые ответы.

Установка не требуется

Удалённый эндпоинт предоставляет те же 19 инструментов, что и npm-пакет. Он работает в браузере, не требует локальных зависимостей и поддерживает демо-режим «из коробки».

Аутентификация

MCP-сервер поддерживает два режима доступа:

Бесплатный доступ (без API-ключа)

Подключайтесь без каких-либо учётных данных, чтобы получить доступ к метрикам бесплатного тарифа: цены, предложение держателей, оценка стоимости, агрегированные данные по ETF, монетодни и данные блокчейна. До 60 дней истории.

Полный доступ (с API-ключом)

Откройте все метрики, включая тарифы Pro и Enterprise. При первом подключении появится страница авторизации Blocklens, где вы вводите свой API-ключ. Здесь используется защищённый поток OAuth — Client ID или Secret не нужны.

Получите свой API-ключ на blocklens.co/api-mcp.

Почему Blocklens + MCP?

Blocklens обеспечивает нативную поддержку MCP для ончейн-аналитики, позволяя ИИ-агентам запрашивать метрики напрямую без написания кода интеграции.

Что это означает на практике:

  • Ончейн-запросы в реальном времени — спросите своего ИИ-агента «Переоценён ли биткоин прямо сейчас?», и он вызовет get_holder_valuation, чтобы проверить MVRV, реализованную капитализацию и многое другое
  • Никакой ручной работы с 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. Вы должны увидеть «blocklens» в списке доступных MCP-инструментов.

Cursor / Windsurf

Добавьте в настройки MCP (.cursor/mcp.json или эквивалент):

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

Демо-режим (без API-ключа)

Вы можете попробовать MCP-сервер без API-ключа. В демо-режиме:

  • Работает: list_metrics, search_metrics, get_metric, get_categories и эндпоинты данных с историей до 60 дней для базовых метрик (grade 0)
  • Требует API-ключ: метрики прибыли (SOPR, реализованные P/L), расширенная история, метрики тарифа Enterprise

Чтобы запустить в демо-режиме, просто опустите BLOCKLENS_API_KEY в конфигурации:

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

Доступные инструменты

MCP-сервер предоставляет 19 инструментов, охватывающих полный набор аналитики Blocklens: рыночные данные, предложение держателей, оценка стоимости, прибыльность, возрастные когорты, история UTXO, монетодни, аналитика ETF, статистика блокчейна, границы циклов и рендеринг графиков. Построен на единой кодовой базе TypeScript.

Требования по тарифам

ТарифИнструменты
Freelist_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
Proget_holder_profit, get_cohort_metrics, get_utxo_history
Proget_dat_entity
Зависит от метрикиrender_chart — бесплатные метрики отрисовываются без ключа; метрики Pro/Enterprise требуют соответствующего тарифа

list_metrics

Free

Список всех доступных ончейн-метрик с описаниями, категориями и требованиями по тарифам.

Параметры: Нет

Сценарий использования: Начните отсюда, чтобы узнать, какие данные доступны. Возвращает полный каталог с идентификаторами метрик, которые понадобятся для других инструментов.

Пример ответа (сокращённый):

[
{
"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 часа.

ПараметрТипПо умолчаниюОписание
symbolstring"BTC"Символ криптовалюты
daysinteger30Количество дневных точек данных (1–10 000)
start_datestringДата начала (YYYY-MM-DD). Переопределяет days.
end_datestringДата окончания (YYYY-MM-DD). По умолчанию — сегодня.

Сценарий использования: Ценовой контекст для любого анализа. Сочетайте с метриками оценки стоимости, чтобы определить, оправдана ли текущая цена ончейн-фундаменталом.


get_holder_supply

Free

Получить разбивку предложения LTH/STH: предложение долгосрочных держателей (удерживается >155 дней), предложение краткосрочных держателей (удерживается <155 дней) и общее обращающееся предложение. Все значения в BTC.

ПараметрТипПо умолчаниюОписание
daysinteger30Количество дневных точек данных (1–10 000)
start_datestringДата начала (YYYY-MM-DD)
end_datestringДата окончания (YYYY-MM-DD)

Сценарий использования: Отслеживание накопления и распределения. Рост предложения LTH = уверенность / накопление. Рост предложения STH = приток новых денег / вероятное распределение в перспективе.


get_holder_valuation

Free

Получить метрики оценки стоимости биткоина: Реализованную капитализацию, Реализованную цену, Реализованную капитализацию и цену LTH/STH, коэффициент MVRV и нереализованную 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

Получить метрики прибыльности биткоина: реализованную P/L LTH/STH (USD) и SOPR (Spent Output Profit Ratio). Требует API-ключ тарифа Pro.

ПараметрТипПо умолчаниюОписание
daysinteger30Количество дневных точек данных (1–10 000)
start_datestringДата начала (YYYY-MM-DD)
end_datestringДата окончания (YYYY-MM-DD)

Сценарий использования: Понять, перемещаются ли монеты с прибылью или убытком. SOPR > 1 означает, что держатели продают с прибылью; SOPR < 1 означает продажу с убытком (часто сигнализирует о капитуляции или формировании дна).


get_cohort_metrics

Pro

Получить метрики возрастных когорт: предложение (BTC), реализованную капитализацию (USD) и реализованную цену (USD) для конкретного возрастного диапазона UTXO. Используется для анализа HODL Waves.

ПараметрТипПо умолчаниюОписание
cohortenumобязательноВозрастной диапазон (см. ниже)
daysinteger30Количество дневных точек данных (1–10 000)
start_datestringДата начала (YYYY-MM-DD)
end_datestringДата окончания (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_processedstringКонкретная дата снимка (YYYY-MM-DD)
cohort_startstringНачало диапазона дат когорты
cohort_endstringКонец диапазона дат когорты
daysinteger1000Количество записей (1–50 000)

Сценарий использования: Анализ покоя монет и паттернов накопления. Когда «спящее» предложение приходит в движение, это часто предшествует значимым ценовым движениям.


get_latest_metrics

Free

Получить самый свежий снимок по всем категориям метрик (цена, предложение, оценка стоимости, прибыль) одним вызовом.

Параметры: Нет

Сценарий использования: Быстрый обзор рынка. Один вызов даёт вам текущее состояние всех ключевых метрик — идеально для ежедневной проверки или начала более глубокого анализа.


search_metrics

Free

Поиск доступных метрик по ключевому слову среди названий, описаний и идентификаторов.

ПараметрТипПо умолчаниюОписание
querystringобязательноПоисковый запрос (например, "realized price", "MVRV", "supply")

Сценарий использования: Найти нужную метрику, когда вы приблизительно знаете, что ищете, но не помните точный идентификатор. Возвращает подходящие метрики с их эндпоинтами и требованиями по тарифам.


get_metric

Free

Получить полное определение одной метрики по её идентификатору, включая название, описание, категорию, эндпоинт, единицу измерения и тариф доступа.

ПараметрТипПо умолчаниюОписание
metric_idstringобязательноИдентификатор метрики (например, "lth_supply", "price", "sth_sopr")

Сценарий использования: Узнать, что именно измеряет метрика, как она рассчитывается и какой тариф требуется, прежде чем получать данные. Ответ включает params и params_schema, когда метрика требует дополнительных параметров (например, exchange, ticker, id).


get_categories

Free

Список всех категорий метрик с количеством и идентификаторами метрик в каждой категории.

Параметры: Нет

Сценарий использования: Получить структурированный обзор доступных данных, организованных по темам (цена, предложение, оценка стоимости, прибыль).

get_coindays

Free

Получить метрики монетодней: Coin Days Destroyed (CDD), оживлённость (liveliness), сохранность (vaultedness) и покой (dormancy). Эти метрики измеряют, как долго монеты удерживались до того, как были потрачены, раскрывая паттерны уверенности и активности.

ПараметрТипПо умолчаниюОписание
daysinteger30Количество дневных точек данных (1–10 000)
start_datestringДата начала (YYYY-MM-DD)
end_datestringДата окончания (YYYY-MM-DD)

Сценарий использования: Обнаружить, когда давно «спящие» монеты начинают двигаться. Резкие всплески CDD часто предшествуют крупным ценовым движениям. Рост оживлённости = старые монеты тратятся; рост сохранности = монеты откладываются для долгосрочного удержания.


get_etf_data

Free

Получить агрегированные данные по биткоин-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

Free

Получить метрики блокчейна: высоту блока или количество добытых блоков в день.

ПараметрТипПо умолчаниюОписание
metricenumобязательно"block_height" или "blocks_mined"
daysinteger30Количество дневных точек данных (1–10 000)
start_datestringДата начала (YYYY-MM-DD)
end_datestringДата окончания (YYYY-MM-DD)

Сценарий использования: Мониторинг состояния сети и майнинговой активности. Отклонение количества добытых блоков в день от ~144 может указывать на изменения хешрейта или корректировки сложности.


get_dat_aggregate

Free

Получить агрегированные данные Digital Asset Treasuries: общее количество BTC, удерживаемое институтами и правительствами, число компаний, чистые потоки, разбивку по публичным/частным/государственным.

ПараметрТипПо умолчаниюОписание
daysinteger30Количество дневных точек данных (1–10 000)
start_datestringДата начала (YYYY-MM-DD)
end_datestringДата окончания (YYYY-MM-DD)

Сценарий использования: Отслеживание институционального принятия биткоина. Рост общего количества BTC в корпоративных и суверенных казначействах сигнализирует о растущей институциональной уверенности.

Для реализованной цены (база затрат на 1 BTC) по типу субъекта (государственный, публичный, частный) используйте render_chart с метриками dat_rp_total, dat_rp_public, dat_rp_government, dat_rp_private или шаблоном dat-realized-price-by-type.


get_dat_registry

Free

Список всех отслеживаемых субъектов Digital Asset Treasury (корпорации, фонды, правительства) с метаданными, включая название, тикер, тип субъекта и страну.

Параметры: Нет

Сценарий использования: Узнать, какие субъекты держат биткоин. Используйте возвращаемое поле id, чтобы запрашивать данные по конкретному субъекту с помощью get_dat_entity.


get_dat_entity

Pro

Получить данные Digital Asset Treasury по конкретному субъекту: активы в BTC, AUM, чистый поток, накопленный поток, рыночную долю, реализованную цену (средняя стоимость на 1 BTC) и общую базу затрат.

ПараметрТипПо умолчаниюОписание
idintegerобязательноИдентификатор субъекта/компании (из get_dat_registry)
daysinteger365Количество дневных точек данных (1–10 000)
start_datestringДата начала (YYYY-MM-DD)
end_datestringДата окончания (YYYY-MM-DD)

Сценарий использования: Анализ биткоин-стратегии конкретного субъекта — отслеживайте рост активов, сравнивайте реализованную цену с рыночной для нереализованной P/L, наблюдайте за паттернами накопления.

Пример: get_dat_entity({ id: 1 }) возвращает данные Strategy (ранее MicroStrategy), включая 762K BTC активов и реализованную цену $75 694.


get_cycle_boundaries

Free

Получить границы циклов халвинга биткоина: дату начала, дату окончания, продолжительность в днях и номер цикла для каждой эпохи халвинга.

Параметры: Нет

Сценарий использования: Определить фазы цикла для сравнительного анализа. Используйте с render_chart и x_axis: "day_offset", чтобы наложить графики результативности циклов, где все циклы начинаются с Дня 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Идентификатор одной метрики (например, "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

Некоторые метрики требуют параметров (например, exchange или ticker). При использовании массива metrics с объектами конфигурации включайте params из определения метрики.

См. Snapshot API для полной документации по опциям рендеринга графиков.


Сценарии использования с примерами промптов

Вот конкретные промпты, которые вы можете дать своему ИИ-агенту после подключения MCP-сервера Blocklens.

Анализ рыночной оценки стоимости

«Переоценён ли биткоин сейчас? Проверь коэффициент MVRV и сравни реализованные цены LTH и STH с текущей спот-ценой.»

Агент вызовет get_holder_valuation и get_prices, затем синтезирует данные, чтобы оценить, выше или ниже совокупной базы затрат находится текущая рыночная стоимость.

Исследование HODL Waves

«Покажи, как изменилось распределение предложения по возрастным когортам за последний год. Накапливают или распределяют долгосрочные держатели?»

Агент вызовет get_cohort_metrics для нескольких когорт с days: 365, затем проанализирует тренды в каждом возрастном диапазоне, чтобы выявить паттерны накопления и распределения.

Еженедельный ончейн-отчёт

«Сформируй еженедельный отчёт о состоянии ончейн-данных биткоина, охватывающий ценовое движение, динамику предложения, прибыльность держателей и MVRV.»

Агент вызовет get_latest_metrics для снимка, затем углубится в get_prices, get_holder_supply, get_holder_valuation и get_holder_profit для 7-дневных трендов, формируя структурированную сводку.

Определение фазы цикла

«Что тренд реализованной капитализации говорит о текущей фазе рынка? Сравни темп роста реализованной капитализации с предыдущими месяцами.»

Агент вызовет get_holder_valuation с более длинным временным окном и проанализирует траекторию реализованной капитализации, чтобы определить, в какой мы фазе — накопления, роста, распределения или спада.

Обнаружение капитуляции

«Проверь, опускался ли STH SOPR ниже 1 за последние 30 дней — это указывает на продажу краткосрочными держателями с убытком.»

Агент вызовет get_holder_profit с days: 30 и изучит значения 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-ключ и просмотреть свой тариф подписки и использование.

Ресурсы