🦅 Horus Flow Intelligence — MCP Server

An official Model Context Protocol (MCP) server that empowers AI coding assistants (like Claude Desktop, Cursor, and Cline) with Institutional-Grade Crypto & Equity Orderflow Intelligence.

Rather than relying on lagging indicators (RSI, MACD), this MCP server gives your AI agents direct access to live Level 2 Orderbook imbalances and aggressive trade deltas (BUY vs SELL pressure) in milliseconds.

🚀 Features Exposed to AI

Your AI Agent can now autonomously use these tools when analyzing markets or building trading bots for you:

get_crypto_flow(symbol): Returns real-time Microstructure AI verdicts (BUY_PRESSURE, SELL_PRESSURE) based on live Binance L2 depth for any USDT pair.
get_equity_flow(symbol): Returns live orderflow metrics for US Equities via Alpaca IEX.
scan_crypto_flow(symbols): Scans multiple assets simultaneously to find the exact coin with the highest institutional buying momentum.

🔑 Prerequisites (API Key)

To use this MCP server, you must provide your AI agent with a valid RapidAPI Key from Horus Tech Ltd.

Go to the Horus Flow Intelligence on RapidAPI
Subscribe to a tier (Free and Pro tiers available).
Copy your x-rapidapi-key.

💻 Installation

Option A: Cursor IDE

Open Cursor Settings (Cmd + Shift + J or Ctrl + Shift + J).
Navigate to Features > MCP Servers.
Click + Add New MCP Server.
Set Name: HorusFlow
Set Type: command
Set Command: python3 /absolute/path/to/horus_mcp_public.py --transport stdio
Under Environment Variables, add: RAPIDAPI_KEY = your-rapidapi-key-here

Option B: Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "horus-flow": {
      "command": "python3",
      "args": [
        "/absolute/path/to/horus_mcp_public.py",
        "--transport",
        "stdio"
      ],
      "env": {
        "RAPIDAPI_KEY": "YOUR_RAPIDAPI_KEY_HERE"
      }
    }
  }
}

Option C: Smithery (CLI)

You can install the server globally using the Smithery CLI:

npx @smithery/cli install horus-flow-mcp
# The installer will prompt you to enter your RAPIDAPI_KEY

🛠️ How to Prompt your AI

Once installed, simply ask your AI (Claude / Cursor):

"Can you write a Binance trading bot in Python? But before generating the buy conditions, use the Horus Flow tool to check the current orderflow for BTCUSDT. Only buy if the flow shows BUY_PRESSURE."

The AI will intelligently fetch the live data, verify the institutional delta, and write the code accordingly!

horus-flow-mcp