Provides real-time crypto derivatives, liquidations, options IV, and market regime data via pay-per-call micropayments.
Also known as hashchecked/kronos-mcp, kronos-mcp, crypto-derivatives-mcp
- Stars
- 0
- Tools
- 22
- Downloads, 30 days
- —
- Latest version
- 0.6.1
- Last commit
- Sep 27, 2026
- License
- —
What is Kronos Crypto Data MCP?
Kronos Crypto Data provides real-time crypto derivatives, liquidations, options IV, and market regime data via pay-per-call micropayments. It exposes 22 tools, such as get_derivatives, get_funding_rate, get_open_interest.
Summary generated from the project's README
About Kronos Crypto Data MCP server
Kronos Crypto Data provides real-time market intelligence for AI agents focusing on derivatives, liquidations, and market regimes. It covers up to 17 assets, offering specialized data such as options implied volatility, gamma exposure, and TradFi macro metrics like the VIX or DXY. Developers can access 19 different tools to retrieve everything from funding rates and open interest to machine-readable market digests.
This server uses the x402 micropayment protocol, allowing autonomous agents to pay per call using USDC on the Base network. Unlike traditional providers that require signups or API keys, this system operates via a funded wallet. Users can connect by providing a BUYER_PRIVATE_KEY in their MCP client configuration. If no key is provided, the server still boots and allows access to the free get_sample tool.
Paid tools range from $0.02 to $0.08 per request. The server supports advanced features like an ML price forecast for specific assets and a tool to check historical forecast accuracy. Because it uses gasless EIP-3009 transfers, users only need USDC on Base to interact with the paid data tools.
What you can do with it
- 1Analyze market regime shiftsAn AI agent can identify if a market is in a squeeze, breakout, or funding-extreme state.
- 2Monitor liquidation clustersA developer can use the server to find high-density price levels where liquidations are likely to occur.
- 3Execute automated micropaymentsAn autonomous agent can pay for specific data points using USDC without needing a manual account or API key.
- 4Retrieve options market dataUsers can pull implied volatility and gamma exposure specifically for Bitcoin and Ethereum.
Written from the project's README. Every use case is checked against a quote from it.
How to install Kronos Crypto Data MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Kronos Crypto Data MCP in Claude Code
$ claude mcp add kronos-mcp -- npx -y crypto-derivatives-mcpInstall Kronos Crypto Data MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"kronos-mcp": {
"command": "npx",
"args": [
"-y",
"crypto-derivatives-mcp"
]
}
}
}Install Kronos Crypto Data MCP in VS Code
.vscode/mcp.json
{
"servers": {
"kronos-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"crypto-derivatives-mcp"
]
}
}
}Install Kronos Crypto Data MCP in VS Code CLI
$ code --add-mcp '{"name":"kronos-mcp","type":"stdio","command":"npx","args":["-y","crypto-derivatives-mcp"]}'Install Kronos Crypto Data MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"kronos-mcp": {
"command": "npx",
"args": [
"-y",
"crypto-derivatives-mcp"
]
}
}
}Install Kronos Crypto Data MCP in Codex
$ codex mcp add kronos-mcp -- npx -y crypto-derivatives-mcpInstall Kronos Crypto Data MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.kronos-mcp] command = "npx" args = ["-y", "crypto-derivatives-mcp"]
Install Kronos Crypto Data MCP in Gemini CLI
$ gemini mcp add -s user kronos-mcp npx -- -y crypto-derivatives-mcpInstall Kronos Crypto Data MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"kronos-mcp": {
"command": "npx",
"args": [
"-y",
"crypto-derivatives-mcp"
]
}
}
}Kronos Crypto Data MCP tools 22
Detected from the READMEget_derivativesget_funding_rateget_open_interestget_market_regimeget_priceget_snapshotget_market_overviewget_funding_extremesget_fear_greedget_ohlcget_volatilityget_alerts
| get_derivatives | — | |
| get_funding_rate | — | |
| get_open_interest | — | |
| get_market_regime | — | |
| get_price | — | |
| get_snapshot | — | |
| get_market_overview | — | |
| get_funding_extremes | — | |
| get_fear_greed | — | |
| get_ohlc | — | |
| get_volatility | — | |
| get_alerts | — |
Show all 22 toolsShow fewer tools
get_market_scanget_macroget_digestget_liquidationsget_options_ivget_gexget_cex_premiumget_forecastget_forecast_ledgerget_sample
| get_market_scan | — | |
| get_macro | — | |
| get_digest | — | |
| get_liquidations | — | |
| get_options_iv | — | |
| get_gex | — | |
| get_cex_premium | — | |
| get_forecast | — | |
| get_forecast_ledger | — | |
| get_sample | — |
Configuration
BUYER_PRIVATE_KEY
| Name | Description | |
|---|---|---|
| BUYER_PRIVATE_KEY | — |
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points
- Source repository linked and reachablehashchecked/kronos-mcp is public and reachablegithub.com/hashchecked/kronos-mcp ↗Pass
- Package names this repository as its sourcecrypto-derivatives-mcp names hashchecked/kronos-mcp as sourcenpmjs.com/package/crypto-derivatives-mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-09-27github.com/hashchecked/kronos-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from crypto-derivatives-mcpPass
- No critical advisory in the package or its dependencies147 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model22 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubKronos 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 up to 17 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.02 per call, settled on-chain in USDC — you pay only for what you use.
- Wallet-optional boot. The free
get_sampletool 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.02 |
get_snapshot |
Everything-in-one snapshot: funding, OI, basis, regime, and the ML forecast (btc/eth/sol only) |
$0.08 |
get_market_overview |
Funding rate + OI snapshot across all 17 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.03 |
get_ohlc |
OHLCV candlestick data. Optional: interval (1h,4h,1d) and limit |
$0.02 |
get_volatility |
Realized volatility metrics for an asset | $0.02 |
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 17 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.02 |
get_digest |
Structured market narrative: machine-readable digest of funding, OI, regime, and the ML forecast (btc/eth/sol only) |
$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 |
Forecast (premium add-on)
An optional add-on on top of the data — not financial advice. Live per-asset accuracy is free at kronossignals.com/api/stats; check it before buying.
| Tool | Description | Cost |
|---|---|---|
get_forecast |
Kronos price forecast at 1h, 4h, or 24h horizon. Kronos ML model for btc/eth/sol; doge/bnb/near/ada run it hourly, with a heuristic in between; xrp uses a composite model that has shown no directional edge |
$0.05 |
get_forecast_ledger |
Machine-readable resolved-forecast accuracy history. Optional: asset, horizon, limit | $0.02 |
Free
| Tool | Description | Cost |
|---|---|---|
get_sample |
A coarse up/down direction with a confidence bucket from the cached forecast — see the response format without paying or funding a wallet | Free |
The asset each tool accepts:
get_derivatives,get_funding_rate,get_open_interest,get_market_regime,get_alerts,get_liquidations:btc,eth,sol,bnb,xrp,doge,ada,avax,link,dot,ltc,trx,bch,atom,near,apt,hypeget_price,get_snapshot,get_ohlc,get_volatility,get_digest:btc,eth,sol,bnb,xrp,doge,ada,avax,link,dot,ltc,trx,bch,atom,near,aptget_cex_premium(Coinbase-listed only):btc,eth,sol,xrp,doge,ada,avax,link,dot,ltc,bch,atom,nearget_forecast:btc,eth,sol,doge,xrp,bnb,near,adaget_options_iv,get_gex:btc,ethget_sample:btc,eth,sol
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 are an optional add-on and not financial advice. No accuracy or performance is guaranteed; get_forecast_ledger exposes the raw resolved-forecast history so you can judge it yourself.
Kronos Crypto Data MCP questions
How do I add Kronos Crypto Data MCP to Claude Code?
Run claude mcp add kronos-mcp -- npx -y crypto-derivatives-mcp in your terminal. Add --scope user to make it available in every project.
How do I add Kronos Crypto Data MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Kronos Crypto Data MCP provide?
It exposes 22 tools, including get_derivatives, get_funding_rate, get_open_interest, get_market_regime, get_price.
Do I need an API key or to sign up?
No, the server uses the x402 micropayment protocol where an autonomous agent pays per call in USDC on Base.
How much does the data cost?
Paid tools range from $0.02 to $0.08 per call, settled on-chain in USDC.
What assets are supported?
The server supports up to 17 assets including BTC, ETH, SOL, BNB, XRP, and others for various data tools.