How do I use MetaTrader MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@MetaTrader MCP Server show me my open positions" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

MetaTrader MCP Server

by felix-murcia

Overview Schema Source Related Servers Discussions Admin

Local

MetaTrader MCP Server

Servidor MCP/HTTP para operar MetaTrader 5 desde LLMs (Claude, Open WebUI, etc.).

Requisitos

Windows 10/11
MetaTrader 5 instalado
Python 3.12

Related MCP server: MetaTrader 5 MCP Server

Instalación

python -m venv venv_mt5
.\venv_mt5\Scripts\activate
pip install metatrader-mcp-server

Configuración

Crea un fichero .env en la raíz del proyecto:

MT5_LOGIN=tu_login
MT5_PASSWORD=tu_password
MT5_SERVER=tu_servidor

.env está en .gitignore — nunca se sube al repositorio.

Arranque manual

.\start_mcp_server.bat

O directamente:

.\venv_mt5\Scripts\python.exe -m metatrader_openapi.main `
  --login tu_login --password tu_password --server tu_servidor `
  --host 0.0.0.0 --port 8000

Arranque automático como servicio

El servidor está registrado como tarea de Windows y arranca automáticamente al iniciar el sistema.

Para gestionar el servicio manualmente usa mcp_service.ps1:

.\mcp_service.ps1 status     # comprobar estado
.\mcp_service.ps1 start      # arrancar
.\mcp_service.ps1 stop       # parar
.\mcp_service.ps1 restart    # reiniciar (si se queda colgado)

El comando status comprueba tres cosas:

Estado de la tarea en el Programador de Windows
Si el proceso Python está corriendo
Si el endpoint HTTP responde

Logs

Los logs se guardan en metatrader_mcp.log en la raíz del proyecto.

2026-06-29 12:52:12  INFO  === MetaTrader MCP Server started (login=tu_login server=tu_servidor) ===
2026-06-29 12:52:33  INFO  GET /api/v1/account/info 200 7ms client=100.81.112.95
2026-06-29 12:53:01  INFO  POST /api/v1/order/market 200 312ms client=100.81.112.95

Cada línea incluye: fecha/hora, nivel, método HTTP, ruta, código de respuesta, tiempo en ms e IP del cliente.

Endpoints HTTP

El servidor expone una API REST en http://localhost:8000. Documentación interactiva en http://localhost:8000/docs.

Cuenta

Método	Ruta	Descripción
GET	`/api/v1/account/info`	Balance, equity, margen, divisa, leverage

Mercado

Método	Ruta	Descripción
GET	`/api/v1/market/symbols`	Lista de símbolos disponibles
GET	`/api/v1/market/price/{symbol}`	Precio actual de un símbolo
GET	`/api/v1/market/candles/{symbol}/{timeframe}`	Últimas N velas

Posiciones abiertas

Método	Ruta	Descripción
GET	`/api/v1/positions`	Todas las posiciones abiertas
GET	`/api/v1/positions/symbol/{symbol}`	Posiciones por símbolo
GET	`/api/v1/positions/{id}`	Posición por ID
DELETE	`/api/v1/positions/{id}`	Cerrar posición por ID
DELETE	`/api/v1/positions`	Cerrar todas las posiciones
DELETE	`/api/v1/positions/profitable`	Cerrar todas las posiciones con beneficio
DELETE	`/api/v1/positions/losing`	Cerrar todas las posiciones con pérdida

Órdenes

Método	Ruta	Descripción
POST	`/api/v1/order/market`	Abrir orden de mercado
POST	`/api/v1/order/pending`	Colocar orden pendiente
GET	`/api/v1/order/pending`	Listar órdenes pendientes
GET	`/api/v1/order/pending/{id}`	Orden pendiente por ID
PUT	`/api/v1/order/pending/{id}`	Modificar orden pendiente
DELETE	`/api/v1/order/pending/{id}`	Cancelar orden pendiente
DELETE	`/api/v1/order/pending`	Cancelar todas las órdenes pendientes

Ejemplo — orden de mercado con SL y TP

curl -X POST http://localhost:8000/api/v1/order/market \
  -H "Content-Type: application/json" \
  -d '{"symbol":"EURUSD","volume":0.01,"type":"BUY","stop_loss":1.13500,"take_profit":1.15000}'

