FullMt5McpByLeo/README.md

<!-- mcp-name: io.github.TradeSystemsNique/mt5-mcp-by-leo -->
<p align="center">
  <img src="https://img.shields.io/badge/Language-C++-3776ab?style=flat-square"/>
  <img src="https://img.shields.io/badge/MQL5-Backend-13C7DE?style=flat-square"/>
  <img src="https://img.shields.io/badge/Protocol-MCP-1B6CA8?style=flat-square"/>
  <img src="https://img.shields.io/badge/Platform-MetaTrader%205-0D1B2A?style=flat-square"/>
  <img src="https://img.shields.io/badge/Author-Niquel%20Mendoza-C9D6DF?style=flat-square"/>
  <a href="./LICENSE">
    <img src="https://img.shields.io/badge/License-Nique%26Leo%20NL--ND-red.svg"/>
  </a>
</p>

<p align="center">
  <strong>Universal MCP Server for MetaTrader 5 Trading & Data Operations</strong>
</p>

---

## Overview

FullMt5McpByLeo is a complete, production-ready MCP server that enables Claude and other AI assistants to control MetaTrader 5 directly. Execute trades, retrieve market data, manage charts, analyze trading history, and automate MT5 operations through natural language.

---


## Main Features (General)
- Fast execution; the MCP server is written in C++ using simdjson and MQL5 uses JsonParserByLeo (fast MQL5 JsonParser), ultra-optimized code for maximum speed. 
The average response time is around 10ms (from when Claude calls a function until its response; note that this may depend on the size of the request... on average it's 10ms).
- Unlike other MCPs for MT5, this MCP has two parts, one in MQL5 and the other in C++, giving access to the full MQL5 API and not limited to the mt5 package for Python, which lacks functions for handling charts, etc.

## Main Features (MCP Functions)

### Trade Operations
Execute and manage trading positions and orders:
- **Open Positions:** Execute market trades (buy/sell) with immediate or pending orders
- **Position Management:** Modify stops/profits, close positions (full or partial)
- **Order Management:** Create, modify, and cancel pending limit/stop orders
- **Trading History:** Query completed deals with profit/loss analysis

### Market Data & Symbols
Access real-time and historical data:
- **OHLC Data:** Retrieve candlestick data (open, high, low, close, volume, spread, etc..)
- **Tick data:** Retrieve Tick data (last, ask, bid, flags, etc..)
- **Symbol Information:** Get symbol properties (digits, spreads, swaps, volumes, etc.. full SYMBOL_INFO_*)
- **Market Watch:** Manage symbol selection and availability

### Indicators 
- **Indicator Manager:** Get parameters, Add indicadors (ALL, Custom, MA, ETC..), Remove, Get Buffers, etc..

### Graphic Objects
Create and modify chart visualizations:
- **Draw Objects:** Create trend lines, rectangles, text labels, arrows
- **Object Properties:** Modify colors, styles, prices, text, full ENUM_OBJECT_PROPERTY_*
- **Chart Annotations:** Add visual markers and indicators to charts

### Chart Management
Control chart windows and redraw operations:
- **Chart Operations:** Open, close, list active charts
- **Chart Properties:** Read chart dimensions, colors, price ranges
- **Visual Updates:** Force chart redraw for real-time updates
- **Indicators:** Add\Delete\GetName\GetTotal of indicator of any chart\subwin 
- **Navigate:** Navigate chart 

### Code & Terminal
Compile and execute Expert Advisors:
- **Compilation:** Compile MQL5 source to EX5 bytecode
- **Backtesting and Optimization:** Run historical tests with multiple tick modeling\leverage\opt criterian\opt mode\forward\visual mode.. etc
and get full report, deals, balance\equity curve.
- **EA Execution:** Run Expert Advisors in real-time
- **Logging:** Retrieve EA logs for debugging and monitoring
- **Terminal and Account:** Obtaing terminal and acount info_* (integer, string, double)

> Note: Python version package mt5_mcp_by_leo is deprecated. now replace by C++ exe server.
> Note: Unlike other MCPs that use .ini files to launch backtests, this MCP doesn't need that because it controls the entire MT5 tester from the same EA, without .ini files, without wasted terminals. In addition, the code compilation is more complete since its AI can choose whether or not to optimize the code, instructions, etc.
---

## Repository Structure

```
FullMt5McpByLeo/
├── Src/                              # MQL5 Backend Functions
│    ....
├── mt5_mcp_by_leo/                   # Json tools definition
│    ....
```

---

## ⚠️ License Activation (Required)

Your MCP server won't work without an active license from TheBotPlace.

1. Purchase McpServerByLeo here: https://www.thebotplace.com/bot/mcpserverbyleo
2. Get your **TBP ID** from your [TheBotPlace account - Your user ID](https://thebotplace.com/profile)
3. Add it to the `args` array in your `claude_desktop_config.json` or the JSON that your AI platform uses (see  Quick Start/step 4 below)

---
## Requirements (pre-instalation)

- General (for all)
> - EXE from releases (McpServer.exe)

- For repo code (devs)
> - Check: [dependencies.json](./dependencies.json)

- For user use:
> - EX5 of releases (Runner an Mt5Mcp).

---

## Installation of repo code 

```bash
cd "C:\Users\YOUR USER\AppData\Roaming\MetaQuotes\Terminal\YOUR ID\MQL5\Shared Projects"
tsndep install "https://forge.mql5.io/nique_372/FullMt5McpByLeo.git"
```

- For use tsndep command requerid tsndep pacakage (avaible in [pypi](https://pypi.org/project/tsndep)).. This command automatically downloads all dependencies and installs all requirements from the repositories.
- If any part of the system is private, then it will fail... contact me so I can give you access (if it's a product, you can buy it; if you have any questions, don't hesitate to contact me).

---

## Quick Start (for final users)

### 1. Download
Download the latest .exe and .ex5 files from the repo [releases](https://forge.mql5.io/nique_372/FullMt5McpByLeo/releases).
Place the .ex5 files in the MT5 terminal's Experts\ folder, and the .exe file in an easily accessible folder (for example, the MT5 terminal's Common\Files\ folder).

### 2. Download tools.json
Download the [tools.json](https://forge.mql5.io/nique_372/FullMt5McpByLeo/src/branch/main/mt5_mcp_by_leo/tools.json) file and place it in your terminal's Common\Files\ folder.

### 3. Create a config json 

Open Common\\Files
And create a json file with this structure:

```json
{
  "general": {
    "type_reg": "stdio_stdin",
    "json_tools_fpath": "JSON_TOOL_PATH"
  },
  "mt5_conn": {
    "host": "127.0.0.1",
    "port": 9999
  },
  "http_lib": {
    "name": "McpMt5Server",
    "version": "1.0.0",
    "host": "127.0.0.1",
    "port": 8080,
    "endpoint": "/"
  },
  "stdio_stdin": {
    "name": "MT5 MCP Server",
    "version": "1.0.0"
  }
}
```
> Full template in [Templates/config.json](https://forge.mql5.io/nique_372/FullMt5McpByLeo/src/branch/main/Templates/config.json)

- JSON_TOOL_PATH: Path to the tools configuration json (you can download the json from the mt5_mcp_by_leo folder and place it in documents for example and put the path to said file here...) Or if you have the repository cloned, you can use the path to tools.json

### 4. Configure in Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "mt5_mcp_by_leo": {
      "command": "PATH_TO_EXE",
      "args": ["PATH_TO_FILE", "YOUR_TBP_ID", "YOUR_MT5_ACCOUNT_LOGIN_ID" 
      ]
    }
  }
}
```
> Full template in [Templates/claude_desktop_config.json](https://forge.mql5.io/nique_372/FullMt5McpByLeo/src/branch/main/Templates/claude_desktop_config.json)

- PATH_TO_EXE: Path to exe McpServer.exe file
- PATH_TO_FILE: Path to json config file
- YOUR_TBP_ID: Your The Bot Place user ID
- YOUR_MT5_ACCOUNT_LOGIN_ID: ACCOUNT_LOGGIN of your mt5 account where Mt5Mcp EA is running

### 5. Configure MetaTrader 5

In MT5: **Tools** → **Options** → **Allowed URLs for WebRequest**
- Add `127.0.0.1` or host you configured.
- Click **Accept**
- Enable AutoTrading and DLL imports

### 6. Open claude desktop 
Open Claude Desktop. At that moment, a CMcpServer.exe is running in the background until it establishes a connection with the EA Mt5Mcp.ex5.

### 7. Attach EA in MT5

```
1. Run Runner.ex5 in any chart.. (dowland from releases)
2. Drag Mt5Mcp.ex5 onto your chart (any) and cofigure it, The parameters of the EA, such as port/host, must match the JSON of Claude Desktop
```

### 8. Use in Claude

```
Open a 0.01 lot BUY on EURUSD with SL at 1.0800 and TP at 1.0900
```

Note:
> You can also use HTTP Remote (McpServer.exe support HTTP with libs httplib + mcp-remote npm package) (see: https://forge.mql5.io/nique_372/McpServer/wiki/Running-HTTP)

---

## License

**[Read Full License](./LICENSE)**

By downloading or using this repository, you accept the license terms.

---

## Documentation
- Wiki: [https://forge.mql5.io/nique_372/FullMt5McpByLeo/wiki](https://forge.mql5.io/nique_372/FullMt5McpByLeo/wiki)
- Testing MCP (Full testing in YT videos):
> - https://www.youtube.com/watch?v=kco7aCOs-bM
> - https://www.youtube.com/watch?v=xCscKpoCi3Y  

---

## Contact
- **Platform:** [MQL5 Community](https://www.mql5.com/es/users/nique_372)
- **Profile:** https://www.mql5.com/es/users/nique_372/news

---

<p align="center">Copyright © 2026 Niquel Mendoza (nique_372).<br/>
TSN Trading Systems ecosystem.</p>