MetaTrader 5 MCP Server

A Model Context Protocol (MCP) server for MetaTrader 5, allowing AI assistants to interact with the MetaTrader 5 platform for trading and market data analysis.

Features

Connect to MetaTrader 5 terminal
Access market data (symbols, rates, ticks)
Place and manage trades
Analyze trading history
Integrate with AI assistants through the Model Context Protocol

Installation

From Source

git clone https://github.com/Qoyyuum/mcp-metatrader5-server.git
cd mcp-metatrader5-server
pip install -e .

Requirements

uv
Python 3.11 or higher
MetaTrader 5 terminal installed
MetaTrader 5 account (demo or real)

Usage

Running the Server

To run the server in development mode:

uv run mt5mcp dev

This will start the server at http://127.0.0.1:8000 by default.

You can specify a different host and port:

uv run mt5mcp dev --host 0.0.0.0 --port 8080

Installing for Claude Desktop

To install the server for Claude Desktop:

git clone https://github.com/Qoyyuum/mcp-metatrader5-server
cd mcp-metatrader5-server
uv run fastmcp install src\mcp_metatrader5_server\server.py

Check your claude_desktop_config.json file. It should look something like this:

{
  "mcpServers": {
    "MetaTrader 5 MCP Server": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "MetaTrader5",
        "--with",
        "fastmcp",
        "--with",
        "numpy",
        "--with",
        "pandas",
        "--with",
        "pydantic",
        "fastmcp",
        "run",
        "C:\\FULL_PATH_TO\\src\\mcp_metatrader5_server\\server.py"
      ]
    }
  }
}

API Reference

Connection Management

initialize(): Initialize the MT5 terminal
login(account, password, server): Log in to a trading account
shutdown(): Close the connection to the MT5 terminal

Market Data Functions

get_symbols(): Get all available symbols
get_symbols_by_group(group): Get symbols by group
get_symbol_info(symbol): Get information about a specific symbol
get_symbol_info_tick(symbol): Get the latest tick for a symbol
copy_rates_from_pos(symbol, timeframe, start_pos, count): Get bars from a specific position
copy_rates_from_date(symbol, timeframe, date_from, count): Get bars from a specific date
copy_rates_range(symbol, timeframe, date_from, date_to): Get bars within a date range
copy_ticks_from_pos(symbol, start_pos, count): Get ticks from a specific position
copy_ticks_from_date(symbol, date_from, count): Get ticks from a specific date
copy_ticks_range(symbol, date_from, date_to): Get ticks within a date range

Trading Functions

order_send(request): Send an order to the trade server
order_check(request): Check if an order can be placed with the specified parameters
positions_get(symbol, group): Get open positions
positions_get_by_ticket(ticket): Get an open position by its ticket
orders_get(symbol, group): Get active orders
orders_get_by_ticket(ticket): Get an active order by its ticket
history_orders_get(symbol, group, ticket, position, from_date, to_date): Get orders from history
history_deals_get(symbol, group, ticket, position, from_date, to_date): Get deals from history

Example Workflows

Connecting and Getting Market Data

# Initialize MT5
initialize()

# Log in to your trading account
login(account=123456, password="your_password", server="your_server")

# Get available symbols
symbols = get_symbols()

# Get recent price data for EURUSD
rates = copy_rates_from_pos(symbol="EURUSD", timeframe=15, start_pos=0, count=100)

# Shut down the connection
shutdown()

Placing a Trade

# Initialize and log in
initialize()
login(account=123456, password="your_password", server="your_server")

# Create an order request
request = OrderRequest(
    action=mt5.TRADE_ACTION_DEAL,
    symbol="EURUSD",
    volume=0.1,
    type=mt5.ORDER_TYPE_BUY,
    price=mt5.symbol_info_tick("EURUSD").ask,
    deviation=20,
    magic=123456,
    comment="Buy order",
    type_time=mt5.ORDER_TIME_GTC,
    type_filling=mt5.ORDER_FILLING_IOC
)

# Send the order
result = order_send(request)

# Shut down the connection
shutdown()

Resources

The server provides the following resources to help AI assistants understand how to use the MetaTrader 5 API:

mt5://getting_started: Basic workflow for using the MetaTrader 5 API
mt5://trading_guide: Guide for placing and managing trades
mt5://market_data_guide: Guide for accessing and analyzing market data
mt5://order_types: Information about order types
mt5://order_filling_types: Information about order filling types
mt5://order_time_types: Information about order time types
mt5://trade_actions: Information about trade request actions

Prompts

The server provides the following prompts to help AI assistants interact with users:

connect_to_mt5(account, password, server): Connect to MetaTrader 5 and log in
analyze_market_data(symbol, timeframe): Analyze market data for a specific symbol
place_trade(symbol, order_type, volume): Place a trade for a specific symbol
manage_positions(): Manage open positions
analyze_trading_history(days): Analyze trading history

Development

Project Structure

mcp-metatrader5-server/
├── src/
│   └── mcp_metatrader5_server/
│       ├── __init__.py
│       ├── server.py
│       ├── market_data.py
│       ├── trading.py
│       ├── main.py
│       └── cli.py
├── run.py
├── README.md
└── pyproject.toml

Building the Package

To build the package:

python -m pip install build
python -m build

Or using uv:

uv build

Publishing to PyPI

To publish the package to PyPI:

python -m pip install twine
python -m twine upload dist/*

Or using uv:

uv publish

License

MIT

Acknowledgements

MetaQuotes for the MetaTrader 5 platform
FastMCP for the MCP server implementation

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Enables AI assistants to interact with the MetaTrader 5 trading platform for market data analysis, placing trades, and managing trading positions. Provides comprehensive access to forex and financial market operations through the Model Context Protocol.

Related MCP Servers

MCP Paradex Server
sv
A
security
A
license
A
quality
A Model Context Protocol server implementation that enables AI assistants to interact with the Paradex perpetual futures trading platform, allowing for retrieving market data, managing trading accounts, placing orders, and monitoring positions.
Last updated -
26
8
MIT License
Stock Analysis MCP Server
TanayPhatak
-
security
F
license
-
quality
A Model Context Protocol server that provides stock technical analysis tools (moving averages, RSI, trade recommendations) for AI assistants to analyze stocks and offer trading signals.
Last updated -
DeFi Trading Agent MCP Server
edkdev
A
security
F
license
A
quality
Transforms AI assistants into autonomous crypto trading agents with real-time market analysis, portfolio management, and trade execution across 17+ blockchains.
Last updated -
32
10
16
IG Trading MCP
kea0811
A
security
F
license
A
quality
Enables AI assistants to interact with IG Trading API for forex, indices, and commodities trading. Provides 21 tools for account management, position trading, order placement, market data analysis, and watchlist management.
Last updated -
21
10
1

View all related MCP servers

MetaTrader 5 MCP Server