Install the Supervisor. Tune the inputs. Trust it in stages.

Install the Supervisor in MT5

From "I just downloaded AI Agents Supervisor.ex5" to "watching the account" in a few small moves. You only ever need one instance — it supervises every EA on the account, not just the chart it sits on.

1. Open the MT5 Data Folder

   In MetaTrader 5: File → Open Data Folder. A Windows Explorer window opens at %APPDATA%\MetaQuotes\Terminal\<hash>\.

2. Drop the .ex5 into MQL5\Experts

   Copy AI Agents Supervisor.ex5 into MQL5\Experts. Upgrading? Overwrite the old file — MT5 uses the new binary on the next chart attach.

3. Restart MT5 (or refresh the Navigator)

   Close and reopen MT5, OR right-click Navigator → Expert Advisors and pick Refresh. AI Agents Supervisor should now appear.

4. Drag it onto any one chart

   Open any chart — the symbol and timeframe don't matter, because the Supervisor watches the whole account, not the chart. A spare EURUSD H1 chart is fine. Drag the EA on; the Inputs dialog opens. Paste your AI key (Group 2), pick your model (Group 1), and leave Execution mode on Shadow for now (Group 3). See Part 2 for every field.

   • Tick Allow Algo Trading on the Common tab.
   • Leave WebRequest URLs empty for now — the next step adds them.

5. Turn on AutoTrading

   Click the AutoTrading button in the toolbar (it turns green). In Shadow mode the Supervisor still won't touch the broker — AutoTrading only matters once you graduate to Approve or Live.

6. Check the Experts tab

   Open Toolbox → Experts (Ctrl+T). On a healthy first run you should see the Supervisor list the magics it discovered on the account and confirm its mode. Anything starting with SETUP INCOMPLETE or ERROR — jump to First-run check.

Allow these websites in MT5 (WebRequest)

MT5 blocks every outbound HTTP request by default. The Supervisor calls your AI provider to reason about each EA, so MT5 needs an explicit allowlist before that works. One-time setup, ~60 seconds.

• Where MT5 → Tools → Options → Expert Advisors tab.
• Tick "Allow WebRequest for listed URL", then add the endpoint for every provider you actually use:

• https://api.openai.com — if any agent runs on GPT (Group 1).
• https://api.anthropic.com — if any agent runs on Claude.
• https://generativelanguage.googleapis.com — if any agent runs on Gemini.
• https://api.deepseek.com — if any agent runs on DeepSeek.
• https://api.x.ai — if any agent runs on Grok (xAI).

First-run check

Two quick signals tell you the Supervisor is alive and watching.

1. The Experts tab lists your EAs

   On a healthy start the Supervisor prints the magic numbers it discovered on the account and the execution mode it's running in. If you see your other EAs listed and the mode reads SHADOW, it's working.

2. The on-chart status panel

   The Supervisor draws a status comment in the chart's top-left corner so you can confirm at a glance that it's running and which mode it's in. This is your quick health check between log reads.

API Setting — get your keys in five minutes

The Supervisor is BYOK — bring your own key. Your two model picks in Group 1 decide which providers you need; if both sit on the same provider, one key is all you fill.

1. Check which providers your models use

   Open the EA inputs → Group 1. The Main AI model (1.1) and the Decision model (1.2) each belong to one provider. Same provider on both → one key. Different providers → one key each.

2. Create the key at the provider

   Each one takes about two minutes: sign up, open the key page, click create, copy the key immediately (most providers show it only once).

   • OpenAI — platform.openai.com → API keys — for GPT models (the default pick on both seats).
   • Anthropic — console.anthropic.com → API Keys — for Claude Sonnet / Opus.
   • Google AI Studio — aistudio.google.com → Get API key — for Gemini 3 Pro / Flash.
   • DeepSeek (optional) — platform.deepseek.com — only if a seat runs DeepSeek.
   • xAI (optional) — console.x.ai — only if a seat runs Grok.

3. Paste it into Group 2

   Inputs dialog → Group 2 "API Keys" → paste the key into the field matching its provider — no spaces, no line breaks.

   See Group 2 — every key field explained

4. Allow the provider URL, then verify

   Whitelist the endpoint in Tools → Options → Expert Advisors — the URL list is in Part 0 · B above. Then run the First-run check: once every selected model has its key, the SETUP INCOMPLETE message is gone and the Supervisor starts its watch cycle.

The Shadow → Approve → Live ladder

The single most important setting is Execution mode. It is a trust ladder, not a switch — you climb it only after the Supervisor has earned it on your account.

1. Shadow — watch only (start here)

   The Supervisor runs the full analysis and logs exactly what it would do, but never touches the broker. Leave it here for at least a week. Read the log against what your EAs actually did — this is how you learn to trust (or distrust) its judgement at zero risk.

2. Approve — ask first

   The Supervisor proposes an action and waits for your manual approval before anything reaches the broker. Good for the middle phase: you stay in control of every intervention while the Supervisor does the watching and the thinking.

3. Live — auto-execute (must be earned)

   The Supervisor acts on its own decisions in real time. Only move here once Shadow and Approve have given you weeks of evidence that its interventions help rather than hurt. AutoTrading must be on.

What it watches — and how it controls

By default the Supervisor watches every EA on the account. How firmly it can intervene depends on whether the target speaks its control protocol.

Whole account vs. specific magics

With Target mode on Whole account (default), it auto-discovers every magic number trading on the account — no list to maintain. Switch to Specific magics only when you want it to ignore everything except the EAs you name.

Cooperative vs. broker-side control

Risk guardrails

The guardrails in Group 4 are account-wide hard limits. They apply across every watched EA at once, regardless of execution mode — even in Shadow the Supervisor measures the account against them and logs every breach.

• Daily loss cap — once the account is down this % on the day, the Supervisor moves to protect (pause entries / close, depending on mode). Default 3%.
• Weekly loss cap — the same idea over the rolling week. Default 6%.
• Equity floor — a hard line. Below this % of your starting equity the Supervisor stops the account trading. Default 80%.
• News blackout — pauses around high-impact news so an EA doesn't get caught in a spike. On by default.

The control actions

When the AI decides an EA needs reining in, it issues one of a small, fixed vocabulary of commands. Knowing them makes the Shadow-mode log easy to read.

• Pause — stop the target opening new entries; existing trades keep running.
• Resume — lift a pause.
• Scale lot — multiply the target's lot size (e.g. cut to 0.5× in elevated risk).
• Direction lock — restrict the target to long-only, short-only, or release back to both.
• Force close — close all of the target's open positions. The blunt instrument — the only one available for broker-side (third-party) EAs.
• Tighten SL — pull stops in to a tighter ATR distance to cap downside on open trades.

Common errors

Six symptoms cover most "it's not working" reports. The Experts tab (Ctrl+T) tells you which one you hit.