MTContext

Official73 tools

by mtcontext

Connect any MCP client to MetaTrader 4/5 to read prices, manage positions, and place trades.

io.github.mtcontext/mtcontext — Model Context Protocol (MCP) Server

The io.github.mtcontext/mtcontext MCP server connects any MCP client to MetaTrader 4/5. It enables clients to read market prices, manage trading positions, and place trades through the MetaTrader integration. The server description is focused on trading connectivity and core execution/read capabilities.

🛠️ Key Features

Connect MCP clients to MetaTrader 4/5
Read prices
Manage positions
Place trades

🚀 Use Cases

Building MCP-based trading clients that require MetaTrader 4/5 data access
Automating position management workflows via MCP

⚡ Developer Benefits

One MCP server interface for MetaTrader 4/5 integration across compatible clients
Supports price reads plus position and order placement operations

⚠️ Limitations

Capabilities described are limited to prices, position management, and trade placement
No additional configuration, performance, or authentication details are provided

Captured live from the server via tools/list.

get_tick

Returns the current bid, ask, and spread for a symbol.

Parameters1

symbol

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "maxLength": 12
    }
  },
  "required": [
    "symbol"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_bars

Returns OHLCV bars for a symbol and timeframe.

Parameters3

symbol	string	required
timeframe	string	required
count	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20
    },
    "timeframe": {
      "type": "string",
      "enum": [
        "M1",
        "M5",
        "M15",
        "M30",
        "H1",
        "H4",
        "D1",
        "W1",
        "MN1"
      ]
    },
    "count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5000,
      "default": 100
    }
  },
  "required": [
    "symbol",
    "timeframe"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_symbols

Returns all symbols available in Market Watch.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_symbol_info

Returns contract spec for a symbol: lot size, swap rates, digits.

Parameters1

symbol

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20
    }
  },
  "required": [
    "symbol"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_account_info

Returns account balance, equity, margin, leverage, and currency.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_positions

Returns all open positions with P&L.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_orders

Returns all pending orders.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_trade_history

Returns closed trades with optional date range filter.

Parameters3

from_date	string	optional
to_date	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "from_date": {
      "type": "string",
      "format": "date-time"
    },
    "to_date": {
      "type": "string",
      "format": "date-time"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000,
      "default": 100
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_indicator

Returns raw indicator values for a symbol and timeframe. Values are deterministic and unlabelled — no directional signals or verdicts are attached; the caller interprets them. Provide either `timeframe` (single) or `timeframes` (array, returns results keyed by timeframe under `by_timeframe`) — exactly one. Supported indicators: RSI (Relative Strength Index): period 2-200 (default 14) → values: number[] MACD (Moving Average Convergence Divergence): fast 2-200 (default 12), slow 2-200 (default 26), signal 2-200 (default 9) → macd: number[], signal: number[], histogram: number[] ATR (Average True Range): period 1-200 (default 14) → values: number[] SMA (Simple Moving Average): period 1-200 (default 20), applied_price CLOSE|OPEN|HIGH|LOW|MEDIAN|TYPICAL (default CLOSE) → values: number[] EMA (Exponential Moving Average): period 1-200 (default 20), applied_price CLOSE|OPEN|HIGH|LOW|MEDIAN|TYPICAL (default CLOSE) → values: number[] BOLLINGER (Bollinger Bands): period 2-200 (default 20), deviation 0.1-10 (default 2.0), applied_price CLOSE|OPEN|HIGH|LOW|MEDIAN|TYPICAL (default CLOSE) → upper: number[], middle: number[], lower: number[] ADX (Average Directional Index / DMI): period 2-200 (default 14) → adx: number[], plus_di: number[], minus_di: number[] STOCHASTIC (Stochastic Oscillator): k_period 1-200 (default 5), d_period 1-200 (default 3), slowing 1-200 (default 3) → k: number[], d: number[] CCI (Commodity Channel Index): period 1-200 (default 14) → values: number[] PARABOLIC_SAR (Parabolic Stop and Reverse): step 0.001-1 (default 0.02), maximum 0.01-1 (default 0.2) → values: number[] ICHIMOKU (Ichimoku Kinko Hyo): tenkan 1-200 (default 9), kijun 1-200 (default 26), senkou 1-200 (default 52) → tenkan: number[], kijun: number[], senkou_a: number[], senkou_b: number[], chikou: number[] WPR (Williams %R): period 1-200 (default 14) → values: number[] MFI (Money Flow Index): period 1-200 (default 14) → values: number[] STDDEV (Standard Deviation): period 1-200 (default 20), applied_price CLOSE|OPEN|HIGH|LOW|MEDIAN|TYPICAL (default CLOSE) → values: number[] DEMARKER (DeMarker): period 1-200 (default 14) → values: number[] MOMENTUM (Momentum): period 1-200 (default 14), applied_price CLOSE|OPEN|HIGH|LOW|MEDIAN|TYPICAL (default CLOSE) → values: number[]

Parameters6

symbol	string	required
timeframe	string	optional
timeframes	array	optional
count	integer	optional
indicator	string	required
params	object	optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20
    },
    "timeframe": {
      "type": "string",
      "enum": [
        "M1",
        "M5",
        "M15",
        "M30",
        "H1",
        "H4",
        "D1",
        "W1",
        "MN1"
      ]
    },
    "timeframes": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "M1",
          "M5",
          "M15",
          "M30",
          "H1",
          "H4",
          "D1",
          "W1",
          "MN1"
        ]
      },
      "minItems": 1,
      "maxItems": 9
    },
    "count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500,
      "default": 10
    },
    "indicator": {
      "type": "string",
      "enum": [
        "RSI",
        "MACD",
        "ATR",
        "SMA",
        "EMA",
        "BOLLINGER",
        "ADX",
        "STOCHASTIC",
        "CCI",
        "PARABOLIC_SAR",
        "ICHIMOKU",
        "WPR",
        "MFI",
        "STDDEV",
        "DEMARKER",
        "MOMENTUM"
      ]
    },
    "params": {
      "type": "object",
      "additionalProperties": {}
    }
  },
  "required": [
    "symbol",
    "indicator"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_terminal_info

Returns MT5 terminal metadata: name, company, path, build, max_bars.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_experts

Returns all Expert Advisors currently attached to open charts.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

read_ea_logs

Returns recent lines from the EA log file. available=false when the log cannot be read (MQL5 sandbox).

Parameters2

count	integer	optional
date	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500,
      "default": 100
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{8}$"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_journal

Returns recent lines from the MT5 Journal log. available=false when the log cannot be read.

Parameters2

count	integer	optional
date	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500,
      "default": 100
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{8}$"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_trade_stats

Returns aggregate statistics over closed trades: total_trades, win/loss counts, win_rate, avg_profit, avg_loss, profit_factor, total_pnl, expectancy, max_drawdown_percent, sharpe_ratio, consistency_percent.

Parameters3

symbol	string	optional
from_date	string	optional
to_date	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "maxLength": 12
    },
    "from_date": {
      "type": "string",
      "format": "date-time"
    },
    "to_date": {
      "$ref": "#/properties/from_date"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_pnl_by_symbol

Returns P&L broken down per trading symbol. Result: { items: [{ symbol, pnl, trades }] } sorted by |pnl| descending.

Parameters2

from_date	string	optional
to_date	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "from_date": {
      "type": "string",
      "format": "date-time"
    },
    "to_date": {
      "$ref": "#/properties/from_date"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_pnl_by_time

Returns P&L bucketed into time intervals. Result: { items: [{ period_start, pnl, trades }] } sorted chronologically.

Parameters3

period	string	optional
from_date	string	optional
to_date	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "period": {
      "type": "string",
      "enum": [
        "DAY",
        "WEEK",
        "MONTH"
      ],
      "default": "DAY"
    },
    "from_date": {
      "type": "string",
      "format": "date-time"
    },
    "to_date": {
      "$ref": "#/properties/from_date"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

check_order

Checks whether an order can be placed without sending it. Supports both market and pending order types. Returns { feasible, required_margin, free_margin, estimated_cost, reason? }.

Parameters4

symbol	string	required
order_type	string	required
volume	number	required
price	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "maxLength": 12
    },
    "order_type": {
      "type": "string",
      "enum": [
        "BUY",
        "SELL",
        "BUY_LIMIT",
        "BUY_STOP",
        "SELL_LIMIT",
        "SELL_STOP"
      ]
    },
    "volume": {
      "type": "number",
      "exclusiveMinimum": 0
    },
    "price": {
      "type": "number",
      "exclusiveMinimum": 0
    }
  },
  "required": [
    "symbol",
    "order_type",
    "volume"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_tick_history

Returns a sequence of raw ticks for a symbol. Result: { ticks: [{ time, bid, ask, last, volume }] }.

Parameters3

symbol	string	required
count	integer	optional
from_date	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "maxLength": 12
    },
    "count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000,
      "default": 100
    },
    "from_date": {
      "type": "string",
      "format": "date-time"
    }
  },
  "required": [
    "symbol"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

place_order

Places a market or pending order on MT5. Defaults to dry_run=true — set dry_run=false to execute live. Pending orders may set expiry (unix epoch seconds) for broker-side expiration; expiry is rejected on market orders. Requires the `trade` capability and inp_AllowTrading=true on the EA.

Parameters10

symbol	string	required
volume	number	required
order_type	string	required
price	number	optional
stop_loss	number	optional
take_profit	number	optional
magic	integer	optional
comment	string	optional
expiry	integer	optional	Pending orders only: expiration as unix epoch seconds (UTC). Must be in the future.
dry_run	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "maxLength": 12
    },
    "volume": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 10
    },
    "order_type": {
      "type": "string",
      "enum": [
        "BUY",
        "SELL",
        "BUY_LIMIT",
        "BUY_STOP",
        "SELL_LIMIT",
        "SELL_STOP"
      ]
    },
    "price": {
      "type": "number",
      "exclusiveMinimum": 0
    },
    "stop_loss": {
      "type": "number",
      "minimum": 0
    },
    "take_profit": {
      "type": "number",
      "minimum": 0
    },
    "magic": {
      "type": "integer",
      "minimum": 0
    },
    "comment": {
      "type": "string",
      "maxLength": 64
    },
    "expiry": {
      "type": "integer",
      "minimum": 0,
      "description": "Pending orders only: expiration as unix epoch seconds (UTC). Must be in the future."
    },
    "dry_run": {
      "type": "boolean",
      "default": true
    }
  },
  "required": [
    "symbol",
    "volume",
    "order_type"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

close_position

Closes an open position by ticket. Defaults to dry_run=true — set dry_run=false to execute live. Requires the `trade` capability and inp_AllowTrading=true on the EA.

Parameters2

ticket	integer	required
dry_run	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticket": {
      "type": "integer",
      "exclusiveMinimum": 0
    },
    "dry_run": {
      "type": "boolean",
      "default": true
    }
  },
  "required": [
    "ticket"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

modify_position

Modifies the stop_loss and/or take_profit of an open position. At least one of stop_loss or take_profit must be provided. Defaults to dry_run=true — set dry_run=false to execute live. Requires the `trade` capability and inp_AllowTrading=true on the EA.

Parameters4

ticket	integer	required
stop_loss	number	optional
take_profit	number	optional
dry_run	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticket": {
      "type": "integer",
      "exclusiveMinimum": 0
    },
    "stop_loss": {
      "type": "number",
      "minimum": 0
    },
    "take_profit": {
      "type": "number",
      "minimum": 0
    },
    "dry_run": {
      "type": "boolean",
      "default": true
    }
  },
  "required": [
    "ticket"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

cancel_order

Cancels a pending (limit or stop) order by ticket. Defaults to dry_run=true — set dry_run=false to execute live. Returns ORDER_NOT_FOUND if the ticket is not in pending orders. Requires the `trade` capability and inp_AllowTrading=true on the EA.

Parameters2

ticket	integer	required
dry_run	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticket": {
      "type": "integer",
      "exclusiveMinimum": 0
    },
    "dry_run": {
      "type": "boolean",
      "default": true
    }
  },
  "required": [
    "ticket"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

partial_close

Closes a portion of an open position. `volume` must be less than the full position volume. Defaults to dry_run=true — set dry_run=false to execute live. Returns INVALID_PARAMETER if volume >= position volume, POSITION_NOT_FOUND if position closed between dry-run and live call. Requires the `trade` capability and inp_AllowTrading=true on the EA.

Parameters3

ticket	integer	required
volume	number	required
dry_run	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticket": {
      "type": "integer",
      "exclusiveMinimum": 0
    },
    "volume": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 10
    },
    "dry_run": {
      "type": "boolean",
      "default": true
    }
  },
  "required": [
    "ticket",
    "volume"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

modify_order

Modifies the price, stop_loss, take_profit, or expiry of a pending order. At least one of price, stop_loss, take_profit, or expiry must be provided. Defaults to dry_run=true — set dry_run=false to execute live. Requires the `trade` capability and inp_AllowTrading=true on the EA.

Parameters6

ticket	integer	required
price	number	optional
stop_loss	number	optional
take_profit	number	optional
expiry	integer	optional
dry_run	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticket": {
      "type": "integer",
      "exclusiveMinimum": 0
    },
    "price": {
      "type": "number",
      "exclusiveMinimum": 0
    },
    "stop_loss": {
      "type": "number",
      "minimum": 0
    },
    "take_profit": {
      "type": "number",
      "minimum": 0
    },
    "expiry": {
      "type": "integer",
      "minimum": 0
    },
    "dry_run": {
      "type": "boolean",
      "default": true
    }
  },
  "required": [
    "ticket"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

close_all_positions

Closes all currently open positions, optionally filtered by symbol. The EA executes all closes in a single command to avoid N round-trips and partial-disconnect risk. Returns a `results` array with per-ticket success/failure. Defaults to dry_run=true — set dry_run=false to execute live. Requires the `trade` capability and inp_AllowTrading=true on the EA.

Parameters2

symbol	string	optional
dry_run	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20
    },
    "dry_run": {
      "type": "boolean",
      "default": true
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

set_breakeven

Moves the stop loss of a position (or all positions) to its entry price. Optional buffer_points adds N points on the safe side of entry. Returns POSITION_NOT_IN_PROFIT if the position has not yet moved favourably. Defaults to dry_run=true — set dry_run=false to execute live. Requires the `trade` capability and inp_AllowTrading=true on the EA.

Parameters3

ticket	integer	optional
buffer_points	integer	optional
dry_run	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticket": {
      "type": "integer",
      "exclusiveMinimum": 0
    },
    "buffer_points": {
      "type": "integer",
      "minimum": 0,
      "default": 0
    },
    "dry_run": {
      "type": "boolean",
      "default": true
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

set_trailing_stop

Registers a software trailing stop on a position. The EA updates the SL each timer cycle when price moves trailing_points in the position's favour. IMPORTANT: trailing state is lost if the EA restarts — callers should re-set after reconnect. trailing_points minimum is 10. Defaults to dry_run=true — set dry_run=false to register live. Requires the `trade` capability and inp_AllowTrading=true on the EA.

Parameters3

ticket	integer	required
trailing_points	integer	required
dry_run	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticket": {
      "type": "integer",
      "exclusiveMinimum": 0
    },
    "trailing_points": {
      "type": "integer",
      "minimum": 10
    },
    "dry_run": {
      "type": "boolean",
      "default": true
    }
  },
  "required": [
    "ticket",
    "trailing_points"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

reverse_position

Closes an open position and opens a market order in the opposite direction as ONE EA command (single trade-context acquisition — minimises the gap between the two fills vs separate close_position + place_order calls). volume defaults to the closed volume; optional stop_loss / take_profit apply to the new position. If the close succeeds but the open fails (margin, market closed), returns REVERSE_PARTIAL with the close details and leaves the account flat — the EA never retries the open on its own. Defaults to dry_run=true — set dry_run=false to execute live. Requires the `trade` capability and inp_AllowTrading=true on the EA.

Parameters5

ticket	integer	required
volume	number	optional
stop_loss	number	optional
take_profit	number	optional
dry_run	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticket": {
      "type": "integer",
      "exclusiveMinimum": 0
    },
    "volume": {
      "type": "number",
      "exclusiveMinimum": 0
    },
    "stop_loss": {
      "type": "number",
      "minimum": 0
    },
    "take_profit": {
      "type": "number",
      "minimum": 0
    },
    "dry_run": {
      "type": "boolean",
      "default": true
    }
  },
  "required": [
    "ticket"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

calculate_lot_size

Calculates the appropriate lot size for a trade based on account equity and risk parameters. Uses live account equity and symbol contract specs from the connected terminal. Returns the recommended lot size, risk amount in account currency, and pip value. Returns LOT_TOO_SMALL if the computed lots are below the symbol minimum. Available at Free+ tier (no analytics capability required).

Parameters3

symbol	string	required
risk_percent	number	required
stop_loss_pips	number	required

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20
    },
    "risk_percent": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 100
    },
    "stop_loss_pips": {
      "type": "number",
      "exclusiveMinimum": 0
    }
  },
  "required": [
    "symbol",
    "risk_percent",
    "stop_loss_pips"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_risk_summary

Returns a portfolio risk overview: aggregate currency exposure, margin utilisation, and correlated pairs. NOTE: Currency exposure logic assumes FX symbols (e.g., EURUSD) where the base currency is the first 3 characters. Results for indices, cryptos, and stocks will be inaccurate. Requires the `analytics` capability (Team+ tier).

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_correlation

Returns the Pearson price correlation coefficient between two symbols over N daily bars. Ranges from -1.0 (perfect inverse) to +1.0 (perfect positive). Requires the `analytics` capability (Team+ tier).

Parameters3

symbol_a	string	required
symbol_b	string	required
bars	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbol_a": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20
    },
    "symbol_b": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20
    },
    "bars": {
      "type": "integer",
      "minimum": 2,
      "maximum": 200,
      "default": 20
    }
  },
  "required": [
    "symbol_a",
    "symbol_b"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_economic_calendar

Returns upcoming and recent economic calendar events. Prefers MT5's built-in Calendar API when a terminal is connected; falls back to the server-side calendar (free feed) on MT4 or when disconnected. Response includes a `source` field ('terminal' or 'server'). Requires the `analytics` capability (Team+ tier).

Parameters4

currencies	array	optional
impact	string	optional
hours_ahead	integer	optional
hours_back	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "currencies": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 3,
        "maxLength": 3
      },
      "maxItems": 10
    },
    "impact": {
      "type": "string",
      "enum": [
        "LOW",
        "MEDIUM",
        "HIGH"
      ]
    },
    "hours_ahead": {
      "type": "integer",
      "minimum": 0,
      "maximum": 168,
      "default": 24
    },
    "hours_back": {
      "type": "integer",
      "minimum": 0,
      "maximum": 168,
      "default": 0
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_market_depth

Returns Depth of Market (DOM) bid/ask levels for a symbol. Requires the broker to supply DOM data — if unavailable, returns empty arrays with a note. On MT4 terminals, returns { error: 'NOT_SUPPORTED_ON_MT4' }. Requires the `read` capability (Pro+ tier).

Parameters2

symbol	string	required
levels	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20
    },
    "levels": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "default": 10
    }
  },
  "required": [
    "symbol"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

scan_symbols

Scans Market Watch symbols and filters by spread, RSI, or ATR thresholds. At least one filter criterion must be provided. Returns up to 50 symbols. If scanning takes over 10 seconds, partial results are returned with partial=true. Requires the `read` capability (Pro+ tier).

Parameters4

filter	object	required
timeframe	string	optional
sort_by	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "filter": {
      "type": "object",
      "properties": {
        "spread_max": {
          "type": "number",
          "exclusiveMinimum": 0
        },
        "rsi_above": {
          "type": "integer",
          "minimum": 0,
          "maximum": 100
        },
        "rsi_below": {
          "type": "integer",
          "minimum": 0,
          "maximum": 100
        },
        "atr_above": {
          "type": "number",
          "exclusiveMinimum": 0
        },
        "atr_below": {
          "type": "number",
          "exclusiveMinimum": 0
        }
      },
      "additionalProperties": false
    },
    "timeframe": {
      "type": "string",
      "enum": [
        "M1",
        "M5",
        "M15",
        "M30",
        "H1",
        "H4",
        "D1",
        "W1",
        "MN1"
      ],
      "default": "H1"
    },
    "sort_by": {
      "type": "string",
      "enum": [
        "spread",
        "rsi",
        "atr",
        "symbol"
      ],
      "default": "symbol"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 20
    }
  },
  "required": [
    "filter"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_spread_alert

Returns the current spread for a symbol compared to an estimated historical average. The 30-day average is estimated from daily high-low range (not tick-level data). A spread is flagged as abnormal if it exceeds threshold_multiplier × the estimated average. Requires the `analytics` capability (Team+ tier).

Parameters2

symbol	string	required
threshold_multiplier	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20
    },
    "threshold_multiplier": {
      "type": "number",
      "exclusiveMinimum": 0,
      "default": 3
    }
  },
  "required": [
    "symbol"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_market_sessions

Returns which major trading sessions (Sydney, Tokyo, London, New York) are currently open and when the next session opens/closes. Pure server-side UTC computation — no EA dispatch required. Available at Free+ tier.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_interest_rates

Returns current central bank policy interest rates for major currencies, sourced from MT5's built-in Calendar API. Includes the date of the last change and next scheduled decision. On MT4 terminals, returns { error: 'NOT_SUPPORTED_ON_MT4' }. Requires the `analytics` capability (Team+ tier).

Parameters1

currencies

array

optional

Raw schema

{
  "type": "object",
  "properties": {
    "currencies": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "USD",
          "EUR",
          "GBP",
          "JPY",
          "CHF",
          "AUD",
          "NZD",
          "CAD"
        ]
      },
      "minItems": 1,
      "maxItems": 8,
      "default": [
        "USD",
        "EUR",
        "GBP",
        "JPY",
        "CHF",
        "AUD",
        "NZD",
        "CAD"
      ]
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_macro_indicators

Returns key macroeconomic indicators (CPI, GDP, NFP, PMI, unemployment, retail sales, trade balance) for a currency with the latest actual, previous, forecast, and surprise values. Data from MT5's built-in Calendar API. On MT4 terminals, returns { error: 'NOT_SUPPORTED_ON_MT4' }. Requires the `analytics` capability (Team+ tier).

Parameters2

currency	string	required
indicators	array	optional

Raw schema

{
  "type": "object",
  "properties": {
    "currency": {
      "type": "string",
      "minLength": 3,
      "maxLength": 3
    },
    "indicators": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "CPI",
          "GDP",
          "NFP",
          "PMI",
          "UNEMPLOYMENT",
          "RETAIL_SALES",
          "TRADE_BALANCE"
        ]
      }
    }
  },
  "required": [
    "currency"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_cot_report

Returns the latest CFTC Commitments of Traders (COT) report data for a currency or commodity. Data sourced from the CFTC Socrata public API (free, no key required), cached 24 hours. Supported symbols: EUR, GBP, JPY, CHF, AUD, CAD, NZD, GOLD, OIL. Returns { error: 'COT_UNAVAILABLE' } if the feed is unreachable. Requires the `analytics` capability (Team+ tier).

Parameters3

symbol	string	required
report_type	string	optional
weeks	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 2,
      "maxLength": 20
    },
    "report_type": {
      "type": "string",
      "enum": [
        "LEGACY",
        "TFF",
        "DISAGGREGATED"
      ],
      "default": "TFF"
    },
    "weeks": {
      "type": "integer",
      "minimum": 1,
      "maximum": 52,
      "default": 4
    }
  },
  "required": [
    "symbol"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_rate_differential

Returns the interest rate differential between the two currencies in a pair, plus the annualised swap cost/credit for the specified volume. Computed server-side from get_interest_rates and get_symbol_info data. Requires the `analytics` capability (Team+ tier).

Parameters2

symbol	string	required
volume	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 6,
      "maxLength": 10
    },
    "volume": {
      "type": "number",
      "exclusiveMinimum": 0,
      "default": 1
    }
  },
  "required": [
    "symbol"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_rate_expectations

Returns the market's expected policy path per G10 central bank: next scheduled meeting + countdown, current policy rate, last decision, and — for USD when a Fed Funds futures quote source is configured — market-implied cut/hold/hike probabilities and the implied year-end rate. Every response is labelled `data_quality: implied | calendar_only`; calendar-only entries omit probability fields entirely (never a fabricated guess). Implied values are DELAYED and APPROXIMATE (`approximate: true`, `method: ff_futures_derived`). Fully EA-independent (server-side + cache; works with no terminal connected). Pass a single G10 currency or `ALL` for the full map. Upstream failures serve cached data with `stale: true` or return { error: 'RATE_EXPECTATIONS_UNAVAILABLE' }. Requires the `analytics` capability (Team+ tier).

Parameters1

currency

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "currency": {
      "type": "string",
      "enum": [
        "USD",
        "EUR",
        "GBP",
        "JPY",
        "CHF",
        "AUD",
        "NZD",
        "CAD",
        "ALL"
      ]
    }
  },
  "required": [
    "currency"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_news

Returns recent forex/financial news articles from NewsAPI.org. Requires NEWS_API_KEY environment variable — returns NEWS_NOT_CONFIGURED if not set. Returns NEWS_UNAVAILABLE if the feed is unreachable. Results cached 5 minutes. Requires the `analytics` capability (Team+ tier).

Parameters2

query	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 100
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 10
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_sentiment

Returns retail trader positioning sentiment for a symbol from Myfxbook Community Outlook (free, no key required). Includes long/short percentages and a contrarian signal (when retail is >70% long, signal is SHORT). Returns SENTIMENT_UNAVAILABLE if the feed is unreachable. Results cached 15 minutes. Requires the `analytics` capability (Team+ tier).

Parameters1

symbol

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20
    }
  },
  "required": [
    "symbol"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

explain_trade

Explains a trade: what conditions existed at entry, the risk/reward ratio, SL/ATR ratio, and whether it aligns with common strategies. Works for both open positions and closed trade history. Returns POSITION_NOT_FOUND if ticket not found. Requires the `analytics` capability (Team+ tier).

Parameters2

ticket	integer	required
timeframe	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticket": {
      "type": "integer",
      "exclusiveMinimum": 0
    },
    "timeframe": {
      "type": "string",
      "enum": [
        "M1",
        "M5",
        "M15",
        "M30",
        "H1",
        "H4",
        "D1",
        "W1",
        "MN1"
      ],
      "default": "H1"
    }
  },
  "required": [
    "ticket"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_fibonacci_levels

Computes Fibonacci retracement and extension levels from swing high and low price points. Pure server-side computation — no EA dispatch required. Available at Free+ tier.

Parameters3

swing_high	number	required
swing_low	number	required
direction	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "swing_high": {
      "type": "number",
      "exclusiveMinimum": 0
    },
    "swing_low": {
      "type": "number",
      "exclusiveMinimum": 0
    },
    "direction": {
      "type": "string",
      "enum": [
        "UP",
        "DOWN"
      ],
      "default": "UP"
    }
  },
  "required": [
    "swing_high",
    "swing_low"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

backtest_strategy

Runs a micro-backtest of a simple rule-based strategy over historical bars fetched from the EA. Maximum 5000 bars. Returns equity curve and basic statistics. Times out after 30 seconds and returns BACKTEST_TIMEOUT. Supported entry/exit conditions: rsi_above, rsi_below, price_above_ema, price_below_ema, macd_cross_above_zero, macd_cross_below_zero. Requires the `analytics` capability (Enterprise+ tier).

Parameters6

symbol	string	required
timeframe	string	required
bars	integer	required
strategy	object	required
initial_balance	number	optional
risk_per_trade_pct	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20
    },
    "timeframe": {
      "type": "string",
      "enum": [
        "M1",
        "M5",
        "M15",
        "M30",
        "H1",
        "H4",
        "D1",
        "W1",
        "MN1"
      ]
    },
    "bars": {
      "type": "integer",
      "minimum": 50,
      "maximum": 5000
    },
    "strategy": {
      "type": "object",
      "properties": {
        "entry": {
          "type": "object",
          "additionalProperties": {
            "type": [
              "number",
              "string"
            ]
          }
        },
        "exit": {
          "type": "object",
          "additionalProperties": {
            "type": [
              "number",
              "string"
            ]
          }
        }
      },
      "required": [
        "entry",
        "exit"
      ],
      "additionalProperties": false
    },
    "initial_balance": {
      "type": "number",
      "exclusiveMinimum": 0,
      "default": 10000
    },
    "risk_per_trade_pct": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 100,
      "default": 1
    }
  },
  "required": [
    "symbol",
    "timeframe",
    "bars",
    "strategy"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_market_snapshot

Returns a single-call market snapshot for one symbol: current tick (bid/ask/spread) plus a chosen indicator set across up to 4 timeframes. Replaces 5-8 separate tool calls when analysing a symbol. Limits: 4 timeframes x 6 indicators, 10 values per indicator. Defaults: timeframes ["H1"], indicators ["RSI", "ATR", "EMA"]. Indicators use their registry default parameters (e.g. RSI 14). If the 10s deadline is hit, returns the completed components with partial: true and a missing[] list. Values are raw and unlabelled — interpretation is up to the caller. Available at Free+ tier.

Parameters4

symbol	string	required
timeframes	array	optional
indicators	array	optional
bars	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20
    },
    "timeframes": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "M1",
          "M5",
          "M15",
          "M30",
          "H1",
          "H4",
          "D1",
          "W1",
          "MN1"
        ]
      },
      "minItems": 1,
      "maxItems": 4,
      "default": [
        "H1"
      ]
    },
    "indicators": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "RSI",
          "MACD",
          "ATR",
          "SMA",
          "EMA",
          "BOLLINGER",
          "ADX",
          "STOCHASTIC",
          "CCI",
          "PARABOLIC_SAR",
          "ICHIMOKU",
          "WPR",
          "MFI",
          "STDDEV",
          "DEMARKER",
          "MOMENTUM"
        ]
      },
      "minItems": 1,
      "maxItems": 6,
      "default": [
        "RSI",
        "ATR",
        "EMA"
      ]
    },
    "bars": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "default": 3
    }
  },
  "required": [
    "symbol"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_currency_strength

Ranks the 8 major currencies (USD EUR GBP JPY CHF CAD AUD NZD) by normalised % change, computed from bars across up to 28 major crosses in the terminal's Market Watch. Strongest first. Symbols missing from Market Watch are skipped and listed in skipped[]; currencies with fewer than 4 contributing pairs are flagged low_confidence. Requires the `analytics` capability (Team+ tier).

Parameters2

timeframe	string	optional
bars	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "timeframe": {
      "type": "string",
      "enum": [
        "M1",
        "M5",
        "M15",
        "M30",
        "H1",
        "H4",
        "D1",
        "W1",
        "MN1"
      ],
      "default": "H4"
    },
    "bars": {
      "type": "integer",
      "minimum": 2,
      "maximum": 200,
      "default": 24
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_key_levels

Computes support/resistance key levels for a symbol: classic + Fibonacci pivot points from the prior period, swing highs/lows (fractal detection), and psychological round numbers near the current price. Each level includes its distance from the current price. Available at Free+ tier.

Parameters3

symbol	string	required
timeframe	string	optional
swing_bars	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20
    },
    "timeframe": {
      "type": "string",
      "enum": [
        "M1",
        "M5",
        "M15",
        "M30",
        "H1",
        "H4",
        "D1",
        "W1",
        "MN1"
      ],
      "default": "D1"
    },
    "swing_bars": {
      "type": "integer",
      "minimum": 10,
      "maximum": 500,
      "default": 100
    }
  },
  "required": [
    "symbol"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

detect_patterns

Runs deterministic rule-based candlestick pattern detection over recent bars: engulfing, hammer, shooting star, doji, inside/outside bar, morning/evening star. Detection thresholds are fixed constants echoed in the response `criteria` field. Patterns are locations in the data, not trade signals. Available at Pro+ tier.

Parameters4

symbol	string	required
timeframe	string	required
bars	integer	optional
patterns	array	optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20
    },
    "timeframe": {
      "type": "string",
      "enum": [
        "M1",
        "M5",
        "M15",
        "M30",
        "H1",
        "H4",
        "D1",
        "W1",
        "MN1"
      ]
    },
    "bars": {
      "type": "integer",
      "minimum": 3,
      "maximum": 200,
      "default": 50
    },
    "patterns": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "doji",
          "hammer",
          "shooting_star",
          "engulfing",
          "inside_bar",
          "outside_bar",
          "morning_star",
          "evening_star"
        ]
      },
      "minItems": 1
    }
  },
  "required": [
    "symbol",
    "timeframe"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_execution_quality

Reports slippage statistics (requested vs filled price) for live market orders placed through MT-MCP: average, median, and worst slippage in points, overall and per symbol. Measurement starts from when fill auditing was enabled — earlier periods return DATA_INSUFFICIENT with the earliest measurable date. Requires the `analytics` capability (Team+ tier).

Parameters3

from_date	string	optional	ISO date, default 30 days ago
to_date	string	optional	ISO date, default today
symbol	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "from_date": {
      "type": "string",
      "description": "ISO date, default 30 days ago"
    },
    "to_date": {
      "type": "string",
      "description": "ISO date, default today"
    },
    "symbol": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

create_alert

Creates a persistent server-side alert, evaluated every ~30 seconds while the terminal is connected (not tick-precise). Types: price (level above/below), indicator (value or cross vs threshold), position_event (sl_hit / tp_hit / position_closed, optional ticket filter), margin_level (below %). mode=once fires a single time; mode=recurring re-arms after cooldown_seconds. Fired events are queued durably — retrieve them with poll_alerts. Active-alert caps by tier: Pro 10, Team 50, Enterprise 200. Available at Pro+ tier.

Parameters5

type	string	required
condition	object	required	Condition object; shape depends on type — see tool description.
mode	string	optional
cooldown_seconds	integer	optional
note	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "price",
        "indicator",
        "position_event",
        "margin_level"
      ]
    },
    "condition": {
      "type": "object",
      "additionalProperties": {},
      "description": "Condition object; shape depends on type — see tool description."
    },
    "mode": {
      "type": "string",
      "enum": [
        "once",
        "recurring"
      ],
      "default": "once"
    },
    "cooldown_seconds": {
      "type": "integer",
      "minimum": 60,
      "maximum": 86400,
      "default": 300
    },
    "note": {
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "type",
    "condition"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_alerts

Lists all alerts for this license with status (active/fired/cancelled), condition, mode, fire count, and last_evaluated_at (stale while the terminal is disconnected — evaluation pauses). Available at Pro+ tier.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

cancel_alert

Cancels an active alert by alert_id (from create_alert or list_alerts). Returns ALERT_NOT_FOUND if the alert does not exist, already fired, or was already cancelled. Available at Pro+ tier.

Parameters1

alert_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "alert_id": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "alert_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

poll_alerts

Drains undelivered fired-alert events (oldest first) and marks them delivered. Each event carries event_id, the alert's condition echo, the triggering values, and the fired timestamp. Events are retained 7 days; pass include_delivered=true to see the retained history. Call this periodically — alerts are pull-based, nothing is pushed. Available at Pro+ tier.

Parameters1

include_delivered

boolean

optional

Raw schema

{
  "type": "object",
  "properties": {
    "include_delivered": {
      "type": "boolean",
      "default": false
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

set_equity_guard

Configures an account-level circuit breaker enforced server-side (survives this session): when equity falls max_daily_loss_percent below the daily anchor (or max_total_drawdown_percent below initial equity), the guard breaches. breach_action: close_all = close all positions then block new live trades until the daily reset; block_new = block only; notify = record an alert event only (see poll_alerts). Evaluation runs on a ~30s sampling loop while the terminal is connected; if disconnected at breach time, the trade block still applies and close_all executes on reconnect. This is best-effort protection above the broker's own stop-out, not a replacement for stop losses. One guard per license — calling again replaces it. Requires the `trade` capability.

Parameters6

max_daily_loss_percent	number	required
max_total_drawdown_percent	number	optional
breach_action	string	required
reset_timezone	string	optional	IANA timezone for the daily reset boundary, e.g. 'UTC' or 'Europe/Prague'.
initial_equity	number	optional	Starting account equity for total drawdown calculation basis.
initial_balance	number	optional	Alias for initial_equity.

Raw schema

{
  "type": "object",
  "properties": {
    "max_daily_loss_percent": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 99
    },
    "max_total_drawdown_percent": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 99
    },
    "breach_action": {
      "type": "string",
      "enum": [
        "close_all",
        "block_new",
        "notify"
      ]
    },
    "reset_timezone": {
      "type": "string",
      "maxLength": 64,
      "default": "UTC",
      "description": "IANA timezone for the daily reset boundary, e.g. 'UTC' or 'Europe/Prague'."
    },
    "initial_equity": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Starting account equity for total drawdown calculation basis."
    },
    "initial_balance": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Alias for initial_equity."
    }
  },
  "required": [
    "max_daily_loss_percent",
    "breach_action"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_equity_guard_status

Returns the current equity guard: config, status (armed / breached / breached_pending / none), day_start_equity anchor, current equity, daily P&L percent, and the equity level at which the guard breaches. Requires the `trade` capability.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

remove_equity_guard

Removes the equity guard. If the guard is currently breached (or breached_pending), removal requires confirm=true — this prevents silently disabling an active safety rail; without it the call returns CONFIRM_REQUIRED. Requires the `trade` capability.

Parameters1

confirm

boolean

optional

Raw schema

{
  "type": "object",
  "properties": {
    "confirm": {
      "type": "boolean",
      "default": false
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

set_prop_firm_rules

Configures a per-terminal prop-firm ruleset evaluated server-side (survives this session). Rules: max_daily_loss_percent (vs the daily equity anchor), optional max_total_drawdown_percent with drawdown_mode (static = from initial balance; trailing = from the high-watermark) and drawdown_basis (balance or equity), optional profit_target_percent, min_trading_days, and consistency_max_day_share_percent (max share of total profit from a single day). A preset (ftmo | generic) pre-fills defaults but the stored ruleset is always fully resolved — explicit params win. reset_timezone (IANA) sets the daily boundary. initial_balance seeds the drawdown basis for mid-challenge onboarding (otherwise seeded from a live sample). One ruleset per (license, terminal); re-calling replaces rule values but preserves the watermark unless initial_balance is re-supplied. ADVISORY ONLY — this never blocks trades. Pass link_equity_guard: true to also install a matching equity guard (breach_action default block_new) for actual enforcement. Requires the `trade` capability.

Parameters13

preset	string	optional
max_daily_loss_percent	number	optional
max_total_drawdown_percent	number	optional
drawdown_mode	string	optional
drawdown_basis	string	optional
profit_target_percent	number	optional
min_trading_days	integer	optional
consistency_max_day_share_percent	number	optional
reset_timezone	string	optional	IANA timezone for the daily reset boundary, e.g. 'Europe/Prague'.
initial_balance	number	optional
initial_equity	number	optional	Alias for initial_balance. Starting account balance/equity for drawdown basis.
link_equity_guard	boolean	optional	Install a matching equity guard for enforcement.
breach_action	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "preset": {
      "type": "string",
      "enum": [
        "ftmo",
        "generic"
      ]
    },
    "max_daily_loss_percent": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 99
    },
    "max_total_drawdown_percent": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 99
    },
    "drawdown_mode": {
      "type": "string",
      "enum": [
        "static",
        "trailing"
      ]
    },
    "drawdown_basis": {
      "type": "string",
      "enum": [
        "balance",
        "equity"
      ]
    },
    "profit_target_percent": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 999
    },
    "min_trading_days": {
      "type": "integer",
      "minimum": 0,
      "maximum": 365
    },
    "consistency_max_day_share_percent": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 100
    },
    "reset_timezone": {
      "type": "string",
      "maxLength": 64,
      "description": "IANA timezone for the daily reset boundary, e.g. 'Europe/Prague'."
    },
    "initial_balance": {
      "type": "number",
      "exclusiveMinimum": 0
    },
    "initial_equity": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Alias for initial_balance. Starting account balance/equity for drawdown basis."
    },
    "link_equity_guard": {
      "type": "boolean",
      "description": "Install a matching equity guard for enforcement."
    },
    "breach_action": {
      "type": "string",
      "enum": [
        "close_all",
        "block_new",
        "notify"
      ]
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_prop_firm_status

Returns a decision-ready prop-firm verdict: overall status (ok | warning | critical | breached), trade_advice (proceed | reduce_risk | block), max_safe_risk_percent for the next trade, per-rule headroom (percent and account currency) with human-readable reasons, days_traded, trailing watermark, and the consistency + profit-target / min-trading-days progress. Status is driven only by loss rules and a consistency violation; profit target and min trading days never worsen it. FAIL-SAFE: if the terminal is unreachable (no fresh equity sample) the response sets stale: true and forces trade_advice: block. Evaluation runs on a ~30s server-side sampling loop, so verdicts can lag intraday spikes — treat the bands as conservative. Requires the `trade` capability.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

remove_prop_firm_rules

Removes the prop-firm ruleset for the terminal (does not touch any linked equity guard — remove that separately with remove_equity_guard). Returns RULESET_NOT_FOUND if none exists. Requires the `trade` capability.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

write_trade_note

Persists a trade journal entry: rationale, setup label, and tags, optionally linked to a position/order ticket. Entries are append-only and immutable — to correct one, write a new note with amends_entry_id pointing at the original. Use at order time to capture WHY a trade was taken; query later with query_journal for post-trade review and per-setup statistics. Free tier stores up to 100 entries. Available at Free+ tier.

Parameters5

text	string	required
ticket	integer	optional
tags	array	optional
setup	string	optional
amends_entry_id	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000
    },
    "ticket": {
      "type": "integer",
      "exclusiveMinimum": 0
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 32,
        "pattern": "^[a-z0-9_-]+$"
      },
      "maxItems": 10,
      "default": []
    },
    "setup": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "amends_entry_id": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "text"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

