Servidor MCP para Agentes de IA

A Blocklens fornece um servidor MCP que permite que agentes de IA consultem análises on-chain diretamente durante as conversas. Em vez de copiar e colar respostas da API, o seu agente descobre as ferramentas disponíveis e as invoca de forma autônoma.

O que é o MCP?

O Model Context Protocol (MCP) é um padrão aberto criado pela Anthropic que define como aplicações de IA se conectam a fontes de dados e ferramentas externas. Pense nele como um adaptador universal — qualquer agente compatível com MCP (Claude, Cursor, Windsurf, etc.) pode se conectar a qualquer servidor MCP sem código de integração personalizado.

Com o MCP, o agente não apenas lê dados — ele pode descobrir quais ferramentas estão disponíveis, entender seus parâmetros e invocá-las com os argumentos corretos. Isso torna as interações muito mais naturais do que elaborar chamadas de API manualmente.

Acesso Remoto (Sem Instalação Necessária)

A maneira mais rápida de conectar é através do nosso endpoint MCP hospedado — sem pacotes para instalar, sem configuração local.

Claude.ai

Vá para Settings → Connectors
Clique em + para adicionar um novo conector
Cole a URL: https://mcp.blocklens.co
Deixe Client ID e Client Secret vazios → clique em Add
Autorize com a sua chave de API quando solicitado

Claude Desktop

Adicione isto ao seu claude_desktop_config.json:

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

ChatGPT

Ative o Developer Mode: Settings → General → Developer Mode
Vá para Settings → Developer → MCP Servers
Clique em Add Server, insira o nome "Blocklens" e a URL: https://mcp.blocklens.co
Autorize com a sua chave de API quando solicitado

Cursor / Windsurf

Abra Settings → MCP Servers
Adicione um servidor remoto com a URL: https://mcp.blocklens.co
Autorize com a sua chave de API quando solicitado

Para o Cursor, você também pode adicionar ao .cursor/mcp.json:

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

Qualquer Cliente HTTP MCP

Faça um POST para https://mcp.blocklens.co usando o transporte Streamable HTTP. O servidor suporta o protocolo MCP completo — descoberta de ferramentas, invocação e respostas em streaming.

Sem instalação necessária

O endpoint remoto fornece as mesmas 19 ferramentas que o pacote npm. Funciona no navegador, não requer dependências locais e já vem com o modo de demonstração pronto para uso.

Autenticação

O servidor MCP suporta dois modos de acesso:

Acesso Gratuito (Sem Chave de API)

Conecte-se sem nenhuma credencial para acessar métricas do nível gratuito: preços, oferta de holders, valuation, agregado de ETF, coindays e dados de blockchain. Até 60 dias de histórico.

Acesso Completo (Com Chave de API)

Desbloqueie todas as métricas, incluindo os níveis Pro e Enterprise. Ao se conectar pela primeira vez, uma página de autorização da Blocklens aparecerá para você inserir a sua chave de API. Isso usa um fluxo OAuth seguro — não é necessário Client ID nem Secret.

Obtenha a sua chave de API em blocklens.co/api-mcp.

Por que Blocklens + MCP?

A Blocklens fornece suporte nativo a MCP para análise on-chain, permitindo que agentes de IA consultem métricas diretamente sem integração personalizada.

O que isso significa na prática:

Consultas on-chain em tempo real — Pergunte ao seu agente de IA "O Bitcoin está sobrevalorizado agora?" e ele invocará get_holder_valuation para verificar o MVRV, a realized cap e muito mais
Sem trabalho manual de API — O agente descobre as ferramentas automaticamente e formata as respostas para você
Pesquisa na velocidade da conversa — Encadeie várias consultas: verifique o preço, depois a oferta, depois a lucratividade, tudo em uma única conversa
Relatórios automatizados — Peça ao seu agente para gerar relatórios semanais de saúde on-chain com dados ao vivo

Instalação Local (Alternativa)

Veja Acesso Remoto para a configuração mais simples — sem pacotes ou configuração local necessária.

Instalação

npm install -g blocklens-mcp-server

Claude Desktop

Adicione isto ao seu arquivo de configuração do Claude Desktop (claude_desktop_config.json):

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

Localização do arquivo de configuração:

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

Após salvar, reinicie o Claude Desktop. Você deverá ver "blocklens" listado entre as ferramentas MCP disponíveis.

