MT-MCP Docs
Tool Reference

Macro Data

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

Parameters

NameTypeRequiredDefaultDescription
symbolstringYes
report_typestringNo"TFF"(one of: LEGACY, TFF, DISAGGREGATED)
weeksintegerNo4

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

Parameters

NameTypeRequiredDefaultDescription
currenciesarrayNo["USD","EUR","GBP","JPY","CHF","AUD","NZD","CAD"]
terminal_idstringNo

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

Parameters

NameTypeRequiredDefaultDescription
currencystringYes
indicatorsarrayNo
terminal_idstringNo

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.


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

Parameters

NameTypeRequiredDefaultDescription
symbolstringYes
volumenumberNo1
terminal_idstringNo

On this page