query_journal

Queries trade journal entries, newest first. Filters: ticket, tag, setup, from_date/to_date (ISO), and search (case-insensitive text match). Entries linked to closed trades include realized_pnl when the terminal is connected (null otherwise). Available at Free+ tier.

Parameters8

ticket	integer	optional
tag	string	optional
setup	string	optional
from_date	string	optional	ISO date
to_date	string	optional	ISO date
search	string	optional
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticket": {
      "type": "integer",
      "exclusiveMinimum": 0
    },
    "tag": {
      "type": "string",
      "minLength": 1,
      "maxLength": 32
    },
    "setup": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "from_date": {
      "type": "string",
      "description": "ISO date"
    },
    "to_date": {
      "type": "string",
      "description": "ISO date"
    },
    "search": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 20
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "default": 0
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_behavioral_insights

Computes descriptive behavioural metrics from closed trade history: overtrading (trades/day vs the trailing 30-day baseline), revenge trading (re-entry within 15 min of a loss on the same symbol at >=1.5x volume), volume escalation across consecutive losses, and winner-vs-loser hold-time asymmetry. All thresholds are fixed constants echoed in the `criteria` field. This is descriptive coaching over trade data, NOT a psychological assessment. Returns DATA_INSUFFICIENT below 10 closed trades. Requires the `analytics` capability (Team+ tier).

