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

Related MCP server: Stock Analysis MCP Server

Installation

From Source

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:

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

You can specify a different host and port:

Installing for Claude Desktop

To install the server for Claude Desktop:

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

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

Placing a Trade

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

Building the Package

To build the package:

Or using uv:

Publishing to PyPI

To publish the package to PyPI:

Or using uv:

License

MIT

Acknowledgements

• MetaQuotes for the MetaTrader 5 platform

• FastMCP for the MCP server implementation