metatrader-mcp-server

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]

---

📋 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: ``bash 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: ``json { "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: ``bash python webhook_bridge.py ``

Step 4: Expose the Port Using ngrok

Expose port 5001 to the internet to get a public URL for TradingView: ``bash 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

1. Alert Name: UT Bot MT5 Automation.
2. Clear the Message box.
3. 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.