Deribit MCP with Claude Session injection

What it is

An independent MCP server for Deribit, run as a long-lived container. It covers the exchange's read surface (tickers, OHLCV candles, order books, Greeks, funding, liquidations) and its mutating surface (market, limit, stop, trailing and bracket orders, combos, mass-cancel, position close), and pairs both with an alert engine and a sidecar that can push events back into a running Claude Code session as native channel notifications.

What you get

• 60+ tools covering Deribit's read and write surface, from instrument metadata to every order primitive and its edit, cancel and close counterparts
• Market data with freshness you can reason about: get_current_price returns source and age_seconds, and skip_cache forces a fresh REST fetch before a time-sensitive call — get_current_price, get_ticker, get_instruments, get_instrument
• Order books two ways — a one-shot REST read, or a WebSocket-cached snapshot plus a delta against the last one, so a tight loop does not pay per-tick latency — get_order_book, get_orderbook_live, get_orderbook_diff, unsubscribe_orderbook, get_book_summary
• OHLCV candles at 1/3/5/10/15/30/60/120/180/360/720-minute or daily resolution, plus the public trade tape, captured liquidations, funding history, realized volatility and options Greeks — get_chart_data, get_last_trades_by_instrument, get_recent_liquidations, get_funding_rate_history, get_historical_volatility, get_greeks
• A pre-trade audit that is enforced, not advisory: every mutating tool requires a decision_id minted by record_decision and validated against the database before the Deribit call, and the id rides through as the order label so fills join back to the reasoning
• Self-scheduling alerts — threshold, cross and percentage-change price conditions, plus time alerts the agent sets to wake itself up later — set_price_alert, set_time_alert
• An external news webhook: anything that can POST can stash a headline with a structured payload and push it into the agent's session, with dedupe_key making repeated aggregator posts idempotent — news_list
• An operator dashboard at /dashboard/ showing health, registered sidecar consumers, positions, alerts, timers, recent decisions, order audits, outbox events and the latest news

Requirements

A Deribit account with API credentials — DERIBIT_API_KEY and DERIBIT_API_SECRET — and DERIBIT_TEST_MODE, which defaults to true and points at test.deribit.com. Trading is off until you set DERIBIT_TRADING_ENABLED, and it stays off unless all four caps are positive numbers: DERIBIT_MAX_AMOUNT_INVERSE, DERIBIT_MAX_AMOUNT_LINEAR, DERIBIT_MAX_AMOUNT_OPTION and DERIBIT_MAX_NOTIONAL_USD. Transport is chosen by MCP_TRANSPORT — stdio for local use, http for a gateway, where MCP_SHARED_SECRET must be sent in the X-Deribit-MCP-Secret header. DERIBIT_EVENT_ADMIN_TOKEN guards consumer registration, the news endpoints and the dashboard. The documented path is Docker: fill .env, docker compose pull, docker compose up -d, and the MCP endpoint is /mcp/ on port 8000. State lives in one SQLite file on a mounted volume.

Setup effort

Follow the published steps

Tools you get

60 tools named in the project's documentation. The ten trading tools refuse to run unless DERIBIT_TRADING_ENABLED is on and all four limits are positive, so a fresh install can use 50. buy, sell, place_bracket and close_position are among them.

Requires

• DERIBIT_API_KEY in your environment
• DERIBIT_API_SECRET in your environment