FXMacroData

REMOTE · FXMACRODATA.COM · SCANNED AUG 3

Macroeconomic and FX time-series data for AI agents: indicators, calendars, COT, forex, commodities.

Available components

+4 this week 69 69 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score →

Endpoint Security63

The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
No authorisation is required to call this server. Every tool declares its destructiveHint and none is destructive, so open access doesn't expose one. See how to fix → View diagnostics → Partial
HTTPS check failed: the endpoint is reachable over plaintext HTTP. See how to fix → View diagnostics → Fail
HSTS check failed: the Strict-Transport-Security header is absent. See how to fix → View diagnostics → Fail
DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail

Transport & Reachability100

Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass

Schema Quality & AI Usability73

100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
AI-judged instruction clarity (excellent).Pass
Context-footprint check failed: tool/resource definitions use about 19034 tokens (~333/item across 57 items; 48 tools + 9 resources), over budget; trim descriptions and params. See how to fix → Fail
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management27

Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage100

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
100% of tool parameters carry a description.Pass
Structured output schemas are declared (46% of tools); any adoption earns full credit.Pass

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Supports UI / widget rendering.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

remote · fxmacrodata.com

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add --transport http fxmacrodata-fxmacrodata https://fxmacrodata.com/mcp

# ~/.codex/config.toml

