How do I use mcp-mt5?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-mt5 compile and backtest my moving average EA" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

mcp-mt5

by ptacr

Overview Schema Related Servers Score Discussions

Hybrid

mcp-mt5

Model Context Protocol server for the MetaTrader 4/5 build pipeline. Compile MQL sources, deploy compiled EAs, run Strategy Tester, parse reports, tail logs — all driven by an LLM agent without touching the MetaTrader UI.

Python License: MIT Platform

What this is — and what it isn't

✅ This server	❌ Not this server
MetaTrader dev harness — compile, deploy, backtest, parse	Live trading (orders, positions, quotes)
Wraps `MetaEditor64.exe` / `terminal64.exe` CLI directly	Wraps the `MetaTrader5` Python package
Runs entirely offline against installed terminal	Connects to a broker server
Iterates strategies before they go live	Executes strategies in production

Use case: an LLM agent edits .mq5 source → compiles → deploys → runs Strategy Tester → reads report → adjusts → repeats. No broker login, no human in the loop, no risk of real-money execution.

For runtime trading, pair this with a live-trading MCP — they target different layers and compose well.

Related MCP server: mcp-mt5

Tools

The server exposes 32 tools and 3 MCP resources across nine categories.

🔍 Discovery & terminal selection

Tool	Description
`env_info`	Dump resolved paths, terminal hash, edition, and missing-component issues
`list_terminals`	Enumerate every MT4/5 terminal data folder under `%APPDATA%\MetaQuotes\Terminal` along with each `origin.txt` install path
`select_terminal`	Switch the active terminal data folder mid-session by origin path, hash, or install dir — handy for testing across multiple brokers

🔨 Build & deploy

Tool	Description
`compile`	Invoke MetaEditor CLI on a `.mq4`/`.mq5`/`.mqh` source. Returns structured `errors[]`/`warnings[]` (file, line, column, error code, message) plus log excerpt
`compile_and_deploy`	Compile, then copy the resulting `.ex4`/`.ex5` into the terminal's `Experts/` folder in one call
`syntax_check`	Same as `compile` but uses MetaEditor's `/s` syntax-only mode for faster feedback
`smoke_test`	Compile + deploy + run a 1-day headless backtest + scan the journal for runtime errors. Catches problems that pass `compile` but fail at runtime
`deploy_ea`	Copy a compiled binary into `Experts/` (with optional rename)
`install_include`	Copy a `.mqh` header into the terminal `Include/` folder — handy for libraries like `LiveLog.mqh`
`list_experts`	Enumerate `Experts/` recursively with size and modification time

🔎 Source analysis

Tool	Description
`extract_inputs`	Parse `input <type> <name> = <default>;` declarations into structured records
`gen_tester_inputs`	Auto-build a `[TesterInputs]` block from EA source (translates `PERIOD_*` enums to numeric codes), optionally write into an existing `tester.ini`
`resolve_includes`	Recursive `#include` resolution that reports missing files and circular references
`find_symbol`	Grep a symbol across MQL files, skipping comments and string literals
`code_metrics`	LOC, function count, max nesting per file — or aggregated across an entire tree
`extract_doc`	Pull MetaEditor `//+--+ //\| ... +--+` doc blocks out as markdown
`find_magic_collision`	Detect duplicate magic-number assignments across the project

⚠️ Lint & validation

Tool	Description
`lint_basic`	Structural rules: missing `OnInit`/`OnDeinit`, unused `input`s, hardcoded magic numbers, hardcoded symbol literals
`check_deprecated`	Flag MT4-style API calls (`OrderSend`, `Ask`, `AccountBalance`, …) with `CTrade`/MT5-API replacement suggestions
`validate_tester_ini`	Sanity-check a `tester.ini` (required keys, date format, numeric ranges) and cross-check `[TesterInputs]` against the EA source declarations

🎨 Format

