{
  "markdown": "# blocklens-mcp-server\n\nMCP (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.\n\n## Quick Start\n\n### Remote Access (No Install)\n\nConnect directly to the hosted endpoint — no packages, no local setup:\n\n**Claude.ai (Browser):** Settings → Connectors → Add → URL: `https://mcp.blocklens.co`\n\n**Claude Desktop / Cursor / Windsurf (via mcp-remote):**\n```json\n{\n  \"mcpServers\": {\n    \"blocklens\": {\n      \"command\": \"npx\",\n      \"args\": [\"mcp-remote\", \"https://mcp.blocklens.co\"]\n    }\n  }\n}\n```\n\n**Any MCP HTTP client:** POST to `https://mcp.blocklens.co` ([Streamable HTTP](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http) transport)\n\n### Local Install\n\n#### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"blocklens\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"blocklens-mcp-server\"],\n      \"env\": {\n        \"BLOCKLENS_API_KEY\": \"blk_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n**Config file location:**\n- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n#### Cursor / Windsurf\n\nAdd to your MCP config (`.cursor/mcp.json`):\n\n```json\n{\n  \"blocklens\": {\n    \"command\": \"npx\",\n    \"args\": [\"-y\", \"blocklens-mcp-server\"],\n    \"env\": {\n      \"BLOCKLENS_API_KEY\": \"blk_your_key_here\"\n    }\n  }\n}\n```\n\n#### Demo Mode (No API Key)\n\nWorks 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.\n\n## Available Tools (15)\n\n| Tool | Description |\n|------|-------------|\n| `list_metrics` | List all 127 available metrics with categories and tiers |\n| `search_metrics` | Search metrics by keyword |\n| `get_metric` | Get full definition of a single metric |\n| `get_categories` | List metric categories with counts |\n| `get_prices` | BTC daily OHLC, market cap, volume, drawdown, realized volatility (1W–1Y) |\n| `get_holder_supply` | LTH/STH supply breakdown, circulating supply |\n| `get_holder_valuation` | Realized cap/price, MVRV, thermo cap, delta cap, balanced price, investor cap |\n| `get_holder_profit` | NUPL, realized/unrealized P/L, SOPR — LTH/STH breakdowns (Pro tier) |\n| `get_cohort_metrics` | Age cohort supply, realized cap, realized price (12 age brackets) |\n| `get_utxo_history` | UTXO set breakdown by age cohort |\n| `get_coindays` | Coin Days Destroyed, liveliness, vaultedness, dormancy, dormancy flow |\n| `get_blockchain` | Block height, blocks mined |\n| `get_cycle_performance` | Cycle performance indexed from lows, ATHs, halvings |\n| `get_latest_metrics` | Latest snapshot across all categories |\n| `render_chart` | Render any metric as PNG with annotations and templates |\n\n## Metrics Coverage (127 total)\n\n### Market Data (27 metrics)\nPrice, 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.\n\n### Supply (16 metrics)\nCirculating supply, LTH/STH supply, cost basis distribution heatmap, and **12 age cohort supplies** (<24h through 10y+) for HODL Waves analysis.\n\n### Valuation (41 metrics)\nRealized 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.\n\n### Profitability (12 metrics)\nNUPL, unrealized/realized P/L, SOPR — each with aggregate, LTH, and STH breakdowns.\n\n### Coin Days (11 metrics)\nCoin Days Destroyed (CDD), binary CDD, supply-adjusted CDD, liveliness, vaultedness, dormancy, dormancy flow, net coin days, coin days accumulated, transferred price, transfer volume.\n\n### ETF Analytics (11 metrics)\nTotal 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.\n\n### Blockchain (2 metrics)\nBlock height, blocks mined.\n\n## Chart Rendering\n\nThe `render_chart` tool generates PNG charts inline in the conversation.\n\n**Quick examples:**\n```\nrender_chart({ metric: \"price\", days: 365 })\nrender_chart({ template: \"mvrv_ratio\" })\nrender_chart({ metrics: [\"lth_supply\", \"sth_supply\"], style: \"area\" })\nrender_chart({ metric: \"dormancy_flow\", overlay: \"price\" })\nrender_chart({ template: \"realized_volatility\", days: 730 })\n```\n\n**Annotations — reference lines and areas:**\n```\nrender_chart({\n  metric: \"lth_mvrv\",\n  reference_lines: [\n    { \"y\": 3.5, \"label\": \"Overheated\", \"stroke\": \"#ef4444\", \"dash\": \"3 3\" }\n  ],\n  reference_areas: [\n    { \"y1\": 0, \"y2\": 0.85, \"label\": \"Undervalued\", \"fill\": \"#22c55e\", \"fill_opacity\": 0.15 }\n  ]\n})\n```\n\n## Example Prompts\n\n- \"What's Bitcoin's current MVRV ratio and what does it say about valuation?\"\n- \"Show me realized volatility — is short-term vol higher than long-term?\"\n- \"Chart dormancy flow with price overlay for the last 2 years\"\n- \"Compare LTH and STH supply trends over 90 days\"\n- \"Are long-dormant coins waking up? Check liveliness and CDD\"\n- \"Show cycle performance from each halving — are we tracking historical patterns?\"\n- \"What's the current NUPL level? Is the market in euphoria or fear?\"\n\n## Access Tiers\n\n| Tier | History | Metrics | Daily Requests |\n|------|---------|---------|----------------|\n| **Demo** (no key) | 60 days | Basic (grade 0) | Unlimited |\n| **Pro** ($50/mo) | Unlimited | All grade 0–1 | 10,000 |\n| **Enterprise** ($900/mo) | Unlimited | All grade 0–2 | 100,000 |\n\n## Links\n\n- [Remote MCP Endpoint](https://mcp.blocklens.co)\n- [Blocklens](https://blocklens.co)\n- [Full Documentation](https://docs.blocklens.co/api/mcp-server)\n- [Metrics Reference](https://docs.blocklens.co/metrics)\n- [API Reference](https://api.blocklens.co/docs)\n- [Get API Key](https://blocklens.co/api-keys)\n- [MCP Protocol](https://modelcontextprotocol.io)\n\n## License\n\nMIT\n",
  "bytes": 6084,
  "sha": "8dd1dc0ab865923c6776cb5c9d05ca993c23d0b6fcac2be1d1ac9ebf7b0c6ac9",
  "repo_slug": "blocklens/blocklens-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_blocklens_blocklens_mcp_server_2bdbfa40/readme"
}