Skip to main content
Glama
felix-murcia

MetaTrader MCP Server

by felix-murcia

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.

F
license - not found
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/felix-murcia/metatrader-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server