MetaTrader MCP

What is MetaTrader MCP Server?

MetaTrader MCP Server is a Python-based Model Context Protocol (MCP) server designed to bridge the gap between AI Large Language Models (LLMs) and the MetaTrader 5 trading platform. It allows LLMs to interact with MetaTrader 5 and execute trading operations programmatically.

How to use MetaTrader MCP Server?

To use MetaTrader MCP Server, you need Python 3.10+ and MetaTrader 5 terminal installed. Install the package via pip:

pip install metatrader-mcp-server

After installation, enable algorithmic trading in your MetaTrader 5 terminal (Tools > Options > Allow algorithmic trading).

For Claude Desktop integration, add the provided JSON configuration to your Claude Desktop settings, including your MetaTrader 5 login, password, and server details.

For other LLMs using Open WebUI, run the HTTP server locally with your MetaTrader 5 credentials:

metatrader-http-server --login <YOUR_MT5_LOGIN> --password <YOUR_MT5_PASSWORD> --server <YOUR_MT5_SERVER> --host 0.0.0.0 --port 8000

Then, add http://localhost:8000 (or your chosen port) as a tool server in Open WebUI settings under the "Tools" menu.

Key Features of MetaTrader MCP Server

• AI LLM Integration: Enables AI models to interact with MetaTrader 5 for trading.
• Model Context Protocol (MCP): Utilizes MCP for seamless communication between LLMs and the trading platform.
• Easy Installation: Simple installation via pip.
• Claude Desktop Compatibility: Direct integration with Claude Desktop for trading operations.
• Open WebUI Support: Compatible with Open WebUI for use with various LLMs like OpenAI's GPT models.
• HTTP Server: Provides an HTTP server for broader LLM integration.

Use Cases of MetaTrader MCP Server

• Automated Trading: Develop and deploy AI-driven automated trading strategies.
• Algorithmic Trading Research: Conduct research and backtesting of algorithmic trading models using LLMs.
• AI-Powered Financial Analysis: Allow LLMs to execute trades based on their analysis of market data.
• Custom Trading Bots: Create highly customized trading bots controlled by advanced AI models.

FAQ about MetaTrader MCP Server

Q: Is financial trading with this package risky? A: Yes, financial trading involves significant risk. The developers explicitly disclaim any liability for losses or profits. This package is provided solely to facilitate MetaTrader 5 trade executions via AI LLMs, and users assume all risks.

Q: What Python version is required? A: Python 3.10+ is required.

Q: Do I need MetaTrader 5 installed? A: Yes, you need the MetaTrader 5 terminal installed in your workspace.

Q: Can I use this with LLMs other than Claude Desktop? A: Yes, you can use it with other LLMs like OpenAI's GPT models via its HTTP server and Open WebUI integration.

MetaTrader MCP Server

This is a Model Context Protocol (MCP) server built with Python to enable AI LLMs to trade using MetaTrader platform.

Disclaimer

Financial trading involves significant risk, and the developers of this package disclaim any liability for any losses or profits; this package is provided solely to facilitate MetaTrader 5 trade executions via AI LLMs using the Model Context Protocol (MCP). By using this package, you assume all risks and agree not to hold the developers liable or to initiate any legal action for any damages, losses, or profits.

Updates

• May 5, 2025: Use broker-based filling modes (0.2.5)
• April 23, 2025: Published to PyPi (0.2.0)
• April 16, 2025: We have our first minor version release (0.1.0)

Installation Guide

Make sure you have Python version 3.10+ and MetaTrader 5 terminal installed in your workspace. Then install the package:

pip install metatrader-mcp-server

Then you need to enable algorithmic trading on MetaTrader 5 terminal. Open Tools > Options and check Allow algorithmic trading.

Claude Desktop Integration

To use this package to enable trading operations via Claude Desktop app, please add this into your Claude Desktop configuration:

{
  "mcpServers": {
    "metatrader": {
      "command": "metatrader-mcp-server",
      "args": [
        "--login",    "<YOUR_MT5_LOGIN>",
        "--password", "<YOUR_MT5_PASSWORD>",
        "--server",   "<YOUR_MT5_SERVER>"
      ]
    }
  }
}

Other LLMs using Open WebUI

You can use this MCP server with other LLMs such as OpenAI's GPT by using its HTTP server and Open WebUI.

To start, make sure you have installed the package. Then, run the server:

metatrader-http-server --login <YOUR_MT5_LOGIN> --password <YOUR_MT5_PASSWORD> --server <YOUR_MT5_SERVER> --host 0.0.0.0 --port 8000

It will launch HTTP server locally on port 8000 and automatically launch MetaTrader 5 terminal.

On Open WebUI settings page, navigate to Tools menu. Then click plus button on "Manage Tool Servers". Add http://localhost:8000 (or whatever you set your port is).

If all is well, you can now access the tools via chat using available models, such as gpt-4o or o4-mini.

Project Roadmap

For full version checklist, see version-checklist.md.

Task	Status	Done	Tested
Connect to MetaTrader 5 terminal	Finished	✅	✅
Develop MetaTrader client module	Finished	✅	✅
Develop MCP Server module	Finished	✅	✅
Implement MCP tools	Finished	✅	✅
Publish to PyPi	Finished	✅	✅
Claude Desktop integration	Finished	✅	✅
OpenAPI server	Finished	✅	✅
Open WebUI integration	Finished	✅	✅
Google ADK integration	On progress	-	-

Developer Documentation

For developers, see Developer's Documentation.