Cursor / Windsurf

Adicione às suas configurações de MCP (.cursor/mcp.json ou equivalente):

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

Modo de Demonstração (Sem Chave de API)

Você pode experimentar o servidor MCP sem uma chave de API. No modo de demonstração:

Funciona: list_metrics, search_metrics, get_metric, get_categories e endpoints de dados com até 60 dias de histórico para métricas básicas (grade 0)
Requer chave de API: Métricas de lucro (SOPR, P/L realizado), histórico estendido, métricas de nível enterprise

Para executar no modo de demonstração, basta omitir a BLOCKLENS_API_KEY da sua configuração:

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

Ferramentas Disponíveis

O servidor MCP expõe 19 ferramentas que cobrem todo o conjunto de análises da Blocklens: dados de mercado, oferta de holders, valuation, lucratividade, cohorts por idade, histórico de UTXO, coin days, análise de ETF, estatísticas de blockchain, limites de ciclo e renderização de gráficos. Construído sobre uma base de código TypeScript unificada.

Requisitos por Nível

Nível	Ferramentas
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`
Depende da métrica	`render_chart` — métricas gratuitas renderizam sem chave; métricas Pro/Enterprise exigem o nível correspondente

`list_metrics`

Free

Lista todas as métricas on-chain disponíveis com descrições, categorias e requisitos de nível.

Parâmetros: Nenhum

Caso de uso: Comece por aqui para descobrir quais dados estão disponíveis. Retorna o catálogo completo com os IDs de métrica que você precisará para outras ferramentas.

Exemplo de resposta (abreviado):

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

Métricas parametrizadas

Algumas métricas exigem parâmetros adicionais (por exemplo, exchange, ticker, id). Verifique o campo params para valores padrão e params_schema para descrições de parâmetros e endpoints de valores disponíveis.

`get_prices`

Free

Obtém preços diários OHLC (abertura/máxima/mínima/fechamento em USD), market cap e volume de negociação de 24h.

Parâmetro	Tipo	Padrão	Descrição
`symbol`	string	`"BTC"`	Símbolo da criptomoeda
`days`	integer	`30`	Número de pontos de dados diários (1–10.000)
`start_date`	string	—	Data de início (`YYYY-MM-DD`). Sobrepõe `days`.
`end_date`	string	—	Data de fim (`YYYY-MM-DD`). Padrão é hoje.

Caso de uso: Contexto de preço para qualquer análise. Combine com métricas de valuation para avaliar se o preço atual é justificado pelos fundamentos on-chain.

`get_holder_supply`

Free

Obtém a divisão de oferta LTH/STH: oferta de Long-Term Holders (mantida por >155 dias), oferta de Short-Term Holders (mantida por <155 dias) e oferta circulante total. Todos os valores em BTC.

Parâmetro	Tipo	Padrão	Descrição
`days`	integer	`30`	Número de pontos de dados diários (1–10.000)
`start_date`	string	—	Data de início (`YYYY-MM-DD`)
`end_date`	string	—	Data de fim (`YYYY-MM-DD`)

Caso de uso: Acompanhe acumulação e distribuição. Oferta LTH crescente = convicção / acumulação. Oferta STH crescente = dinheiro novo entrando / possível distribuição adiante.

`get_holder_valuation`

Free

Obtém métricas de valuation do Bitcoin: Realized Cap, Realized Price, Realized Cap e Price de LTH/STH, ratio MVRV e P/L não realizado.

Parâmetro	Tipo	Padrão	Descrição
`days`	integer	`30`	Número de pontos de dados diários (1–10.000)
`start_date`	string	—	Data de início (`YYYY-MM-DD`)
`end_date`	string	—	Data de fim (`YYYY-MM-DD`)

Caso de uso: Framework de valuation central. MVRV > 3,5 historicamente sinaliza sobreaquecimento; MVRV < 1 sinaliza subvalorização. Compare os realized prices de LTH vs STH para avaliar a estrutura do mercado.

`get_holder_profit`

Pro

Obtém métricas de lucratividade do Bitcoin: P/L realizado de LTH/STH (USD) e SOPR (Spent Output Profit Ratio). Requer chave de API do nível Pro.

Parâmetro	Tipo	Padrão	Descrição
`days`	integer	`30`	Número de pontos de dados diários (1–10.000)
`start_date`	string	—	Data de início (`YYYY-MM-DD`)
`end_date`	string	—	Data de fim (`YYYY-MM-DD`)

Caso de uso: Entenda se as moedas estão sendo movimentadas com lucro ou prejuízo. SOPR > 1 significa que os holders estão vendendo com lucro; SOPR < 1 significa venda com prejuízo (frequentemente sinaliza capitulação ou formação de fundo).

`get_cohort_metrics`

Pro

Obtém métricas de cohort por idade: oferta (BTC), realized cap (USD) e realized price (USD) para uma faixa de idade de UTXO específica. Usado para análise de HODL Waves.

Parâmetro	Tipo	Padrão	Descrição
`cohort`	enum	obrigatório	Faixa de idade (veja abaixo)
`days`	integer	`30`	Número de pontos de dados diários (1–10.000)
`start_date`	string	—	Data de início (`YYYY-MM-DD`)
`end_date`	string	—	Data de fim (`YYYY-MM-DD`)

Cohorts válidos: 24h, 1d_1w, 1w_1m, 1m_3m, 3m_6m, 6m_12m, 1y_2y, 2y_3y, 3y_5y, 5y_7y, 7y_10y, 10y_plus

Caso de uso: Análise aprofundada de grupos de idade específicos. Por exemplo, verifique se o cohort 3m_6m está crescendo (nova acumulação amadurecendo) ou se as moedas 10y_plus estão finalmente se movendo (oferta dormente há muito tempo despertando).

`get_utxo_history`

Pro

Obtém a divisão do conjunto de UTXO por cohort de idade. Mostra as quantidades de token (BTC) e os valores em USD para cada cohort em uma data específica.

Parâmetro	Tipo	Padrão	Descrição
`date_processed`	string	—	Data de snapshot específica (`YYYY-MM-DD`)
`cohort_start`	string	—	Início do intervalo de datas do cohort
`cohort_end`	string	—	Fim do intervalo de datas do cohort
`days`	integer	`1000`	Número de registros (1–50.000)

Caso de uso: Analise padrões de dormência e acumulação de moedas. Quando a oferta dormente se move, isso frequentemente precede movimentos de preço significativos.

`get_latest_metrics`

Free

Obtém o snapshot mais recente em todas as categorias de métrica (preço, oferta, valuation, lucro) em uma única chamada.

Parâmetros: Nenhum

Caso de uso: Visão geral rápida do mercado. Uma chamada fornece o estado atual de todas as métricas-chave — ideal para verificações diárias ou para iniciar uma análise mais profunda.

`search_metrics`

Free

Pesquisa as métricas disponíveis por palavra-chave em nomes, descrições e IDs.

Parâmetro	Tipo	Padrão	Descrição
`query`	string	obrigatório	Termo de pesquisa (por exemplo, `"realized price"`, `"MVRV"`, `"supply"`)

Caso de uso: Encontre a métrica certa quando você sabe aproximadamente o que procura, mas não o ID exato. Retorna as métricas correspondentes com seus endpoints e requisitos de nível.

`get_metric`

Free

Obtém a definição completa de uma única métrica pelo seu ID, incluindo nome, descrição, categoria, endpoint, unidade e nível de acesso.

Parâmetro	Tipo	Padrão	Descrição
`metric_id`	string	obrigatório	Identificador da métrica (por exemplo, `"lth_supply"`, `"price"`, `"sth_sopr"`)

Caso de uso: Verifique exatamente o que uma métrica mede, como é calculada e qual nível é necessário antes de buscar os dados. A resposta inclui params e params_schema quando a métrica requer parâmetros adicionais (por exemplo, exchange, ticker, id).

`get_categories`

Free

Lista todas as categorias de métrica com contagens e os IDs de métrica em cada categoria.

Parâmetros: Nenhum

Caso de uso: Obtenha uma visão geral estruturada dos dados disponíveis organizados por tema (preço, oferta, valuation, lucro).

`get_coindays`

Free

Obtém métricas de Coin Days: Coin Days Destroyed (CDD), liveliness, vaultedness e dormancy. Essas métricas medem por quanto tempo as moedas foram mantidas antes de serem gastas, revelando padrões de convicção e atividade.

Parâmetro	Tipo	Padrão	Descrição
`days`	integer	`30`	Número de pontos de dados diários (1–10.000)
`start_date`	string	—	Data de início (`YYYY-MM-DD`)
`end_date`	string	—	Data de fim (`YYYY-MM-DD`)

Caso de uso: Detecte quando moedas dormentes há muito tempo começam a se mover. Picos altos de CDD frequentemente precedem grandes movimentos de preço. Liveliness crescente = moedas antigas sendo gastas; vaultedness crescente = moedas sendo trancadas para retenção de longo prazo.

`get_etf_data`

Free

Obtém dados agregados de ETF de Bitcoin: holdings totais (BTC), AUM (USD), fluxos líquidos diários, fluxos cumulativos, dominância de ETF e realized price de ETF.

Parâmetro	Tipo	Padrão	Descrição
`days`	integer	`30`	Número de pontos de dados diários (1–10.000)
`start_date`	string	—	Data de início (`YYYY-MM-DD`)
`end_date`	string	—	Data de fim (`YYYY-MM-DD`)

Caso de uso: Acompanhe a demanda institucional através dos fluxos de ETF. AUM crescente e fluxos líquidos positivos sinalizam acumulação institucional. Compare o realized price de ETF ao preço à vista para avaliar se os holders de ETF estão com lucro.

`get_blockchain`

Free

Obtém métricas de blockchain: altura do bloco ou blocos minerados por dia.

Parâmetro	Tipo	Padrão	Descrição
`metric`	enum	obrigatório	`"block_height"` ou `"blocks_mined"`
`days`	integer	`30`	Número de pontos de dados diários (1–10.000)
`start_date`	string	—	Data de início (`YYYY-MM-DD`)
`end_date`	string	—	Data de fim (`YYYY-MM-DD`)

Caso de uso: Monitore a saúde da rede e a atividade de mineração. Um número de blocos minerados por dia que destoe de ~144 pode indicar mudanças no hashrate ou ajustes de dificuldade.

`get_dat_aggregate`

Free

Obtém dados agregados de Digital Asset Treasuries: total de BTC mantido por instituições e governos, contagem de empresas, fluxos líquidos e divisão pública/privada/governamental.

Parâmetro	Tipo	Padrão	Descrição
`days`	integer	`30`	Número de pontos de dados diários (1–10.000)
`start_date`	string	—	Data de início (`YYYY-MM-DD`)
`end_date`	string	—	Data de fim (`YYYY-MM-DD`)

Caso de uso: Acompanhe a adoção institucional do Bitcoin. O total crescente de BTC entre tesourarias corporativas e soberanas sinaliza uma convicção institucional crescente.

Para realized price (cost basis por BTC) por tipo de entidade (governo, pública, privada), use render_chart com as métricas dat_rp_total, dat_rp_public, dat_rp_government, dat_rp_private ou o template dat-realized-price-by-type.

`get_dat_registry`

Free

Lista todas as entidades de Digital Asset Treasury rastreadas (corporações, fundos, governos) com metadados incluindo nome, ticker, tipo de entidade e país.

Parâmetros: Nenhum

Caso de uso: Descubra quais entidades possuem Bitcoin. Use o campo id retornado para consultar dados por entidade com get_dat_entity.

`get_dat_entity`

Pro

Obtém dados de Digital Asset Treasury por entidade: holdings de BTC, AUM, fluxo líquido, fluxo cumulativo, participação de mercado, realized price (custo médio por BTC) e cost basis total.

Parâmetro	Tipo	Padrão	Descrição
`id`	integer	obrigatório	ID da entidade/empresa (de `get_dat_registry`)
`days`	integer	`365`	Número de pontos de dados diários (1–10.000)
`start_date`	string	—	Data de início (`YYYY-MM-DD`)
`end_date`	string	—	Data de fim (`YYYY-MM-DD`)

Caso de uso: Analise a estratégia de Bitcoin de uma entidade específica — acompanhe o crescimento das holdings, compare o realized price ao preço de mercado para o P/L não realizado e monitore os padrões de acumulação.

Exemplo: get_dat_entity({ id: 1 }) retorna dados da Strategy (anteriormente MicroStrategy) incluindo holdings de 762K BTC e realized price de $75.694.

`get_cycle_boundaries`

Free

Obtém os limites do ciclo de halving do Bitcoin: data de início, data de fim, duração em dias e número do ciclo para cada época de halving.

Parâmetros: Nenhum

Caso de uso: Identifique fases de ciclo para análise comparativa. Use com render_chart e x_axis: "day_offset" para sobrepor gráficos de desempenho de ciclo onde todos os ciclos começam no Dia 0.

Exemplo de resposta (abreviado):

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

Depende da métrica

Renderiza um gráfico de análise on-chain do Bitcoin como uma imagem PNG ou um gráfico vetorial SVG. Retorna a imagem inline na conversa. Suporta métricas únicas, múltiplas métricas, templates e personalização completa.

Parâmetro	Tipo	Padrão	Descrição
`metric`	string	—	ID de métrica única (por exemplo, `"price"`, `"lth_supply"`)
`metrics`	array	—	Múltiplas métricas como strings ou objetos de configuração
`template`	string	—	Template de gráfico (por exemplo, `"mvrv_ratio"`, `"holder_supply"`)
`days`	integer	`365`	Dias de histórico (7–3.650)
`start_date`	string	—	Data de início (`YYYY-MM-DD`)
`end_date`	string	—	Data de fim (`YYYY-MM-DD`)
`overlay`	`"price"`	—	Adiciona sobreposição de preço do BTC
`theme`	`"light"` / `"dark"`	`"light"`	Tema de cores
`width`	integer	`1200`	Largura da imagem em pixels
`height`	integer	`600`	Altura da imagem em pixels
`title`	string	auto	Título do gráfico
`style`	`"line"` / `"area"` / `"bar"`	auto	Estilo padrão do gráfico
`scale`	`"linear"` / `"log"`	`"linear"`	Escala do eixo Y
`y_axes`	array	—	Eixos Y personalizados com zonas verticais. Cada objeto: `{ id, side, scale?, format?, range?, domain_min?, domain_max?, no_padding? }`. Veja Snapshot API — Eixos Y Personalizados.
`x_axis`	`"date"` / `"day_offset"`	`"date"`	Modo do eixo X. Use `"day_offset"` para sobreposições de desempenho de ciclo. Requer que todas as `metrics` sejam da mesma família `cycle_ath_`, `cycle_low_` ou `cycle_halving_*`.
`heatmap_id`	`"cost-basis-distribution"`	—	Renderiza um heatmap em vez de um gráfico de linha. Mutuamente exclusivo com `metric` / `metrics` / `template`. Veja Renderização de Heatmap.
`heatmap_period`	`"3m"` / `"6m"` / `"1y"` / `"2y"` / `"3y"` / `"5y"` / `"all"`	`"1y"`	Janela de tempo para o agrupamento do heatmap.
`heatmap_color_scale`	`"viridis"` / `"plasma"` / `"inferno"` / `"magma"` / `"cividis"`	`"viridis"`	Paleta de cores para as células do heatmap.
`heatmap_y_scale`	`"linear"` / `"log"`	`"linear"`	Escala do eixo Y para os bins de preço do heatmap.
`params`	object	—	Parâmetros por chamada para métricas parametrizadas (por exemplo, `{ exchange: "binance" }`, `{ ticker: "IBIT" }`). Obrigatório quando o `params_schema` da métrica declara um campo obrigatório.
`format`	`"png"` / `"svg"` / `"json"`	`"png"`	Formato de saída. `"png"` retorna uma imagem rasterizada, `"svg"` retorna um gráfico vetorial escalável (ideal para incorporar em apresentações de slides ou impressão), `"json"` retorna apenas os metadados do gráfico (sem renderização).

Caso de uso: Visualize qualquer métrica diretamente na conversa. O agente retorna uma imagem de gráfico que aparece inline — sem necessidade de abrir um navegador ou dashboard.

Exemplos de chamadas:

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

Algumas métricas exigem parâmetros (como exchange ou ticker). Ao usar o array metrics com objetos de configuração, inclua os params da definição da métrica.

Veja Snapshot API para a documentação completa sobre as opções de renderização de gráficos.

Casos de Uso com Exemplos de Prompts

Aqui estão prompts concretos que você pode dar ao seu agente de IA depois que o servidor MCP da Blocklens estiver conectado.

Análise de Valuation de Mercado

"O Bitcoin está atualmente sobrevalorizado? Verifique o ratio MVRV e compare os realized prices de LTH vs STH com o preço à vista atual."

O agente invocará get_holder_valuation e get_prices, então sintetizará os dados para avaliar se o valor de mercado atual está acima ou abaixo do cost basis agregado.

Pesquisa de HODL Waves

"Mostre-me como a distribuição de oferta entre os cohorts de idade mudou no último ano. Os long-term holders estão acumulando ou distribuindo?"

O agente invocará get_cohort_metrics para múltiplos cohorts com days: 365, então analisará as tendências em cada faixa de idade para identificar padrões de acumulação vs distribuição.

Relatório Semanal On-Chain

"Gere um relatório semanal de saúde on-chain do Bitcoin cobrindo a ação de preço, a dinâmica de oferta, a lucratividade dos holders e o MVRV."

O agente invocará get_latest_metrics para um snapshot, então aprofundará em get_prices, get_holder_supply, get_holder_valuation e get_holder_profit para tendências de 7 dias, produzindo um resumo estruturado.

Identificação de Fase de Ciclo

"O que a tendência da realized cap sugere sobre a fase atual do mercado? Compare a taxa de crescimento da realized cap com os meses anteriores."

O agente invocará get_holder_valuation com uma janela de tempo mais longa e analisará a trajetória da realized cap para identificar se estamos em acumulação, markup, distribuição ou markdown.

Detecção de Capitulação

"Verifique se o STH SOPR caiu abaixo de 1 nos últimos 30 dias — isso indica short-term holders vendendo com prejuízo."

O agente invocará get_holder_profit com days: 30 e examinará os valores de STH SOPR para sinalizar eventos de capitulação.

Níveis de Acesso

Nível	Acesso MCP	Histórico	Métricas	Requisições Diárias
Demo (sem chave)	Sim	60 dias	Básicas (grade 0)	Ilimitadas
Pro ($50/mês)	Sim	Ilimitado	Todas (grade 0–1)	10.000
Enterprise ($900/mês)	Sim	Ilimitado	Todas (grade 0–2)	100.000

O servidor MCP funciona com todos os níveis. O modo de demonstração é uma ótima maneira de explorar as ferramentas antes de assinar. Obtenha uma chave de API para desbloquear o acesso completo.

Obtenha a Sua Chave de API

Visite blocklens.co/api-mcp para criar uma chave de API e visualizar o seu nível de assinatura e uso.

Recursos

Endpoint MCP remoto: mcp.blocklens.co
Pacote npm: blocklens-mcp-server
Código-fonte: GitHub
llms.txt: docs.blocklens.co/llms.txt
Manifesto do plugin de IA: docs.blocklens.co/.well-known/ai-plugin.json
Documentação da Snapshot API: Chart Snapshot API
Referência da API: Documentação interativa da API
Obter chave de API: blocklens.co/api-mcp
Protocolo MCP: modelcontextprotocol.io

O que é o MCP?​

Acesso Remoto (Sem Instalação Necessária)​

Claude.ai​

Claude Desktop​

ChatGPT​

Cursor / Windsurf​

Qualquer Cliente HTTP MCP​

Autenticação​

Acesso Gratuito (Sem Chave de API)​

Acesso Completo (Com Chave de API)​

Por que Blocklens + MCP?​

Instalação Local (Alternativa)​

Instalação​

Claude Desktop​

Cursor / Windsurf​

Modo de Demonstração (Sem Chave de API)​

Ferramentas Disponíveis​

Requisitos por Nível​

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​

Casos de Uso com Exemplos de Prompts​

Análise de Valuation de Mercado​

Pesquisa de HODL Waves​

Relatório Semanal On-Chain​

Identificação de Fase de Ciclo​

Detecção de Capitulação​

Níveis de Acesso​

Obtenha a Sua Chave de API​

Recursos​

O que é o MCP?

Acesso Remoto (Sem Instalação Necessária)

Claude.ai

Claude Desktop

ChatGPT

Cursor / Windsurf

Qualquer Cliente HTTP MCP

Autenticação

Acesso Gratuito (Sem Chave de API)

Acesso Completo (Com Chave de API)

Por que Blocklens + MCP?

Instalação Local (Alternativa)

Instalação

Claude Desktop

Cursor / Windsurf

Modo de Demonstração (Sem Chave de API)

Ferramentas Disponíveis

Requisitos por Nível

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

Casos de Uso com Exemplos de Prompts

Análise de Valuation de Mercado

Pesquisa de HODL Waves

Relatório Semanal On-Chain

Identificação de Fase de Ciclo

Detecção de Capitulação

Níveis de Acesso

Obtenha a Sua Chave de API

Recursos