rgl-mcp

MCP server for RGL — Crypto Derivatives Intelligence API.

Gives AI agents (Claude, GPT, Cursor, etc.) access to real-time crypto market intelligence: vol surface, liquidation cascade warnings, regime detection, and more.

What you get

21 tools — market regime, vol surface (SVI), cascade risk, liquidation data, contagion, macro, trading signals, system health

9 prompt templates — risk assessment, cascade early warning, position sizing, entry timing, portfolio rebalance, morning brief, and more

8 resources — market overview, contagion, macro snapshot, morning brief, per-asset regime/cascade/vol-surface

Quick start

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "rgl": {
      "command": "rgl-mcp",
      "env": {
        "RGL_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code

claude mcp add rgl -- rgl-mcp

Install

pip install rgl-mcp

Or with uv:

uvx rgl-mcp

Configuration

Env var	Default	Description
RGL_API_URL	https://rgl.gokiai.com	API base URL
RGL_API_KEY	(empty)	API key for Pro/Max tier. Free tier works without a key

Free tier (no API key needed)

These tools work without an API key:

• get_market_regime — current regime (bull/bear/range/high_volatility)
• get_market_context — regime + duration stats + transition probabilities
• get_cross_asset_overview — all 20 assets at a glance
• get_regime_history — regime timeline
• get_drift / get_stability — regime change probability
• get_system_status / get_asset_list — health check
• get_contagion — cross-asset correlation network

Pro tier ($49/mo)

Everything in Free, plus:

• get_vol_surface — full IV surface with SVI parameterization (BTC/ETH)
• get_term_structure — ATM IV across expirations
• get_skew — 25-delta risk reversal and butterfly
• get_greeks — OI-weighted aggregate Greeks
• get_liquidations — time-bucketed liquidation data
• get_cascade_risk — cascade risk score (0-1)
• get_cascade_intelligence — unified cascade early warning
• get_trading_signals / get_batch_signals — all signals in one call
• get_derivatives — vol surface + liquidations + regime combined
• get_macro_snapshot — DXY, VIX, S&P 500, US 10Y, Gold

Prompt templates

Use these from Claude Desktop or any MCP client:

Prompt	Description
risk_assessment	Combine cascade + drift + stability into risk level
vol_surface_analysis	Interpret term structure, skew, Greeks
cascade_early_warning	Unified cascade assessment with urgency levels
position_sizing	Optimal position size and leverage
risk_manager_check	Risk limit go/no-go decision
market_analyst_brief	Market overview synthesis
entry_timing	Entry signal optimization
portfolio_rebalance	Multi-asset rebalancing
morning_brief	Daily market briefing

Supported assets

BTC, ETH, SOL, BNB, XRP, ADA, DOGE, AVAX, DOT, LINK, MATIC, UNI, SHIB, LTC, ATOM, NEAR, APT, ARB, OP, FIL

Vol surface (options data): BTC, ETH only.

Data sources

• Binance — OHLCV, liquidations, funding rates (20 assets)
• OKX — OHLCV, open interest, liquidations (20 assets)
• Deribit — options (IV, Greeks, OI) for BTC/ETH
• BitFlyer — funding rates

Updated every 2-5 minutes. Vol surface every 2 minutes.

Get an API key

Visit rgl.gokiai.com to create an account and get your API key.

License

MIT