Skip to content

Releases: shubhvisputek/meta-trader-mcp

v1.1.0

13 Jun 18:46

Choose a tag to compare

meta-trader-mcp v1.1.0

A large feature release on top of 1.0.2: 40+ new MCP tools (75 total) plus
two trading-path fixes. Cross-platform (Windows native / macOS·Linux via Wine /
remote bridge); trading stays OFF by default behind the risk interceptor.

✨ Added

  • 75 tools + 4 mtm:// resources + 3 prompts (was ~30).
  • Strategy analytics (Phase 3a): the MQL5 .set engine (read/write/patch/
    diff/describe sweeps), deal-level backtest-report analytics
    (analyze_backtest_report), and a SQLite report-history store (8 tools).
  • Wine-driving suite (Phase 3b): compile_ea/validate_ea_syntax,
    run_backtest/_quick/run_optimization, wine diagnostics/introspection,
    cache + project scaffolding.
  • Live-data & analytics parity (Phase 4): candles by range/from, tick
    history, check_order pre-trade preview, scan_market screener, 10 indicators
    (added Bollinger/ATR/Stochastic/ADX/CCI/Williams %R), risk/return analytics
    (volatility, VaR/CVaR, correlation, seasonality), and MCP resources + prompts.
  • 342 mocked tests (~82% coverage), green on macOS/Linux/Windows × Py 3.10–3.12,
    plus an opt-in live smoke suite driving every tool against a real MT5.

🐛 Fixed

  • Order filling is symbol-aware — derives type_filling from
    symbol_info.filling_mode (FOK > IOC > RETURN); fixes broker retcode 10030 on
    FOK-only symbols for check_order and the real order path.
  • Bulk close/cancel counts now report {closed, attempted, failed} instead of
    counting rejected closes as successes.
  • Windows CI green — cross-platform Path.home(), deterministic rate-limit
    test clock, forward-slash MQL5 logical paths.

Install: pip install meta-trader-mcp==1.1.0 · Full details in CHANGELOG.md.

v1.0.1

12 Jun 19:32

Choose a tag to compare

Slim release — same features, much lighter.

What changed

  • Dropped the standalone fastmcp dependency. The server uses the FastMCP bundled in the official mcp SDK; the heavyweight package (and its cryptography/authlib/keyring subtree) is now an opt-in [fastmcp] extra.
  • pandas is now optional ([pandas] extra). It was only used by the vendored MT5Client dataframe helpers, never by the MCP tools or startup.
  • Result: the Claude Desktop .mcpb bundle shrank from ~34 MB / 7,342 files to ~17–27 MB / ~2,150 files, so the one-click install no longer times out ("reply was never sent"). pip install is faster and lighter too.

No tool or runtime behaviour changed.

Install

pip install meta-trader-mcp                          # PyPI (lean)
brew install shubhvisputek/tap/meta-trader-mcp       # Homebrew

Claude Desktop: download the .mcpb for your platform below (one-click), or point a config entry at the installed binary — see the README for both paths.

Docker: ghcr.io/shubhvisputek/meta-trader-mcp:1.0.1

⚠️ Trading is off by default. See DISCLAIMER.md.

v1.0.0

12 Jun 18:21

Choose a tag to compare

First release of meta-trader-mcp — a cross-platform Model Context Protocol server for MetaTrader 5.

Install

pip install meta-trader-mcp            # macOS / Linux / Windows
pip install "meta-trader-mcp[windows]" # Windows: adds the MetaTrader5 binding

Claude Desktop (one click): download the .mcpb for your platform below and double-click it.

Platform Bundle
macOS (Apple Silicon) meta-trader-mcp-macos-arm64.mcpb
Windows (x64) meta-trader-mcp-windows-x64.mcpb
Linux (x64) meta-trader-mcp-linux-x64.mcpb

The .mcpb bundles carry all Python dependencies except the interpreter — they need python3 (3.10–3.12) on PATH.

Docker (remote-bridge companion): ghcr.io/shubhvisputek/meta-trader-mcp:1.0.0

Highlights

  • One server, three runtimes: windows-native, local-wine, remote-bridge.
  • Trading is off by default; every order passes a non-bypassable risk interceptor (max lot, equity-drawdown ceiling, payload guardrails, rate limiting).
  • Lazy-connect: the server starts with no live MT5 connection and returns a structured MT5_NOT_RUNNING instead of crashing.
  • 10 MCP tools: market data, indicators (SMA/EMA/RSI/MACD), order execution, position management, headless Strategy Tester backtests.

⚠️ This software can place real orders against a live account. See DISCLAIMER.md.

SHA256SUMS.txt lists checksums for every asset.