deribit-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | HTTP server port | 3000 |
| MCP_API_KEY | No | Bearer token for authentication (required for HTTP mode) | |
| MCP_TRANSPORT | No | stdio for local, http for cloud | stdio |
| DERIBIT_TESTNET | No | Set true for testnet | false |
| MCP_CORS_ORIGIN | No | Allowed CORS origin for HTTP mode | * |
| DERIBIT_CLIENT_ID | No | Deribit API key ID | |
| DERIBIT_CLIENT_SECRET | No | Deribit API secret |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_currenciesA | List all available currencies on Deribit |
| get_instrumentsA | List tradable instruments (options, futures, spots) for a currency. Returns instrument names, strike prices, expiration dates, and contract details. Essential for discovering available options chains. |
| get_tickerA | Get real-time quote data for an instrument. For options, includes greeks (delta, gamma, vega, theta, rho), implied volatility, mark price, bid/ask, open interest, and volume. |
| get_order_bookA | Get the order book (bids and asks) for an instrument, including best bid/ask, mark price, and funding rate for perpetuals. |
| get_book_summary_by_currencyA | Get summary info (volume, open interest, bid/ask, mark price) for all instruments of a currency. Useful for scanning the entire options or futures market at a glance. |
| get_index_priceA | Get the current index price for a given underlying index (e.g. btc_usd, eth_usd). |
| get_historical_volatilityB | Get historical volatility data points for a currency index over time. |
| get_volatility_indexB | Get DVOL (Deribit Volatility Index) OHLCV data — Deribit's equivalent of the VIX. Shows implied volatility trend over time. |
| get_tradingview_chart_dataA | Get OHLCV candlestick data for any instrument. Useful for price charts, technical analysis, and historical price research. |
| get_funding_rate_historyA | Get historical funding rate data for a perpetual instrument. Shows hourly funding rates, index prices, and interest rates. |
| get_delivery_pricesB | Get historical settlement/delivery prices for an index. Useful for backtesting and understanding past expiry outcomes. |
| get_account_summaryA | Get account balance, equity, margin usage, and P&L summary for a currency. |
| get_positionsA | Get all open positions, including size, direction, P&L, average price, and greeks for options. |
| get_order_stateA | Get the current state of an order by its order_id. Returns order_state (open, filled, cancelled, rejected, untriggered), average_price, filled_amount, price, and all order details. Use this to check if an order was filled, partially filled, or cancelled. |
| get_open_ordersB | List all open (unfilled) orders, optionally filtered by currency or instrument type. |
| buyA | Place a buy order on Deribit. Supports limit, market, stop_limit, and stop_market order types. Use with caution — this places a real trade. |
| sellA | Place a sell order on Deribit. Supports limit, market, stop_limit, and stop_market order types. Use with caution — this places a real trade. |
| cancel_orderA | Cancel an open order by its order ID. |
| cancel_all_ordersA | Cancel all open orders, optionally filtered by currency and instrument type. |
| edit_orderA | Modify an existing open order's price, amount, or other parameters without cancelling and re-placing. |
| close_positionA | Close an existing position entirely. Places a market or limit order to flatten the position. |
| get_user_tradesA | Get recent trade fills for a currency. ALWAYS filter by kind (option, future, spot) to narrow results. Shows price, size, fees, P&L, IV, and underlying price. Use get_user_trades_by_instrument if you know the specific instrument name. |
| get_user_trades_by_instrumentA | Get trade history for a SPECIFIC instrument. Preferred when you know the instrument name (e.g. 'show me my fills on ETH_USDC-27MAR26-2400-C'). Returns price, size, fees, underlying price and IV at time of trade. |
| get_transaction_logC | Get the full ledger of account transactions: trades, settlements, fees, funding payments, deposits, withdrawals, and transfers. |
| get_marginsA | Estimate the margin required for a hypothetical trade before placing it. Returns margin for both buy and sell sides, plus min/max price bounds. |
| get_expirationsA | List available option expiration dates for a currency, sorted chronologically. For USDC currency, use 'underlying' to filter ETH vs BTC options. |
| get_options_chainA | Get options chain for a specific currency + expiry. Returns strikes with bid/ask, mark price, IV, greeks, OI. IMPORTANT: always specify 'underlying' for USDC currency, and use 'atm_range' to limit strikes (default 10 = ATM ± 10). |
| find_options_by_deltaA | Find options closest to a target delta for a given currency and expiry. E.g., 'find the 25-delta put' or 'find the 50-delta call'. Returns the best matching options sorted by delta proximity. |
| get_volatility_surfaceA | Get the implied volatility surface across all strikes and expirations for a currency. Returns a matrix of expiry × strike → IV, plus ATM IV and skew metrics per expiry. Essential for relative value analysis and vol trading. |
| get_portfolio_greeksA | Get aggregated portfolio greeks across all open option positions for a currency. Shows total delta, gamma, vega, and theta exposure, plus per-position breakdown. Essential for understanding net risk. |
| get_portfolio_summaryA | One-shot overview of your entire account for a currency: balances, margin usage, equity, all open positions with P&L, and all open orders. Saves multiple API calls into a single comprehensive snapshot. |
| analyze_positionA | PREFERRED tool for position analysis — returns fee-aware NET P&L (after actual entry fees from trade history + estimated exit fees at ~$0.9/contract taker), realistic exit simulation at bid/ask (not mark), DTE, greeks, moneyness, risk flags, and HOLD/TAKE_PROFIT/CLOSE/ROLL recommendations. Always use this instead of get_positions + get_ticker when analyzing positions. |
| portfolio_risk_metricsA | Portfolio-level risk dashboard with dollar greeks, theta/netliq ratio, delta/theta ratio, margin utilization, concentration per underlying, and health status (HEALTHY/CAUTION/AT_RISK). Based on Tasty Trade risk framework. |
| iv_rankA | Get IV Rank, IV Percentile, HV30, and Volatility Risk Premium (VRP) for a cryptocurrency. IV Rank > 50 = rich (good for selling premium), < 30 = cheap (good for buying). |
| scan_candidatesA | Scan for option trading opportunities by strategy (naked_put, strangle, covered_call). Returns ranked candidates with premium, delta, IV, margin, annualized yield, and position sizing recommendations. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| position_management | Systematic position review with risk flags and actionable recommendations. Use when reviewing, adjusting, or deciding whether to close/roll options positions. |
| risk_management | Portfolio-level risk assessment based on Tasty Trade framework. Use for comprehensive portfolio health check, buying power analysis, and risk metric evaluation. |
| strategy_advisor | Trade idea generation with entry criteria, position sizing, and complete trade plans. Scans for opportunities based on IV rank, VRP, and strategy-specific criteria. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 35 tools
Most tools target a distinct resource or action, with clear separation between market data, account/position data, order management, and options analytics. A few analytical tools (get_positions, analyze_position, get_portfolio_summary, portfolio_risk_metrics) have overlapping position/risk information, but the descriptions do enough to differentiate their intended use.
The majority of tools follow a predictable get_<noun> or <verb>_<noun> pattern, which makes navigation straightforward. Minor deviations like iv_rank and portfolio_risk_metrics break the verb-oriented convention slightly, and get_tradingview_chart_data mixes a brand into an otherwise clean naming scheme.
35 tools is a large surface for an MCP server, exceeding the 25+ threshold where the set starts feeling heavy for agent tool selection. While the domain is broad, several tools could be consolidated (e.g., the volatility-related tools and the position/portfolio analytics tools).
The tool set covers the core trading lifecycle well: market data, order placement/management, positions, fills, account summaries, and advanced options/risk analytics. Minor gaps remain, such as no multi-leg strategy order placement despite strategy scanning being offered, and no historical order search beyond open orders and trade fills.