llms.txt Content
# Blocklens
> Bitcoin on-chain analytics platform — 210+ metrics, REST API, MCP server, interactive charts, heatmap rendering.
Blocklens provides Bitcoin on-chain analytics derived from self-hosted full nodes with raw UTXO-level analysis since the genesis block (2009). Also tracks Bitcoin ETF data across 27 global ETF products.
## AI Integration (MCP)
**Recommended way to access Blocklens data from AI assistants:**
### Remote MCP Server (No Install)
Connect directly to the hosted endpoint — no packages, no local setup:
- **Endpoint:** `https://mcp.blocklens.co` (Streamable HTTP transport)
- **Claude.ai:** Settings → Connectors → Add → URL: `https://mcp.blocklens.co`
- **Claude Desktop (via mcp-remote):**
```json
{
"mcpServers": {
"blocklens": {
"command": "npx",
"args": ["mcp-remote", "https://mcp.blocklens.co"]
}
}
}
```
### Local Install (Alternative)
Install via npm for stdio-based MCP clients:
```
npx blocklens-mcp-server
```
Or add to your MCP config (Claude Desktop, Cursor, etc.):
```json
{
"mcpServers": {
"blocklens": {
"command": "npx",
"args": ["blocklens-mcp-server"]
}
}
}
```
Both methods provide the same 19 tools covering all Blocklens analytics — no API key needed for demo-tier data.
### Key MCP Capabilities
- **render_chart**: Generate PNG chart images with any metric combination
- **Cycle overlay charts**: Compare Bitcoin cycles using `x_axis: "day_offset"` — all cycles start at Day 0 for visual comparison. Metrics: cycle_ath_1..5, cycle_low_1..4, cycle_halving_1..4
- **Heatmap rendering**: Cost basis distribution heatmap via `heatmap_id: "cost-basis-distribution"` with viridis/soft/plasma color scales
- **Formulas**: Compute derived metrics (ratios, differences) with `m1 / m2` expressions
- **Custom axes**: Multi-axis charts with vertical zones, reference lines, shaded areas
- Remote endpoint: https://mcp.blocklens.co
- npm: https://www.npmjs.com/package/blocklens-mcp-server
-