MCP Options Order Flow Server

A high-performance MCP server for comprehensive options order flow analysis.

A high-performance Model Context Protocol (MCP) server for comprehensive options order flow analysis. This server provides real-time options order flow data, pattern detection, and institutional bias analysis through an intuitive MCP interface.

- Real-time Options Flow Analysis: Monitor options order flow across multiple contracts with sub-10ms response times
- Advanced Pattern Detection: Identify sweeps, blocks, and unusual volume patterns with institutional-grade algorithms
- Institutional Bias Tracking: Monitor smart money positioning and directional sentiment
- Historical Trend Analysis: 30-minute interval analysis with key directional changes
- Dynamic Monitoring: Configure and monitor specific strike ranges and expirations without restarts
- High Performance: Built for production use with distributed Go+Python architecture

This MCP server integrates with themcp-trading-data-brokerGo service to provide:

┌─────────────────────┐ gRPC ┌─────────────────────┐ WebSocket ┌─────────────────────┐ │ MCP Options Server │ ──────────► │ mcp-trading-data- │ ──────────────► │ Market Data │ │ (Python) │ │ broker (Go) │ │ Provider │ │ │ │ │ │ │ │ • MCP Tools │ │ • Options Analysis │ │ • Options Quotes │ │ • XML Formatting │ │ • Pattern Detection │ │ • Real-time Data │ │ • Context Building │ │ • Data Storage │ │ │ └─────────────────────┘ └─────────────────────┘ └─────────────────────┘

-

mcp-trading-data-broker: The Go-based data broker service

- Provides gRPC server on port 9090
- Handles real-time options data collection and analysis
- Must be running before starting this MCP server

Network Access: For gRPC communication between services

# Clone the repository git clone <repository-url> cd mcp-options-order-flow-server # Create virtual environment python -m venv venv source venv/bin/activate # On macOS/Linux # venv\Scripts\activate # On Windows # Install dependencies pip install -r requirements.txt

# gRPC Data Broker Connection export GRPC_HOST=localhost export GRPC_PORT=9090 export GRPC_TIMEOUT=30 # Optional: Custom logging export LOG_LEVEL=INFO

# Method 1: Using the convenience script python run_server.py # Method 2: Using module execution python -m src.mcp_server # Method 3: Direct execution python src/mcp_server.py

Add to your Claude Desktop MCP configuration:

{ "mcpServers": { "options-flow": { "command": "python", "args": ["run_server.py"], "cwd": "/path/to/mcp-options-order-flow-server", "env": { "GRPC_HOST": "localhost", "GRPC_PORT": "9090" } } } }

Get comprehensive options order flow analysis for a ticker.

- ticker(string): Stock ticker symbol (e.g., "SPY", "QQQ")

Returns:XML-formatted analysis including:

- Monitored contracts grouped by expiration and strike
- Current activity levels and directional bias
- Detected patterns with confidence scores
- Historical trend analysis with 30-minute intervals
- Institutional bias and most active strikes

Configure options monitoring for specific contracts.

- ticker(string): Stock ticker symbol
- configurations(array): Configuration objects with:

- expiration(integer): Expiration date in YYYYMMDD format
- strike_range(array): List of strike prices to monitor
- include_both_types(boolean): Monitor both calls and puts

{ "ticker": "SPY", "configurations": [ { "expiration": 20240419, "strike_range": [400, 405, 410], "include_both_types": true } ] }

Get current monitoring configuration status.

Returns:XML-formatted status showing all actively monitored contracts

Check connectivity and health status of the data broker.

Returns:Health status with connection details and response time metrics

"Please monitor SPY options for expiration 2024-04-19, strikes 400-410, both calls and puts"

"Analyze the current options flow for SPY"

"What options contracts are currently being monitored for SPY?"

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

Managed MCP server for Bybit perpetual futures trading. Isolated sub-accounts, built-in risk management, 12 trading tools.

Deterministic macro regime engine for AI trading agents — RISK_ON / NEUTRAL / RISK_OFF / STRESS with transparent scoring rules.

A quantitative analysis platform for Futu Securities, offering intelligent caching, technical analysis, and pattern recognition.

Complete MCP server for MT5: Through the MCP protocol, it allows [Trades, Orders, History, Graphic Objects, Terminal Logs, Compilation, etc.]

Access real-time and historical token, wallet, and trading data from the Solana ecosystem via the Solana Tracker API.

Access financial data like stock prices, currency info, and insider trading data using the Synth Finance API.

A modular trading automation project using the Zerodha Kite Connect API for tool-based and resource-based automation.

Integrates the xtquant quantitative trading platform with an AI assistant, enabling AI to access and operate quantitative trading data and functions.

Provides stock market data and trading capabilities using the yfinance library.