Skip to main content
Glama

📊 Lumina OrderBook MCP (lumina-orderbook-mcp)

Give Claude Code, Cursor, and AI Agents Real-Time 60-Level L2 Order Books, Liquidity Walls, Schmitt-Trigger Factor Ontology & Zero-Repaint ATR Risk Maps — With Zero API Keys.

CI License: MIT Python 3.10+ MCP Compatible DOI Paper 1 DOI Paper 4 Featured Ecosystem GitHub Sponsors

⚡ 30-Second AI Copy-Paste Install • 🛠️ MCP Tools • 📦 Sample Output • 💎 Pro Edition (NASDAQ TotalView 60-Depth) • 🇯🇵 日本語ガイド


Why lumina-orderbook-mcp?

"LLM nodes should argue about meaning; deterministic code should own the numbers."

When people ask an LLM "Is NVDA or BTC a good entry right now?", standard chatbots either hallucinate prices, eyeball screenshots, repaint on unclosed candles, or drift on stop-loss arithmetic. And existing TradingView MCP scrapers require keeping a heavy desktop app open on a debug port.

lumina-orderbook-mcp runs 100% locally on your machine with zero API keys, zero account signups, and zero TradingView Desktop dependency:

  1. Live 60-Level L2 Limit Order Book & Tape Imbalance (24/7 Crypto): Multi-exchange automatic failover (Coinbase Exchange $\rightarrow$ Kraken $\rightarrow$ Hyperliquid — never geo-blocked by HTTP 451 in the US, EU, or Japan). Computes Stoikov micro-price, spread (bps), Top-10 & Deep-60 Order Flow Imbalance (OFI), largest USD buy/sell walls, and aggressive tape delta.

  2. Intraday 5m Volume-at-Price (VAP) Microstructure (US/JP Equities, ETFs, Gold, FX): Computes Point of Control (POC), 70% Institutional Value Area (VAH / VAL), Session VWAP deviation in bps, and high-volume support/resistance magnets (NVDA, TSLA, SPY, GLD, 7203.T, USDJPY, XAUUSD).

  3. Zero-Repaint Closed-Bar Risk Blueprint: Automatically slices off unclosed forming candles so signals never repaint mid-bar. Outputs EMA(20/50/200), Weinstein 200-Day SMA Stage-2 status, causal ADR(15) remaining intraday fuel %, Schmitt-Trigger Factor Ontology polarity tags, and exact 1.5x ATR structural stop / 1.5R & 3.0R targets.


Related MCP server: Gogi MCP Server

⚡ 30-Second Setup (Just Paste 1 Sentence into Your AI)

No manual JSON editing needed. Copy and paste this single sentence into Claude Code, Cursor, Windsurf, or Antigravity:

Please install and configure the MCP server from https://github.com/ramuza0113-sketch/lumina-orderbook-mcp (use `uvx` if available, otherwise `pip install git+https://github.com/ramuza0113-sketch/lumina-orderbook-mcp.git` and run via `python -m lumina_orderbook_mcp.server`) so you can query live L2 order books, OFI liquidity walls, and deterministic ATR risk maps.

Or Configure Directly via CLI / JSON

Option A: Claude Code (1 command with uvx)

claude mcp add lumina-orderbook -- uvx --from git+https://github.com/ramuza0113-sketch/lumina-orderbook-mcp lumina-orderbook-mcp

Option B: Cursor (.cursor/mcp.json) / Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "lumina-orderbook": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/ramuza0113-sketch/lumina-orderbook-mcp",
        "lumina-orderbook-mcp"
      ]
    }
  }
}

Option C: Standard pip + Automatic Claude Desktop Installer (Windows Store / MSIX & macOS supported!)

pip install git+https://github.com/ramuza0113-sketch/lumina-orderbook-mcp.git
python -m lumina_orderbook_mcp.server --install-claude

(Automatically detects both standard %APPDATA%\Claude and Microsoft Store %LOCALAPPDATA%\Claude-Data configs, safely backs up existing preferences, and registers lumina-orderbook! Then fully quit Claude Desktop via Ctrl+Q and reopen.)


🛠️ Included MCP Tools

Tool Name

What It Computes Deterministically

Example Symbols

get_live_l2_orderbook

Crypto: Live 60-level L2 Order Book, Stoikov Micro-Price, Top-10 & Deep-60 OFI, Top-3 USD Bid/Ask Walls, Aggressive Tape Delta.Stocks/ETFs/FX: 5m Volume-at-Price (POC, VAH, VAL), Session VWAP distance (bps), High-Volume Support/Resistance Nodes.

BTC-USD, ETH-USD, SOL-USD, NVDA, TSLA, SPY, GLD, 7203.T, XAUUSD

get_ai_quant_candle_packet

