UT Bot MetaTrader 5 Webhook Bridge & AI Agent

Automate your TradingView Pine Script alerts directly into MetaTrader 5 (MT5) with custom Stop Loss (SL) and Take Profit (TP) levels using FastAPI, ngrok, and the Antigravity developer agent.

🌟 How It Works

[TradingView Strategy Alert] 
          │ (Triggers & sends JSON payload)
          ▼
[ngrok Tunnel (Public URL)]
          │ (Forwards to local machine)
          ▼
[FastAPI Webhook Server]
          │ (Parses payload & gets current price)
          ▼
[MetaTrader 5 Client]
          │ (Executes market order with SL & TP)
          ▼
   [MT5 Terminal]

Related MCP server: MCP Trader Server

📋 Prerequisites

1. Windows OS (required for the MetaTrader 5 Python SDK).

2. Python 3.10+ installed.

3. MetaTrader 5 Desktop Terminal installed and logged into your broker account.

4. Algorithmic Trading Enabled:

   • Open MT5.

   • Go to Tools ➔ Options ➔ Expert Advisors.

   • Check "Allow algorithmic trading" and click OK.

🚀 Quick Start & Installation

Step 1: Install Dependencies

Install the required Python packages:

pip install fastapi uvicorn metatrader-mcp-server pydantic

Step 2: Configure Antigravity MCP Server

To allow Antigravity to check your balances, open positions, and manage trades using natural language, update your global Antigravity configuration file:

File Path: C:\Users\DATA ENG. OLA\.gemini\config\mcp_config.json

Add the "metatrader" server configuration:

{
  "mcpServers": {
    "metatrader": {
      "command": "C:\\Users\\DATA ENG. OLA\\AppData\\Local\\Packages\\PythonSoftwareFoundation.Python.3.13_qbz5n2kfra8p0\\LocalCache\\local-packages\\Python313\\Scripts\\metatrader-mcp-server.exe",
      "args": [
        "--login", "YOUR_MT5_LOGIN",
        "--password", "YOUR_MT5_PASSWORD",
        "--server", "YOUR_MT5_SERVER",
        "--transport", "stdio"
      ]
    }
  }
}

(Make sure to adjust the path to your python local-packages directory if it differs).

Step 3: Set Up the Webhook Bridge

Create the webhook_bridge.py file to receive and process alerts from TradingView. The script automatically handles symbol cleaning (removing exchange prefixes like EXNESS:) and resolves library-specific SL/TP validation bugs.

Running the Server

Run the webhook bridge on port 5001:

python webhook_bridge.py

Step 4: Expose the Port Using ngrok

Expose port 5001 to the internet to get a public URL for TradingView:

ngrok http 5001

Copy the generated Forwarding URL (e.g. https://your-subdomain.ngrok-free.dev).

📊 TradingView Integration

Step 1: Save the Pine Script

Create a new Pine Editor script in TradingView and paste the code from ut_bot_strategy.pine. Click Save and Add to chart.

Step 2: Set Up the Alert

1. Press Alt + A to open the Create Alert dialog.

2. Condition: Select UT Bot Strategy – Buy & Sell with SL/TP.

3. Trigger: Select Alert() function calls only (crucial for sending dynamic JSON parameters).

4. Webhook URL: Under the Notifications tab, check Webhook URL and paste your public ngrok URL with /webhook at the end: https://your-subdomain.ngrok-free.dev/webhook

5. Alert Name: UT Bot MT5 Automation.

6. Clear the Message box.

7. Click Create.

🔒 Security Recommendations

• Demo First: Always test with a demo/trial account before using real money.

• Firewalling: Use an authentication mechanism or limit ngrok access if deploying to a production VPS.