How do I use MetaTrader MCP Server?

This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.

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

ActivityInactive

ResponsivenessNo issues

Resources

Related MCP Connectors

AlgoVesta MCP Trading
com.algovesta
Trade 16 crypto exchanges + MetaTrader 5 from your AI assistant via one MCP connection.
Cryptocurrency Finance
23
https://api.algovesta.com/mcp
fxapis — MetaTrader 5 A
com.fxapis
Let AI agents trade and read MetaTrader 5 accounts. Hosted — no terminal for you to run.
Finance Autonomous Agents
1
https://api.fxapis.com/mcp
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
https://mcp.mtcontext.com/mcp/v1
Tickwire for MetaTrader 4 and 5 A
io.tickwire
Hosted MCP server for MT4 and MT5: read accounts, prices and candles, and place or close orders.
Finance
191
https://api.tickwire.io/mcp

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 7 days ago (2026-10-28 06:54 UTC)
116 PyPI
238
MIT
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 5 months ago (2026-06-10 04:56 UTC)
MIT
MetaTrader MCP Server
Finance Research & Data
joangrcia
A
license
Not graded
quality
C
maintenance
Enables AI assistants to trade on MetaTrader 5 using natural language, supporting account management, order placement, and real-time market data.
Updated 4 months ago (2026-06-19 22:13 UTC)
1
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

MT5 MCP Server

MetaTrader MCP Server