Closed-Bar Only (anti-repaint) EMA(20/50/200), Daily SMA200 Stage-2 filter, RSI(14), RVOL(20), Causal ADR(15) remaining fuel %, Schmitt-Trigger Ontology tags, and 1.5x ATR Stop / 1.5R / 3.0R Long & Short risk maps + unit sizing per $100 risk.

NVDA (1h), BTC-USD (15m), 7203.T (1d), USDJPY (30m)

scan_market_liquidity_anomalies

Scans up to 10 tickers in parallel/batch and ranks them by absolute microstructure order-flow / institutional volume conviction.

"BTC-USD,ETH-USD,SOL-USD,NVDA,TSLA,GLD"

open_live_quant_terminal

Launches a live auto-refreshing dark-mode Bloomberg-style Web Terminal (http://127.0.0.1:8765) showing the 6-ticker Anomaly Radar, Live 60-Level L2 DOM Ladder + SVG Depth Curve (or 24-bin VAP Profile), ADR15 Fuel Tank Gauge, and 1.5R/3.0R Risk Blueprints in English & Japanese!

symbol="BTC-USD", timeframe="1h" (or CLI: lumina-orderbook-mcp --dashboard)

check_pro_institutional_bridge

Localhost (127.0.0.1) TCP readiness check for Moomoo OpenD (:11111 NASDAQ TotalView), IBKR Gateway/TWS (:4002/:7497), and MT5 Bridge (:8001).

(No arguments needed)

💬 Prompts to Try Right Away

  • "Check the live 60-level L2 order book on BTC-USD and ETH-USD. Where are the biggest USD buy/sell walls right now, and is aggressive tape buying confirming the book?"

  • "Pull both the intraday VAP liquidity profile and the 1h closed-bar quant risk packet for NVDA. Does it still have intraday ADR15 fuel left, and what are the exact 1.5R / 3.0R levels?"

  • "Scan BTC-USD,SOL-USD,NVDA,TSLA,SPY,GLD and tell me which asset has the strongest institutional order-flow imbalance right now."


📦 Real Deterministic JSON Output

{
  "symbol": "BTC-USD",
  "asset_class": "CRYPTO",
  "feed_type": "LIVE_L2_LIMIT_ORDER_BOOK",
  "exchange_source": "Coinbase Exchange (Zero-Auth L2)",
  "levels_analyzed": { "bids": 60, "asks": 60 },
  "touch": {
    "best_bid": 64349.68,
    "best_ask": 64349.69,
    "stoikov_micro_price": 64349.69,
    "spread_abs": 0.01,
    "spread_bps": 0.0
  },
  "order_flow_imbalance": {
    "top10_bid_ratio_pct": 96.27,
    "top10_imbalance": 0.9255,
    "deep_imbalance": 0.4447,
    "distance_weighted_pressure": 0.7875,
    "schmitt_trigger_regime": "STRONG_BID_DOMINANCE"
  },
  "liquidity_walls": {
    "largest_bid_support_walls": [
      { "price": 64340.6, "size": 0.924096, "notional_usd": 59456.89, "distance_bps": 1.41 }
    ],
    "largest_ask_resistance_walls": [
      { "price": 64359.4, "size": 0.559841, "notional_usd": 36031.01, "distance_bps": 1.51 }
    ]
  },
  "recent_tape_flow": {
    "sample_trades": 60,
    "tape_delta_imbalance": 1.0,
    "tape_state": "AGGRESSIVE_TAPE_BUYING"
  }
}

💎 Community (Free) vs Sponsor Pro Edition

lumina-orderbook-mcp is part of the Lumina Quantitative Research Ecosystem (featured in awesome-quant & Awesome_AI4Finance).

Feature

Community Edition (This Repo — MIT)

💎 Sponsor Pro Edition ($25/mo & $100/mo)

API Keys Required

0 (Instant Run)

Local BYOD (Moomoo OpenD / IBKR / MT5)

Crypto 60-Level L2 Order Book + Tape OFI

✅ Included

✅ Included + Multi-Venue Lead-Lag

US/JP Stock 5m Volume-at-Price (POC/VAH/VAL)

✅ Included

✅ Included

Closed-Bar Schmitt-Trigger & ATR 1.5R/3.0R Map

✅ Included

✅ Included

Live 60-Level US Equity L2 (NASDAQ TotalView via OpenD :11111)

Port Readiness Check

✅ Full Millisecond 60-Depth Feed

Spoofing Wall-Collapse & Iceberg Absorption Detector

—

✅ Scroll-Out Resistant Deep OFI (DOI: 10.5281/zenodo.23935930)

Z3 Theorem-Proved Slippage-Proof Pyramiding & OCO Bridge

—

✅ Included ($100/mo Pro Container Tier)

👉 Become a GitHub Sponsor (♡ Sponsor) to support open-source quantitative research & unlock Sponsor-Only Pro repositories!


🇯🇵 日本語クイックガイド (Japanese)

**APIキー登録ゼロ・完全無料(MITライセンス)**で、お使いの Claude Code / Cursor / Claude Desktop / Antigravity に「リアルタイム60段板(暗号資産L2フル板)・機関投資家の売買壁・日米株の価格帯別出来高(POC/VAH/VAL)・確定足ベースのATR損切り&利確マップ」を直結できるMCPサーバーです。

初心者向け:AIに「1行コピペ」するだけで自動導入

難しい設定ファイルの編集は不要です。普段使っている Claude Code や Cursor のチャット欄に、以下の1文をそのまま貼り付けて送信してください:

https://github.com/ramuza0113-sketch/lumina-orderbook-mcp のMCPサーバーをインストールして設定に追加して(uvxがなければ pip install git+https://github.com/ramuza0113-sketch/lumina-orderbook-mcp.git して python -m lumina_orderbook_mcp.server で登録して)。リアルタイムの板情報(OFI)とATRリスク計算を使えるようにして。

導入後にそのまま聞ける質問例

  • 🔥 新機能(ビジュアル板&ランキング画面を起動): Luminaのライブ板&リスク画面をブラウザで開いて(または単体起動コマンド: lumina-orderbook-mcp --dashboard)

  • BTC-USD と ETH-USD のリアルタイム60段板を見て、今どこに一番厚い買い壁・売り壁があるか教えて

  • NVDA と トヨタ(7203.T) の出来高プロファイル(POC)と1時間足の確定足リスクマップを出して。今日のADR値幅燃料はまだ残ってる?

  • BTC-USD, SOL-USD, NVDA, TSLA, GLD を一括スキャンして、今一番板と出来高の偏りが強い銘柄をランキングして

さらに米国株の Moomoo OpenD(NASDAQ TotalView 60段リアルタイム板・見せ板スプーフィング急キャンセル検知・アイスバーグ吸収検知) や上位コンテナを利用したい方は、右上の ♡ Sponsor(GitHub Sponsors) から公式サポーター枠をご確認ください。


📚 Academic References & Citation

  • Hashimoto, K. (2026a). Eliminating Polarity Hallucinations and Order Book Horizon Truncation Bias in Autonomous Multi-Agent Quantitative Systems: Schmitt-Trigger Factor Ontologies, Scroll-Out Resistant Deep OFI, and Slippage-Proof Pyramiding. CERN Zenodo. DOI: 10.5281/zenodo.23935930

  • Hashimoto, K. (2026d). Formal Verification of Quantitative Execution Guardrails via Z3 SMT Theorem Proving. CERN Zenodo. DOI: 10.5281/zenodo.24050440

  • Main Multi-Agent Research Framework: ramuza0113-sketch/lumina-ai-hedge-fund

Disclaimer: This software is provided strictly for quantitative research, educational, and informational purposes. Nothing output by this MCP server constitutes financial, investment, or trading advice.

Available Tools

5 tools
check_pro_institutional_bridgeA

Check localhost (127.0.0.1) readiness for institutional Level-2 / execution bridges (Moomoo OpenD :11111 NASDAQ TotalView 60-depth, Interactive Brokers Gateway/TWS :4002/:7497, and MetaTrader 5 RPyC Bridge :8001) and display Lumina OrderBook MCP Pro upgrade details.

Inputs: no named parameters. Returns: result

get_ai_quant_candle_packetA

Compute a zero-repaint (closed-bar only) quantitative analysis & deterministic ATR risk packet. [日本語検索キーワード: 確定足リスクマップ / 損切り・利確ライン / ATR / ADR値幅燃料 / EMAトレンド判定]

Supported timeframes: '5m', '15m', '30m', '1h', '1d'. Works across US Stocks ('NVDA', 'AAPL'), Japanese Stocks ('7203.T', '8035.T'), Crypto ('BTC-USD', 'SOL-USD'), Commodities ('GLD', 'XAUUSD'), and FX ('USDJPY').

Returns:

  • Confirmed closed candle OHLCV (eliminates mid-candle repainting)

  • EMA(20/50/200) alignment + Weinstein 200-Day SMA Stage-2 regime

  • Causal 15-day ADR% & remaining intraday ADR fuel% (chasing-exhaustion warning)

  • Schmitt-Trigger Factor Ontology semantic polarity tags (prevents LLM polarity hallucinations)

  • Deterministic 1.5x ATR structural stop loss, 1.5R partial & 3.0R runner targets, and unit sizing per $100 risk.

Inputs: symbol, timeframe. Returns: result

get_live_l2_orderbookB

Fetch real-time market microstructure & liquidity walls for Crypto, US/JP Stocks, ETFs, Gold, or FX. [日本語検索キーワード: リアルタイム60段板 / 板情報 / オーダーブック / 買い壁・売り壁 / 歩み値OFI / 出来高プロファイル POC VWAP]

  • For Crypto (e.g. 'BTC-USD', 'ETH-USD', 'SOL-USD', 'XRP-USD'): Returns live 60-level L2 limit order book (Coinbase -> Kraken -> Hyperliquid automatic fallback), Stoikov micro-price, spread (bps), Top-10 & Deep-60 Order Flow Imbalance (OFI), largest Bid/Ask liquidity walls in USD, and recent aggressive tape delta.

  • For Stocks / ETFs / Gold / FX (e.g. 'NVDA', 'TSLA', 'SPY', 'GLD', '7203.T', 'USDJPY'): Returns live 5-minute Volume-at-Price (VAP) Point of Control (POC), 70% Value Area (VAH/VAL), Session VWAP deviation (bps), institutional accumulation/distribution pressure, and local Moomoo OpenD (:11111) NASDAQ TotalView port readiness.

Inputs: depth, symbol. Returns: result

open_live_quant_terminalB

Launch and open the interactive dark-mode Lumina Live OrderBook & Quant Risk Web Terminal in the user's browser (http://127.0.0.1:8765). [日本語検索キーワード: Lumina ライブ板 / 板画面 / オーダーブック画面 / リスク画面 / ターミナル / ランキング画面を開く]

Displays 3 real-time visual panels simultaneously:

  1. Multi-Asset OFI & Volume Imbalance Ranking Radar (clickable watchlist)

  2. Live auto-ticking 60-level L2 Order Book DOM Ladder + Cumulative Depth Chart (Crypto) or 24-bin Volume-at-Price POC/VAH/VAL Histogram (Stocks / Gold / FX)

  3. Closed-Bar Trend Stack, Intraday ADR15 Fuel Tank Gauge, and 1.5R / 3.0R Long & Short Blueprints. Call this tool whenever the user asks to visually see or open the order book, chart, ranking board, or Lumina terminal UI.

Inputs: symbol, timeframe, watchlist. Returns: result

scan_market_liquidity_anomaliesA

Scan up to 10 comma-separated tickers simultaneously and rank them by real-time L2 order-book pressure or intraday institutional volume imbalance. [日本語検索キーワード: 一括スキャン / 銘柄ランキング / 板・出来高インバランス順位]

Inputs: symbols_csv. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 5 tools

    Disambiguation4/5

    Each tool targets a recognizably different action: closed-bar quant packet, live L2/VAP fetch, multi-ticker scan, terminal UI launch, and bridge readiness check. The main soft overlap is between get_live_l2_orderbook and scan_market_liquidity_anomalies, since both surface liquidity/imbalance metrics; the single-symbol vs. batch distinction is stated but an agent could still hesitate when asked to 'show liquidity for NVDA'.

    Naming Consistency5/5

    All names are snake_case and follow a clear verb_noun pattern (check_, get_, get_, open_, scan_). Resource qualifiers (pro_institutional_bridge, ai_quant_candle_packet, live_l2_orderbook, live_quant_terminal, market_liquidity_anomalies) are descriptive and unambiguous.

    Tool Count4/5

    Five tools is well within the healthy 3-15 range and each earns its place in the orderbook/quant workflow. However, every tool is very heavy (multi-section payloads), so there is no lightweight call for simple lookups, making the granularity slightly coarse.

    Completeness4/5

    The surface covers the core lifecycle: closed-bar analysis with ATR risk, live microstructure, batch ranking scan, visual terminal, and connectivity diagnostics. Minor gaps remain around symbol discovery/validation, historical backfill beyond the candle packet, and any watchlist/alert management.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      B
      maintenance
      Enables AI co-pilots to interact with TradingView charts, manage alerts via REST API, automate morning briefs with custom trading rules, and perform real-time market analysis.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants in MCP clients to query real-time market data, inspect portfolio and Web3 wallet balances across brokers, place protected equity/ETF, crypto, forex, options, DeFi swap, and prediction market orders, and run backtests.
      MIT
    • A
      license
      Not graded
      quality
      F
      maintenance
      Enables AI agents to query liquidation radar for seven tokens, inspect recorded BTC/ETH order book depth with wall history and aggressor flow, and request Li.Fi cross-chain swap routes that agents sign themselves.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to read live Hyperliquid market data — perp and spot metadata, mid prices, order books, OHLCV candles, funding rates and history, and current open interest — keylessly from the exchange's public info API, with no wallet or trading access.
      105 npm
      MIT