MT-MCP Docs
Tool Reference

Market Intelligence

4 tools — auto-generated from the MCP server's tool schemas.

Generated

This page is generated from packages/server/mcp/src/tools/*.ts by pnpm docs:generate-tools. Do not edit it by hand — edit the tool's description/schema in source and regenerate.

get_economic_calendar

Returns upcoming and recent economic calendar events sourced from MT5's built-in Calendar API. Filters by currency, impact level, and time window. On MT4 terminals, returns { error: 'NOT_SUPPORTED_ON_MT4' }. Requires the analytics capability (Team+ tier).

Parameters

NameTypeRequiredDefaultDescription
currenciesarrayNo
impactstringNo(one of: LOW, MEDIUM, HIGH)
hours_aheadintegerNo24
hours_backintegerNo0
terminal_idstringNo

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).

Parameters

NameTypeRequiredDefaultDescription
symbolstringYes
levelsintegerNo10
terminal_idstringNo

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).

Parameters

NameTypeRequiredDefaultDescription
symbolstringYes
threshold_multipliernumberNo3
terminal_idstringNo

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).

Parameters

NameTypeRequiredDefaultDescription
filterobjectYes
timeframestringNo"H1"(one of: M1, M5, M15, M30, H1, H4, D1, W1, MN1)
sort_bystringNo"symbol"(one of: spread, rsi, atr, symbol)
limitintegerNo20
terminal_idstringNo

On this page