Free Bitcoin on-chain analytics API & MCP server: MVRV, NUPL, SOPR, exchange flows, whales
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Explain one metric before using its numbers: what it shows, how to read it, caveats, formula, payload fields with units, input data categories, update cadence, known limitations and freshness (last data day, published_at, granularities), plus the page URL, the REST endpoint and a ready citation string. Call it when the user asks what a metric means or before interpreting get_chart output.
Chart id from list_charts, e.g. "sopr".
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http charts https://kotecharts.com/api/v1/mcp
Explain one metric before using its numbers: what it shows, how to read it, caveats, formula, payload fields with units, input data categories, update cadence, known limitations and freshness (last data day, published_at, granularities), plus the page URL, the REST endpoint and a ready citation string. Call it when the user asks what a metric means or before interpreting get_chart output.
| Argument | Type | Description |
|---|---|---|
| id* | string | Chart id from list_charts, e.g. "sopr". |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Chart id from list_charts, e.g. \"sopr\"."
}
},
"additionalProperties": false
}Fetch the historical values of one chart as JSON rows {t, …fields} (units per field: describe_chart → fields). Use for trends, history and comparisons; use get_latest when only the current value matters. Time series are downsampled to maxPoints (default 500, max 2000; first/last points preserved). Use from/to (YYYY-MM-DD or an exact UTC timestamp) to window and granularity (5m|day|3day|week|month|year) where available. Five-minute data is retained for 30 days; daily data is closed-only unless includePartial=true explicitly requests the still-open UTC day. That row is partial:true with partialMethod (trailing24h: rolling 24h ending at asOf, comparable with closed days; asOf: a level as of asOf), estimated (true = blended from yesterday, not exact 5m data) and coverage (share of the UTC day elapsed); never sum it with closed days.
| Argument | Type | Description |
|---|---|---|
| id* | string | Chart id from list_charts, e.g. "mvrv-z-score". |
| to | string | Inclusive end, YYYY-MM-DD or UTC timestamp (…Z). Omit for "up to now". |
| from | string | Inclusive start, YYYY-MM-DD or UTC timestamp (…Z). Omit for full history. |
| exchange | string | Venue scope for exchange-netflow only; default all. |
| maxPoints | integer | Max rows returned after even downsampling (default 500). |
| granularity | string | Bucket size; must be one of the chart's availableGranularities (describe_chart). |
| includePartial | boolean | granularity=day only: append the still-open UTC day as a partial:true row. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Chart id from list_charts, e.g. \"mvrv-z-score\"."
},
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?Z)?$",
"description": "Inclusive end, YYYY-MM-DD or UTC timestamp (…Z). Omit for \"up to now\"."
},
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?Z)?$",
"description": "Inclusive start, YYYY-MM-DD or UTC timestamp (…Z). Omit for full history."
},
"exchange": {
"enum": [
"all",
"binance",
"binance-us",
"okx",
"bybit",
"coinbase",
"coinbase-prime",
"kraken",
"kucoin",
"htx"
],
"type": "string",
"description": "Venue scope for exchange-netflow only; default all."
},
"maxPoints": {
"type": "integer",
"maximum": 2000,
"minimum": 10,
"description": "Max rows returned after even downsampling (default 500)."
},
"granularity": {
"enum": [
"5m",
"day",
"3day",
"week",
"month",
"year"
],
"type": "string",
"description": "Bucket size; must be one of the chart's availableGranularities (describe_chart)."
},
"includePartial": {
"type": "boolean",
"description": "granularity=day only: append the still-open UTC day as a partial:true row."
}
},
"additionalProperties": false
}Answer "what is X now?": the most recent data point for one chart (plus the previous point for context) with asOf metadata (last data day, published_at, analysed block height). Distributions return the current snapshot; ranked lists return the top 10. exchange selects a venue for exchange-netflow only.
| Argument | Type | Description |
|---|---|---|
| id* | string | Chart id from list_charts, e.g. "nupl". |
| exchange | string | Venue scope for exchange-netflow only; default all. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Chart id from list_charts, e.g. \"nupl\"."
},
"exchange": {
"enum": [
"all",
"binance",
"binance-us",
"okx",
"bybit",
"coinbase",
"coinbase-prime",
"kraken",
"kucoin",
"htx"
],
"type": "string",
"description": "Venue scope for exchange-netflow only; default all."
}
},
"additionalProperties": false
}Discover which Bitcoin on-chain metrics exist. Returns every public chart with id, title, one-line blurb, category and formula. Call this FIRST to find a chart id (e.g. "mvrv", "exchange", "whale"), then use describe_chart / get_chart / get_latest with that id. Read-only, no side effects; the human page of each chart is https://kotecharts.com/c/{id}.
| Argument | Type | Description |
|---|---|---|
| query | string | Optional case-insensitive substring matched against id, title, blurb and category, e.g. "sopr" or "Exchange". Omit to list all. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"query": {
"type": "string",
"maxLength": 80,
"description": "Optional case-insensitive substring matched against id, title, blurb and category, e.g. \"sopr\" or \"Exchange\". Omit to list all."
}
},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 16, 2026.