Horus Flow MCP

---

🤖 El Ciclo de Decisión Cero-Humano en Acción

Cuando conectas Claude Desktop, Cursor, o un agente autónomo de LangChain / AutoGen a Horus Cortex, tu agente deja de alucinar y comienza a ejecutar con el rigor de riesgo de Wall Street:

┌─────────────────────────────────────────────────────────────────────────────────────────────┐
│  Autonomous Quant Agent (Claude 3.5 Sonnet / Cursor IDE) 🤖                                │
│                                                                                             │
│  Prompt: "BTC is pumping. Should we execute a 3x breakout long entry?"                      │
│                                                                                             │
│  AI Calls Tool: `get_horus_cortex()`                                                        │
│  ◀  Horus Cortex Returns:                                                                   │
│     {                                                                                       │
│       "regime_state": "TRANSITION",                                                         │
│       "trust_score": 26.5,                                                                  │
│       "action_policy": {                                                                    │
│         "directive": "Deteriorating Transition: Capital Preservation Lock (0.0x)",          │
│         "trend_allowed": false,                                                             │
│         "ignition_allowed": false                                                           │
│       },                                                                                    │
│       "market_vitals": { "taker_ratio": 0.24, "global_ignition": 0.08 },                    │
│       "active_contradictions": [                                                            │
│         { "id": "BULLISH_PRICE_vs_HOLLOW_BREADTH", "severity": "MEDIUM" }                   │
│       ],                                                                                    │
│       "execution_boundaries": {                                                             │
│         "invalidation_support": 77052.0,                                                    │
│         "breakout_resistance": 78608.0                                                      │
│       }                                                                                     │
│     }                                                                                       │
│                                                                                             │
│  AI Final Output:                                                                           │
│  "⛔ TRADE ABORTED — CAPITAL PRESERVATION ENFORCED.                                        │
│   Although spot price is making local highs, Horus Cortex flags a severe divergence:        │
│   1. Taker Buy/Sell ratio collapsed to 0.24 (Aggressive seller absorption).                 │
│   2. Global market breadth is dormant (0.08) indicating an isolated, hollow squeeze.        │
│   3. Cortex Trust Score is 26.5/100 with active trend locks enabled.                        │
│   Action: Standing aside. Re-evaluating only if price confirms above $78,608 with volume."  │
└─────────────────────────────────────────────────────────────────────────────────────────────┘

---

🛑 Deja de Predecir Velas. Empieza a Medir la Gravedad.

Los traders minoristas dependen de indicadores rezagados (RSI, MACD, Medias Móviles) que calculan lo que ya ha sucedido.

Horus es predictivo, no reactivo:

1. Nivel 1-2 Física (El Ojo): Mide la profundidad del libro de órdenes en subsegundos, muros de liquidez falsos (spoofing), y el delta de ejecución agresiva del tomador antes de que se impriman las velas.
2. Nivel 3 Forense (El Radar): Rastrea Cascadas de Liquidación (Dirección de la Gravedad) y Ratios de Especulación Spot vs. Futuros.
3. Nivel 4 Cortex (La Mente): Sintetiza 7 familias de evidencia independientes con un Motor de Contradicciones en tiempo real para generar multiplicadores de tamaño de posición ejecutables por máquina y límites de invalidación en USD.

---

🏗️ Arquitectura

