Setup

Connecting MT5

Open the Agent GUI and configure your MT5 credentials and backend connection. The agent encrypts everything locally — your broker password never leaves your machine in plaintext.

01Open the GUI

Launch BullionAgent.exe from the agent folder. If the service is running, the GUI connects to it via a local IPC channel (port 17421) and reflects live status. If the service isn't running yet, the GUI will show disconnected — you can still configure credentials.

02Fill in the Setup tab

Navigate to the Setup tab and fill in all required fields:

Field	Type		Notes
Backend URL	string	required	Your Bullion backend gRPC address. Provided during onboarding, e.g. your-vps-ip:50051
Agent ID	string	required	Copy from the dashboard → Agents → your agent → Agent ID
API Key	string	required	Copy from the dashboard → Agents → your agent → API Key
MT5 Path	path	required	Full path to terminal64.exe, e.g. C:\Program Files\MetaTrader 5\terminal64.exe
MT5 Account	number	required	Your numeric MT5 login number from your broker
MT5 Server	string	required	Broker server name exactly as shown in MT5, e.g. ICMarkets-Demo02
MT5 Password	password	required	Your MT5 account password. Stored encrypted in local SQLite — never sent to the backend in plaintext

ℹ

Finding your MT5 Path. In MT5, go to Help → About. The data folder path is shown there. The terminal executable is terminal64.exe one level up from the data folder. Alternatively, use the Browse button in the Agent GUI to navigate to it directly.

03Save and connect

1
Click Save configuration
The agent writes all credentials to its encrypted local database (storage/agent.db) and immediately attempts to connect.
2
Watch the status card
The top-left of the GUI shows three indicators. Within a few seconds you should see:
gRPC liveMT5 sync
If MT5 isn't already running, the agent will launch the terminal and wait up to 15 seconds for it to initialize before attempting login.
3
Check the dashboard
In the dashboard, go to Agents. Your agent should show as healthy with a recent heartbeat timestamp. The linked broker account will flip to connected within the next reconciliation cycle (~30 seconds).

Troubleshooting

If the gRPC indicator stays at wait, double-check the Backend URL and API Key — a single wrong character will prevent authentication. Check the Logs tab in the GUI for detailed error messages.

If MT5 stays at off, verify the MT5 Path is correct and points to terminal64.exe, and that your account number, server, and password are exactly right. The Logs tab will show the raw MT5 error code.

⚠

Credential security. The agent stores credentials in an encrypted SQLite file at storage/agent.db. Keep this directory access-controlled on your machine. Never share the agent.db file.

Add a broker account →