MT5-Quant

MCP server for MT5 strategy development on macOS/Linux. 57 tools to compile, backtest, analyze, optimize, and manage MQL5 Expert Advisors — no Windows required.

You: "Backtest MyEA Jan-Mar, what caused the February drawdown?"

Claude: [compile → clean → backtest → analyze 1,847 deals]
        → Feb 14: BUY grid at L6, locking lot 1.75× base
        → Cutloss fired 17 points later
        → Recommendation: cap locking multiplier to ≤1.2×

Why MT5-Quant

	MT5-Quant	Other MT5 MCPs	QuantConnect
Backtest pipeline	✅ Full	❌	Cloud only
Deal-level analytics	✅ 15+ dims	❌	❌
MQL5 compilation	✅	❌	❌
macOS/Linux native	✅	Windows only	Cloud
Optimization	✅ Background	❌	✅ Paid

Quick Install

1. Download & Setup

curl -L -o mt5.tar.gz https://github.com/masdevid/mt5-mcp/releases/latest/download/mt5-quant-macos-arm64.tar.gz
tar -xzf mt5.tar.gz
bash scripts/setup.sh

2. Register MCP Server

Claude Code

# Navigate to your project directory first
cd /path/to/your/mt5-quant

# Register MCP server (requires absolute path)
claude mcp add MT5-Quant -- $(pwd)/mt5-quant

# Verify installation
claude mcp list

Windsurf

Add to ~/.windsurf/config.yaml:

mcpServers:
  mt5-quant:
    command: /absolute/path/to/mt5-quant
    env:
      MT5_MCP_HOME: /absolute/path/to/mt5-quant

Or use the config command:

# Get absolute path
which mt5-quant

# Add to Windsurf config
cat >> ~/.windsurf/config.yaml << EOF
mcpServers:
  mt5-quant:
    command: $(which mt5-quant)
    env:
      MT5_MCP_HOME: $(dirname $(which mt5-quant))
EOF

Full Setup →

Note: MCP servers require absolute paths. Use $(pwd) or full path like /Users/name/mt5-quant/mt5-quant, not relative paths like ./mt5-quant.

Quick Start

Run a backtest on MyEA from 2025.01.01 to 2025.03.31

The AI runs the full pipeline: compile → clean cache → backtest → extract → analyze.

Documentation

Doc	Purpose
QUICKSTART.md	Complete setup for macOS/Linux
CONFIG.md	Configuration reference
WINDSURF.md	Windsurf IDE integration
TOOLS.md	All 57 tools documented
ARCHITECTURE.md	Design and internals
TROUBLESHOOTING.md	Common issues
REMOTE_AGENTS.md	Linux optimization agents

MCP Tools (57)

Core workflow

Tool	Description
run_backtest	Full pipeline: compile → clean → backtest → extract → analyze
run_optimization	Genetic optimization (background, returns immediately)
get_optimization_results	Parse optimization results after MT5 finishes
analyze_report	Read analysis.json from any report directory
compare_baseline	Compare report vs baseline, return winner/loser verdict
compile_ea	Compile MQL5 EA via MetaEditor
list_experts	List all EAs in MQL5/Experts directory
list_indicators	List all indicators in MQL5/Indicators directory
list_scripts	List all scripts in MQL5/Scripts directory
healthcheck	Quick server health check

Granular Analytics (individual analysis)

Tool	Description
analyze_monthly_pnl	Monthly P/L breakdown only
analyze_drawdown_events	Drawdown events and causes only
analyze_top_losses	Worst losing deals only
analyze_loss_sequences	Consecutive loss patterns only
analyze_position_pairs	Position hold time and P/L pairs
analyze_direction_bias	Buy vs Sell performance
analyze_streaks	Win/loss streak analysis
analyze_concurrent_peak	Peak simultaneous positions

Use these for targeted analysis, or analyze_report to run all at once.

Monitoring

| Tool | Descri

... View full README on GitHub