Repository avatar
AI Tools
v1.1.2
active

charts

com.kotecharts/charts

Free Bitcoin on-chain analytics API & MCP server: MVRV, NUPL, SOPR, exchange flows, whales

Documentation

Kote Charts — Free Bitcoin On-Chain Analytics API & MCP Server

PyPI npm npm MCP proxy MCP Registry Kote Charts MCP connector CI License: MIT

110+ charts, history since 2009: MVRV, NUPL, SOPR, exchange flows and whale analytics — computed from our own Bitcoin full node, free, with a public REST API, a keyless MCP server for AI agents, and machine-readable methodology for every metric.

Website · Charts · API docs · MCP · Methodology · OpenAPI · llms.txt

MCP serverhttps://kotecharts.com/api/v1/mcp — Streamable HTTP, no key (60 req/min per IP; a free key gives 3 req/s)
REST APIhttps://kotecharts.com/api/v1/public/charts/{id} — free key, 3 req/s
Metric cataloghttps://kotecharts.com/api/v1/metrics — formula, fields + units, input categories, cadence, limitations, freshness — no key
Pythonpip install kotecharts → python/
TypeScript / JSnpm i kotecharts → typescript/
stdio MCPnpx -y kotecharts-mcp → mcp-proxy/

30-second start

Give your AI agent Bitcoin on-chain data (Claude Code):

claude mcp add --transport http kote-charts https://kotecharts.com/api/v1/mcp

Then ask: "Where is Bitcoin in its cycle according to MVRV Z-Score and NUPL? Cite the charts." Other clients (Claude Desktop, ChatGPT, Cursor, VS Code, Windsurf, Gemini CLI, Codex) → integrations/.

Read the methodology of any metric — no key:

curl -s https://kotecharts.com/api/v1/metrics/mvrv-z-score | jq '.data | {formula, fields, sources, limitations, lastT}'

Pull data with a free key from kotecharts.com/account:

curl -H "Authorization: Bearer $KOTE_API_KEY" \
  "https://kotecharts.com/api/v1/public/charts/mvrv-z-score?from=2025-01-01&granularity=week"
from kotecharts import KoteCharts

kc = KoteCharts()  # reads KOTE_API_KEY
df = kc.chart("mvrv-z-score", start="2020-01-01", granularity="week").to_pandas()
import { KoteCharts } from 'kotecharts';

const kc = new KoteCharts(); // reads KOTE_API_KEY
const nupl = await kc.latest('nupl');

What's inside

CategoryExamples
ValuationMVRV, MVRV Z-Score, NUPL, Puell Multiple, Mayer Multiple, stock-to-flow, power law
Realized metricsSOPR, aSOPR, STH/LTH SOPR, realized cap & price, realized P&L
Coin ageHODL waves, coin days destroyed, dormancy, age-band realized cap
Exchange flows & whalesexchange netflow (per venue), reserves, whale ratio, whale accumulation, whale→exchange
Holders & supplyLTH/STH supply, supply in profit, balance cohorts
Network & feestransactions, active addresses, fees, block interval, UTXO set
Cross-asset & ETFsspot ETF flows, BTC vs gold / DXY / S&P 500, stablecoin supply ratio

The full, always-current list: docs/metrics.md (generated) or GET /api/v1/metrics.

Repository layout

PathWhat
docs/MCP reference (tools, resources, prompts), REST API, metric catalog, methodology
integrations/Copy-paste setup for Claude, ChatGPT, Cursor, VS Code, Windsurf, Gemini CLI, Codex, agent frameworks
python/kotecharts on PyPI — sync + async client, pandas helper
typescript/kotecharts on npm — zero-dependency fetch client, types from OpenAPI
mcp-proxy/kotecharts-mcp on npm — stdio ↔ hosted MCP bridge
examples/Python and TypeScript scripts, agent examples
skills/kote-charts/Agent Skill: how an agent should use and cite the data
server.jsonOfficial MCP Registry manifest (com.kotecharts/charts)

Data, license and attribution

  • Code in this repository: MIT.
  • Data from kotecharts.com: free for personal, educational and other non-commercial use with attribution — see DATA-LICENSE.md. Cite "Kote Charts" and link the chart page https://kotecharts.com/c/{id} (every API/MCP answer carries a ready cite string).
  • Educational only — not financial advice. Metrics are descriptive, not forecasts; read each metric's limitations.

How the data is made

Every on-chain metric is computed from a Bitcoin full node we operate ourselves (every block since the 2009 genesis block) and a UTXO cost-basis index built from it; market inputs come from public market data. Exchange and whale metrics rely on address labels and clustering, which are heuristic. Details: methodology · machine-readable: GET /api/v1/metrics.

NPM
kotecharts-mcp
Install Command
npm install kotecharts-mcp