Kronos Crypto Data MCP Server

Real-time crypto market data for AI agents — derivatives (funding / OI / basis), liquidations, options IV, GEX, CEX premium, multi-source price, realized volatility, market-regime detection, and TradFi macro across 16 assets. An optional ML price forecast is available as a premium add-on.

x402-native: no API key, no signup. An autonomous agent discovers this server and pays per call in USDC on Base via the x402 micropayment protocol. There is no dashboard, no account, no API-key provisioning — just point a funded wallet at it and call. That is the one thing incumbent crypto-data MCPs (CoinGecko / CoinMarketCap / CoinGlass) cannot do.

• Data-first. 19 paid data tools covering derivatives, liquidations, options, macro, and screeners.
• Pay-per-call. Prices from $0.001 per call, settled on-chain in USDC — you pay only for what you use.
• Wallet-optional boot. The free get_sample tool works with no wallet at all.

Wallet-optional boot

The server boots and responds to initialize + tools/list without any environment variables set. Free tools (like get_sample) work without a wallet. Paid tools return a clear error if BUYER_PRIVATE_KEY is missing or the wallet has insufficient USDC — they never crash the server.

Quick start

Add the server to your MCP client config. For paid tools, set BUYER_PRIVATE_KEY to a wallet funded with USDC on Base. Omit the env block entirely to run only the free get_sample tool.

{
  "mcpServers": {
    "kronos-crypto-data": {
      "command": "npx",
      "args": ["crypto-derivatives-mcp"],
      "env": {
        "BUYER_PRIVATE_KEY": "0x<your-funded-wallet-private-key>"
      }
    }
  }
}

That's it — no signup, no API key. The first paid call triggers an on-chain USDC micropayment and returns both the data and the settlement tx hash.

Tools

Data & derivatives

Tool	Description	Cost
get_derivatives	Full derivatives snapshot: funding rate, annualized funding, OI, 1h OI change, basis, funding trend, plain-English read	$0.02
get_funding_rate	Perpetual funding rate + annualized rate. Positive = bullish lean, negative = bearish lean	$0.02
get_open_interest	Open interest and 1-hour OI change. Rising OI + rising price = strong trend	$0.02
get_market_regime	Market regime: squeeze / breakout / funding-extreme / OI-surge / normal	$0.02
get_price	Real-time spot price for an asset	$0.001
get_snapshot	Everything-in-one snapshot: funding, OI, basis, regime, and forecast	$0.04
get_market_overview	Funding rate + OI snapshot across all 16 assets at once	$0.02
get_funding_extremes	Screener: assets with the most extreme funding rates right now	$0.003
get_fear_greed	Current crypto Fear & Greed index score and classification	$0.001
get_ohlc	OHLCV candlestick data. Optional: interval (1h,4h,1d) and limit	$0.001
get_volatility	Realized volatility metrics for an asset	$0.01
get_alerts	Regime alerts for an asset: squeeze, breakout, funding-extreme, OI-surge, or normal	$0.02
get_market_scan	Market-wide screen across up to 16 assets ranked by signal strength and regime state. Optional assets filter	$0.04
get_macro	TradFi macro snapshot: VIX, DXY, 10Y yield, SPX, gold — plus BTC correlations	$0.001
get_digest	Structured market narrative: machine-readable digest of funding, OI, regime, and forecast signals	$0.02
get_liquidations	Liquidation cluster-map and recent OKX liquidation prints. Identifies high-density price levels	$0.003
get_options_iv	Options implied volatility, skew, and term-structure. BTC and ETH only	$0.03
get_gex	Gamma exposure (GEX) and max-pain price. BTC and ETH only	$0.04
get_cex_premium	Coinbase premium: spot price difference between Coinbase and global aggregated price	$0.02

Forecast (premium add-on)

A predictive signal layered on top of the data — not financial advice.

Tool	Description	Cost
get_forecast	Kronos price forecast at 1h, 4h, or 24h horizon. Full ML model for btc/eth/sol; beta composite model for doge/xrp/bnb	$0.01 (btc/eth/sol) · $0.001 beta (doge/xrp/bnb)
get_forecast_ledger	Machine-readable resolved-forecast accuracy history. Optional: asset, horizon, limit	$0.001

Free

Tool	Description	Cost
get_sample	Sample data — explore the response format without paying or funding a wallet	Free

All asset-scoped tools (except get_options_iv and get_gex) accept asset from: btc, eth, sol, bnb, xrp, doge, ada, avax, link, dot, ltc, trx, bch, atom, near, apt.

get_options_iv and get_gex accept btc or eth only. Forecasts are available only for btc/eth/sol (full ML) and doge/xrp/bnb (beta composite).

Install

npx (recommended)

Use the config in Quick start above.

BUYER_PRIVATE_KEY is optional at boot — the server starts without it. Omit the env block entirely to use only the free get_sample tool, or add the key when you need paid data.

Local clone

git clone https://github.com/hashchecked/kronos-mcp.git
cd kronos-mcp
npm install
npm run build

Then in your MCP client config:

{
  "mcpServers": {
    "kronos-crypto-data": {
      "command": "node",
      "args": ["/absolute/path/to/kronos-mcp/dist/index.js"],
      "env": {
        "BUYER_PRIVATE_KEY": "0x<your-funded-wallet-private-key>"
      }
    }
  }
}

How payment works

When a paid tool is called, the server makes an HTTP GET to the Kronos API. The API returns HTTP 402 with the price and pay-to address. The server's x402 library builds an EIP-3009 transferWithAuthorization signed by the configured wallet and sends it in the retry request header. The x402 facilitator submits the on-chain transaction (paying gas). The settlement tx hash is returned alongside the data.

What to configure:

• BUYER_PRIVATE_KEY — hex private key for a wallet funded with USDC on Base mainnet (eip155:8453). No ETH needed; x402 uses gasless EIP-3009 transfers.
• USDC contract on Base: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Use a dedicated wallet. Fund it with only as much USDC as you need.

Error messages

Situation	Error returned
Paid tool called, no key set	Payment required — BUYER_PRIVATE_KEY is not set...
Paid tool called, wallet has no USDC	Payment failed — the configured wallet has insufficient USDC on Base mainnet... Fund the wallet at 0x... with USDC on Base...

Environment Variables

Variable	Required	Default	Description
BUYER_PRIVATE_KEY	No (free tools work without it)	—	Hex private key for wallet funded with USDC on Base mainnet
BASE_URL	No	https://kronossignals.com	Kronos API base URL
NETWORK	No	eip155:8453	EIP-155 chain ID (8453 = Base mainnet)

Security

Never commit your private key to version control. The .gitignore excludes .env and .env.*. Use a dedicated wallet with a limited USDC balance. For production deployments, supply the key via a secrets manager.

The forecast tools provide a premium predictive signal, not financial advice. No accuracy or performance is guaranteed; get_forecast_ledger exposes the raw resolved-forecast history so you can judge it yourself.