# blocklens-mcp-server

**Category:** 📊 Monitoring  
**Repository:** https://github.com/blocklens/blocklens-mcp-server  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/blocklens-mcp-server

## Description
Bitcoin on-chain analytics: 85+ metrics including MVRV, SOPR, realized price, holder data

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

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

## Documentation & README

# blocklens-mcp-server

MCP (Model Context Protocol) server for [Blocklens](https://blocklens.co) 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"]
    }
  }
}
```

**Any MCP HTTP client:** POST to `https://mcp.blocklens.co` ([Streamable HTTP](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#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"
      }
    }
  }
}
```

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

#### 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](https://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 })
```

**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 }
  ]
})
```

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

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

## Links

- [Remote MCP Endpoint](https://mcp.blocklens.co)
- [Blocklens](https://blocklens.co)
- [Full Documentation](https://docs.blocklens.co/api/mcp-server)
- [Metrics Reference](https://docs.blocklens.co/metrics)
- [API Reference](https://api.blocklens.co/docs)
- [Get API Key](https://blocklens.co/api-keys)
- [MCP Protocol](https://modelcontextprotocol.io)

## License

MIT