A 165K-line financial intelligence platform that turns Reddit into structured options trade ideas. Built solo in 9 days. The first financial intelligence MCP server in existence. Connect Claude, Cursor, or any MCP-compatible AI to live trading signals, sentiment analysis, and unusual options activity — in one line of config. ROT is the world's first financial intelligence MCP server. No other MCP
Add this skill
npx mdskills install Mattbusel/reddit-options-trader-rotComprehensive financial intelligence MCP server with 7 tools for live trading signals and market data
1# Reddit Options Trader (ROT)23**A 165K-line financial intelligence platform that turns Reddit into structured options trade ideas. Built solo in 9 days.**45**The first financial intelligence MCP server in existence.** Connect Claude, Cursor, or any MCP-compatible AI to live trading signals, sentiment analysis, and unusual options activity — in one line of config.67[]()8[]()9[]()10[]()111213---1415## MCP Server — Talk to Wall Street Through Your AI1617ROT is the **world's first financial intelligence MCP server**. No other MCP server gives your AI real-time access to trading signals, sentiment data, unusual options activity, and sports betting intelligence — all sourced from Reddit, RSS, and social media, analyzed by a 9-stage AI pipeline.1819### Connect in 30 Seconds (Zero Install)2021The server is hosted. No packages, no Docker, no API keys. Just add one block to your config:2223**Claude Desktop** — Add to `claude_desktop_config.json`:2425```json26{27 "mcpServers": {28 "rot": {29 "url": "https://web-production-71423.up.railway.app/mcp"30 }31 }32}33```3435**Cursor / Windsurf / Any MCP Client** — Point at:3637```38https://web-production-71423.up.railway.app/mcp39```4041That's it. Your AI can now query live financial intelligence.4243### What Your AI Can Do4445| Tool | What It Does |46|------|-------------|47| `get_trending_tickers` | See what Wall Street and Reddit are buzzing about right now |48| `get_signals` | Get AI-analyzed trading signals with strategies and confidence scores |49| `get_sentiment` | Bull/bear breakdown and net sentiment for any ticker |50| `get_market_overview` | 30-day snapshot: win rate, signal volume, avg confidence |51| `get_unusual_activity` | Detect IV spikes, volume surges, and institutional positioning |52| `get_sports_feed` | Sports betting intel with line mover scores (0-100) |53| `search_signals` | Search all signals by keyword ("FDA approval", "earnings beat") |5455### Try These Prompts5657Once connected, just ask your AI in natural language:5859- *"What stocks are trending on Reddit right now?"*60- *"Show me bearish signals for TSLA"*61- *"What's the sentiment on NVDA?"*62- *"Are there any unusual options activity alerts?"*63- *"Search for signals about FDA approvals"*64- *"Give me a full market overview for the last 30 days"*65- *"What NFL injuries might move betting lines today?"*6667No API key needed. Every tool is free.6869> Full MCP documentation: [MCP_README.md](MCP_README.md)7071---7273## What Is This7475ROT is a full-stack signal intelligence platform. It monitors Reddit in real time, detects emerging market events, extracts and validates tickers, enriches them with market data, scores credibility, reasons about conviction, and generates structured options trade ideas — complete with strike selection, expiry heuristics, and risk parameters.7677This is not a trading bot. ROT is the intelligence layer that surfaces what matters before price fully reacts.7879**Live deployment:** [rot.up.railway.app](https://web-production-71423.up.railway.app/)8081---8283## The Numbers8485```86CODEBASE87──────────────────────────────────────88Production Code: 58,869 lines │ 230 files89Test Code: 92,182 lines │ 201 files90Templates: 14,318 lines │ 64 files91Total Python: 151,116 lines │ 431 files92Grand Total: ~165,000+ lines │ 564 files9394TESTING95──────────────────────────────────────96Test Functions: 6,916 (5,063 sync + 1,853 async)97Test-to-Prod Ratio: 1.57:198External API Calls: 0 (fully mocked)99CI: Pytest on every push, 75% coverage floor100101SECURITY102──────────────────────────────────────103CodeQL Alerts: 0 (425 fixed)104Dependabot Alerts: 0105Open CVEs: 0106TODO/FIXME Comments: 0107Bare except: pass: 0108Hardcoded Secrets: 0109Security Scanners: 5 (CodeQL, Bandit, pip-audit, TruffleHog, Dependabot)110111INFRASTRUCTURE112──────────────────────────────────────113Database Tables: 33+114API Endpoints: 100+115MCP Tools: 7 (first financial MCP server)116MCP Resources: 2117Tier Gates: 35+118NLP Modules: 10119Background Loops: 8120Pipeline Stages: 9121```122123---124125## Why This Exists126127In January 2026, Intercontinental Exchange — the $98.8B company that owns the NYSE — launched "Reddit Signals and Sentiment," selling structured Reddit market data to institutional investors.128129ROT does the same thing for everyone else. ICE sells raw data feeds to hedge funds at institutional prices. ROT is the complete platform — ingestion, analysis, trade ideas, dashboard, alerts — at retail scale.130131---132133## Architecture134135### 9-Stage Pipeline136137```138Reddit/RSS → Trend Detection → NLP (10 modules) → Event Building → Market Enrichment139 → Credibility Scoring → Feedback Suppression → LLM Reasoning → Trade Ideas140```141142Every stage runs continuously. Memory-bounded dedup (max 2,000). Circuit breaker on LLM (auto-disables after 3 failures, stub fallback). Full pipeline executes in seconds.143144### Security (Grade: A)145146Independently audited at **A (93-95/100)** across two separate assessments.147148- **Authentication:** JWT + API Key + Session Cookie (3 methods)149- **Authorization:** 5-tier hierarchy (Free → Pro → Premium → Ultra → Enterprise) + Admin. 35+ gate functions.150- **SQL Injection:** 100% parameterized queries. Field whitelist for dynamic updates.151- **XSS Prevention:** 3-layer defense — Jinja2 autoescape + nh3 Rust sanitizer + nonce-based CSP152- **CSRF:** Custom ASGI middleware with timing-safe HMAC comparison153- **Security Headers:** 6/6 — CSP, X-Frame-Options: DENY, nosniff, Referrer-Policy, Permissions-Policy, X-XSS-Protection154- **Rate Limiting:** Database-backed, multi-instance safe. Per-tier daily + burst limits. Brute-force protection.155- **Security Logging:** 10 SIEM-ready JSON event types. Global sanitizing filter. Request ID correlation.156- **CI/CD:** 5 automated scanners on every push — CodeQL, Bandit, pip-audit, TruffleHog, Dependabot157158### Test Suite1591601.57:1 test-to-production ratio — more test code than production code.1611626,916 tests across 201 files. Zero external API calls (everything mocked). Runs in CI on every push with coverage enforcement.163164**What the tests have found:**165- A ghost endpoint — two health check routes existed, the minimal one shadowed the comprehensive one166- A tier gate design assumption that didn't match actual product behavior167- A CVE in `cryptography` caught and patched within hours of enabling dependency pinning168- A known pytest `caplog` fixture isolation issue triggered by extreme test density (23 tests for a single security logger module)169- A serialization bug where `Evidence` dataclass objects were silently failing to store, dropping 100% of signals170171### Key Design Patterns172173| Pattern | Implementation |174|---------|---------------|175| **Pipeline Orchestration** | 9-stage DAG with dedup and filtering |176| **Circuit Breaker** | LLM disabled after 3 failures, stub fallback, auto-recovery |177| **Mixin Composition** | 16 DB mixins (231 methods) vs monolithic file |178| **Dual-Path NLP** | Custom 10-module engine with regex fallback |179| **Query Cache** | Async TTL with thundering-herd prevention (per-key locks) |180| **Tier Gating** | Returns dicts of flags, not exceptions. Admin bypasses all. |181| **MCP Server** | Remote HTTP/SSE, 7 tools + 2 resources, zero-config connection |182| **Non-root Docker** | gosu-based entrypoint with volume permission handling |183184---185186## Core Capabilities187188### Real-Time Ingestion189- **Reddit:** PRAW streaming from r/wallstreetbets, r/stocks (hot, new, rising, top)190- **RSS:** 13+ feeds including Reuters Business, SEC 8-K filings191- Deduplication, freshness gating, persistence across restarts192193### Trend Detection194Momentum-based, not mention-based. Score velocity, comment velocity, engagement acceleration. Emits `TrendCandidate` objects when thresholds are exceeded.195196### Ticker Extraction & Validation197- `$TSLA`, bare `TSLA`, multi-ticker posts198- Aggressive filtering: macro noise, non-equities, slang, delisted symbols199- Alias normalization (`SPXW` → `^GSPC`, `TSMC` → `TSM`)200201### Market Enrichment202Live data via yfinance with local caching. Price, market cap, volume, IV context.203204### Event Classification205Event types (earnings, squeeze, regulatory, product, macro), sentiment detection (bullish/bearish/mixed), time horizon inference (intraday through earnings window).206207### Credibility Scoring208ML scorer (GradientBoosting) + 12 heuristic factors. DD flair bonus, engagement quality, cross-post penalties, ticker focus, text depth. Transparent score breakdown.209210### LLM Reasoning (Optional)211Provider-agnostic — OpenAI, Anthropic, DeepSeek. Thesis synthesis, risk identification, context expansion. Circuit breaker with safe fallback.212213### Trade Idea Generation214Bull call spreads, bear put spreads, straddles. ATM ± 5% strike selection, weekly/monthly expiry heuristics, max loss calculation, quality scoring. Market cap and data availability gates.215216### Web Dashboard217FastAPI + Jinja2. Real-time signal feed (WebSockets), confidence bars, stance badges, trending tickers, signal detail pages with full reasoning and trade structure. Dark theme.218219### Alerts220Discord webhooks, email, Twitter. High-confidence signals only. Rich embeds with ticker, stance, confidence, strategy, option legs, risks, catalyst window.221222### Additional Systems223- **MCP Server:** World's first financial intelligence MCP server — 7 tools, 2 resources, zero-install remote connection224- **Backtesting Engine:** Monte Carlo simulation, walk-forward optimization, 12 modules225- **Strategy Builder:** Rule-based, ML optimizer, genetic algorithms, regime detection, marketplace226- **Social Intelligence:** Manipulation detection, bot detection, pump-dump patterns, coordination tracking227- **Options Flow:** Block/sweep/dark pool detection, IV analysis, Greek calculations228- **Macro Events:** FOMC calendar, earnings tracking, seasonal patterns, insider activity229- **Gamification:** Badges, leaderboards, progression system230- **Enterprise Export:** 9-step data lineage, scheduled exports, analytics231232---233234## Project Structure235236```237src/rot/238├── app/ # Server, pipeline runner, background loops239├── ingest/ # Reddit + RSS ingestion (7 modules)240├── trend/ # Trend detection and ranking241├── nlp/ # 10-module NLP pipeline (500+ lexicon)242├── extract/ # Event builder (dual-path NLP/regex)243├── market/ # Trade builder, enrichment, validation244├── credibility/ # ML scorer + 12 heuristics245├── reasoner/ # LLM reasoning with circuit breaker246├── storage/ # 33+ tables, 16 DB mixins, migrations247├── web/ # FastAPI routes, auth, middleware, templates248├── strategy/ # ML, genetic, regime, marketplace249├── social/ # Manipulation, propagation, network analysis250├── flow/ # Options flow intelligence, Greeks251├── backtest/ # Monte Carlo, walk-forward, 12 modules252├── macro/ # FOMC, earnings, seasonal, insider253├── alerts/ # Discord, email, Twitter, webhook dispatch254├── agents/ # Autonomous trading agents (safety rails)255├── gamification/ # Badges, leaderboards, progression256├── export/ # Enterprise exports, 9-step lineage257├── core/ # Config, types, logging, sanitization258└── ... # + affiliates, sports, integrations, analysis259260tests/ # 201 files, 92,182 lines, 6,916 test functions261templates/ # 64 Jinja2 templates262docs/ # 17 documentation files263```264265---266267## Setup268269```bash270# 1. Clone271git clone https://github.com/Mattbusel/Reddit-Options-Trader-ROT-.git272cd Reddit-Options-Trader-ROT-273274# 2. Configure275cp .env.example .env276# Fill in: Reddit API credentials, optional LLM API key277278# 3. Install279pip install -e ".[dev]"280281# 4. Run282python -m rot.app.server283# Dashboard: http://localhost:8000/dashboard284# API docs: http://localhost:8000/docs285286# 5. Test287pytest tests/ -v288```289290---291292## Audit Results293294Two independent AI-assisted audits, both scoring **A overall**:295296| Dimension | Score |297|-----------|-------|298| Security | A to A+ (93-98/100) |299| Architecture | A (95/100) |300| Code Quality | A (94/100) |301| Test Suite | A (92-95/100) |302| Dependencies | A to A+ |303| Documentation | A- to A |304| **Overall** | **A (93-95/100)** |305306Zero open recommendations. All P0, P1, P2, and P3 items from both audits have been closed.307308Full audit reports available in [`docs/`](docs/).309310---311312## Disclaimer313314This project is for research and experimentation only. Nothing in this repository constitutes financial advice. ROT is a signal intelligence platform, not an execution engine.315316---317318319320321322323324325326
Full transparency — inspect the skill content before installing.