# Kronos Crypto Data MCP server

> Provides real-time crypto derivatives, liquidations, options IV, and market regime data via pay-per-call micropayments.

- Repository: https://github.com/hashchecked/kronos-mcp
- Page: https://hostedmcp.org/servers/hashchecked/kronos-mcp
- Transport: stdio
- Stars: 0
- Latest version: 0.6.1

## Install

### Claude Code

```sh
claude mcp add kronos-mcp -- npx -y crypto-derivatives-mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "kronos-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "crypto-derivatives-mcp"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "kronos-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "crypto-derivatives-mcp"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"kronos-mcp","type":"stdio","command":"npx","args":["-y","crypto-derivatives-mcp"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "kronos-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "crypto-derivatives-mcp"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add kronos-mcp -- npx -y crypto-derivatives-mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.kronos-mcp]
command = "npx"
args = ["-y", "crypto-derivatives-mcp"]
```

### Gemini CLI

```sh
gemini mcp add -s user kronos-mcp npx -- -y crypto-derivatives-mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "kronos-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "crypto-derivatives-mcp"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `BUYER_PRIVATE_KEY` | no | no |  |

## Tools (22)

- `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`
- `get_market_scan`
- `get_macro`
- `get_digest`
- `get_liquidations`
- `get_options_iv`
- `get_gex`
- `get_cex_premium`
- `get_forecast`
- `get_forecast_ledger`
- `get_sample`

## FAQ

### 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.
