HTS(MetaTrader5) Trading MCP

A Model Context Protocol (MCP) server that connects Claude AI with MetaTrader 5 for forex trading operations and market data analysis.

Features

Market Data

• Historical Candles: Retrieve OHLC data for any forex symbol and timeframe

• Multi-Timeframe Analysis: Fetch candle data across multiple timeframes simultaneously

• Account Information: View trading account details and metrics

• Position Tracking: Monitor all open positions

• Order Management: Track pending orders

Trading Operations

• Order Placement: Create market and pending orders (BUY, SELL, LIMIT, STOP)

• Order Modification: Update price levels, SL/TP, and expiration times

• Order Cancellation: Cancel pending orders

• Position Management: Close positions (full/partial) and modify SL/TP levels

Related MCP server: metatrader-mcp

Architecture

The system consists of two components:

1. MCP Server (Node.js/TypeScript)

   • Exposes tools via Model Context Protocol

   • Manages command queue for EA communication

   • Provides HTTP API for MT5 integration

2. MetaTrader 5 EA (MQL5)

   • Executes trading operations

   • Retrieves market data

   • Communicates with MCP server via HTTP

Installation

npm install
npm run build

Configuration

Create a .env file:

HTTP_PORT=3000

Usage

Start the MCP Server

npm start

Configure Claude Desktop

Add to your Claude desktop config:

{
  "mcpServers": {
    "mcp-server": {
      "command": "node",
      "args": ["/path/to/trading-mcp/dist/index.js"]
    }
  }
}

Deploy MT5 EA

1. Copy ea/info-bot.mq5 to your MetaTrader 5 Experts folder

2. Compile the EA in MetaEditor

3. Attach the EA to any chart

4. Ensure the EA has the correct HTTP endpoint configured

API Tools

Market Data Tools

• get_candles - Historical candle data for a symbol

• get_bulk_candles - Multi-timeframe candle data

• get_accounts - All trading accounts

• get_account - Specific account by number

• get_positions - All open positions

• get_orders - All pending orders

Trading Tools

• open_order - Create new trading order

• modify_order - Update pending order

• cancel_order - Cancel pending order

• close_position - Close open position

• modify_position - Update position SL/TP

• get_command_queue - View pending commands

• get_handler_queue - View command results