Tool	Description
`format_mql`	Format a source file via `clang-format` (treats MQL as C++ with an MQL-friendly default style)
`format_check`	Same as above but reports whether changes are needed without writing the file

✏️ Refactor

Tool	Description
`rename_symbol`	Whole-word rename across all MQL files in a tree, with `dry_run` preview
`extract_function`	Brace-aware extraction of a contiguous block into a new helper function — inline or into an external `.mqh`

📊 Strategy Tester

Tool	Description
`patch_tester_ini`	Programmatically update keys in a `tester.ini` (e.g. `Tester.Symbol`, `Tester.FromDate`, `TesterInputs.RiskPct`) before running
`run_backtest`	Launch `terminal64.exe /config:tester.ini`, optionally headless (when `ShutdownTerminal=1`), and return the latest tester log path
`parse_optimization`	[LEGACY] Best-effort parser for the latest `.opt` (optimization passes) binary file
`top_passes`	[LEGACY] Sort optimization passes by a chosen criterion and return the top N
`read_optimization_csv`	High-fidelity CSV reader for optimization results generated via `OptExport.mqh`
`start_job`	Start non-blocking Strategy Tester runs (backtest or optimize) using SQLite tracking
`check_job_status`	Poll execution status, elapsed time, and exit codes of background runs
`get_job_result`	Retrieve full parsed backtest report or optimization CSV after job completion
`list_jobs`	Query the history and status of all background Strategy Tester executions
`instrument_ea_for_opt`	Automatically write OptExport include and OnTester log code into any EA source
`read_tester_report`	Locate and parse the latest tester HTML report into a structured `summary` (net profit, profit factor, drawdown, trade counts, etc.) plus a sample of trade rows
`compare_reports`	Diff two tester reports key-by-key with absolute and percent deltas
`regression_check`	Verify a candidate report stays within guard thresholds vs a baseline (e.g. "net_profit may not drop more than 5%")
`kill_terminal`	`taskkill` if the terminal hangs

📝 Logs & snapshots

Tool	Description
`tail_log`	Tail the last N lines of either `Files/LiveLog.txt`, the daily `Logs/YYYYMMDD.log`, or the most recent tester log. Optional structured parse into `{ts, source, message}` records
`snapshot_sources`	Freeze a copy of source files into a timestamped folder with a `manifest.json`
`list_snapshots`	Enumerate previously captured snapshots

📡 MCP resources

Live, re-readable URIs that an MCP client can poll instead of calling a tool repeatedly.

URI	Description
`mt5://livelog`	Latest tail of `MQL5/Files/LiveLog.txt`
`mt5://journal`	Today's daily MT5 journal log
`mt5://tester-log`	Most recent Strategy Tester journal

Quick start

Install

pip install mcp-mt5

Requires Windows + an installed MetaTrader 4 or 5 terminal.

Register with an MCP client

Most MCP clients accept a JSON entry under mcpServers. The server inherits its configuration from environment variables:

{
  "mcpServers": {
    "mt5": {
      "command": "mcp-mt5",
      "env": {
        "MT5_INSTALL": "C:\\Program Files\\MetaTrader 5"
      }
    }
  }
}

Refer to your client's documentation for the exact config file location.

Verify the install

Once registered, ask your agent to call env_info:

{
  "edition": "mt5",
  "install": "C:\\Program Files\\MetaTrader 5",
  "terminal_hash": "<32-char-hex-hash>",
  "metaeditor": "C:\\Program Files\\MetaTrader 5\\MetaEditor64.exe",
  "experts_dir": "C:\\Users\\<you>\\AppData\\Roaming\\MetaQuotes\\Terminal\\<hash>\\MQL5\\Experts",
  "issues": []
}

An empty issues array means everything is wired up correctly.

Configuration

Resolution priority for the MetaTrader install + data folder:

Explicit env vars (below)
Auto-scan of %APPDATA%\MetaQuotes\Terminal\*\origin.txt for a folder whose origin matches MT5_INSTALL
Portable mode fallback (data colocated with install dir)

