tradepilot-mcp-server

# 🚀 TradePilot MCP Server v3.0 **Advanced 18-Layer Trading Intelligence Engine** A production-grade MCP (Model Context Protocol) server that combines **Polygon.io real-time market data** with an **18-layer technical analysis engine** for autonomous options trading intelligence. --- ## 📊 What is This? TradePilot is a **FastAPI-based MCP server** that: - Fetches real-time and historical market data from Polygon.io - Runs analysis through **18 specialized layers** (Technical + Price Action + Options + Master Brain) - Provides **14 high-probability playbooks** targeting 85-95% win rates - Delivers actionable options trading signals with precise strike/expiry recommendations - Includes multi-ticker scanning, risk management, and alert notifications Think of it as your **AI options trading copilot** powered by institutional-grade analysis. --- ## 🎯 Key Features - **18-Layer Analysis System** - Layers 1-10: Technical indicators (Momentum, Volume, Trend, Structure) - Layers 11-13: Price action (Support/Resistance, VWAP, Volume Profile) - Layers 14-17: Options analysis (IV, Greeks, Gamma, Put/Call ratios) - Layer 18: Master Brain with 14 playbooks - **Trading Modes** - SCALP: 0-2 DTE options - SWING: 7-45 DTE options - INTRADAY: Same-day trades - **Advanced Features** - Multi-ticker scanner with filtering - Kelly Criterion position sizing - Risk management with drawdown protection - Discord/Slack/Telegram alerts - Backtesting engine - AI-ready JSON output --- ## 🚀 Quick Start ```bash # Clone the repository git clone https://github.com/Sakhir786/tradepilot-mcp-server.git cd tradepilot-mcp-server # Set up environment python3 -m venv venv source venv/bin/activate pip install -r requirements.txt # Configure environment variables cp .env.example .env # Edit .env and add your POLYGON_API_KEY # Run the server python main.py # Or with uvicorn: uvicorn main:app --host 0.0.0.0 --port 10000 ``` Access documentation at: http://localhost:10000/docs --- ## 📡 API Endpoints ### 18-Layer Analysis - `GET /engine18/analyze` - Full 18-layer analysis - `GET /engine18/quick` - Quick signal check - `GET /engine18/scan` - Multi-ticker scanner - `GET /engine18/playbooks` - List all 14 playbooks - `GET /engine18/health` - System health check ### Market Data (Polygon.io) - `GET /candles` - OHLCV data - `GET /options` - Options chain - `GET /news` - Latest news - `GET /ticker-details` - Company info --- ## 🔧 Environment Variables ```bash POLYGON_API_KEY=your_api_key_here TRADEPILOT_PRODUCTION_PATH=/path/to/tradepilot-mcp-server TRADEPILOT_LAYERS_PATH=/path/to/layers TRADEPILOT_PORTFOLIO_VALUE=100000 TRADEPILOT_DISCORD_WEBHOOK=your_webhook_url ``` --- ## 📊 Example Usage ```python import requests # Full analysis response = requests.get( "http://localhost:10000/engine18/analyze", params={"symbol": "SPY", "mode": "swing"} ) analysis = response.json() print(f"Direction: {analysis['analysis_summary']['direction']}") print(f"Win Probability: {analysis['analysis_summary']['win_probability']}%") ``` --- ## 🎯 14 High-Probability Playbooks **Bullish (CALLS):** 1. Liquidity Sweep + BOS (85-95%) 2. CHoCH Reversal (82-92%) 3. Trend Continuation (80-90%) 4. FVG Fill + Rejection (81-88%) 5. Order Block Bounce (79-87%) 6. Divergence + Structure (80-88%) 7. VWAP Reclaim (77-85%) **Bearish (PUTS):** 8-14. Mirror patterns for bearish setups --- ## 🔐 Security & Best Practices - Never commit `.env` files - Keep API keys secure - Use environment variables for sensitive data - Enable rate limiting for production deployments --- ## 📝 License MIT License - See LICENSE file for details --- ## 🤝 Contributing Contributions welcome! Please open an issue or submit a pull request. --- ## 📧 Support For issues or questions, please open a GitHub issue. **TradePilot v3.0 - Professional Options Trading Intelligence** 🚀📈