Options Order Flow
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.
What is Options Order Flow?
Options Order Flow is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 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.
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.
This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Server for comprehensive options order flow analysis. This s
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-options-order-flowConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Options Order Flow
The MCP Options Order Flow Server provides real-time options order flow analysis through four focused tools that connect to an underlying data broker via gRPC. It detects patterns in options activity, identifies institutional positioning bias, reports on monitored contracts by expiration and strike range, and validates connectivity to the data feed. Designed for traders and quant analysts who want to query options market dynamics through natural language in Claude or another MCP client, the server runs as a Python process that communicates with a local or remote gRPC data broker hosting the actual market data.
Prerequisites
- Python 3.9+ with pip installed
- A running gRPC data broker service hosting options order flow data (local or remote)
- Network access to the gRPC host and port (default localhost:9090)
- Claude Desktop or another MCP-compatible AI client
- The cloned repository from GitHub
Clone the repository
The server is distributed as source code. Clone the repository to a local directory.
git clone https://github.com/fintools-ai/mcp-options-order-flow-server.git
cd mcp-options-order-flow-serverInstall Python dependencies
Install the required packages from the requirements file into your Python environment.
pip install -r requirements.txtConfigure environment variables
Set the gRPC connection parameters for your data broker. All variables have defaults and are optional if you are running a local broker on port 9090.
export GRPC_HOST=localhost
export GRPC_PORT=9090
export GRPC_TIMEOUT=30
export LOG_LEVEL=INFOVerify the data broker connection
Run the server manually and use the data_broker_health_check tool to confirm connectivity before configuring your AI client.
python run_server.pyAdd the server to Claude Desktop configuration
Edit claude_desktop_config.json to add the options-flow server entry. Use the cwd field to point to the cloned repository directory.
{
"mcpServers": {
"options-flow": {
"command": "python",
"args": ["run_server.py"],
"cwd": "/path/to/mcp-options-order-flow-server",
"env": {
"GRPC_HOST": "localhost",
"GRPC_PORT": "9090",
"GRPC_TIMEOUT": "30",
"LOG_LEVEL": "INFO"
}
}
}
}Restart Claude Desktop and test
Restart Claude Desktop to load the server. Ask it to check the data broker health and then configure monitoring for a ticker to confirm the tools are working end to end.
Options Order Flow Examples
Client configuration
Claude Desktop configuration for the Options Order Flow server with gRPC broker connection details.
{
"mcpServers": {
"options-flow": {
"command": "python",
"args": ["run_server.py"],
"cwd": "/Users/you/mcp-options-order-flow-server",
"env": {
"GRPC_HOST": "localhost",
"GRPC_PORT": "9090",
"GRPC_TIMEOUT": "30",
"LOG_LEVEL": "INFO"
}
}
}
}Prompts to try
Query options order flow data and configure monitoring through natural language.
- "Check the health of the options data broker and show response latency"
- "Set up monitoring for AAPL options expiring in the next 30 days with strikes between 170 and 200"
- "Analyze the current options order flow for SPY and show any detected patterns"
- "What is the current institutional bias in TSLA options based on recent order flow?"
- "Show the monitoring status for all tickers I have configured"Troubleshooting Options Order Flow
Connection refused or gRPC timeout errors
Verify that your gRPC data broker service is running and accessible at the GRPC_HOST and GRPC_PORT values in your configuration. The default assumes a local broker at localhost:9090. Use the data_broker_health_check tool to diagnose connectivity issues and adjust GRPC_TIMEOUT for slow connections.
analyze_options_flow returns no data for a ticker
The ticker must first be configured for monitoring using configure_options_monitoring_tool with the desired expiration date range and strike price range. Once monitoring is set up, order flow data will be collected and available for analysis.
Python module import errors on startup
Ensure all dependencies were installed from requirements.txt in the same Python environment used to run the server. If you have multiple Python versions, specify the full path to the correct python executable in the command field of your MCP config.
Frequently Asked Questions about Options Order Flow
What is Options Order Flow?
Options Order Flow is a Model Context Protocol (MCP) server that 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. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Options Order Flow?
Follow the installation instructions on the Options Order Flow GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Options Order Flow?
Options Order Flow works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Options Order Flow free to use?
Yes, Options Order Flow is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Options Order Flow Alternatives — Similar Finance & Fintech Servers
Looking for alternatives to Options Order Flow? Here are other popular finance & fintech servers you can use with Claude, Cursor, and VS Code.
ValueCell
★ 10.7kValueCell is a community-driven, multi-agent platform for financial applications.
Vibe Trading
★ 8.1k'Vibe-Trading: Your Personal Trading Agent'
Quantdinger
★ 6.2kAI quantitative trading platform for crypto, stocks, and forex with backtesting, live trading, market data, and multi-agent research.vibe-trading ,trading-agents,ai-trader,ai-trading
TradingView
★ 2.8kReal-time crypto & stock screening, advanced technical indicators, Bollinger Bands intelligence, candlestick patterns + native Claude Desktop integration. Multi-exchange (Binance, KuCoin, Bybit+). Open-source AI trading infrastructure.
Financial Datasets
★ 2.1kProvides access to comprehensive financial data including income statements, balance sheets, cash flow statements, stock prices, company news, SEC filings, and cryptocurrency information with built-in financial ratio analysis.
Stripe
★ 1.6kThe Stripe Model Context Protocol server allows you to integrate with Stripe APIs through function calling. This protocol supports various tools to interact with different Stripe services.
Browse More Finance & Fintech MCP Servers
Explore all finance & fintech servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Options Order Flow in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Options Order Flow?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.