crypto-derivatives-mcp

Kronos Crypto Data MCP Server

Real-time crypto data for AI agents — derivatives, forecasts, alerts, liquidations, options IV, GEX, macro, digest, screeners, and sentiment. Pay-per-call via x402 on Base (no signup, no API key). 22 tools covering 16 assets.

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.

Tools

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_forecast	Kronos ML price forecast at 1h, 4h, or 24h horizon	$0.01
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.02
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.02
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
get_forecast_ledger	Machine-readable resolved-forecast accuracy history. Optional: asset, horizon, limit	$0.001
get_sample	Free sample data — explore the response format without paying	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.

Install

npx (recommended)

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

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.