[mcp_servers.fxmacrodata-fxmacrodata]
url = "https://fxmacrodata.com/mcp"

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "fxmacrodata-fxmacrodata": {
      "type": "remote",
      "url": "https://fxmacrodata.com/mcp",
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add fxmacrodata-fxmacrodata --url https://fxmacrodata.com/mcp --transport streamable-http

# ~/.hermes/config.yaml

mcp_servers:
  fxmacrodata-fxmacrodata:
    url: "https://fxmacrodata.com/mcp"

// mcp.json

{
  "mcpServers": {
    "fxmacrodata-fxmacrodata": {
      "type": "http",
      "url": "https://fxmacrodata.com/mcp"
    }
  }
}

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

3 Aug 26 +1

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.
1 Aug 26 +1

No change was recorded against any check on this day. Stability & Change Management went from 17 to 20. That category is still filling its 30-day observation window: 5 days of observed history at the previous scan, 6 at this one. The score rises as the window fills, whether or not the server changes.
31 Jul 26 0
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
30 Jul 26 +1
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
29 Jul 26 +1

No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.
27 Jul 26 +1
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
26 Jul 26 64

First indexed and scored.

Show 6 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Probed https://fxmacrodata.com/mcp

TLS valid

Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .

Subject	Issuer	Valid from	Valid until	Key	Signature	Serial
CN=fxmacrodata.com	CN=YE2,O=Let's Encrypt,C=US	25 Jul 2026	23 Oct 2026	ECDSA 256	ECDSA-SHA384	58af267b584425a52ff386f154acad4a635
SANs: *.fxmacrodata.com, fxmacrodata.com
CN=YE2,O=Let's Encrypt,C=US (CA)	CN=Root YE,O=ISRG,C=US	3 Sept 2025	2 Sept 2028	ECDSA 384	ECDSA-SHA384	4df3b15dd6c0784c507cd37b58e6f115
CN=Root YE,O=ISRG,C=US (CA)	CN=ISRG Root X2,O=Internet Security Research Group,C=US	13 May 2026	2 Sept 2032	ECDSA 384	ECDSA-SHA384	872165fc34b6e5fba8add5b3705fb53a
CN=ISRG Root X2,O=Internet Security Research Group,C=US (CA)	CN=ISRG Root X1,O=Internet Security Research Group,C=US	13 May 2026	2 Sept 2032	ECDSA 384	SHA256-RSA	6c8f1dc727c7117f7baf853ac980f9cd

DNSSEC insecure

Validation of fxmacrodata.com. — Not signed

Zone	DS	Keys	Algorithms	Outcome
.	trust_anchor	20326, 38696	8, 8	Verified
com.	present	19718	13	Verified
fxmacrodata.com.	absent			Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation

Authentication No authorisation required

The endpoint answered without asking for a token. Anyone who knows the URL can reach it.

Result	No authorisation required
HTTP status	200

Transports 2 probes

Transport	URL	Outcome	Status	Location
streamable-http	https://fxmacrodata.com/mcp	Verified	200
http (plaintext)	http://fxmacrodata.com/mcp	Served over HTTP	200

MCP tools — 48 exposed · ~18,075 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

announcement_changes Macro Announcement Changes ~149

Poll recently ingested macro announcement changes with a resumable cursor. This is the bounded MCP-safe companion to the release-event stream: use the returned next_cursor as since on a later call instead of holding an unbounded streaming tool invocation open.

Input Output Examples

Name	Type	Req	Description
currencies	—	—	Optional comma-separated currency codes, `g10`, or `all`. Without subscriber access, results are limited to the public scope.
indicators	—	—	Optional comma-separated announcement indicator slugs.
limit	integer	—	Maximum matching change events to return.
payload	string	—	Event payload shape: compact trigger rows or full announcement rows.
since	—	—	Optional previous next_cursor, ISO 8601 timestamp, or Unix epoch seconds.

Name	Type	Req	Description
result	object	yes	—

No examples provided.

commodities Commodity Indicators ~149

Get historical price series for supported commodity indicators using the exact slugs advertised by this schema. Requires an API key. Supported indicators: crude_oil_inventories, gold, natural_gas, natural_gas_storage, oil_brent, oil_wti, platinum, silver.

Input Output Examples

Name	Type	Req	Description
end_date	—	—	Inclusive upper bound, YYYY-MM-DD.
indicator	—	—	Commodity indicator slug. Supported: crude_oil_inventories, gold, natural_gas, natural_gas_storage, oil_brent, oil_wti, platinum, silver.
start_date	—	—	Inclusive lower bound, YYYY-MM-DD.
symbol	—	—	Backward-compatible alias for `indicator`. Prefer `indicator` in new calls.

Name	Type	Req	Description
result	object	yes	—

No examples provided.

commodities_visual_artifact Commodities Visual Artifact ~100

Same payload as commodities, but packaged with MCP Apps chart metadata so compatible clients render an interactive commodity chart inline.

Input Output Examples

Name	Type	Req	Description
end_date	—	—	Inclusive upper bound, YYYY-MM-DD.
indicator	string	yes	Commodity indicator slug. Supported: crude_oil_inventories, gold, natural_gas, natural_gas_storage, oil_brent, oil_wti, platinum, silver.
start_date	—	—	Inclusive lower bound, YYYY-MM-DD.

No output schema declared.

No examples provided.

cot_data COT Report ~205

Get weekly CFTC Commitment of Traders (COT) positioning data for a currency's FX futures contract on the CME. Use this when the user asks about speculator positioning, non-commercial longs vs shorts, hedge-fund FX positioning, or wants to gauge sentiment extremes. Returns weekly snapshots with long/short open interest by trader category. Updated every Friday at 15:30 ET reflecting the Tuesday cutoff. Requires an API key. Supported currencies: AUD, CAD, CHF, EUR, GBP, HUF, JPY, MXN, NZD, TRY, USD, XAU.

Input Output Examples

Name	Type	Req	Description
currency	string	yes	3-letter ISO currency code for the FX futures contract (case-insensitive). Supported: AUD, CAD, CHF, EUR, GBP, HUF, JPY, MXN, NZD, TRY, USD, XAU.
end_date	—	—	Inclusive upper bound, YYYY-MM-DD.
start_date	—	—	Inclusive lower bound, YYYY-MM-DD.

Name	Type	Req	Description
result	object	yes	—

No examples provided.

cot_visual_artifact COT Visual Artifact ~159

Same payload as cot_data, but with MCP Apps chart metadata. By default it charts noncommercial net positioning; pass `metric` to chart another COT field.

Input Output Examples

Name	Type	Req	Description
currency	string	yes	3-letter ISO currency code for the FX futures contract (case-insensitive). Supported: AUD, CAD, CHF, EUR, GBP, HUF, JPY, MXN, NZD, TRY, USD, XAU.
end_date	—	—	Inclusive upper bound, YYYY-MM-DD.
metric	—	—	Field to plot from each COT row. Typical values: noncommercial_net, noncommercial_net_zscore, noncommercial_long, noncommercial_short, open_interest.
start_date	—	—	Inclusive lower bound, YYYY-MM-DD.

No output schema declared.

No examples provided.

data_catalogue Indicator Catalogue ~326

List every macroeconomic indicator FXMacroData publishes for a currency, with units, frequency, and coverage/freshness metadata. ALWAYS call this first when the user asks about a country's macro data — it returns the exact `indicator` slug strings to pass to indicator_query, release_calendar, and indicator_visual_artifact. Check `coverage` before calling indicator_query; stale, partial, or unavailable rows are not suitable for real-time carry or inflation analysis. Supported currencies (lowercase 3-letter codes): AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.

Input Output Examples

Name	Type	Req	Description
currency	string	yes	3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.
include_capabilities	boolean	—	Include machine-readable indicator capabilities when the API supports them, such as supported transformations, history availability, and release-calendar linkage.
include_coverage	boolean	—	Include coverage/freshness rows with latest_available_date, coverage_quality, has_recent_data, and recent_observation_count. Leave true when deciding whether an indicator is usable before calling ind…
indicator	—	—	Optional indicator slug to limit coverage calculation, for example `core_inflation`. Use this when you already know the candidate series.

Name	Type	Req	Description
result	object	yes	—

No examples provided.

event_impact_replay_task Event Impact Replay Task ~757

Create a point-in-time replay timeline mapping macro announcements to FX context and heuristic impact markers. Supports MCP Tasks for async execution when clients send task-augmented requests.

Input Output Examples

Name	Type	Req	Description
base	—	—	FX base currency for market context, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.
currency	string	yes	Currency for macro event series, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.
end_date	—	—	Optional inclusive upper bound, YYYY-MM-DD.
indicator	string	yes	Indicator slug for event replay. Supported examples: average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, breakeven_inflation_rate, building_approvals, buildin…
lookback_events	—	—	Maximum number of recent events to include in replay.
quote	—	—	FX quote currency for market context, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.
start_date	—	—	Optional inclusive lower bound, YYYY-MM-DD.

No output schema declared.

No examples provided.

event_predictions Event Predictions ~1,267

Return stored forecasts, consensus-style predictions, central-bank projections, survey forecasts, IMF forecasts, nowcasts, or FXMacroData blended predictions for macro announcements. Use this with release_calendar and indicator_query when a report needs actual-vs-consensus, prior-vs-forecast, or event-surprise context. Rows are keyed by announcement_id/date/indicator and include prediction source metadata. Supported currencies: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD. Supported indicators: average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, breakeven_inflation_rate, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, gdp, gdp_growth_q4_yoy, gdp_growth_qoq_saar, gdp_quarterly, gold_reserves, gov_bond_10y, gov_bond_1y, gov_bond_20y, gov_bond_2y, gov_bond_30y, gov_bond_3y, gov_bond_40y, gov_bond_4y, gov_bond_5y, gov_bond_7y, government_debt, house_price_index, household_credit, housing_starts, imports, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, monthly_cpi, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, ppi_mom, primary_income_balance, retail_sales, retail_sales_control_group, retail_sales_ex_autos, retail_sales_ex_a…

Input Output Examples

Name	Type	Req	Description
currency	string	yes	3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.
end_date	—	—	Optional inclusive upper bound by reference-period date, YYYY-MM-DD.
indicator	string	yes	Required indicator slug. Currency-wide prediction reads are not supported. Supported: average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, breakeven_inflation_…
limit	integer	—	Maximum prediction groups to return. Defaults to 20; maximum 100.
offset	integer	—	Zero-based prediction-group offset.
page	—	—	One-based page number. When supplied, overrides offset.
prediction_source	—	—	Optional source slug filter, for example ecb_spf or philly_fed_spf.
prediction_type	—	—	Optional forecast type filter, for example market_consensus, market_prediction, model_nowcast, survey, central_bank_forecast, central_bank_projection, imf_weo, or fxmacrodata.
start_date	—	—	Optional inclusive lower bound by reference-period date, YYYY-MM-DD.

Name	Type	Req	Description
result	object	yes	—

No examples provided.

forex FX Spot Rates ~578

Get raw historical FX spot-rate rows for a currency pair (e.g. EUR/USD, USD/JPY). Prefer this tool when the user explicitly wants a plain-text table, raw rows, exact values, JSON-like data, or technical-indicator series (SMA, EMA, RSI, MACD, Bollinger Bands, etc.) computed from spot without a chart. If the user asks more generally to show/tell/explain the last few weeks or months of a pair, prefer forex_visual_artifact instead so the client can render a chart. Daily granularity from official central-bank reference rates with full multi-year history. Supported currencies (use lowercase 3-letter codes): AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD. Optional `indicators` parameter accepts a comma-separated list of technical indicator slugs to attach to each row. Supported indicator values: adx_14, atr_14, bollinger_bands, cci_20, donchian_20, ema_12, ema_20, ema_200, ema_26, ema_50, macd, macd_histogram, macd_signal, rsi_14, sma_20, sma_200, sma_50, stochastic_14_3, williams_r_14, all.

Input Output Examples

Name	Type	Req	Description
base	string	yes	Base currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.
end_date	—	—	Inclusive upper bound, YYYY-MM-DD. Defaults to today.
indicators	—	—	Comma-separated technical-indicator slugs to attach to each row. Supported: adx_14, atr_14, bollinger_bands, cci_20, donchian_20, ema_12, ema_20, ema_200, ema_26, ema_50, macd, macd_histogram, macd_s…
quote	string	yes	Quote currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.
start_date	—	—	Inclusive lower bound, YYYY-MM-DD. Defaults to ~5 years ago.

Name	Type	Req	Description
result	object	yes	—

No examples provided.

forex_visual_artifact FX Visual Artifact ~376

Same payload as forex, but packaged with MCP Apps chart metadata so compatible clients render an interactive spot-rate chart inline. Prefer this by default for FX pair time-series requests, especially for prompts like 'show me AUD/USD', 'tell me the last 30 days', 'how has EUR/USD moved recently', or any request where a trend view is more useful than raw rows. Only prefer plain forex when the user explicitly asks for a table, raw values, JSON, CSV-style output, or exact row-by-row data.

Input Output Examples

Name	Type	Req	Description
base	string	yes	Base currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.
end_date	—	—	Inclusive upper bound, YYYY-MM-DD.
indicators	—	—	Optional technical indicators to include in the raw payload. Supported: adx_14, atr_14, bollinger_bands, cci_20, donchian_20, ema_12, ema_20, ema_200, ema_26, ema_50, macd, macd_histogram, macd_signa…
quote	string	yes	Quote currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.
start_date	—	—	Inclusive lower bound, YYYY-MM-DD.

No output schema declared.

No examples provided.

fx_backtest_task FX Backtest Task ~308

Run a transparent rule-based FX backtest on historical spot data using carry and/or momentum signals. Supports MCP Tasks for async execution when clients send task-augmented requests.

Input Output Examples

Name	Type	Req	Description
base	string	yes	Base currency, 3-letter ISO code. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.
end_date	—	—	Inclusive upper bound, YYYY-MM-DD.
event_gated	—	—	When true, only allow positions during release-event windows derived from announcement_datetime on base and quote calendars.
event_window_days	—	—	Event gate window in days around each release date (0 means release-date only).
initial_capital	—	—	Starting capital for equity-curve calculations.
momentum_lookback	—	—	Momentum lookback in observations for the momentum signal.
quote	string	yes	Quote currency, 3-letter ISO code. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.
start_date	—	—	Inclusive lower bound, YYYY-MM-DD.
strategy	—	—	Signal mode: carry, momentum, or carry_momentum.
transaction_cost_bps	—	—	Per-side transaction cost in basis points applied on position changes.

No output schema declared.

No examples provided.

fx_intraday_reference_rates Intraday FX Reference Rates ~85

Return subscriber intraday official FX reference-rate observations for one pair. Call fx_reference_universe first to verify pair and source availability.

Input Output Examples

Name	Type	Req	Description
base	string	yes	Base currency code.
end_time	—	—	Optional inclusive RFC 3339 source timestamp.
quote	string	yes	Quote currency code.
start_time	—	—	Optional inclusive RFC 3339 source timestamp.

Name	Type	Req	Description
result	object	yes	—

No examples provided.

fx_reference_sources FX Reference Sources ~31

List public official FX reference-rate sources and their source policy before requesting a pair-specific intraday reference-rate series.

Input Output Examples

Input schema present but exposes no named parameters.

Name	Type	Req	Description
result	object	yes	—

No examples provided.

fx_reference_universe FX Reference Pair Universe ~59

List the public FX reference-rate pair universe, optionally filtered by currency or source id. Call this before requesting an intraday reference-rate series.

Input Output Examples

Name	Type	Req	Description
currency	—	—	Optional 3-letter currency filter.
source	—	—	Optional official source id filter.

Name	Type	Req	Description
result	object	yes	—

No examples provided.

fx_trade_setup_task FX Trade Setup Task ~207

Build a trader-oriented FX pair setup using spot context, macro differentials, upcoming catalyst risk, and optional COT positioning. Supports MCP Tasks for async execution when clients send task-augmented requests.

Input Output Examples

Name	Type	Req	Description
base	string	yes	Base currency, 3-letter ISO code. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.
horizon_events	—	—	Maximum upcoming catalysts per leg to rank.
include_cot	—	—	When true, attempt to include COT positioning context for both legs.
quote	string	yes	Quote currency, 3-letter ISO code. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.

No output schema declared.

No examples provided.

indicator_intel_task Indicator Intelligence Task ~601

Build an intelligence pack for one indicator by combining chart-ready series data, derived analytics, and nearest release timing context. Supports MCP Tasks for async execution when clients send task-augmented requests.

Input Output Examples

Name	Type	Req	Description
currency	string	yes	3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.
end_date	—	—	Inclusive upper bound, YYYY-MM-DD.
indicator	string	yes	Indicator slug for the given currency. Supported: average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, breakeven_inflation_rate, building_approvals, building_p…
start_date	—	—	Inclusive lower bound, YYYY-MM-DD.

No output schema declared.

No examples provided.

indicator_query Indicator Time Series ~1,466

Get a paginated historical time series of a single macroeconomic indicator for a currency, sourced directly from the official central bank or statistical agency. Use this for CPI/inflation, GDP, unemployment, policy rates, bond yields, payrolls, retail sales, PCE, PPI, trade balance, current account, money supply, and similar series. Each row returns `date` (value-as-of), `val` (numeric), and `announcement_datetime` (when the value was first published — useful for backtest point-in-time integrity). This plain tool returns raw rows for data workflows. Use `indicator_visual_artifact` when the host should render an MCP App chart. Use `limit`, `offset`, or `page` to page through broad histories; check `pagination.next_offset` and `pagination.page_includes_latest_available` in the result. Responses default to official-source rows only; prohibited private aggregator rows are always removed. Always call data_catalogue(currency) first to get the exact indicator slug. USD indicators are free; non-USD requires API key. Supported currencies: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD. Supported indicators: average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, breakeven_inflation_rate, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, gdp, gdp_growth_q4_yoy, gdp_growth_qoq_saar, gdp_quarterly, gold_reserves, gov_bond_10y, gov_bond_1y, gov_bond_20y, gov_bond_2y, gov_bond_30y, gov_bond_3y, gov_bond_40y, gov_bond_4y, gov_bond_5y, gov_bond_7…

Input Output Examples

Name	Type	Req	Description
currency	—	—	3-letter ISO currency code (case-insensitive). Optional if `slug` is provided as a `"usd:cpi"`-style compound. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SE…
end_date	—	—	Inclusive upper bound, YYYY-MM-DD.
indicator	—	—	Indicator slug for the given currency. Optional if `slug` is provided as a `"usd:cpi"`-style compound. Supported: average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_se…
limit	integer	—	Maximum rows to return from the existing REST pagination path. Defaults to 20; maximum 100.
official_only	boolean	—	When true, return only official-source rows and remove explicit fallback observations. Prohibited private aggregator rows are always removed.
offset	integer	—	Zero-based row offset after most-recent-first ordering.
page	—	—	One-based page number. When supplied, the REST endpoint derives offset as `(page - 1) * limit`.
slug	—	—	Optional compound `"<currency>:<indicator>"` slug (e.g. `"usd:cpi"`, `"jpy:policy_rate"`). Many small / open tool-calling models concatenate the two parts anyway. When supplied, overrides `currency`…
start_date	—	—	Inclusive lower bound, YYYY-MM-DD.

Name	Type	Req	Description
result	object	yes	—

No examples provided.

indicator_visual_artifact Indicator Visual Artifact ~1,263

Same payload as indicator_query, but also returns MCP Apps metadata so compatible clients (Claude Desktop, ChatGPT, Codex, etc.) render an interactive line chart instead of a JSON dump. Prefer this by default for indicator time-series requests, especially when the user asks to show, tell, explain, compare, inspect a trend, or review a recent window. For broad histories, use the existing `limit`, `offset`, or `page` controls and inspect `pagination.next_offset` rather than retrying with arbitrary shorter windows. Only fall back to indicator_query when the user explicitly wants a raw table, plain text list, JSON, exact rows, or minimal structured data. Supported currencies: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD. Supported indicators: average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, breakeven_inflation_rate, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, gdp, gdp_growth_q4_yoy, gdp_growth_qoq_saar, gdp_quarterly, gold_reserves, gov_bond_10y, gov_bond_1y, gov_bond_20y, gov_bond_2y, gov_bond_30y, gov_bond_3y, gov_bond_40y, gov_bond_4y, gov_bond_5y, gov_bond_7y, government_debt, house_price_index, household_credit, housing_starts, imports, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, monthly_cpi, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, part_time_employment,…

Input Output Examples

Name	Type	Req	Description
currency	string	yes	3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.
end_date	—	—	Inclusive upper bound, YYYY-MM-DD.
indicator	string	yes	Indicator slug. Supported: average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, breakeven_inflation_rate, building_approvals, building_permits, business_confid…
limit	integer	—	Maximum rows to render from the existing REST pagination path. Defaults to 20; maximum 100.
offset	integer	—	Zero-based row offset after most-recent-first ordering.
page	—	—	One-based page number. When supplied, the REST endpoint derives offset as `(page - 1) * limit`.
start_date	—	—	Inclusive lower bound, YYYY-MM-DD.

No output schema declared.

No examples provided.

known_at_time_task Known At Time Task ~638

Return the slice of a macro series that would have been known at a specific timestamp, using announcement_datetime as the point-in-time integrity boundary. Supports MCP Tasks for async execution when clients send task-augmented requests.

Input Output Examples

Name	Type	Req	Description
as_of	string	yes	UTC ISO-8601 timestamp or YYYY-MM-DD cutoff. Only rows with announcement_datetime <= this moment are returned.
currency	string	yes	3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.
end_date	—	—	Optional inclusive upper bound, YYYY-MM-DD.
indicator	string	yes	Indicator slug for the given currency. Supported: average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, breakeven_inflation_rate, building_approvals, building_p…
start_date	—	—	Optional inclusive lower bound, YYYY-MM-DD.

No output schema declared.

No examples provided.

latest_announcements Latest Macro Announcements ~59

Return the latest stored macroeconomic value for every available indicator in one currency. Use this for a compact current macro snapshot after data_catalogue has confirmed the currency coverage.

Input Output Examples

Name	Type	Req	Description
currency	string	yes	3-letter ISO currency code (case-insensitive).

Name	Type	Req	Description
result	object	yes	—

No examples provided.

latest_commodities Latest Commodity Values ~34

Return the latest stored value for every available commodity indicator in one response. This subscriber tool is the batch counterpart to commodities.

Input Output Examples

Input schema present but exposes no named parameters.

Name	Type	Req	Description
result	object	yes	—

No examples provided.

macro_briefing_task Macro Briefing Task ~130

Build a compact macro briefing for a currency by combining catalogue, key macro series, release-calendar, prediction, news, risk-sentiment, COT, seasonality, and FX technical context. Supports MCP Tasks for async execution when clients send a task-augmented request.

Input Output Examples

Name	Type	Req	Description
currency	string	yes	3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.

No output schema declared.

No examples provided.

macro_factor Macro Factor ~157

Return a precomputed macro factor for one currency, with optional stored component scores and source references. Use this for a documented factor value, not as a substitute for inspecting its underlying macro releases.

Input Output Examples

Name	Type	Req	Description
currency	string	yes	3-letter ISO currency code (case-insensitive).
end_date	—	—	Optional inclusive end date, YYYY-MM-DD.
factor	string	yes	Factor slug, for example monetary_stance.
include_components	boolean	—	Include stored component scores when available.
include_sources	boolean	—	Include public source endpoint references when available.
limit	integer	—	Maximum rows to return.
offset	integer	—	Zero-based row offset.
start_date	—	—	Optional inclusive start date, YYYY-MM-DD.

Name	Type	Req	Description
result	object	yes	—

No examples provided.

macro_heatmap_task Macro Heatmap Task ~615

Build a cross-currency macro heatmap from indicator time series and return a matrix with latest values, recent changes, and z-scores. Supports MCP Tasks for async execution when clients send task-augmented requests.

Input Output Examples

Name	Type	Req	Description
currencies	—	—	Comma-separated 3-letter currency codes (lowercase preferred). Supported values include: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.
end_date	—	—	Optional inclusive upper bound, YYYY-MM-DD.
indicators	—	—	Comma-separated indicator slugs to include in the matrix. Supported values include: average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, breakeven_inflation_ra…
start_date	—	—	Optional inclusive lower bound, YYYY-MM-DD.

No output schema declared.

No examples provided.

macro_news Macro News ~252

Return recent official central-bank news and press-release headlines for a currency. Use this when a report needs headline context for central-bank policy, inflation, employment, GDP, trade, fiscal, energy, or commodity narratives. The tool returns official-source headline rows and lightweight keyword-derived affected_indicators and sentiment fields when a headline is classifiable. Supported currencies: AUD, BRL, CAD, CHF, CNY, CZK, DKK, EUR, GBP, HKD, INR, JPY, MXN, NOK, NZD, PEN, PLN, SEK, SGD, THB, USD, ZAR.

Input Output Examples

Name	Type	Req	Description
currency	string	yes	3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNY, CZK, DKK, EUR, GBP, HKD, INR, JPY, MXN, NOK, NZD, PEN, PLN, SEK, SGD, THB, USD, ZAR.
limit	integer	—	Maximum number of headline rows to request.
lookback_days	integer	—	Maximum age of returned headlines in calendar days when headline timestamps are available.
offset	integer	—	Zero-based headline offset.

Name	Type	Req	Description
result	object	yes	—

No examples provided.

macro_regime_classifier_task Macro Regime Classifier Task ~144

Classify a currency's macro regime using policy rate, inflation, GDP, and unemployment context, with explicit assumptions and confidence notes. Supports MCP Tasks for async execution when clients send task-augmented requests.

Input Output Examples

Name	Type	Req	Description
currency	string	yes	3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.
end_date	—	—	Optional inclusive upper bound, YYYY-MM-DD.
start_date	—	—	Optional inclusive lower bound, YYYY-MM-DD.

No output schema declared.

No examples provided.

macro_research_pack_task Macro Research Pack Task ~620

Bundle catalogue, indicator history, next release timing, and optional FX pair context into one persistent-host-friendly research payload. Supports MCP Tasks for async execution when clients send task-augmented requests.

Input Output Examples

Name	Type	Req	Description
base	—	—	Optional FX base currency for pair context.
currency	string	yes	3-letter ISO currency code. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.
end_date	—	—	Optional inclusive upper bound, YYYY-MM-DD.
indicator	string	yes	Indicator slug. Supported: average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, breakeven_inflation_rate, building_approvals, building_permits, business_confid…
quote	—	—	Optional FX quote currency for pair context.
start_date	—	—	Optional inclusive lower bound, YYYY-MM-DD.

No output schema declared.

No examples provided.

macro_war_room_task Macro War Room Task ~742

Build a multi-panel macro market cockpit that combines FX sessions, upcoming release queue, pair context, and generated risk alerts. Supports MCP Tasks for async execution when clients send task-augmented requests.

Input Output Examples

Name	Type	Req	Description
base	—	—	Base currency for pair context, 3-letter ISO code (case-insensitive). Defaults to the release currency when omitted. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, P…
currency	—	—	Release currency used for queue and spotlight indicator. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.
end_date	—	—	Optional inclusive upper bound, YYYY-MM-DD.
indicator	—	—	Spotlight indicator slug for release context. Supported examples: average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, breakeven_inflation_rate, building_appro…
quote	—	—	Quote currency for pair context, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.
start_date	—	—	Optional inclusive lower bound, YYYY-MM-DD.

No output schema declared.

No examples provided.

market_sessions FX Market Sessions ~122

Tell the user which FX trading sessions are currently open (Sydney, Tokyo, London, New York) and when the next session opens/closes. Use this when the user asks 'is the market open?', 'when does London open?', or 'which sessions overlap right now?'. Pass an ISO-8601 UTC timestamp via `at` to get the snapshot for a specific moment instead of now. Accounts for weekends and major banking holidays.

Input Output Examples

Name	Type	Req	Description
at	—	—	Optional ISO-8601 UTC timestamp; defaults to now. Use to snapshot session state at a specific moment.

Name	Type	Req	Description
result	object	yes	—

No examples provided.

mcp_auth_guide MCP Auth Guide ~82

Explain which authentication mode to use for FXMacroData MCP across major clients and platforms. Use this when the user asks whether to use OAuth, an API key, a bearer token, ChatGPT/OpenAI Apps, Claude/Anthropic, Microsoft/VS Code/Copilot-style clients, AstrBot, Cursor, Codex, local scripts, or CI.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

mcp_capabilities MCP Capabilities ~89

Explain what the FXMacroData MCP server can do, which tools render MCP Apps, which tools return plain rows, what is public versus subscriber-only, and how to choose tools across ChatGPT, Claude, Cursor, Codex, and plain MCP clients. Use this when a user asks what is available, why visuals are not showing, or how to get the same result in a different interface.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

official_dataset_family Official Dataset Family ~238

Get metadata-first official dataset payloads grouped by API endpoint type. Use endpoint_type to pick the API taxonomy group and dataset to choose the specific series family. Supported endpoint types: monetary_policy, fiscal_policy, international_trade, statistics_releases. Supported datasets: auction_metrics, bop, capital_flows, cb_liquidity, credit_conditions, external_debt, fx_intervention, iip, services_trade, treasury_cash, wage_settlements.

Input Output Examples

Name	Type	Req	Description
component	—	—	Required only when dataset='bop'. Supported bop components: goods_balance, services_balance, primary_income, secondary_income, current_account, capital_account, financial_account.
currency	string	yes	3-letter ISO currency code (case-insensitive).
dataset	string	yes	Dataset slug within the selected endpoint_type. Supported: auction_metrics, bop, capital_flows, cb_liquidity, credit_conditions, external_debt, fx_intervention, iip, services_trade, treasury_cash, wa…
endpoint_type	string	yes	Endpoint taxonomy group from the API structure. Supported: monetary_policy, fiscal_policy, international_trade, statistics_releases.

Name	Type	Req	Description
result	object	yes	—

No examples provided.

pair_intel_task FX Pair Intelligence Task ~208

Build an intelligence pack for an FX pair by combining policy-rate spread context, spot-rate context, and release-timing metadata. Supports MCP Tasks for async execution when clients send task-augmented requests.

Input Output Examples

Name	Type	Req	Description
base	string	yes	Base currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.
end_date	—	—	Inclusive upper bound, YYYY-MM-DD.
quote	string	yes	Quote currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.
start_date	—	—	Inclusive lower bound, YYYY-MM-DD.

No output schema declared.

No examples provided.

ping Ping ~40

Quick health check that confirms the FXMacroData API and MCP server are reachable. Use this only if other tools fail unexpectedly — it is not needed before normal calls.

Input Output Examples

Input schema present but exposes no named parameters.

Name	Type	Req	Description
result	object	yes	—

No examples provided.

plot_visual_artifact Plot Visual Artifact ~1,201

Build a generic MCP Apps chart from one or more FXMacroData endpoint families. Use this for arbitrary plot requests, multi-series charts, and actual-vs-consensus views that need to combine announcements with event_predictions. Supported series sources are announcements, predictions, forex, commodities, and cot. For example, plot USD policy-rate midpoint actuals against market consensus by passing one announcements series for `usd/policy_rate_midpoint` and one predictions series for `usd/policy_rate_midpoint` with `prediction_type=market_consensus`. This tool never fetches arbitrary URLs or runs custom chart code; it only composes approved FXMacroData API surfaces into the comparison chart app.

Input Output Examples

Name	Type	Req	Description
base	—	—	Base currency for single-series forex plots. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.
chart_kind	string	—	Initial chart view. Supported: line, area, bar, dot, step.
currency	—	—	Single-series currency for announcements, predictions, or COT. Supported macro currencies: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD. Supported COT curr…
end_date	—	—	Inclusive upper bound, YYYY-MM-DD.
indicator	—	—	Single-series indicator for announcements, predictions, or commodities. Supported macro indicators: average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, breake…
limit	integer	—	Maximum rows per source. Defaults to 20; maximum 100.
offset	integer	—	Zero-based row offset per source.
page	—	—	One-based page number per source.
prediction_source	—	—	Optional prediction source filter for prediction series.
prediction_type	—	—	Optional prediction type filter for prediction series.
query	—	—	Optional natural-language request to preserve in the payload title/context.
quote	—	—	Quote currency for single-series forex plots. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.
series	—	—	Optional list of series specs. Each spec supports `source` (announcements, predictions, forex, commodities, cot), `currency`, `indicator`, `base`, `quote`, `label`, `y_key`, `metric`, `prediction_typ…
source	—	—	Single-series source when `series` is omitted. Supported values: announcements, predictions, forex, commodities, cot.
start_date	—	—	Inclusive lower bound, YYYY-MM-DD.
title	—	—	Optional chart title. Defaults to query or an auto-generated title.
x_axis	string	—	Field to use as the shared x-axis. Supported: date, announcement_datetime, announcement_datetime_local, generated_at, observation_datetime.
y_key	—	—	Single-series metric field. Defaults by source: val for announcements and commodities, predicted_value for predictions, rate for forex, noncommercial_net for COT.
y_label	—	—	Optional y-axis label for the chart.

No output schema declared.

No examples provided.

policy_rate_differential_visual_artifact Policy-Rate Differential Visual Artifact ~195

Build a two-series chart comparing base and quote policy-rate history to visualize the rate differential setup for an FX pair.

Input Output Examples

Name	Type	Req	Description
base	string	yes	Base currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.
end_date	—	—	Inclusive upper bound, YYYY-MM-DD.
quote	string	yes	Quote currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.
start_date	—	—	Inclusive lower bound, YYYY-MM-DD.

No output schema declared.

No examples provided.

policy_scenario_modeler_task Policy Scenario Modeler Task ~309

Run a policy-rate spread what-if scenario for an FX pair and estimate directional spot impact using an explicit heuristic elasticity assumption. Supports MCP Tasks for async execution when clients send task-augmented requests.

Input Output Examples

Name	Type	Req	Description
base	string	yes	Base currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.
elasticity_per_100bps	—	—	Heuristic percent change in FX spot for a 100 bps spread change. Used as a scenario assumption, not a forecast guarantee.
end_date	—	—	Optional inclusive upper bound, YYYY-MM-DD.
policy_shock_bps	—	—	Optional alias for shock_bps for compatibility with host-side app payloads.
quote	string	yes	Quote currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.
shock_bps	—	—	Policy shock size in basis points (100 bps = 1.00 percentage point).
shock_leg	—	—	Which leg receives the policy shock: base or quote.
start_date	—	—	Optional inclusive lower bound, YYYY-MM-DD.

No output schema declared.

No examples provided.

portfolio_risk_engine_task Portfolio Risk Engine Task ~126

Analyze a multi-position FX book for concentration, stress exposure, and event-driven catalyst risk. Supports MCP Tasks for async execution when clients send task-augmented requests.

Input Output Examples

Name	Type	Req	Description
horizon_events	—	—	Maximum release events to consider per currency leg.
positions_json	string	yes	JSON array of FX positions. Each item should include base, quote, side (long/short), and notional. Example: [{"base":"eur","quote":"usd","side":"long","notional":100000}]
stress_shock_pct	—	—	Stress shock in percent applied to each pair.

No output schema declared.

No examples provided.

press_releases Official Press Releases ~88

Return the public central-bank press-release archive for a currency without adding derived sentiment or indicator classifications. Use macro_news when a headline summary is useful; use this tool when the original official release rows matter.

Input Output Examples

Name	Type	Req	Description
currency	string	yes	3-letter ISO currency code (case-insensitive).
limit	integer	—	Maximum rows to return.
offset	integer	—	Zero-based row offset.

Name	Type	Req	Description
result	object	yes	—

No examples provided.

quant_scenario_lab_task Quant Scenario Lab Task ~301

Run an expanded quant-style policy scenario for an FX pair with deterministic projection, stress percentiles, and horizon assumptions. Supports MCP Tasks for async execution when clients send task-augmented requests.

Input Output Examples

Name	Type	Req	Description
annualized_volatility_pct	—	—	Annualized volatility assumption (percent) for stress-band construction.
base	string	yes	Base currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.
elasticity_per_100bps	—	—	Heuristic percent FX move per 100 bps spread change.
end_date	—	—	Optional inclusive upper bound, YYYY-MM-DD.
horizon_days	—	—	Scenario horizon in calendar days.
quote	string	yes	Quote currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.
shock_bps	—	—	Policy shock size in basis points (100 bps = 1.00 percentage point).
shock_leg	—	—	Which leg receives the policy shock: base or quote.
start_date	—	—	Optional inclusive lower bound, YYYY-MM-DD.

No output schema declared.

No examples provided.

rate_curve Rate Curve Analytics ~119

Return official government-nominal curve nodes, slopes, or derived forward segments for one currency. This is a subscriber data tool and preserves the endpoint's requested view and method metadata.

Input Output Examples

Name	Type	Req	Description
currency	string	yes	3-letter currency code.
curve_family	string	—	Official curve family.
date	—	—	Optional target date, YYYY-MM-DD.
method	string	—	Forward derivation method when view is forwards.
metric	string	—	Curve metric.
view	string	—	Curve view: nodes, slopes, or forwards.

Name	Type	Req	Description
result	object	yes	—

No examples provided.

rate_differentials Pair Rate Differentials ~195

Return the stored or derived rate differential for one FX pair. Use the returned measure, rate type, curve family, and tenor metadata when explaining the result.

Input Output Examples

Name	Type	Req	Description
base	string	yes	Base currency code.
curve_family	string	—	Curve family when rate_type is forward.
end_date	—	—	Optional inclusive end date, YYYY-MM-DD.
end_tenor_years	number	—	End tenor in years for forward differentials.
limit	integer	—	Maximum rows to return.
measure	string	—	Shared rate measure to compare across the pair.
offset	integer	—	Zero-based row offset.
quote	string	yes	Quote currency code.
rate_type	string	—	Differential type: spot or forward.
start_date	—	—	Optional inclusive start date, YYYY-MM-DD.
start_tenor_years	number	—	Start tenor in years for forward differentials.

Name	Type	Req	Description
result	object	yes	—

No examples provided.

release_calendar Release Calendar ~1,416

Get upcoming scheduled macroeconomic release timestamps for a currency. Use this when the user asks 'when is the next CPI/GDP/payrolls/policy decision', or to plan a trade around a known release. Returns ISO-8601 announcement_datetime values in UTC plus market-local timestamps. Pass `timezone` for an additional `announcement_datetime_requested_timezone` field. Each row has a `release` string with the indicator name and a `currency` code. Unbounded calls return future releases only; do not show stale past rows unless the user explicitly asks for historical/past calendar data. Consumer-facing clients should present the returned markdown agenda or render the Release Calendar App resource; do not summarize this tool as only a row count. Pass an optional `indicator` filter to narrow to a single series. Pass optional `start_date` and `end_date` bounds when the user mentions a month, week, day, or explicit date range. Supported currencies: AED, ARS, AUD, BOB, BRL, CAD, CHF, CLP, CNH, CNY, COMM, COP, CZK, DKK, DZD, EGP, EUR, GBP, HKD, HUF, IDR, ILS, INR, JPY, KRW, MAD, MXN, MYR, NGN, NOK, NZD, PEN, PHP, PKR, PLN, RUB, SAR, SEK, SGD, THB, TRY, TWD, USD, UYU, VND, ZAR. Supported indicators: average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, breakeven_inflation_rate, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, gdp, gdp_growth_q4_yoy, gdp_growth_qoq_saar, gdp_quarterly, gold_reserves, gov_bond_10y, gov_bond_1y, gov_bond_20y, gov_bond_2y, gov_bond_30y, gov_bond_3y, gov_bond_…

Input Output Examples

Name	Type	Req	Description
currency	string	yes	3-letter ISO currency code (case-insensitive). Supported: AED, ARS, AUD, BOB, BRL, CAD, CHF, CLP, CNH, CNY, COMM, COP, CZK, DKK, DZD, EGP, EUR, GBP, HKD, HUF, IDR, ILS, INR, JPY, KRW, MAD, MXN, MYR,…
end_date	—	—	Optional inclusive upper bound, YYYY-MM-DD.
indicator	—	—	Optional indicator slug to narrow results. Supported: average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, breakeven_inflation_rate, building_approvals, buildi…
start_date	—	—	Optional inclusive lower bound, YYYY-MM-DD.
timezone	—	—	Optional IANA timezone for an additional converted timestamp, for example America/Sao_Paulo.

No output schema declared.

No examples provided.

release_calendar_visual_artifact Release Calendar Visual Artifact ~1,369

Same payload as release_calendar, but named as an explicit visual artifact tool so compatible MCP Apps clients render the interactive Release Calendar App inline. Prefer this by default when the user asks to show, display, visualize, or render a macro release calendar, especially for prompts like 'show me the AUD release calendar'. Only prefer plain release_calendar when the user explicitly asks for a raw table, JSON, exact rows, or text-only output. Pass optional `indicator`, `start_date`, and `end_date` filters when the user names a specific series, month, week, day, or date range. Pass `timezone` when the user asks for local times in a specific city or region. Supported currencies: AED, ARS, AUD, BOB, BRL, CAD, CHF, CLP, CNH, CNY, COMM, COP, CZK, DKK, DZD, EGP, EUR, GBP, HKD, HUF, IDR, ILS, INR, JPY, KRW, MAD, MXN, MYR, NGN, NOK, NZD, PEN, PHP, PKR, PLN, RUB, SAR, SEK, SGD, THB, TRY, TWD, USD, UYU, VND, ZAR. Supported indicators: average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, breakeven_inflation_rate, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, gdp, gdp_growth_q4_yoy, gdp_growth_qoq_saar, gdp_quarterly, gold_reserves, gov_bond_10y, gov_bond_1y, gov_bond_20y, gov_bond_2y, gov_bond_30y, gov_bond_3y, gov_bond_40y, gov_bond_4y, gov_bond_5y, gov_bond_7y, government_debt, house_price_index, household_credit, housing_starts, imports, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_open…

Input Output Examples

Name	Type	Req	Description
currency	string	yes	3-letter ISO currency code (case-insensitive). Supported: AED, ARS, AUD, BOB, BRL, CAD, CHF, CLP, CNH, CNY, COMM, COP, CZK, DKK, DZD, EGP, EUR, GBP, HKD, HUF, IDR, ILS, INR, JPY, KRW, MAD, MXN, MYR,…
end_date	—	—	Optional inclusive upper bound, YYYY-MM-DD.
indicator	—	—	Optional indicator slug to narrow results. Supported: average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, breakeven_inflation_rate, building_approvals, buildi…
start_date	—	—	Optional inclusive lower bound, YYYY-MM-DD.
timezone	—	—	Optional IANA timezone for an additional converted timestamp, for example America/Sao_Paulo.

No output schema declared.

No examples provided.

release_risk_score_task Release Risk Score Task ~180

Score upcoming releases for a currency pair using release-calendar proximity and indicator-level heuristics. Supports MCP Tasks for async execution when clients send task-augmented requests.

Input Output Examples

Name	Type	Req	Description
base	string	yes	Base currency, 3-letter ISO code. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.
horizon_events	—	—	Maximum release events per currency to score.
quote	string	yes	Quote currency, 3-letter ISO code. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.

No output schema declared.

No examples provided.

risk_sentiment Global Risk Sentiment ~103

Return the global risk-on/risk-off sentiment series used for FX regime analysis. The result includes a derived composite score, regime label, component contributions, pagination, and data_quality metadata. Use this for cross-asset regime context before classifying high-beta, safe-haven, commodity, or USD-defensive FX conditions.

Input Output Examples

Name	Type	Req	Description
end_date	—	—	Optional inclusive end date in YYYY-MM-DD format.
start_date	—	—	Optional inclusive start date in YYYY-MM-DD format.

Name	Type	Req	Description
result	object	yes	—

No examples provided.

seasonality FX Seasonality ~180

Get monthly return seasonality for an FX pair or XAU/USD. Use this when the user asks for seasonal patterns, month-of-year tendency, historical monthly win rate, or XAUUSD/gold seasonality. Returns monthly average return, median return, win rate, sample size, dispersion, and per-year monthly returns from stored FX or gold series.

Input Output Examples

Name	Type	Req	Description
end_date	—	—	Inclusive upper bound, YYYY-MM-DD. Defaults to today.
instrument	string	yes	Six-letter pair such as EURUSD, AUDUSD, USDJPY, or XAUUSD. Slashes and separators are accepted by the REST endpoint only when passed as a single string.
lookback_years	—	—	Number of years to include, 2-30. Defaults to 10.
month	—	—	Optional month filter, 1-12 or name such as July.

Name	Type	Req	Description
result	object	yes	—

No examples provided.

subscribe_for_mcp_access Subscribe For MCP Access ~37

Open subscription options when a user needs to unlock MCP app visuals, charts, and advanced analytical tools. Returns a direct checkout path.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

26 Jul 3 Aug

Day	Score
26 Jul	64
27 Jul	65
28 Jul	65
29 Jul	66
30 Jul	67
31 Jul	67
1 Aug	68
2 Aug	68
3 Aug	69