Qoyyuum/mcp-metatrader5-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. Documentation
## 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 PyPI
bash
uvx --from mcp-metatrader5-server mt5mcp
### From Source
bash
git clone https://github.com/Qoyyuum/mcp-metatrader5-server.git
cd mcp-metatrader5-server
uv sync
uv run mt5mcp
## Requirements
uv (recommended) or pip
Python 3.11 or higher
MetaTrader 5 terminal installed on Windows
MetaTrader 5 account (demo or real)
## Usage
### Quick Start
The server runs in stdio mode by default for MCP clients like Claude Desktop:
bash
uv run mt5mcp
### Development Mode (HTTP)
For testing with HTTP transport, create a .env file:
env
MT5MCPTRANSPORT=http
MT5MCPHOST=127.0.0.1
MT5MCPPORT=8000
Then run:
bash
uv run mt5mcp
The server will start at http://127.0.0.1:8000
### Installing for MCP Clients
#### Method 1: Using uvx (Simplest - No Installation Required) ⭐
Add this configuration to your MCP client's config file:
For Claude Desktop (claudedesktopconfig.json):
json
"mcpServers": {
"mcp-metatrader5-server": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/Qoyyuum/mcp-metatrader5-server",
"mt5mcp"
#### Method 2: Using FastMCP Install (Recommended)
bash
git clone https://github.com/Qoyyuum/mcp-metatrader5-server
cd mcp-metatrader5-server
After git cloning the repo, run the following commands:
For MCP JSON format
bash
uv run fastmcp install mcp-json src/mcpmt5/main.py
For Claude Desktop
bash
uv run fastmcp install claude-desktop src/mcpmt5/main.py
For Claude Code
bash
uv run fastmcp install claude-code src/mcpmt5/main.py
For Cursor
bash
uv run fastmcp install cursor src/mcpmt5/main.py
For Gemini CLI
bash
uv run fastmcp install gemini-cli src/mcpmt5/main.py
#### Method 3: Manual Configuration
Add this to your claudedesktopconfig.json or whatever LLM config file:
json
"mcpServers": {
"mcp-metatrader5-server": {
"command": "uvx",
"args": [
"--from",
"mcp-metatrader5-server",
"mt5mcp"
],
"env": {
"MT5PATH": "C:\\Program Files\\MetaTrader 5\\terminal64.exe",
"MT5LOGIN": " ",
"MT5PASSWORD": " ",
"MT5SERVER": " "
The env block is optional. When it is set, initialize() and login() can be
called without arguments and the agent never needs to see or ask for your
credentials. Explicit arguments still take precedence. MT5USERNAME is
accepted as an alias for MT5LOGIN.
> Security: with credentials in the env block, the config file holds a
> secret. Keep it out of git, shared backups and shared or synced folders.
## 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
getsymbols(): Get all available symbols
getsymbolsbygroup(group): Get symbols by group
getsymbolinfo(symbol): Get information about a specific symbol
getsymbolinfotick(symbol): Get the latest tick for a symbol
copyratesfrompos(symbol, timeframe, startpos, count): Get bars from a specific position