mt5-remote-reader-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| VPS_USER | No | SSH username for the VPS | Administrator |
| MT5_TOOL_PATH | No | Path to mt5_tool.py on the VPS | C:\Users\Administrator\Desktop\mt5_tool.py |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_versionA | Restituisce la versione installata di mt5-remote-reader-mcp. Utile per verificare che il package sia aggiornato. |
| save_vpsA | 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. |
| list_vpsA | 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. |
| delete_vpsA | Rimuove una VPS dalla rubrica. |
| connect_vpsA | 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:
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. |
| get_vps_installerA | 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:
Dopo aver eseguito l'exe, tornare qui e richiamare connect_vps. |
| get_all_open_positionsA | 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. |
| get_all_account_infoA | 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. |
| check_vps_statusA | 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:
|
| list_terminalsA | 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. |
| get_open_positionsA | 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. |
| get_account_infoB | Ritorna le informazioni del conto MT5: balance, equity, margin, free margin, margin level, profit flottante, valuta, leva, login, broker. |
| get_trade_historyA | 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. |
| get_expert_logA | Ritorna le ultime N righe del log dell'Expert Advisor del terminale. Utile per diagnosticare problemi o verificare l'attività dell'EA. |
| get_symbolsC | Ritorna tutti gli strumenti di trading disponibili sul terminale. |
| get_symbol_infoA | Ritorna i dettagli completi di uno strumento specifico. Include: contract_size, volume_min/max/step, swap_long/short, bid, ask, spread. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 16 tools
Each tool has a clearly distinct purpose, covering different aspects of VPS management and MT5 data retrieval. Overlap between single and aggregate tools (e.g., get_account_info vs get_all_account_info) is intentional and well-documented.
All tool names follow a consistent verb_noun pattern in snake_case, such as check_vps_status, get_account_info, list_terminals. The naming is predictable and makes the function of each tool immediately clear.
16 tools is well-scoped for the server's purpose of remote MT5 reading and VPS management. Each tool serves a specific need without redundancy or oversaturation.
The tool set covers all essential operations: VPS lifecycle management (save, list, delete, connect), account info retrieval (single and aggregate), positions, symbols, trade history, logs, and diagnostics. No obvious gaps for the stated read-only domain.