Resolve and report MT4/5 paths, terminal hash, and missing-component issues.

Enumerate all MetaTrader terminal data folders under %APPDATA%\MetaQuotes\Terminal.

Compile a .mq4/.mq5/.mqh source via MetaEditor CLI.

Args: source: Absolute path to the source file. include: Optional MQL root override (parent of Include/). Defaults to terminal MQL root. log_file: Optional explicit log path. Defaults to .log. timeout_sec: Subprocess timeout.

Returns: returncode, structured errors/warnings lists, result_errors/result_warnings, log_path, log_excerpt (last 80 lines), cmd.

Launch terminal with /config:<tester.ini>.

Args: config: Absolute path to tester.ini. wait: Block until terminal exits (requires ShutdownTerminal=1 in ini). timeout_sec: Wait timeout. portable: Pass /portable flag.

Returns: returncode, elapsed_sec, latest_tester_log path.

Force-kill all running terminal processes for the configured edition.

Read last N lines from terminal logs.

Args: mode: "live" (Files/LiveLog.txt), "journal" (Logs/YYYYMMDD.log), "tester" (latest tester log). lines: Tail line count. date: Override YYYYMMDD for journal mode. structured: Parse journal lines into ts/source/message records.

Copy compiled .ex4/.ex5 binary into Experts/.

Args: source_ex: Path to compiled .ex4/.ex5. name: Optional rename target.

Copy a .mqh into the terminal Include folder (e.g. for LiveLog.mqh).

Args: source: Absolute path to source .mqh. target_name: Optional rename.

List compiled EAs in Experts/.

Locate and parse latest MT5 tester HTML report.

Args: path: Explicit report path. If omitted, find latest *.htm under Tester/. raw_truncate: Max chars of raw HTML returned.

Update fields in a tester.ini file in-place.

Args: config: Path to tester.ini. updates: Mapping of Section.Key → value (e.g. {"Tester.Symbol": "EURUSD", "Tester.FromDate": "2025.01.01"}).

Returns dict listing applied + skipped keys.

Compile then deploy resulting .ex5/.ex4 to Experts/ in one shot.

Parse input <type> <name> = <default>; declarations from a source file.

Generate a [TesterInputs] block from EA inputs.

If write_to points at a tester.ini, the block is appended/replaced in-place.

Recursively resolve #include directives. Reports unresolved files.

Grep a symbol across MQL files, skipping comments and string literals.

Compute LOC/function/nesting metrics for a file or every MQL file under a root.

Extract MetaEditor //+--+ //| ... +--+ doc blocks from a source file.

Find duplicate magic-number assignments across the project.

Compile a source via MetaEditor's syntax-only mode (/s) and return diagnostics.

Run structural lint rules (missing handlers, unused inputs, hardcoded magic/symbol).

Flag MT4-style deprecated API calls in MT5 source.

Sanity-check a tester.ini. If source given, cross-check inputs vs EA declarations.

Format an MQL file via clang-format (treats source as C++).

Report whether a file needs formatting without writing it.

Rename a symbol across MQL files (whole-word match). dry_run=True previews only.

[LEGACY] Best-effort binary .opt parser — unreliable, prefer read_optimization_csv with OptExport.mqh instrumented EA.

Parse the latest .opt file in the Tester folder, or one given by path.

[LEGACY] Best-effort binary .opt parser — unreliable, prefer read_optimization_csv with OptExport.mqh instrumented EA.

Sort optimization passes by criterion and return the top N.

Read optimization results from the CSV file generated by OptExport.mqh in Common Files folder.

Args: run_id: The run ID specified during optimization run. top_n: Number of top passes to return. criterion: The column name to sort by (e.g. 'profit', 'sharpe_ratio', 'custom_metric'). descending: Set to True to sort from highest to lowest.

Diff two MT5 tester HTML reports key-by-key with absolute and percent deltas.

Verify candidate report stays within guard thresholds vs baseline.

Freeze a copy of source files into a timestamped folder under dest.

List all snapshot folders under dest.

Switch the active terminal data folder for this session.

Provide one of: origin (install path stored in origin.txt), hash (32-char folder name), or install (auto-scan for the matching origin).

Subsequent tool calls will use the new layout until the server restarts.

Compile, deploy, run a 1-day headless backtest, and scan the journal for runtime errors.

Returns ok: true only if compilation, deployment, run, and the journal scan all pass.

Extract a contiguous block of lines into a new helper function.

Brace-counting + regex param detection — not a full AST parser. Returns the proposed helper, call site, and parameter list. Set dry_run=False to write.

Start a non-blocking backtest or optimization Strategy Tester run.

Args: config: Absolute path to the tester .ini configuration file. kind: Execution type, either "backtest" or "optimize".

Check the status and elapsed duration of a background execution job.

Args: job_id: The job ID returned by start_job.

Retrieve full structured results of a completed background job.

Args: job_id: The job ID returned by start_job.

List recent Strategy Tester execution jobs tracked in the database.

Args: limit: Maximum number of jobs to return (default 20). status: Optional filter by job status (e.g. 'running', 'done', 'failed').

Automatically instrument an MQL5 Expert Advisor (.mq5) file with OptExport.mqh logging.

Args: ea_path: Absolute path to the .mq5 file.