
Blocklens Mcp Server
Connects Claude to Blocklens's Bitcoin on-chain analytics engine with 127 metrics computed from raw blockchain data. You get 15 tools covering market data, supply distribution, valuation models (MVRV, NUPL, SOPR), HODL waves across 12 age cohorts, coin days destroyed, liveliness, dormancy flow, and cycle performance indexed from halvings and ATHs. The render_chart tool generates annotated PNGs inline for any metric or combination. Works in demo mode without an API key (60 days of basic metrics), or connect with a Pro/Enterprise key for full history and LTH/STH breakdowns. Reach for this when you're analyzing Bitcoin market cycles, holder behavior, or on-chain valuation models and need Claude to pull live data and generate charts in conversation.
- tools
- 15
- auth
- Secret needed
- transport
- STDIO
- env var
- 1
- last updated
- Mar 8, 2026
Tools
15 toolsPublic tool metadata for what this MCP can expose to an agent.
list_metricsList all 127 available metrics with categories and tiers
List all 127 available metrics with categories and tiers
No parameter schema in public metadata yet.
search_metricsSearch metrics by keyword
Search metrics by keyword
No parameter schema in public metadata yet.
get_metricGet full definition of a single metric
Get full definition of a single metric
No parameter schema in public metadata yet.
get_categoriesList metric categories with counts
List metric categories with counts
No parameter schema in public metadata yet.
get_pricesBTC daily OHLC, market cap, volume, drawdown, realized volatility (1W–1Y)
BTC daily OHLC, market cap, volume, drawdown, realized volatility (1W–1Y)
No parameter schema in public metadata yet.
get_holder_supplyLTH/STH supply breakdown, circulating supply
LTH/STH supply breakdown, circulating supply
No parameter schema in public metadata yet.
get_holder_valuationRealized cap/price, MVRV, thermo cap, delta cap, balanced price, investor cap
Realized cap/price, MVRV, thermo cap, delta cap, balanced price, investor cap
No parameter schema in public metadata yet.
get_holder_profitNUPL, realized/unrealized P/L, SOPR — LTH/STH breakdowns (Pro tier)
NUPL, realized/unrealized P/L, SOPR — LTH/STH breakdowns (Pro tier)
No parameter schema in public metadata yet.
get_cohort_metricsAge cohort supply, realized cap, realized price (12 age brackets)
Age cohort supply, realized cap, realized price (12 age brackets)
No parameter schema in public metadata yet.
get_utxo_historyUTXO set breakdown by age cohort
UTXO set breakdown by age cohort
No parameter schema in public metadata yet.
get_coindaysCoin Days Destroyed, liveliness, vaultedness, dormancy, dormancy flow
Coin Days Destroyed, liveliness, vaultedness, dormancy, dormancy flow
No parameter schema in public metadata yet.
get_blockchainBlock height, blocks mined
Block height, blocks mined
No parameter schema in public metadata yet.
get_cycle_performanceCycle performance indexed from lows, ATHs, halvings
Cycle performance indexed from lows, ATHs, halvings
No parameter schema in public metadata yet.
get_latest_metricsLatest snapshot across all categories
Latest snapshot across all categories
No parameter schema in public metadata yet.
render_chartRender any metric as PNG with annotations and templates
Render any metric as PNG with annotations and templates
No parameter schema in public metadata yet.
Sponsors
Configuration
BLOCKLENS_API_KEY*secretBlocklens API key (get one at https://blocklens.co/settings)
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):
{
"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:
{
"mcpServers": {
"blocklens": {
"command": "npx",
"args": ["-y", "blocklens-mcp-server"],
"env": {
"BLOCKLENS_API_KEY": "blk_your_key_here"
}
}
}
}
Details
- Repository
- github.com/blocklens/blocklens-mcp-server
- Website
- blocklens.co
- Categories
- Monitoring & Observability, Finance & Commerce
- Package
blocklens-mcp-server- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active