Restituisce la versione installata di mt5-remote-reader-mcp. Utile per verificare che il package sia aggiornato.

Aggiunge o aggiorna una VPS nella rubrica locale sicura. Le credenziali sono salvate cifrate in ~/.mt5-reader/vps.json. Dopo questa chiamata non sarà mai più necessario inserire ip, username e password.

Elenca tutte le VPS salvate in rubrica. Mostra nome, IP e username — mai le password. Chiamare sempre questo tool per primo per vedere le VPS disponibili.

Rimuove una VPS dalla rubrica.

Configura una VPS Windows per l'uso con mt5-remote-reader. Va chiamato la prima volta che si usa una VPS nuova.

Fa tutto automaticamente:

• Verifica se Python è installato, altrimenti lo installa

• Installa le librerie necessarie (MetaTrader5, psutil)

• Copia mt5_tool.py sulla VPS

• Testa la connessione con MT5 e ritorna i terminali trovati

Se SSH non è raggiungibile (VPS vergine), scarica automaticamente setup_mt5_vps.exe in ~/Downloads e fornisce le istruzioni per eseguirlo.

MetaTrader 5 deve essere già installato e loggato sulla VPS.

Scarica setup_mt5_vps_{version}.exe in ~/Downloads e restituisce il percorso.

Usare quando connect_vps fallisce perché SSH non è ancora attivo sulla VPS. L'exe va copiato sulla VPS Windows ed eseguito come amministratore: tasto destro → "Esegui come amministratore".

L'exe installa automaticamente sulla VPS:

• OpenSSH Server (abilita la connessione SSH)

• Python 3.8

• Librerie MetaTrader5 e psutil

• mt5_tool.py sul Desktop della VPS

Dopo aver eseguito l'exe, tornare qui e richiamare connect_vps.

Legge le posizioni aperte su TUTTE le VPS in rubrica in parallelo. Non serve specificare nulla: recupera automaticamente tutte le VPS salvate e tutti i terminali MT5 attivi su ciascuna.

Usare questo tool invece di get_open_positions quando si vuole una panoramica completa di tutti i conti monitorati.

Ritorna: {nome_vps: {nome_terminale: [posizioni]}} per ogni VPS raggiungibile. Le VPS non raggiungibili compaiono con status "error" invece delle posizioni.

Legge le informazioni di conto su TUTTE le VPS in rubrica in parallelo. Non serve specificare nulla: recupera automaticamente tutte le VPS salvate e tutti i terminali MT5 attivi su ciascuna.

Per ogni terminale restituisce: login, name, balance, equity, profit, margin, free_margin, margin_level, currency, leverage, server, broker.

Usare questo tool invece di get_account_info quando si vuole una panoramica completa di tutti i conti monitorati.

Ritorna: {nome_vps: {nome_terminale: {info_conto}}} per ogni VPS raggiungibile. Le VPS non raggiungibili compaiono con status "error" invece delle info conto.

Verifica se una o tutte le VPS sono raggiungibili via SSH (health check leggero). Non interroga MT5 — è solo un ping SSH con timeout breve (5 secondi).

Utile per:

• Diagnostica rapida prima di operazioni più complesse

• Capire subito se un problema è di rete o di MT5

• Monitoraggio dello stato delle VPS

Elenca tutti i terminali MetaTrader 5 attivi sulla VPS. Ritorna nome, login, broker, server e stato connessione per ogni terminale. Usare sempre questo tool prima degli altri per scoprire i nomi dei terminali disponibili.

Ritorna le posizioni aperte sul terminale specificato. Ogni posizione include: ticket, symbol, type (buy/sell), volume, open_price, current_price, sl, tp, profit, swap, open_time, comment, magic.

Ritorna le informazioni del conto MT5: balance, equity, margin, free margin, margin level, profit flottante, valuta, leva, login, broker.

Ritorna lo storico dei trade chiusi negli ultimi N giorni. Ogni trade include: symbol, type, volume, open_price, close_price, open_time, close_time, profit, swap, commission, net_profit.

Ritorna le ultime N righe del log dell'Expert Advisor del terminale. Utile per diagnosticare problemi o verificare l'attività dell'EA.

Ritorna tutti gli strumenti di trading disponibili sul terminale.

Ritorna i dettagli completi di uno strumento specifico. Include: contract_size, volume_min/max/step, swap_long/short, bid, ask, spread.