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.