list_metricsList all available on-chain metrics with descriptions, categories, and tier requirements. Returns id, name, description, category, unit, endpoint, and
get_pricesGet daily OHLC prices (open/high/low/close in USD), market cap, and 24h trading volume. Returns one row per day, newest first.
get_holder_supplyGet Bitcoin holder supply breakdown: Long-Term Holder (LTH) supply, Short-Term Holder (STH) supply, and circulating supply. LTH = held >155 days, STH
get_holder_valuationGet Bitcoin valuation metrics: Realized Cap (USD), Realized Price (USD), LTH/STH Realized Cap and Price, MVRV ratio (Market Value / Realized Value), a
get_holder_profitGet Bitcoin profit metrics: LTH/STH Realized P/L (USD) and SOPR (Spent Output Profit Ratio). SOPR > 1 means coins moved at profit; < 1 means at loss.
get_cohort_metricsGet age cohort metrics: supply (BTC), realized cap (USD), and realized price (USD) for a specific UTXO age bracket. 12 cohorts from <24h to 10y+. Used
get_utxo_historyGet UTXO set breakdown by age cohort. Shows token amounts (BTC) and USD values for each cohort date. Useful for analyzing coin dormancy and accumulati
get_latest_metricsGet the most recent snapshot across all metric categories (price, supply, valuation, profit) in a single call. Ideal for a quick market overview witho
search_metricsSearch available metrics by name or description. Returns matching metrics with their IDs, API endpoints, access tiers, and descriptions. Use this to d
get_metricGet the full definition of a single metric by its ID. Returns name, description, category, endpoint, unit, access tier, documentation, and related met
get_categoriesList all metric categories with counts and metric IDs in each. Categories include: price, supply, valuation, profit. Useful for discovering what data
get_coindaysGet Coin Days metrics: CDD, binary CDD, supply-adjusted CDD, liveliness, vaultedness, dormancy, dormancy flow, transferred price, and transfer volume.
get_blockchainGet blockchain network metrics: block height or daily blocks mined.
get_cycle_performanceGet Bitcoin cycle performance data. Shows price progression indexed from cycle reference points (lows, ATHs, halvings). Without type parameter returns
get_cycle_boundariesGet Bitcoin market cycle boundary summaries: start/peak/bottom dates and prices, max drawdown %, days to bottom, days to recovery, total duration. Cyc
get_etf_dataGet Bitcoin ETF aggregate data: holdings, AUM, flows, dominance, realized price.
get_dat_aggregateGet Digital Asset Treasuries aggregate data: total BTC held by institutions/governments, total companies, net flows, public/private/government breakdo
get_dat_entityGet per-entity Digital Asset Treasury data: BTC holdings, AUM, net flow, realized price (cost basis per BTC), total cost basis. Common entities: Strat
+3 more tools
We re-grade npm:blocklens-mcp-server on a schedule and alert your Slack/webhook the moment its tools change or its grade drops — rug-pull insurance for the connection.
Add the wmcp.sh trust oracle as an MCP server and call grade_mcp_server / check_mcp_drift in your agent's pre-connection gate:
https://wmcp.sh/mcp/trust
readOnly vs observed behavior) layer on via the wmcp.sh proxy.