Env var	Default	Notes
`MT5_INSTALL`	`C:\Program Files\MetaTrader 5`	Install dir containing `terminal64.exe`
`MT5_DATA`	(auto-detected)	`%APPDATA%\MetaQuotes\Terminal\<hash>`
`MT5_TERMINAL_HASH`	(auto-detected)	32-char folder name
`MT5_EDITION`	`mt5`	Set to `mt4` for MetaTrader 4

MT4 support

Set MT5_EDITION=mt4 and point MT5_INSTALL at your MT4 install. The server switches to metaeditor.exe (32-bit), terminal.exe, and the MQL4/ data tree automatically.

Example workflow

A typical LLM-driven iteration loop:

1. env_info                                          → verify paths
2. compile_and_deploy source="MyEA.mq5"              → 0 errors, .ex5 deployed ✅
3. patch_tester_ini config="tester.ini" updates={
     "Tester.Symbol": "EURUSD",
     "Tester.FromDate": "2025.01.01",
     "TesterInputs.RiskPct": "1.5"
   }
4. run_backtest config="tester.ini" wait=true
5. read_tester_report                                → summary.net_profit = 1234.56
                                                       summary.profit_factor = 1.45
6. tail_log mode="tester" lines=200 structured=true  → diagnose journal warnings
7. <edit Signal.mqh based on findings>
8. → loop back to step 2

A sample `tester.ini`

; Launch: terminal64.exe /config:tester.ini
; Period codes: M1=1, M5=5, M15=15, H1=16385, H4=16388, D1=16408
; Model: 0=Every tick, 1=1 min OHLC, 4=Real ticks

[Tester]
Expert=MyEA
Symbol=EURUSD
Period=M15
Model=1
FromDate=2024.01.01
ToDate=2024.12.31
Deposit=10000
Currency=USD
Leverage=500
Visual=0
ShutdownTerminal=1     ; required so run_backtest can wait for the run to finish
Report=tester_report

[TesterInputs]
; ParamName=value||start||step||stop||(N=fixed|Y=optimize)
; RiskPct=1.0||0.1||0.1||3.0||N

A more complete sample lives at examples/tester.ini.

Remote access from Linux client

Since MetaTrader 5 and MetaEditor must run on Windows, but your development environment may be on Linux/macOS, mcp-mt5 provides two remote connection patterns:

Option A: Token-Authenticated HTTP Transport (streamable-http)

Run mcp-mt5 as a network web service. Set MCP_MT5_TRANSPORT=http and configure a secure Bearer token via MCP_MT5_TOKEN:

# On the Windows Server VPS:
set MCP_MT5_TRANSPORT=http
set MCP_MT5_PORT=8931
set MCP_MT5_TOKEN=your-random-secure-token
python -m mcp_mt5.server

Then connect from your Linux client using standard streamable-http MCP setup:

{
  "mcpServers": {
    "mt5": {
      "command": "mcp-client-streamable-http",
      "args": ["http://<your-vps-ip>:8931/mcp"],
      "env": {
        "Authorization": "Bearer your-random-secure-token"
      }
    }
  }
}

Note: For production deployments, it is highly recommended to bind to 127.0.0.1 and place a reverse proxy (like Caddy or Nginx) in front of the server to handle TLS and restrict public interfaces.

Option B: SSH stdio bridge

Run the MCP server locally over an SSH connection. This option requires no port exposure or network transport configuration on the server:

{
  "mcpServers": {
    "mt5": {
      "command": "ssh",
      "args": [
        "username@winserver-vps",
        "python -m mcp_mt5.server"
      ]
    }
  }
}

Development

git clone https://github.com/PHUICMT/mcp-mt5
cd mcp-mt5
pip install -e ".[dev]"
pytest                    # runs the 18-test suite
ruff check src tests      # lints

CI runs on Windows for Python 3.10, 3.11, and 3.12 against every push to main. Tagging a release (e.g. v0.2.0) triggers an OIDC publish to PyPI.

