MT5-MCP-Quant

Native Windows MCP server for MetaTrader 5 strategy development. Compile, backtest, analyze, optimize, debug, manage Market Watch, and build static economic-calendar datasets through 96 MCP tools—without Wine, WSL, or runtime GUI automation.

The repository, Rust crate, executable, MCP registration examples, and Agent Skill identifiers all use the mt5-mcp-quant / mt5_mcp_quant project identity.

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-MCP-Quant

Focus: Backtest organization, reporting, and analytics — capabilities MT5 itself doesn't provide.

Unlike integrations centered on the MetaTrader5 Python trading API, MT5-MCP-Quant focuses on Strategy Tester automation, report organization, deal-level insight, and optimization workflows.

Related MCP server: mt5-mcp

Quick Start

Do I need to manage an .exe?

No, not during normal use. MT5-MCP-Quant is a native Windows MCP server, so the MCP client must start a Windows process in the background. That process is technically an .exe, but it is a one-time installation detail:

• Do not double-click the binary. It speaks JSON-RPC over stdio and is meant to be started by an MCP client.

• An AI coding agent can download or build it, save its path in the client configuration, and verify the connection once.

• After registration, use natural-language prompts. Codex, Claude Code, OpenCode, or Hermes starts and stops MT5-MCP-Quant automatically.

• cargo run does not remove the executable; Rust still builds one internally and makes every MCP startup slower. A registered release build is the recommended runtime.

In short: the runtime needs an executable, but the user should not have to manage it.

Requirements

• Windows 10/11 x64 and native MetaTrader 5, opened once under the same user account

• A logged-in MT5 demo or live account in the same interactive Windows session

• For a pre-built release: no Rust or Visual Studio installation is required

• For source builds only: Rust stable and Visual Studio’s Desktop development with C++ workload

Release formats

Each Windows release publishes two equivalent, checksummed artifacts:

• mt5-mcp-quant-windows-x64.mcpb is the installable Windows MCP Bundle referenced by the MCP Registry.

• mcp-mt5-mcp-quant-windows-x64.tar.gz is the portable archive for agents and manual installation.

Both contain the binary, configuration example, documentation, PowerShell installers, all ten MT5 skills, auditable MQL sources, README, changelog, and license. crates.io publishing is intentionally out of scope.

Agent-managed installation

Give this prompt to Codex, Claude Code, OpenCode, or Hermes from the repository directory:

Install and configure MT5-MCP-Quant on this Windows computer. Prefer the official pre-built Windows x64 release; build from source only when needed. Detect MT5 with scripts/setup.ps1, register the server as mt5_mcp_quant over stdio, install the Agent Skills for this client, and verify that healthcheck works and exactly 96 tools are available. Do not ask me to launch the binary manually.

The agent should complete the whole one-time setup:

1. Download the Windows x64 release, or build the Rust source when a release is unavailable.

2. Run powershell -ExecutionPolicy Bypass -File scripts\setup.ps1 to detect the MT5 program and data directories.

3. Register the runtime command and --stdio in the client's MCP configuration.

4. Install the router and workflow skills with scripts\install-agent-skills.ps1.

5. Ask for one client restart, then confirm MT5 readiness and the exact 96-tool inventory.

6. For Market Watch or calendar work, compile the embedded MT5McpQuantBridge Service and ask the user to start it once from MT5 Navigator → Services → MT5-MCP-Quant.

The stored binary path is an internal runtime setting after step 3. Normal users should not need to remember, open, or pass that path in prompts.

Install Agent Skills

Install the router and nine workflow skills for Codex, Claude Code, OpenCode, and Hermes:

powershell -ExecutionPolicy Bypass -File scripts\install-agent-skills.ps1 -Client all

Users can then write a vague prompt such as “MT5 MCP'yi kullan ve EA'me bak.” The router performs safe discovery and selects the appropriate workflow without requiring a tool name. See Agent Skills.

The router starts with read-only orientation checks: MCP health, active account, available EAs, and the latest report. It then chooses setup, MQL development, set-file management, backtesting, optimization, calendar data, reporting, analytics, or recovery. When two materially different goals remain possible, it asks one outcome-level question instead of asking the user to choose an MCP tool.

First Backtest

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.

MCP Tools (96)

Core workflow

Market Watch and economic calendar

The embedded MT5McpQuantBridge MQL5 Service is optional for the original 92 tools and required only for broker-catalog/Market Watch and live-calendar operations. Start it once from MT5 Navigator; unlike the earlier proposal, calendar export does not require running a new Script for every export.

Granular Analytics (individual analysis)

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

Deal-Level Analytics (New)

Monitoring

Reports & logs

History & baseline

Cache management

Pre-flight & Validation

Debugging & Diagnostics (New)

Project Management

History & Comparison

.set file — read / write

.set file — analysis & generation

Search & Discovery

Full schema: docs/MCP_TOOLS.md

Troubleshooting

Run verify_setup from your LLM first — it checks all paths and returns actionable hints.

For crashes or unexplained failures during backtest/compile/optimization:

• check_mt5_status — Check native terminal, MetaEditor, tester, and data paths

• search_mt5_errors — Find crash causes in logs

• check_mt5_process + kill_mt5_process — Detect and kill stuck processes

• get_backtest_crash_info — Investigate failed backtest reports

Full Troubleshooting Guide →

Acknowledgements

MT5-MCP-Quant stands on the shoulders of exceptional open-source projects:

• Rust — The language that makes zero-cost abstractions, memory safety, and fearless concurrency practical

• Tokio — The async runtime powering all concurrent operations

• Windows — Native process execution and filesystem integration for MetaTrader 5

• MetaTrader 5 — MetaQuotes' trading platform (trademark of MetaQuotes Software Corp.)

• rusqlite — Ergonomic SQLite bindings for Rust

• serde — The serialization framework making config and report handling painless

• scraper — HTML parsing for MT5 report extraction

• tempfile — Secure temporary file handling

Special thanks to the Model Context Protocol (MCP) team at Anthropic for defining the standard that makes AI-powered development workflows possible.

Disclaimer

Not Financial Advice. MT5-MCP-Quant is a development and analysis tool for algorithmic trading strategies. It does not provide investment advice, trading recommendations, or guarantee profitability. All backtest results are historical simulations and do not guarantee future performance.

Use at Your Own Risk. Trading financial instruments carries substantial risk of loss. The authors and contributors of MT5-MCP-Quant accept no liability for:

• Trading losses incurred using strategies developed or tested with this tool

• Data loss or corruption from backtest operations

• Bugs, errors, or incorrect analysis results

• System crashes, native MT5 process failures, or broker/runtime incompatibilities

Software Warranty. This software is provided "as-is" without warranty of any kind, express or implied, including but not limited to warranties of merchantability, fitness for a particular purpose, or non-infringement. See LICENSE for full terms.

Third-Party Software. MT5-MCP-Quant interacts with MetaTrader 5 and other third-party software. Users are responsible for complying with all applicable licenses and terms of service. MetaTrader is a trademark of MetaQuotes Software Corp. MT5-MCP-Quant is not affiliated with, endorsed by, or sponsored by MetaQuotes.

Regulatory Compliance. Users are responsible for ensuring their trading activities comply with applicable financial regulations in their jurisdiction. Automated trading may be restricted or require licensing in some regions.

License

MIT License