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"
      }
    }
  }
}

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):

{
  "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)

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

... View full README on GitHub