Project layout

mcp-mt5/
├── src/mcp_mt5/
│   ├── server.py        # FastMCP tool definitions
│   ├── paths.py         # Layout detection + origin.txt scan
│   └── parsers.py       # Compile log + tester HTML report parsers
├── tests/               # 18 pytest tests, no live MT5 required
├── examples/            # Sample tester.ini + client config
└── .github/workflows/   # CI + PyPI release

Limitations

Windows-only. MetaTrader CLI binaries don't ship for Linux/macOS. Wine ports may work but are untested.
No live broker access. This server intentionally never authenticates to a broker. Use a separate MCP server for runtime trading.
Tester report parsing is best-effort. MetaTrader's HTML output isn't a stable schema; the raw HTML is also returned alongside the parsed structure so you can fall back to text inspection when needed.
Optimization runs (.opt) are best-effort (legacy). Binary .opt files are unreliable to parse directly due to changing format layouts across MT5 builds. For high-fidelity optimization runs, it is recommended to instrument your Expert Advisor with OptExport.mqh and retrieve optimization passes via the read_optimization_csv tool.

Roadmap

All v0.3.x roadmap items shipped in v0.4.0. Future ideas:

Real tree-sitter MQL grammar for extract_function (current implementation is brace-counting + regex)
WebSocket transport for long-lived sessions (currently stdio only)
Linux/Wine port for non-Windows agents

License

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

mcp-metaeditor
Finance Developer Tools
CtpN3m01
F
license
-
quality
D
maintenance
Connects MCP clients to MetaTrader 5 MetaEditor on Linux via Wine, enabling automated MQL5 development workflows including code editing, compilation of EAs/indicators, and strategy backtesting.
Last updated 2026-04-04
3
mcp-mt5
Developer Tools Testing & QA Tools Finance
PHUICMT
A
license
B
quality
A
maintenance
Model Context Protocol server for the MetaTrader 4/5 build pipeline, enabling LLM-driven compilation, deployment, backtesting, and log tailing without UI interaction.
Last updated 2026-05-04
35
10
MIT
Meta-Trader-MCP
Finance AI & Machine Learning
shubhvisputek
A
license
-
quality
A
maintenance
Exposes a unified AI interface to MetaTrader 5 over the Model Context Protocol, enabling live quotes, historical data, technical indicators, order execution, position management, and headless backtests.
Last updated 2026-06-12
MIT
MetaTrader MCP Server
Finance Research & Data
joangrcia
A
license
-
quality
A
maintenance
Enables AI assistants to trade on MetaTrader 5 using natural language, supporting account management, order placement, and real-time market data.
Last updated 2026-06-19
1
MIT

View all related MCP servers

Related MCP Connectors

ateam-mcp
Build, validate, and deploy multi-agent AI solutions from any AI environment.
Backtest360
MCP server exposing the Backtest360 engine API as tools for AI agents.
Frenchie
OCR, transcription, file extraction, and image generation for AI agents via MCP.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ptacr/mcp-mt5'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

mcp-mt5

What this is — and what it isn't

Tools

🔍 Discovery & terminal selection

🔨 Build & deploy

🔎 Source analysis

⚠️ Lint & validation

🎨 Format

✏️ Refactor

📊 Strategy Tester

📝 Logs & snapshots

📡 MCP resources

Quick start

Install

Register with an MCP client

Verify the install

Configuration

MT4 support

Example workflow

A sample tester.ini

Remote access from Linux client

Option A: Token-Authenticated HTTP Transport (streamable-http)

Option B: SSH stdio bridge

Development

Project layout

Limitations

Roadmap

License

Maintenance

Resources

Looking for Admin?

Related MCP Servers

mcp-metaeditor

mcp-mt5

Meta-Trader-MCP

MetaTrader MCP Server

Related MCP Connectors

Latest Blog Posts

MCP directory API

A sample `tester.ini`