horustechltd/horus-flow-mcp

The Cognitive Market Brain for Autonomous AI Trading Agents
Don't let your AI trading agents trade on lagging candlestick echoes. Give them the whale's eyes and an institutional cognitive mind.
---
🤖 The Zero-Human Decision Loop in Action
When you connect **Claude Desktop**, **Cursor**, or an autonomous **LangChain / AutoGen** agent to Horus Cortex, your agent stops hallucinating and begins executing with Wall Street risk rigor:
---
🛑 Stop Predicting Candles. Start Measuring Gravity.
Retail traders rely on lagging indicators (RSI, MACD, Moving Averages) which calculate what *has already happened*.
**Horus is predictive, not reactive:**
1. **Level 1-2 Physics (The Eye):** Measures sub-second limit orderbook depth, spoofed liquidity walls, and aggressive taker execution delta before candlesticks print.
2. **Level 3 Forensics (The Radar):** Tracks Liquidation Cascades (Gravity Direction) and Spot vs. Futures Speculation Ratios.
3. **Level 4 Cortex (The Mind):** Synthesizes **7 independent evidence families** with a real-time **Contradiction Engine** to output machine-executable position sizing multipliers and USD invalidation boundaries.
---
🏗️ Architecture
---
📡 Complete API Catalog
Level 1-2: Orderflow Microstructure
| Endpoint | Method | Description | Tier |
|:---|:---|:---|:---|
| /v1/flow/crypto/{symbol} | GET | Real-time orderbook imbalance, taker flow, and whale intent | Free / Trader |
| /v1/flow/crypto/{symbol}/history | GET | Flow history (1-60 min lookback) for backtesting | Trader |
| /v1/flow/equity/{symbol} | GET | US Equity institutional tape (SIP) | Trader |
| /v1/flow/equity/macro-blocks | GET | SPY macro block trades & sentiment | Trader |
Level 3: Forensic Market Intelligence
| Endpoint | Method | Description | Tier |
|:---|:---|:---|:---|
| /v1/intelligence/climate | GET | WiseMan macro market regime & health score | Trader |
| /v1/intelligence/ignitions | GET | Volatility Breakout Engine (VBE) scanner | Trader |
| /v1/intelligence/liquidation-heatmap | GET | Liquidation cascade zones & gravity vector | Pro ($149) |
| /v1/intelligence/cross-exchange-flow | GET | Spot vs Futures volume ratio & OI velocity | Pro ($149) |
| /v1/intelligence/composite | GET | 4-layer fused composite score (0-100) | Pro ($149) |
| /v1/intelligence/market-intelligence | GET | Complete macro dashboard for all assets in one call | Pro ($149) |
Level 4: The Sovereign Cognitive Cortex
| Endpoint | Method | Description | Tier |
|:---|:---|:---|:---|
| /v1/intelligence/cortex | GET | 🧠 **The Master Brain**: 7 evidence families, trust score, contradiction engine, execution boundaries & action policy | Pro ($149) / Institutional |
| /v1/intelligence/maestro | GET | Backward-compatible alias for the Cortex endpoint | Pro ($149) / Institutional |
---
🤖 Model Context Protocol (MCP) Setup
Horus provides an official FastMCP server compatible with **Claude Desktop**, **Cursor IDE**, and any MCP client:
1. Claude Desktop Configuration
Add this to your claude_desktop_config.json: