Native Windows MCP server for MetaTrader 5 backtesting, Market Watch, calendar data, and analytics.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
Manual Client & Custom JSON ConfigExpand JSON ▾
Client Config & Setup
Choose your client or environment
Target File:
💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Documentation Overview
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.
Why MT5-MCP-Quant
Focus: Backtest organization, reporting, and analytics — capabilities MT5 itself doesn't provide.
| MT5-MCP-Quant | Others | |
|---|---|---|
| Platform | Native Windows | Windows integrations |
| Backtest pipeline | ✅ Full (compile → run → analyze) | ✅ Via MT5 Python package |
| Deal-level analytics | ✅ 19 dimensions, DB-backed | ❌ |
| Report organization | ✅ SQLite (reports + deals) + search + history | ❌ |
| MQL5 compilation | ✅ MetaEditor CLI | ⚠️ Via GUI or terminal |
| Optimization | ✅ Background + results parsing + .set generation | ⚠️ Terminal only, no parsing |
| Crash debugging | ✅ Native process, log, and resource diagnostics | ❌ |
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.
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 rundoes 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.mcpbis the installable Windows MCP Bundle referenced by the MCP Registry.mcp-mt5-mcp-quant-windows-x64.tar.gzis 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 asmt5_mcp_quantover stdio, install the Agent Skills for this client, and verify thathealthcheckworks and exactly 96 tools are available. Do not ask me to launch the binary manually.
The agent should complete the whole one-time setup:
- Download the Windows x64 release, or build the Rust source when a release is unavailable.
- Run
powershell -ExecutionPolicy Bypass -File scripts\setup.ps1to detect the MT5 program and data directories. - Register the runtime command and
--stdioin the client's MCP configuration. - Install the router and workflow skills with
scripts\install-agent-skills.ps1. - Ask for one client restart, then confirm MT5 readiness and the exact 96-tool inventory.
- For Market Watch or calendar work, compile the embedded
MT5McpQuantBridgeService 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:
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
The AI runs the full pipeline: compile → clean cache → backtest → extract → analyze.
MCP Tools (96)
Core workflow
| Tool | Description |
|---|---|
run_backtest | Full pipeline: compile → clean → backtest → extract → analyze |
run_backtest_quick | Async quick backtest using pre-compiled EA; poll status |
run_backtest_only | Async raw backtest without compile/analysis; poll status |
launch_backtest | Fire-and-forget: launch MT5 backtest, poll for completion |
get_backtest_status | Poll running backtest status (MT5 running, report found, elapsed time) |
run_optimization | Genetic optimization (background, returns immediately) |
get_optimization_results | Parse optimization results after MT5 finishes |
list_jobs | List all optimization jobs with status |
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 |
list_symbols | List symbols with local Strategy Tester history |
Market Watch and economic calendar
| Tool | Description |
|---|---|
ensure_market_watch_symbol | Resolve broker suffix/prefix aliases without guessing, select the exact symbol, and verify Market Watch visibility |
prepare_calendar_export | Create an idempotent asynchronous export job against the active broker's live MT5 calendar |
inspect_calendar_export | Poll job state, progress, row count, coverage, validation, and machine-readable errors |
prepare_calendar_backtest_dataset | Publish a validated CSV v1 dataset and checksum manifest for Strategy Tester EAs |
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)
| 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.
Deal-Level Analytics (New)
| Tool | Description |
|---|---|
list_deals | List individual deals with filters (type, profit range, volume, dates) |
search_deals_by_comment | Full-text search in deal comments (e.g., "Layer #3") |
search_deals_by_magic | Filter deals by EA magic number |
analyze_profit_distribution | Profit histogram: small/medium/large wins and losses |
analyze_time_performance | Performance by hour of day and day of week |
analyze_hold_time_distribution | Hold time buckets + correlation with profit |
analyze_layer_performance | Grid/martingale layer analysis from comments |
analyze_volume_vs_profit | Volume correlation + performance by lot size |
analyze_costs | Commission and swap impact on profitability |
analyze_efficiency | Profit per hour/day, annualized return, trade frequency |
Monitoring
| Tool | Description |
|---|---|
verify_setup | Check native MT5 program/data paths and EA/set file inventory |
get_optimization_status | Check live state of a background optimization job |
list_jobs | All optimization jobs with compact status in one call |
Reports & logs
Related MCP Servers
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about MT5 MCP Quant
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/mt5-mcp-quant)HTML Embed
<a href="https://allmcps.com/mcp/mt5-mcp-quant"><img src="https://allmcps.com/api/badge/mt5-mcp-quant?style=directory" alt="MT5 MCP Quant on AllMCPs" /></a>Technical Specs & Signals
CategoryDeveloper Tools
28Quality signal: Emerging · 28/100How this signal is calculated ▾
Server availabilityNot measured
Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.
Verified ownership8/20
Documentation & tools12/30
Adoption & activity1/15
Community engagement0/10
A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge and attach your website — proof is checked automatically, then reviewed by our team.
Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.