Ejemplo — cerrar posición

curl -X DELETE http://localhost:8000/api/v1/positions/9328864980

Historial

Método	Ruta	Descripción
GET	`/api/v1/history/deals`	Historial de deals (acepta `from_date`, `to_date`, `symbol`)
GET	`/api/v1/history/orders`	Historial de órdenes

Herramientas MCP

El servidor expone las mismas operaciones como herramientas MCP para uso directo desde Claude u otros LLMs compatibles con MCP.

Herramienta	Descripción
`get_account_info`	Info de cuenta
`get_symbol_price`	Precio de un símbolo
`get_symbols`	Lista de símbolos (con filtro opcional)
`get_candles_latest`	Últimas N velas
`get_candles_by_date`	Velas por rango de fechas
`get_deals`	Historial de deals como CSV
`get_orders`	Historial de órdenes como CSV
`get_all_positions`	Posiciones abiertas
`place_market_order`	Orden de mercado (con SL/TP opcionales)
`place_pending_order`	Orden pendiente
`modify_position`	Modificar SL/TP de posición abierta
`modify_pending_order`	Modificar orden pendiente
`close_position`	Cerrar posición por ID
`close_all_positions`	Cerrar todas las posiciones
`close_all_profitable_positions`	Cerrar posiciones con beneficio
`close_all_losing_positions`	Cerrar posiciones con pérdida
`cancel_pending_order`	Cancelar orden pendiente por ID
`cancel_all_pending_orders`	Cancelar todas las órdenes pendientes

Docker

docker-compose up -d

Las credenciales se leen del fichero .env automáticamente.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

AlgoVesta MCP TradingOAuth
com.algovesta
Trade 16 crypto exchanges + MetaTrader 5 from your AI assistant via one MCP connection.
Cryptocurrency Finance
2
MTContext A
io.github.mtcontext
Connect any MCP client to MetaTrader 4/5 to read prices, manage positions, and place trades.
Finance Research & Data
1
Autoview A
io.github.autoview-com
Trade across 22+ exchanges and brokers from any MCP-capable AI agent, no install required.
Finance Cryptocurrency
21
openmm-mcp A
io.github.QBT-Labs
MCP server for OpenMM — exposes market data, account, trading, and strategy tools to AI agents
Finance
1513

Related MCP Servers

MetaTrader 5 MCP Server
Finance Code Execution
sameerasulakshana
F
license
Not graded
quality
D
maintenance
Enables AI assistants to interact with the MetaTrader 5 trading platform for market data analysis, placing trades, and managing trading positions. Provides comprehensive access to forex and financial market operations through the Model Context Protocol.
Updated a year ago (2025-08-23 04:00 UTC)
1
-
MetaTrader 5 MCP Server
Finance
Qoyyuum
A
license
Not graded
quality
A
maintenance
Enables AI assistants to connect to MetaTrader 5 for trading, market data access, and account management through the Model Context Protocol.
Updated 8 days ago (2026-09-07 00:08 UTC)
219
MIT
metatrader5-mcp-server
Finance Cryptocurrency
geekjapan
F
license
Not graded
quality
D
maintenance
Enables AI applications to interact with MetaTrader 5 terminals via WebSocket MCP protocol for trading operations and account management.
Updated a year ago (2025-06-23 13:23 UTC)
4
-
MT5 MCP Server
Finance Research & Data
junmt
A
license
Not graded
quality
D
maintenance
Enables interaction with MetaTrader 5 for market data, technical analysis, Fibonacci calculations, and trading via MCP clients such as Claude.
Updated 3 months ago (2026-06-10 04:56 UTC)
MIT

MetaTrader MCP Server

Requisitos

Instalación

Configuración

Arranque manual

Arranque automático como servicio

Logs

Endpoints HTTP

Cuenta

Mercado

Posiciones abiertas

Órdenes

Ejemplo — orden de mercado con SL y TP

Ejemplo — cerrar posición

Historial

Herramientas MCP

Docker

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

MetaTrader 5 MCP Server

MetaTrader 5 MCP Server

metatrader5-mcp-server

MT5 MCP Server