graph TD
    %% Styling
    classDef crypto_stream fill:#F3BA2F,stroke:#000,color:#000,stroke-width:2px;
    classDef equity_stream fill:#000,stroke:#09b533,color:#09b533,stroke-width:2px;
    classDef compute fill:#1A1F36,stroke:#00D6FF,color:#fff,stroke-width:2px;
    classDef level3 fill:#1A1F36,stroke:#FF6B00,color:#fff,stroke-width:2px;
    classDef cortex fill:#4A154B,stroke:#FFD700,color:#fff,stroke-width:3px;
    classDef mcp fill:#632CA6,stroke:#fff,color:#fff,stroke-width:2px;
    classDef client fill:#FF3366,stroke:#fff,color:#fff,stroke-width:2px;

    %% Ingestion
    subgraph Data_Pipelines [Sub-Millisecond Websocket Ingestion]
        B[Binance WSS <br/> L1/L2 Book]:::crypto_stream
        A[Alpaca WSS <br/> SIP Equities]:::equity_stream
        BF[Binance Futures <br/> OI / Funding / Liquidations]:::crypto_stream
    end

    %% Level 1-2 Engine
    subgraph Core_Engine [Level 1-2: Microstructure Physics]
        IC[Imbalance Calculator <br/> Bid/Ask Walls]:::compute
        FC[Flow Calculator <br/> Tape Deltas]:::compute
        BC[Behavioral Court <br/> Spoofing & Absorption Rules]:::compute
    end

    %% Level 3 Intelligence
    subgraph L3_Engine [Level 3: Institutional Intelligence]
        LH[Liquidation Heatmap <br/> Gravity Zones]:::level3
        XF[Cross-Exchange Flow <br/> Spot ↔ Futures]:::level3
        CI[Composite Intelligence <br/> 4-Layer Verdict]:::level3
    end

    %% Level 4 Cognitive Cortex
    subgraph L4_Cortex [Level 4: The Sovereign Cognitive Cortex]
        HC[Horus Cortex Symphony 3.0 <br/> 7 Forensic Families + Contradiction Engine]:::cortex
        TS[Penalized Trust Score 0-100]:::compute
        EB[Execution Boundaries USD]:::compute
        AP[Action Policy Multipliers for Bots]:::compute
    end

    %% Output
    subgraph Output_Layer [Data Delivery & Agent Integration]
        MCP[AI Agent FastMCP Server <br/> 8 Sovereign Tools]:::mcp
        API[FastAPI REST Gateway <br/> 13 Endpoints]:::client
        Dash[Real-Time Portal <br/> Live Microstructure]:::client
    end

    B --> IC
    A --> IC
    B --> FC
    A --> FC
    BF --> LH
    BF --> XF

    IC --> BC
    FC --> BC
    LH --> CI
    XF --> CI
    BC --> CI

    CI --> HC
    HC --> TS
    HC --> EB
    HC --> AP

    HC --> MCP
    HC --> API
    BC --> Dash

---

📡 Catálogo Completo de API

Nivel 1-2: Microestructura de Flujo de Órdenes

Endpoint	Método	Descripción	Nivel
/v1/flow/crypto/{symbol}	GET	Desequilibrio del libro de órdenes en tiempo real, flujo del tomador e intención de la ballena	Gratis / Trader
/v1/flow/crypto/{symbol}/history	GET	Historial de flujo (retrospectiva de 1-60 min) para backtesting	Trader
/v1/flow/equity/{symbol}	GET	Cinta institucional de acciones de EE. UU. (SIP)	Trader
/v1/flow/equity/macro-blocks	GET	Operaciones en bloque macro de SPY y sentimiento	Trader

Nivel 3: Inteligencia Forense de Mercado

Endpoint	Método	Descripción	Nivel
/v1/intelligence/climate	GET	Régimen macro de mercado WiseMan y puntuación de salud	Trader
/v1/intelligence/ignitions	GET	Escáner del Motor de Ruptura de Volatilidad (VBE)	Trader
/v1/intelligence/liquidation-heatmap	GET	Zonas de cascada de liquidación y vector de gravedad	Pro ($149)
/v1/intelligence/cross-exchange-flow	GET	Ratio de volumen Spot vs Futuros y velocidad de OI	Pro ($149)
/v1/intelligence/composite	GET	Puntuación compuesta fusionada de 4 capas (0-100)	Pro ($149)
/v1/intelligence/market-intelligence	GET	Panel macro completo para todos los activos en una sola llamada	Pro ($149)

Nivel 4: El Cortex Cognitivo Soberano

Endpoint	Método	Descripción	Nivel
/v1/intelligence/cortex	GET	🧠 El Cerebro Maestro: 7 familias de evidencia, puntuación de confianza, motor de contradicciones, límites de ejecución y política de acción	Pro ($149) / Institucional
/v1/intelligence/maestro	GET	Alias retrocompatible para el endpoint Cortex	Pro ($149) / Institucional

---

🤖 Configuración del Protocolo de Contexto de Modelo (MCP)

