Skip to main content
Glama
deenesjakoruzh
tradingmavenfx-cmd

MT5 MCP Server

by tradingmavenfx-cmd
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

MT5 MCP Server

A local MCP server that connects a MetaTrader 5 terminal to Claude. It reads market data, account state and history, captures chart screenshots, and can send live orders.

Requirements

  1. The MetaTrader 5 terminal must be running

  2. Tools → Options → Expert Advisors → "Allow algorithmic trading" must be enabled

  3. An account must be logged in

If the terminal is closed, every tool returns MT5 initialize failed — open it and retry.

Related MCP server: metatrader-mcp

Install

uv venv --python 3.12 .venv
uv pip install --python .venv/Scripts/python.exe -r requirements.txt

Then adjust the paths in .mcp.json and restart Claude Code.

Tools (20)

Market data

Tool

What it does

mt5_status

Terminal build, connection, account, balance, equity, margin, DEMO/REAL

list_symbols

Search symbols — wildcards supported (EUR*, *USD*)

symbol_info

Digits, point, spread, contract size, lot limits, margin and swap rates

get_ticks

Live bid/ask and spread for one or more symbols

get_candles

OHLCV from M1 to MN1, by count or by date range

get_tick_history

Raw bid/ask tick stream, useful for backtesting

Account

Tool

What it does

get_positions

Open positions and total floating P/L

get_pending_orders

Active limit and stop orders

get_history_deals

Closed trades with profit, commission and swap totals

get_history_orders

Orders that were placed, cancelled or rejected

calc_trade

Margin and expected profit before sending anything (no order is placed)

Screen capture

Tool

What it does

list_charts

Open charts with symbol, timeframe and size

screenshot

PNG of the terminal window or of a single chart

screenshot does not come from the MetaTrader5 Python API — that API has no screenshot function at all. It is built on the Windows PrintWindow call (mt5_capture.py). It works on a background window, but not on a minimised one.

Pass target='window' for the whole terminal, or target='XAUUSD,M30' for one chart. Passing just 'XAUUSD' picks the largest chart for that symbol.

Trading — live

Tool

What it does

open_position

Market buy/sell, SL/TP as absolute price or in points

place_pending_order

Buy/sell limit or stop, with optional expiry

modify_position

Change SL/TP on an open position

modify_pending_order

Change price, SL or TP on a pending order

close_position

Full or partial close

cancel_pending_order

Remove a pending order

close_all_positions

Close everything, or only one symbol

⚠️ There is no demo/real guard on the trading tools. Orders go to whichever account the terminal is logged into. The broker's filling mode is detected automatically and the symbol is added to Market Watch as needed.

CLI (trade.py)

The same tools without Claude, straight from the command line:

.venv/Scripts/python.exe trade.py buy XAUUSD 0.01 --sl-points 500 --tp-points 1000
.venv/Scripts/python.exe trade.py modify 10090941191 --sl 4345.56 --tp 4360.56
.venv/Scripts/python.exe trade.py close 10090941191
.venv/Scripts/python.exe trade.py close-all --symbol XAUUSD
.venv/Scripts/python.exe trade.py positions
.venv/Scripts/python.exe trade.py calc buy XAUUSD 0.01 --close-price 4360

Run trade.py --help for every subcommand.

Time format

All time inputs are UTC: YYYY-MM-DD, YYYY-MM-DD HH:MM, or YYYY-MM-DD HH:MM:SS. Output timestamps are UTC as well.

Configuration

These environment variables are optional in .mcp.json:

Variable

Purpose

MT5_PATH

Path to terminal64.exe, used to launch the terminal if it is closed

MT5_LOGIN / MT5_PASSWORD / MT5_SERVER

Log into a different account (default: whatever the terminal already uses)

Smoke test

.venv/Scripts/python.exe -c "import mt5_mcp_server as s; print(s.mt5_status()['account'])"

This server cannot be deployed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • MetaTrader 5 MCP Server

    amirkhonov
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables comprehensive access to the MetaTrader 5 trading platform for retrieving market data, managing accounts, and executing trading operations. It provides 32 specialized tools for interacting with MT5 functionalities, including historical OHLCV data access, real-time position monitoring, and automated order management.
    1
    MIT

  • metatrader-mcp

    ali-rajabpour
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables users to capture real MetaTrader 5 chart snapshots with custom indicators and fetch market data through natural language in Claude Desktop.
    3
    MIT

  • MT5 MCP Server

    junmt
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables interaction with MetaTrader 5 for market data, technical analysis, Fibonacci calculations, and trading via MCP clients such as Claude.
    MIT

  • HTS MetaTrader5 Trading MCP

    Yumin-Kim
    F
    license
    A
    quality
    D
    maintenance
    Enables Claude AI to perform forex trading operations and market data analysis through MetaTrader 5, including order placement, position management, and multi-timeframe candle data retrieval.
    16
    -