MetaTrader MCP Server

What is MetaTrader MCP Server about?

Enables large language models to interact with MetaTrader 5, allowing AI‑driven trade execution and management via a standardized MCP interface.

How to use MetaTrader MCP Server?

1. Prerequisites: Python 3.10+ installed and a MetaTrader 5 terminal set up on the same machine.
2. Install: pip install metatrader-mcp-server.
3. Enable algorithmic trading in MetaTrader 5 (Tools → Options → Allow algorithmic trading).
4. Run the server (CLI):

   metatrader-mcp-server --login <YOUR_MT5_LOGIN> --password <YOUR_MT5_PASSWORD> --server <YOUR_MT5_SERVER>
   

   This launches the MCP server and automatically starts the MT5 terminal.
5. Claude Desktop integration – add the following to the Claude configuration:

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

6. Open WebUI / other LLMs – start the HTTP variant:

   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 as a tool server in the Open WebUI settings.

Key Features

• Python‑based MCP server that connects directly to a local MT5 terminal.
• CLI and HTTP interfaces for flexible integration with Claude, GPT, Open WebUI, and other LLM platforms.
• Supports broker‑based filling modes (introduced in v0.2.5).
• Fully packaged and distributed via PyPI (v0.2.0+).
• Comprehensive documentation and roadmap for future extensions (e.g., Google ADK integration).

Use Cases

• Automating quantitative‑finance strategies where an LLM decides trade signals and the server executes them on MT5.
• Providing an AI‑driven “tool” for chat‑based assistants (Claude Desktop, Open WebUI) to place, modify, or close orders.
• Rapid prototyping of AI trading bots without writing low‑level MT5 API code.
• Educational environments to demonstrate AI‑enabled algorithmic trading workflows.

FAQ

Q: What Python version is required? A: Python 3.10 or newer.

Q: Do I need a licensed MetaTrader 5 terminal? A: Yes, the server interacts with a locally installed MT5 client.

Q: How are credentials supplied? A: Via command‑line arguments --login, --password, and --server when launching the server.

Q: Can I run the server on a remote machine? A: The server must be on the same host as the MT5 terminal because it launches the client locally.

Q: Is there any legal disclaimer? A: Yes – the package disclaims liability for any trading losses; users assume all risks.

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.