{
  "markdown": "<div align=\"center\">\n  <h1>🦅 HORUS CORTEX & FLOW</h1>\n  <h3>The Cognitive Market Brain for Autonomous AI Trading Agents</h3>\n\n  <p>\n    <a href=\"https://glama.ai/mcp/servers/horustechltd/horus-flow-mcp\"><img src=\"https://glama.ai/mcp/servers/horustechltd/horus-flow-mcp/badges/card.svg\" alt=\"Glama Verified\"></a>\n    <a href=\"https://glama.ai/mcp/servers/horustechltd/horus-flow-mcp\"><img src=\"https://glama.ai/mcp/servers/horustechltd/horus-flow-mcp/badges/score.svg\" alt=\"Glama Score\"></a>\n  </p>\n\n  <p>\n    <img src=\"https://img.shields.io/badge/Quality-A--Tier%20Verified-gold?style=for-the-badge&logo=ai\" alt=\"A-Tier\">\n    <img src=\"https://img.shields.io/badge/Protocol-FastMCP%202.0-purple?style=for-the-badge&logo=anthropic\" alt=\"FastMCP\">\n    <img src=\"https://img.shields.io/badge/Latency-Sub--Millisecond-brightgreen?style=for-the-badge&logo=speedtest\" alt=\"Latency\">\n    <img src=\"https://img.shields.io/badge/Python-3.12+-blue?style=for-the-badge&logo=python\" alt=\"Python\">\n    <img src=\"https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge\" alt=\"License\">\n  </p>\n\n  <p>\n    <strong>Don't let your AI trading agents trade on lagging candlestick echoes. Give them the whale's eyes and an institutional cognitive mind.</strong>\n  </p>\n</div>\n\n---\n\n## 🤖 The Zero-Human Decision Loop in Action\n\nWhen 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:\n\n```text\n┌─────────────────────────────────────────────────────────────────────────────────────────────┐\n│  Autonomous Quant Agent (Claude 3.5 Sonnet / Cursor IDE) 🤖                                │\n│                                                                                             │\n│  Prompt: \"BTC is pumping. Should we execute a 3x breakout long entry?\"                      │\n│                                                                                             │\n│  AI Calls Tool: `get_horus_cortex()`                                                        │\n│  ◀  Horus Cortex Returns:                                                                   │\n│     {                                                                                       │\n│       \"regime_state\": \"TRANSITION\",                                                         │\n│       \"trust_score\": 26.5,                                                                  │\n│       \"action_policy\": {                                                                    │\n│         \"directive\": \"Deteriorating Transition: Capital Preservation Lock (0.0x)\",          │\n│         \"trend_allowed\": false,                                                             │\n│         \"ignition_allowed\": false                                                           │\n│       },                                                                                    │\n│       \"market_vitals\": { \"taker_ratio\": 0.24, \"global_ignition\": 0.08 },                    │\n│       \"active_contradictions\": [                                                            │\n│         { \"id\": \"BULLISH_PRICE_vs_HOLLOW_BREADTH\", \"severity\": \"MEDIUM\" }                   │\n│       ],                                                                                    │\n│       \"execution_boundaries\": {                                                             │\n│         \"invalidation_support\": 77052.0,                                                    │\n│         \"breakout_resistance\": 78608.0                                                      │\n│       }                                                                                     │\n│     }                                                                                       │\n│                                                                                             │\n│  AI Final Output:                                                                           │\n│  \"⛔ TRADE ABORTED — CAPITAL PRESERVATION ENFORCED.                                        │\n│   Although spot price is making local highs, Horus Cortex flags a severe divergence:        │\n│   1. Taker Buy/Sell ratio collapsed to 0.24 (Aggressive seller absorption).                 │\n│   2. Global market breadth is dormant (0.08) indicating an isolated, hollow squeeze.        │\n│   3. Cortex Trust Score is 26.5/100 with active trend locks enabled.                        │\n│   Action: Standing aside. Re-evaluating only if price confirms above $78,608 with volume.\"  │\n└─────────────────────────────────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## 🛑 Stop Predicting Candles. Start Measuring Gravity.\n\nRetail traders rely on lagging indicators (RSI, MACD, Moving Averages) which calculate what *has already happened*. \n\n**Horus is predictive, not reactive:**\n1. **Level 1-2 Physics (The Eye):** Measures sub-second limit orderbook depth, spoofed liquidity walls, and aggressive taker execution delta before candlesticks print.\n2. **Level 3 Forensics (The Radar):** Tracks Liquidation Cascades (Gravity Direction) and Spot vs. Futures Speculation Ratios.\n3. **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.\n\n---\n\n## 🏗️ Architecture\n\n```mermaid\ngraph TD\n    %% Styling\n    classDef crypto_stream fill:#F3BA2F,stroke:#000,color:#000,stroke-width:2px;\n    classDef equity_stream fill:#000,stroke:#09b533,color:#09b533,stroke-width:2px;\n    classDef compute fill:#1A1F36,stroke:#00D6FF,color:#fff,stroke-width:2px;\n    classDef level3 fill:#1A1F36,stroke:#FF6B00,color:#fff,stroke-width:2px;\n    classDef cortex fill:#4A154B,stroke:#FFD700,color:#fff,stroke-width:3px;\n    classDef mcp fill:#632CA6,stroke:#fff,color:#fff,stroke-width:2px;\n    classDef client fill:#FF3366,stroke:#fff,color:#fff,stroke-width:2px;\n\n    %% Ingestion\n    subgraph Data_Pipelines [Sub-Millisecond Websocket Ingestion]\n        B[Binance WSS <br/> L1/L2 Book]:::crypto_stream\n        A[Alpaca WSS <br/> SIP Equities]:::equity_stream\n        BF[Binance Futures <br/> OI / Funding / Liquidations]:::crypto_stream\n    end\n\n    %% Level 1-2 Engine\n    subgraph Core_Engine [Level 1-2: Microstructure Physics]\n        IC[Imbalance Calculator <br/> Bid/Ask Walls]:::compute\n        FC[Flow Calculator <br/> Tape Deltas]:::compute\n        BC[Behavioral Court <br/> Spoofing & Absorption Rules]:::compute\n    end\n\n    %% Level 3 Intelligence\n    subgraph L3_Engine [Level 3: Institutional Intelligence]\n        LH[Liquidation Heatmap <br/> Gravity Zones]:::level3\n        XF[Cross-Exchange Flow <br/> Spot ↔ Futures]:::level3\n        CI[Composite Intelligence <br/> 4-Layer Verdict]:::level3\n    end\n\n    %% Level 4 Cognitive Cortex\n    subgraph L4_Cortex [Level 4: The Sovereign Cognitive Cortex]\n        HC[Horus Cortex Symphony 3.0 <br/> 7 Forensic Families + Contradiction Engine]:::cortex\n        TS[Penalized Trust Score 0-100]:::compute\n        EB[Execution Boundaries USD]:::compute\n        AP[Action Policy Multipliers for Bots]:::compute\n    end\n\n    %% Output\n    subgraph Output_Layer [Data Delivery & Agent Integration]\n        MCP[AI Agent FastMCP Server <br/> 8 Sovereign Tools]:::mcp\n        API[FastAPI REST Gateway <br/> 13 Endpoints]:::client\n        Dash[Real-Time Portal <br/> Live Microstructure]:::client\n    end\n\n    B --> IC\n    A --> IC\n    B --> FC\n    A --> FC\n    BF --> LH\n    BF --> XF\n\n    IC --> BC\n    FC --> BC\n    LH --> CI\n    XF --> CI\n    BC --> CI\n\n    CI --> HC\n    HC --> TS\n    HC --> EB\n    HC --> AP\n\n    HC --> MCP\n    HC --> API\n    BC --> Dash\n```\n\n---\n\n## 📡 Complete API Catalog\n\n### Level 1-2: Orderflow Microstructure\n| Endpoint | Method | Description | Tier |\n|:---|:---|:---|:---|\n| `/v1/flow/crypto/{symbol}` | `GET` | Real-time orderbook imbalance, taker flow, and whale intent | Free / Trader |\n| `/v1/flow/crypto/{symbol}/history` | `GET` | Flow history (1-60 min lookback) for backtesting | Trader |\n| `/v1/flow/equity/{symbol}` | `GET` | US Equity institutional tape (SIP) | Trader |\n| `/v1/flow/equity/macro-blocks` | `GET` | SPY macro block trades & sentiment | Trader |\n\n### Level 3: Forensic Market Intelligence\n| Endpoint | Method | Description | Tier |\n|:---|:---|:---|:---|\n| `/v1/intelligence/climate` | `GET` | WiseMan macro market regime & health score | Trader |\n| `/v1/intelligence/ignitions` | `GET` | Volatility Breakout Engine (VBE) scanner | Trader |\n| `/v1/intelligence/liquidation-heatmap` | `GET` | Liquidation cascade zones & gravity vector | Pro ($149) |\n| `/v1/intelligence/cross-exchange-flow` | `GET` | Spot vs Futures volume ratio & OI velocity | Pro ($149) |\n| `/v1/intelligence/composite` | `GET` | 4-layer fused composite score (0-100) | Pro ($149) |\n| `/v1/intelligence/market-intelligence` | `GET` | Complete macro dashboard for all assets in one call | Pro ($149) |\n\n### Level 4: The Sovereign Cognitive Cortex\n| Endpoint | Method | Description | Tier |\n|:---|:---|:---|:---|\n| `/v1/intelligence/cortex` | `GET` | 🧠 **The Master Brain**: 7 evidence families, trust score, contradiction engine, execution boundaries & action policy | Pro ($149) / Institutional |\n| `/v1/intelligence/maestro` | `GET` | Backward-compatible alias for the Cortex endpoint | Pro ($149) / Institutional |\n\n---\n\n## 🤖 Model Context Protocol (MCP) Setup\n\nHorus provides an official FastMCP server compatible with **Claude Desktop**, **Cursor IDE**, and any MCP client:\n\n### 1. Claude Desktop Configuration\nAdd this to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"horus-cortex\": {\n      \"command\": \"python3\",\n      \"args\": [\"/absolute/path/to/horus_flow_api/horus_mcp.py\", \"--transport\", \"stdio\"],\n      \"env\": {\n        \"FLOW_API_KEY\": \"YOUR_HORUS_API_KEY\"\n      }\n    }\n  }\n}\n```\n\n### 2. Available Sovereign Tools for AI Agents\n1. `get_horus_cortex()`: 🧠 **Primary Cognitive Tool** — Full consensus, trust score (0-100), boundaries ($), and bot action multipliers.\n2. `get_crypto_flow(symbol)`: Sub-second L2 orderflow and aggressive trade delta.\n3. `get_equity_flow(symbol)`: US Equity block trades and tape prints.\n4. `scan_crypto_flow(symbols)`: Batch scanner for active whale positioning.\n5. `get_liquidation_heatmap(symbol)`: Liquidation cascade zones and gravitational pull.\n6. `get_cross_exchange_flow(symbol)`: Spot vs Futures volume ratio and funding rate risk.\n7. `get_composite_intelligence(symbol)`: 4-layer composite verdict (0-100).\n8. `get_full_market_intelligence()`: Macro overview of all monitored instruments.\n\n---\n\n## ⚡ 60-Second Quant Bot Quickstart (Python)\n\n```python\nimport requests\n\nHEADERS = {\"X-API-Key\": \"your_horus_api_key\"}\nBASE_URL = \"https://flow.horustek.pro\"\n\n# 1. Query Horus Cortex for the Sovereign Market State\nres = requests.get(f\"{BASE_URL}/v1/intelligence/cortex\", headers=HEADERS).json()\n\ntrust_score = res[\"trust_score\"]\npolicy = res[\"action_policy\"]\nboundaries = res[\"execution_boundaries\"]\n\nprint(f\"🧠 Market State: {res['regime_state']} | Trust: {trust_score}/100\")\nprint(f\"🛡️ Action Directive: {policy['directive']}\")\nprint(f\"🎯 Support Invalidation: ${boundaries['invalidation_support']:,.0f} | Breakout Target: ${boundaries['breakout_resistance']:,.0f}\")\n\n# 2. Enforce Autonomous Risk Rules\nif not policy[\"trend_allowed\"]:\n    print(\"⛔ Trade Rejected: Cortex forbids trend breakouts during transitions.\")\nelse:\n    position_multiplier = policy[\"trend_multiplier\"]\n    # execute_trade(multiplier=position_multiplier, stop_loss=boundaries[\"invalidation_support\"])\n```\n\n---\n\n## 💎 Institutional Subscription Tiers\n\n| Feature | Explorer (Free) | Trader ($49/mo) | Professional ($149/mo) | Institutional ($499/mo) |\n|:---|:---:|:---:|:---:|:---:|\n| **Daily API Quota** | 100 calls/day | 1,000 calls/day | 5,000 calls/day | Unlimited |\n| **Microstructure L2 Flow** | Top 3 Symbols | All Crypto Symbols | All Crypto + US Equity | All Instruments |\n| **Whale Tape & Imbalances** | Basic | Real-Time | Real-Time Sub-ms | Priority Dedicated Socket |\n| **Level 3 Intelligence** | ❌ | ❌ | ✅ Full Access | ✅ Full Access |\n| **🧠 Level 4 Horus Cortex** | ❌ | ❌ | ✅ **Full Cognitive Brain** | ✅ **Full Cognitive Brain** |\n| **Autonomous Bot Multipliers** | ❌ | ❌ | ✅ | ✅ |\n| **AI Agent MCP Server** | Community | Community | ✅ Full FastMCP Access | ✅ Dedicated Private Server |\n| **SLA & Support** | Community | Standard | Priority | 24/7 Dedicated Quant Desk |\n\n---\n\n## 🌐 Live Real-Time Dashboard\nExplore the live institutional orderflow visualizer at [flow.horustek.pro/dash/](https://flow.horustek.pro/dash/).\n\n---\n\n*Engineered with mathematical rigor for Autonomous AI Agents and Quantitative Traders.*  \n**© 2026 Horus Tech Ltd.** 🦅\n",
  "bytes": 12850,
  "sha": "b40aca7264c43163bd4d1f960f0ce8bf155a8a384eeee59003f64d8d2f0139cb",
  "repo_slug": "horustechltd/horus-flow-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_pro_horustek_horus_flow_mcp_f78b35ad/readme"
}