Blocklens Mcp Server

io.github.blocklensPublished by GitHub account blocklensv0.4.3Updated Oct 24, 2026

Bitcoin on-chain analytics — 109 metrics: MVRV, SOPR, NUPL, HODL Waves, CDD, cycles & more

VerifiedSTDIODesktop onlyFinance Data & Analytics

Server details

Identifier: io.github.blocklens/blocklens-mcp-server
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account blocklens for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.blocklens%2Fblocklens-mcp-server.svg)](https://sourceweft.com/mcp/io.github.blocklens%2Fblocklens-mcp-server?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Blocklens MCP server gives an AI assistant Bitcoin on-chain analytics: 127 metrics such as MVRV, SOPR, NUPL, HODL Waves and CDD, plus PNG chart rendering.

What you can do: Browse and search the metric catalog, read definitions and categories, and get the latest snapshot across categories (list_metrics, search_metrics, get_metric, get_categories, get_latest_metrics). Retrieve BTC market data: daily OHLC, market cap, volume, drawdown and realized volatility windows (get_prices). Query holder and supply data: LTH/STH supply, realized cap and price, MVRV, NUPL, SOPR, age cohorts and UTXO history (get_holder_supply, get_holder_valuation, get_holder_profit, get_cohort_metrics, get_utxo_history). Read coin-days metrics such as CDD, liveliness, dormancy and dormancy flow, plus block height and cycle performance (get_coindays, get_blockchain, get_cycle_performance).
When to use it: Useful when you want an assistant to answer Bitcoin valuation, supply, profitability or cycle questions and to chart those metrics inline, rather than looking up numbers by hand.
Requirements: Runs as a local npm package over stdio, or as a hosted remote endpoint. A BLOCKLENS_API_KEY environment variable is required for full access; without it a demo mode gives 60 days of history for basic-tier metrics. Paid Pro and Enterprise tiers exist for unlimited history and all metrics.

Before you install

The server needs a BLOCKLENS_API_KEY secret, which is placed in the client config file. Full history and higher-tier metrics require a paid subscription (Pro or Enterprise). Metric data is fetched from Blocklens' servers, so queries go to that third party.

Installation

In SourceWeft

Open Blocklens Mcp Server in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

blocklens-mcp-server

MCP (Model Context Protocol) server for Blocklens Bitcoin on-chain analytics. Connect your AI agent to 127 on-chain metrics computed from raw blockchain data — no API wrappers, no delays.

Quick Start

Remote Access (No Install)

Connect directly to the hosted endpoint — no packages, no local setup:

Claude.ai (Browser): Settings → Connectors → Add → URL: https://mcp.blocklens.co

Claude Desktop / Cursor / Windsurf (via mcp-remote):

json

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

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

Any MCP HTTP client: POST to https://mcp.blocklens.co (Streamable HTTP transport)

Local Install

Claude Desktop

Add to your claude_desktop_config.json:

json

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

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

Config file location:

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

Cursor / Windsurf

Add to your MCP config (.cursor/mcp.json):

json

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

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

Demo Mode (No API Key)

Works without an API key — you get 60 days of history for basic-tier metrics. Get an API key at blocklens.co/api-keys for full access.

Available Tools (15)

Tool	Description
`list_metrics`	List all 127 available metrics with categories and tiers
`search_metrics`	Search metrics by keyword
`get_metric`	Get full definition of a single metric
`get_categories`	List metric categories with counts
`get_prices`	BTC daily OHLC, market cap, volume, drawdown, realized volatility (1W–1Y)
`get_holder_supply`	LTH/STH supply breakdown, circulating supply
`get_holder_valuation`	Realized cap/price, MVRV, thermo cap, delta cap, balanced price, investor cap
`get_holder_profit`	NUPL, realized/unrealized P/L, SOPR — LTH/STH breakdowns (Pro tier)
`get_cohort_metrics`	Age cohort supply, realized cap, realized price (12 age brackets)
`get_utxo_history`	UTXO set breakdown by age cohort
`get_coindays`	Coin Days Destroyed, liveliness, vaultedness, dormancy, dormancy flow
`get_blockchain`	Block height, blocks mined
`get_cycle_performance`	Cycle performance indexed from lows, ATHs, halvings
`get_latest_metrics`	Latest snapshot across all categories
`render_chart`	Render any metric as PNG with annotations and templates

Metrics Coverage (127 total)

Market Data (27 metrics)

Price, OHLC, volume, market cap, drawdown from ATH, 6 realized volatility windows (1W, 2W, 1M, 3M, 6M, 1Y), cycle performance, and individual cycle tracks from lows, ATHs, and halvings.

Supply (16 metrics)

Circulating supply, LTH/STH supply, cost basis distribution heatmap, and 12 age cohort supplies (<24h through 10y+) for HODL Waves analysis.

Valuation (41 metrics)

Realized cap, realized price, MVRV (aggregate + LTH/STH), thermo cap, delta cap, average cap, balanced price, investor cap, market cap/thermo cap ratio, and 24 age cohort realized prices and caps.

Profitability (12 metrics)

NUPL, unrealized/realized P/L, SOPR — each with aggregate, LTH, and STH breakdowns.

Coin Days (11 metrics)

Coin Days Destroyed (CDD), binary CDD, supply-adjusted CDD, liveliness, vaultedness, dormancy, dormancy flow, net coin days, coin days accumulated, transferred price, transfer volume.

ETF Analytics (11 metrics)

Total BTC holdings, AUM, net/cumulative flows, cumulative money flow, ETF realized price, US Spot ETF realized price, US Spot cumulative money flow, BTC dominance, US BTC holdings, ETF premium average.

Blockchain (2 metrics)

Block height, blocks mined.

Chart Rendering

The render_chart tool generates PNG charts inline in the conversation.

Quick examples:

render_chart({ metric: "price", days: 365 })render_chart({ template: "mvrv_ratio" })render_chart({ metrics: ["lth_supply", "sth_supply"], style: "area" })render_chart({ metric: "dormancy_flow", overlay: "price" })render_chart({ template: "realized_volatility", days: 730 })

render_chart({ metric: "price", days: 365 })render_chart({ template: "mvrv_ratio" })render_chart({ metrics: ["lth_supply", "sth_supply"], style: "area" })render_chart({ metric: "dormancy_flow", overlay: "price" })render_chart({ template: "realized_volatility", days: 730 })

Annotations — reference lines and areas:

render_chart({  metric: "lth_mvrv",  reference_lines: [    { "y": 3.5, "label": "Overheated", "stroke": "#ef4444", "dash": "3 3" }  ],  reference_areas: [    { "y1": 0, "y2": 0.85, "label": "Undervalued", "fill": "#22c55e", "fill_opacity": 0.15 }  ]})

render_chart({  metric: "lth_mvrv",  reference_lines: [    { "y": 3.5, "label": "Overheated", "stroke": "#ef4444", "dash": "3 3" }  ],  reference_areas: [    { "y1": 0, "y2": 0.85, "label": "Undervalued", "fill": "#22c55e", "fill_opacity": 0.15 }  ]})

Example Prompts

"What's Bitcoin's current MVRV ratio and what does it say about valuation?"
"Show me realized volatility — is short-term vol higher than long-term?"
"Chart dormancy flow with price overlay for the last 2 years"
"Compare LTH and STH supply trends over 90 days"
"Are long-dormant coins waking up? Check liveliness and CDD"
"Show cycle performance from each halving — are we tracking historical patterns?"
"What's the current NUPL level? Is the market in euphoria or fear?"

Access Tiers

License

MIT

Source: README.md at commit 8cc2dc0

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v0.4.3LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts
Declare a license in the repository or the registry entry.

Tier	History	Metrics	Daily Requests
Demo (no key)	60 days	Basic (grade 0)	Unlimited
Pro ($50/mo)	Unlimited	All grade 0–1	10,000
Enterprise ($900/mo)	Unlimited	All grade 0–2	100,000

Blocklens Mcp Server

Overview

Installation

In SourceWeft

Other MCP clients

README

blocklens-mcp-server

Quick Start

Remote Access (No Install)

Local Install

Claude Desktop

Cursor / Windsurf

Demo Mode (No API Key)

Available Tools (15)

Metrics Coverage (127 total)

Market Data (27 metrics)

Supply (16 metrics)

Valuation (41 metrics)

Profitability (12 metrics)

Coin Days (11 metrics)

ETF Analytics (11 metrics)

Blockchain (2 metrics)

Chart Rendering

Example Prompts

Access Tiers

Links

License

Tools

Version history

Score