Parameters2

from_date	string	optional	ISO date, default 30 days ago
to_date	string	optional	ISO date, default today

Raw schema

{
  "type": "object",
  "properties": {
    "from_date": {
      "type": "string",
      "description": "ISO date, default 30 days ago"
    },
    "to_date": {
      "type": "string",
      "description": "ISO date, default today"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_event_risk

Preflight check: returns a graded verdict (proceed/caution/block) for trading a symbol based on upcoming high-impact economic events within the horizon. Uses the server-side calendar — works with no terminal connected. Includes blackout windows, resume_after time, and per-event details. Unknown symbols default to caution (fail-safe). Requires the `analytics` capability (Team+ tier).

Parameters6

symbol	string	required
horizon_hours	number	optional
high_before_min	integer	optional
high_after_min	integer	optional
medium_before_min	integer	optional
medium_after_min	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20
    },
    "horizon_hours": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 168,
      "default": 4
    },
    "high_before_min": {
      "type": "integer",
      "exclusiveMinimum": 0
    },
    "high_after_min": {
      "type": "integer",
      "exclusiveMinimum": 0
    },
    "medium_before_min": {
      "type": "integer",
      "exclusiveMinimum": 0
    },
    "medium_after_min": {
      "type": "integer",
      "exclusiveMinimum": 0
    }
  },
  "required": [
    "symbol"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_holding_risk

Assesses risk for holding (or planning to hold) a position in a symbol for a specified duration. Reports events landing inside the hold window, weekend/market-closure gap exposure, and triple-swap day flags. Uses the server-side calendar — works with no terminal. Requires the `analytics` capability (Team+ tier).

Parameters2

symbol	string	required
expected_hold_hours	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20
    },
    "expected_hold_hours": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 720,
      "default": 24
    }
  },
  "required": [
    "symbol"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_risk_regime

Returns a composite risk-on/risk-off score in [−1, 1] from z-scored market inputs (VIX, DXY, gold, 2s10s spread, equities). Pure scoring function with transparent per-input drivers, confidence, missing_inputs, and sizing_advice. Requires at least 3 available inputs or returns REGIME_UNAVAILABLE. Requires the `analytics` capability (Team+ tier).

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_economic_surprise

Returns a rolling actual-vs-forecast surprise index for a currency's economic events, weighted by impact tier (high=3×, medium=1×, low ignored). Reports insufficient_history when fewer than 30 days of data exist. Uses the server-side calendar. Requires the `analytics` capability (Team+ tier).

Parameters2

currency	string	required
days	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "currency": {
      "type": "string",
      "minLength": 3,
      "maxLength": 3
    },
    "days": {
      "type": "integer",
      "minimum": 7,
      "maximum": 365,
      "default": 90
    }
  },
  "required": [
    "currency"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_cb_stance

Returns the central bank hawk/dove stance for a currency, scored from −1 (max dovish) to +1 (max hawkish). Reads from persisted snapshots — no LLM call in the request path. Includes recent_change indicator, source statements, and classifier provenance marker. Requires the `analytics` capability (Team+ tier).

Parameters1

currency

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "currency": {
      "type": "string",
      "minLength": 3,
      "maxLength": 3
    }
  },
  "required": [
    "currency"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

set_news_guard

Configures a persistent server-side news monitor. When enabled, the guard polls news at the specified interval, classifies articles by severity and affected currencies, and triggers alerts (via poll_alerts) when articles meet the threshold. One guard per license — calling again replaces the config. Notify-only: the guard never closes positions or blocks trades. Requires the `analytics` capability.

Parameters4

currencies	array	required
keywords	array	optional
min_severity	string	optional
poll_interval_seconds	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "currencies": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 3,
        "maxLength": 3
      },
      "minItems": 1,
      "maxItems": 10
    },
    "keywords": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 100
      },
      "maxItems": 20,
      "default": []
    },
    "min_severity": {
      "type": "string",
      "enum": [
        "low",
        "medium",
        "high",
        "critical"
      ],
      "default": "high"
    },
    "poll_interval_seconds": {
      "type": "integer",
      "minimum": 300,
      "maximum": 3600,
      "default": 300
    }
  },
  "required": [
    "currencies"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_news_guard_status

Returns the current news guard configuration, enabled state, last poll time, classifier mode (llm/heuristic), and count of alerts raised in the last 24h. Returns { status: 'none' } if no guard is configured. Requires the `analytics` capability.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

remove_news_guard

Removes the news guard for this license. The guard stops polling immediately. Returns { removed: true } on success. Requires the `analytics` capability.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_market_context

Returns live cross-asset context in one call: DXY (broad USD), VIX (equity-vol risk regime), and the US 10Y yield — each with level, short-horizon (5-day) change, asof, and source — plus a transparent risk_tone (risk_on / neutral / risk_off) derived from a documented VIX+DXY heuristic. Reads the server-side market-snapshot foundation; works with no terminal connected (incl. MT4). Degrades transparently: unavailable inputs are listed in missing_inputs, never zeroed; risk_tone is 'unknown' unless both VIX and DXY are present. Returns MARKET_CONTEXT_UNAVAILABLE only when no input can be sourced. This is the raw-feed reader that get_risk_regime (a composite score) is not. Requires the `analytics` capability (Team+ tier).

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md3 KBView on GitHub

MTContext MCP Quickstart

Connect Claude, Cursor, or any MCP-compatible client to a MetaTrader 4 or 5 terminal — no Python, no local server to run.

MTContext is a cloud-hosted, remote MCP server. There's nothing to clone, build, or pip install from this repo — this repo exists to document the connection and point at the real thing. (This is intentional: the server implementation itself is closed-source, cloud infrastructure, not something you run yourself.)

How it works

Sign up (free tier: read-only market data, no card required).
Drag one Expert Advisor file (.ex5 for MT5, .ex4 for MT4 — MT4 support coming soon) onto a chart in your MetaTrader terminal.
Copy your ready-made MCP config snippet from the dashboard and paste it into your client's config.
Ask your AI client, in plain English, for live prices, account state, indicators, or — when you explicitly allow it — trades. Every trade-affecting call defaults to dry_run: true until you confirm.

Connection

MTContext exposes a single remote Streamable HTTP MCP endpoint per account:

json

{
  "mcpServers": {
    "mtcontext": {
      "type": "http",
      "url": "https://mcp.mtcontext.com/mcp/v1",
      "headers": {
        "Authorization": "Bearer YOUR_LICENSE_KEY"
      }
    }
  }
}

Get your real YOUR_LICENSE_KEY from your dashboard after connecting a terminal — see examples/claude_desktop_config.example.json.

What you can ask it

"What's the current EURUSD bid and ask?"
"What's my account balance and open positions?"
"Run RSI and MACD on GBPUSD, H1."
"Size a position on XAUUSD risking 1% of my equity with a 30-pip stop."
"Place a dry-run buy on EURUSD, 0.1 lots, and show me what would happen."

Full tool reference: docs.mtcontext.com. Setup guides and troubleshooting: help.mtcontext.com.

Why not a self-hosted MCP server?

Several open-source MetaTrader MCP servers exist and require installing Python and running a local process yourself, usually MT5-only, with no safety layer beyond what you build. MTContext trades that developer-only setup for a one-file install, MT4 and MT5, and a dry-run-by-default safety model — aimed at traders, not just developers who happen to trade.

License

The contents of this repository (documentation and examples) are MIT licensed — see LICENSE. This does not cover the MTContext service itself, which is proprietary.

Install

Tools (73)

get_tickget_barsget_symbolsget_symbol_infoget_account_infoget_positionsget_ordersget_trade_history

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.mtcontext.com/mcp/v1

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mtcontext": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.mtcontext.com/mcp/v1"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.