Horus proporciona un servidor FastMCP oficial compatible con Claude Desktop, Cursor IDE y cualquier cliente MCP:

1. Configuración de Claude Desktop

Añade esto a tu claude_desktop_config.json:

{
  "mcpServers": {
    "horus-cortex": {
      "command": "python3",
      "args": ["/absolute/path/to/horus_flow_api/horus_mcp.py", "--transport", "stdio"],
      "env": {
        "FLOW_API_KEY": "YOUR_HORUS_API_KEY"
      }
    }
  }
}

2. Herramientas Soberanas Disponibles para Agentes de IA

1. get_horus_cortex(): 🧠 Herramienta Cognitiva Principal — Consenso completo, puntuación de confianza (0-100), límites ($) y multiplicadores de acción del bot.
2. get_crypto_flow(symbol): Flujo de órdenes L2 en subsegundos y delta de operaciones agresivas.
3. get_equity_flow(symbol): Operaciones en bloque de acciones de EE. UU. e impresiones de cinta.
4. scan_crypto_flow(symbols): Escáner por lotes para posicionamiento activo de ballenas.
5. get_liquidation_heatmap(symbol): Zonas de cascada de liquidación y atracción gravitacional.
6. get_cross_exchange_flow(symbol): Ratio de volumen Spot vs Futuros y riesgo de tasa de financiación.
7. get_composite_intelligence(symbol): Veredicto compuesto de 4 capas (0-100).
8. get_full_market_intelligence(): Visión macro de todos los instrumentos monitoreados.

---

⚡ Inicio Rápido de Bot Cuantitativo en 60 Segundos (Python)

import requests

HEADERS = {"X-API-Key": "your_horus_api_key"}
BASE_URL = "https://flow.horustek.pro"

# 1. Query Horus Cortex for the Sovereign Market State
res = requests.get(f"{BASE_URL}/v1/intelligence/cortex", headers=HEADERS).json()

trust_score = res["trust_score"]
policy = res["action_policy"]
boundaries = res["execution_boundaries"]

print(f"🧠 Market State: {res['regime_state']} | Trust: {trust_score}/100")
print(f"🛡️ Action Directive: {policy['directive']}")
print(f"🎯 Support Invalidation: ${boundaries['invalidation_support']:,.0f} | Breakout Target: ${boundaries['breakout_resistance']:,.0f}")

# 2. Enforce Autonomous Risk Rules
if not policy["trend_allowed"]:
    print("⛔ Trade Rejected: Cortex forbids trend breakouts during transitions.")
else:
    position_multiplier = policy["trend_multiplier"]
    # execute_trade(multiplier=position_multiplier, stop_loss=boundaries["invalidation_support"])

---

💎 Niveles de Suscripción Institucional

Característica	Explorer (Gratis)	Trader ($49/mes)	Professional ($149/mes)	Institutional ($499/mes)
Cuota Diaria de API	100 llamadas/día	1,000 llamadas/día	5,000 llamadas/día	Ilimitada
Flujo L2 de Microestructura	Top 3 Símbolos	Todos los Símbolos Cripto	Todos los Cripto + Acciones EE. UU.	Todos los Instrumentos
Cinta de Ballenas y Desequilibrios	Básico	Tiempo Real	Tiempo Real Sub-ms	Socket Dedicado Prioritario
Inteligencia de Nivel 3	❌	❌	✅ Acceso Completo	✅ Acceso Completo
🧠 Nivel 4 Horus Cortex	❌	❌	✅ Cerebro Cognitivo Completo	✅ Cerebro Cognitivo Completo
Multiplicadores de Bot Autónomo	❌	❌	✅	✅
Servidor MCP para Agentes de IA	Comunidad	Comunidad	✅ Acceso FastMCP Completo	✅ Servidor Privado Dedicado
SLA y Soporte	Comunidad	Estándar	Prioritario	Mesa Cuantitativa Dedicada 24/7

---

🌐 Panel en Vivo en Tiempo Real

Explora el visualizador institucional de flujo de órdenes en vivo en flow.horustek.pro/dash/.

---

Ingeniería con rigor matemático para Agentes Autónomos de IA y Traders Cuantitativos.
© 2026 Horus Tech Ltd. 🦅