Skip to main content
Glama
schoeffeljp

deribit-mcp

by schoeffeljp

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
PORTNoHTTP server port3000
MCP_API_KEYNoBearer token for authentication (required for HTTP mode)
MCP_TRANSPORTNostdio for local, http for cloudstdio
DERIBIT_TESTNETNoSet true for testnetfalse
MCP_CORS_ORIGINNoAllowed CORS origin for HTTP mode*
DERIBIT_CLIENT_IDNoDeribit API key ID
DERIBIT_CLIENT_SECRETNoDeribit 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

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription
position_managementSystematic position review with risk flags and actionable recommendations. Use when reviewing, adjusting, or deciding whether to close/roll options positions.
risk_managementPortfolio-level risk assessment based on Tasty Trade framework. Use for comprehensive portfolio health check, buying power analysis, and risk metric evaluation.
strategy_advisorTrade 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

NameDescription

No resources

TDQS

B3.4/5.0

Scored across 35 tools

Disambiguation4/5

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.

Naming Consistency4/5

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.

Tool Count2/5

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

Completeness4/5

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.

Maintenance

ActivityNo data
ResponsivenessUnresponsive