FXMacroData
Macroeconomic and FX time-series data for AI agents: indicators, calendars, COT, forex, commodities.
| Endpoint | https://fxmacrodata.com/mcp (streamable-http) |
|---|---|
| Registry version | 1.0.1 |
| Now | 52 tools · grade C (65) · pin ts_f4578337b1ca68cb5c700bac463d54f6 · protocol 2025-06-18 |
| First / last listed | 2026-11-13 00:39 UTC / 2026-11-13 00:39 UTC |
| Grade over time | 2026-11-13: C (65), 52 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: ping mcp_capabilities subscribe_for_mcp_access data_catalogue risk_sentiment macro_news release_calendar release_calendar_visual_artifact event_predictions latest_announcements press_releases rate_curve rate_differentials forex seasonality indicator_query plot_visual_artifact macro_briefing_task macro_heatmap_task geopolitical_history geopolitical_event geopolitical_event_revisions geopolitical_sources geopolitical_event_reaction event_impact_replay_task fx_trade_setup_task fx_backtest_task research_run_list research_run_read research_run_submit research_run_cancel research_run_reveal_holdout research_paper_list research_paper_read research_paper_start research_paper_start_version research_paper_events research_paper_pause research_paper_resume research_paper_flatten research_paper_archive research_paper_journal research_paper_append_journal research_paper_revise_journal market_sessions cot_data commodities catalogue_search catalogue_related organisation_search organisation_profile official_datasets
ping | Health check that confirms the FXMacroData API and MCP server are reachable. Returns the API health response. params: none |
mcp_capabilities | Explains what the FXMacroData MCP server can do: which tools render MCP Apps, which return plain rows, what is public versus subscriber-only, and how tool selection differs across ChatGPT, Claude, Cursor, Codex, and plain MCP clients. Suited to questions about what is available, why visuals are not showing, or how to get the same result in a different interface. params: topic |
subscribe_for_mcp_access | Returns FXMacroData subscription options and a direct checkout path for unlocking MCP app visuals, charts, and advanced analytical tools. params: none |
data_catalogue | List every macroeconomic indicator FXMacroData publishes for a currency, with units, frequency, and coverage/freshness metadata. Returns the exact `indicator` slug strings used across FXMacroData indicator, calendar, and prediction endpoints. Rows whose `coverage` is stale, partial, or unavailable are not suitable for real-time carry or inflation analysis. Other views, all free: `forecasts` shows params: currency, include_coverage, include_capabilities, indicator, view, source, sha256 |
risk_sentiment | 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. Suited to cross-asset regime context for high-beta, safe-haven, commodity, or USD-defensive FX conditions. Access: free, no API key required. params: start_date, end_date, view, after_sequence, limit |
macro_news | Return recent official central-bank news and press-release headlines for a currency, covering central-bank policy, inflation, employment, GDP, trade, fiscal, energy, and commodity narratives. Rows are official-source headlines with lightweight keyword-derived affected_indicators and sentiment fields when a headline is classifiable. Supported currencies: lowercase 3-letter catalogue currency, e.g. params: currency*, lookback_days, limit, offset |
release_calendar | Get upcoming scheduled macroeconomic release timestamps for a currency, for questions such as when the next CPI, GDP, payrolls, or policy decision is due. Returns ISO-8601 announcement_datetime values in UTC plus market-local timestamps, a markdown agenda, and Release Calendar App metadata. The optional `timezone` adds an `announcement_datetime_requested_timezone` field. Each row has a `release` s params: currency*, indicator, start_date, end_date, timezone, view, as_of, knowledge_mode, importance, event_kind, archive_event_id, checkpoint, cursor, limit |
release_calendar_visual_artifact | Returns the release calendar payload with MCP Apps metadata so compatible clients render the interactive Release Calendar App inline. Suited to requests to show, display, visualize, or render a macro release calendar, such as 'show me the AUD release calendar'. Optional `indicator`, `start_date`, and `end_date` filters narrow the calendar to a series, month, week, day, or date range; `timezone` ad params: currency*, indicator, start_date, end_date, timezone |
event_predictions | Return stored forecasts, consensus-style predictions, central-bank projections, survey forecasts, IMF forecasts, nowcasts, or FXMacroData blended predictions for macro announcements, for 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: lowercase 3-letter catalogue curren params: currency*, indicator*, prediction_type, prediction_source, start_date, end_date, limit, offset, page, prediction_class, as_of, event_compatible_only, pre_release_only, official_limit, before_date, seasonality, frequency, annualization, period_aggregation, basis |
latest_announcements | Return the latest stored macroeconomic value for every available indicator in one currency, as a compact current macro snapshot. An unverified announcement_datetime has unproven origin; it is neither a verified scheduled time nor observed actual publication. Report absent schedule, publication and ingestion evidence as unknown, and latency as not measured. Access: USD needs no API key; other curre params: currency, view, currencies, indicators, since, limit, payload |
press_releases | Return the public central-bank press-release archive for a currency as the original official release rows, without derived sentiment or indicator classifications. Access: USD needs no API key; other currencies return subscription_required with a subscribe link. params: currency*, limit, offset |
rate_curve | 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. Access: API key required, else returns subscription_required with a subscribe link. params: currency*, curve_family, metric, view, method, date |
rate_differentials | Return the stored or derived rate differential for one FX pair, with the measure, rate type, curve family, and tenor metadata that define it. Access: API key required, else returns subscription_required with a subscribe link. params: base*, quote*, measure, rate_type, curve_family, start_tenor_years, end_tenor_years, start_date, end_date, limit, offset |
forex | Get raw historical FX spot-rate rows for a currency pair (e.g. EUR/USD) as a plain-text table, raw rows, exact values, or JSON-like data, without chart metadata. Daily official central-bank reference rates with multi-year history. Optional technical-indicator series (SMA, EMA, RSI, MACD, Bollinger Bands, etc.) are selected by comma-separated slugs in indicators; interval selects daily or intraday. params: base*, quote*, start_date, end_date, indicators, interval, start_time, end_time |
seasonality | Get monthly return seasonality for an FX pair or XAU/USD, covering seasonal patterns, month-of-year tendency, historical monthly win rate, and 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. Access: API key required, else returns subscription_required with a subscribe link. params: instrument*, lookback_years, month, end_date |
indicator_query | Returns one currency/indicator's persisted official-producer history using catalogue identifiers. Rows contain `date` (reference period), numeric `val` and separate publication evidence; no chart metadata. `as_of` selects historically eligible values; current values may include revisions. Newest-first pagination: default 100 rows with `start_date`, otherwise 20; `limit` maximum 100. When `paginati params: currency, indicator, start_date, end_date, limit, offset, page, slug, official_only, as_of, availability, dataset_version, revisions, series_mode, value_mode, base, date_basis, factor, include_components, include_sources |
plot_visual_artifact | Build a generic MCP Apps chart: single or multi-series charts, including actual-vs-consensus views combining announcements with predictions. Rate-differential plots show both policy rates and their spread. Charts FXMacroData data only; no arbitrary URLs or custom code. Access: USD needs no API key; other currencies return subscription_required with a subscribe link. params: query, series, source, currency, indicator, base, quote, prediction_type, prediction_source, x_axis, y_key, y_label, title, chart_kind, start_date, end_date, limit, offset, page |
macro_briefing_task | 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. Set depth for one indicator, a regime classification, a research pack, or a short spoken news answer. Access: USD needs no API key; other currencies return subscription_required with a subscribe link. params: currency, depth, indicator, base, quote, start_date, end_date |
macro_heatmap_task | Build a cross-currency macro heatmap from indicator time series and return a matrix with latest values, recent changes, and z-scores. Set mode for a single-pair market cockpit instead. Access: USD needs no API key; other currencies return subscription_required with a subscribe link. params: currencies, indicators, start_date, end_date, mode, base, quote, currency, indicator |
geopolitical_history | Search stored official sanctions (OFAC) and maritime-security (UKMTO) records by source, country, date or text. Each row carries the event_id the other geopolitical tools take and its revision history. Paged with limit and offset. Access: API key required, else returns subscription_required with a subscribe link. params: source_id, country, subtype, include_undated, date_basis, start_date, end_date, as_of, search, after_revision, limit, offset |
geopolitical_event | Full stored record of one official-source geopolitical event, by event_id, with separate incident, publication and capture dates; as_of returns it as known at a past cutoff. Access: API key required, else returns subscription_required with a subscribe link. params: event_id*, as_of |
geopolitical_event_revisions | Every stored revision of one geopolitical event's source record, by event_id, showing how the publisher changed it over time; as_of limits it to what was known at a past cutoff. Access: API key required, else returns subscription_required with a subscribe link. params: event_id*, as_of, limit, offset |
geopolitical_sources | Lists the official geopolitical sources held: source_id values, record counts, collection outcomes and coverage limits. Takes no arguments. Access: API key required, else returns subscription_required with a subscribe link. params: none |
geopolitical_event_reaction | Precomputed FX reference-price moves for one currency pair around one geopolitical event, by event_id. Context only: not causation or a trading signal. Access: API key required, else returns subscription_required with a subscribe link. params: event_id*, pair, as_of |
event_impact_replay_task | Replay verified publication events against measured 1, 5 and 20-observation FX reference returns. Daily windows exclude the publication-day fixing; changes from previous actuals are not consensus surprises. Access: USD needs no API key; other currencies return subscription_required with a subscribe link. params: currency*, indicator*, base, quote, lookback_events, start_date, end_date |
fx_trade_setup_task | Build a trader-oriented FX pair setup using spot context, macro differentials, upcoming catalyst risk, and optional COT positioning. Set view for pair context only or a ranked event-risk score. Access: API key required, else returns subscription_required with a subscribe link. params: base*, quote*, horizon_events, include_cot, view, start_date, end_date |
fx_backtest_task | Run a spot-only FX backtest using historical policy-rate-differential and/or lagged momentum signals. Downloads complete histories, verifies vintages and price coverage, and charges opening, rebalancing and closing costs. The carry signal does not include funding income or broker rollover. Access: API key required, else returns subscription_required with a subscribe link. params: base*, quote*, start_date, end_date, strategy, momentum_lookback, transaction_cost_bps, initial_capital, event_gated, event_window_days |
research_run_list | List owned saved studies. Requires FXMacroData account access; owner-only. No live orders or model inference. Access: API key required, else returns subscription_required with a subscribe link. params: none |
research_run_read | Read one saved study; full report is available in the Research App. Requires FXMacroData account access; owner-only. No live orders or model inference. Access: API key required, else returns subscription_required with a subscribe link. params: run_id* |
research_run_submit | Queue one bounded research calculation; returns a queued run ID. Requires FXMacroData account access; owner-only. No live orders or model inference. Access: API key required, else returns subscription_required with a subscribe link. params: configuration*, kind, request_id |
research_run_cancel | Cancel a saved research job. Cancellation cannot be undone; completed work may need a new submission. Requires FXMacroData account access; owner-only. No live orders or model inference. Access: API key required, else returns subscription_required with a subscribe link. params: run_id* |
research_run_reveal_holdout | Irreversibly expose a study holdout and record its exposure. The holdout can no longer be treated as unseen. Requires FXMacroData account access; owner-only. No live orders or model inference. Access: API key required, else returns subscription_required with a subscribe link. params: run_id* |
research_paper_list | List owned reference paper accounts. Requires FXMacroData account access; owner-only. No live orders or model inference. Access: API key required, else returns subscription_required with a subscribe link. params: none |
research_paper_read | Read one reference paper account and its versions. Requires FXMacroData account access; owner-only. No live orders or model inference. Access: API key required, else returns subscription_required with a subscribe link. params: book_id* |
research_paper_start | Create a new reference paper account starting flat at USD 100. Replay is historical. Requires FXMacroData account access; owner-only. No live orders or model inference. Access: API key required, else returns subscription_required with a subscribe link. params: run_id*, label*, request_id*, mode, limits |
research_paper_start_version | Archive the current version and start a fresh immutable version flat at USD 100. Discards its active position and pending order without a synthetic closing fill; preserves history. Requires FXMacroData account access; owner-only. No live orders or model inference. Access: API key required, else returns subscription_required with a subscribe link. params: book_id*, expected_version*, run_id*, label*, request_id*, mode, limits |
research_paper_events | Read paged paper event summaries; full input evidence remains in the private audit export. Requires FXMacroData account access; owner-only. No live orders or model inference. Access: API key required, else returns subscription_required with a subscribe link. params: book_id*, offset |
research_paper_pause | Pause new paper entries. Requires FXMacroData account access; owner-only. No live orders or model inference. Access: API key required, else returns subscription_required with a subscribe link. params: book_id*, expected_version* |
research_paper_resume | Resume paper entries unless risk halted. Requires FXMacroData account access; owner-only. No live orders or model inference. Access: API key required, else returns subscription_required with a subscribe link. params: book_id*, expected_version* |
research_paper_flatten | Request paper position flattening and discard pending orders; this changes simulated account state. Requires FXMacroData account access; owner-only. No live orders or model inference. Access: API key required, else returns subscription_required with a subscribe link. params: book_id*, expected_version* |
research_paper_archive | Archive a paper account and its active version. This account cannot be resumed. Requires FXMacroData account access; owner-only. No live orders or model inference. Access: API key required, else returns subscription_required with a subscribe link. params: book_id*, expected_version* |
research_paper_journal | Read five journal notes per offset, with long text explicitly shortened. Requires FXMacroData account access; owner-only. No live orders or model inference. Access: API key required, else returns subscription_required with a subscribe link. params: book_id*, offset |
research_paper_append_journal | Append a version-linked journal note; does not modify existing notes. Requires FXMacroData account access; owner-only. No live orders or model inference. Access: API key required, else returns subscription_required with a subscribe link. params: book_id*, version_id*, kind*, body*, event_id |
research_paper_revise_journal | Append a new revision of an existing journal note, retaining the previous revisions. Requires FXMacroData account access; owner-only. No live orders or model inference. Access: API key required, else returns subscription_required with a subscribe link. params: entry_id*, expected_revision*, book_id*, version_id*, kind*, body*, event_id |
market_sessions | Returns which FX trading sessions are currently open (Sydney, Tokyo, London, New York) and when the next session opens or closes, for questions such as 'is the market open?', 'when does London open?', or 'which sessions overlap right now?'. An ISO-8601 UTC timestamp in `at` returns the snapshot for a specific moment instead of now. Accounts for weekends and major banking holidays. Access: free, no params: at |
cot_data | Get weekly CFTC Commitment of Traders (COT) positioning data for a currency's FX futures contract on the CME, covering speculator positioning, non-commercial longs vs shorts, hedge-fund FX positioning, and sentiment extremes. Returns weekly snapshots with long/short open interest by trader category. Updated every Friday at 15:30 ET reflecting the Tuesday cutoff. USD (the USD Index contract) is ava params: currency, start_date, end_date, report, instrument, limit, offset |
commodities | Get historical price series for supported commodity indicators using the exact slugs advertised by this schema. Supported indicators: crude_oil_inventories, distillate_inventories, gasoline_inventories, gold, natural_gas, natural_gas_storage, oil_brent, oil_wti, platinum, silver. Access: API key required, else returns subscription_required with a subscribe link. params: indicator, symbol, start_date, end_date, latest |
catalogue_search | Find public macro indicator series, publishers, explicit country links or organisation references. Search by text or filter by currency, country code, or publisher ID. Empty results do not establish missing data coverage. Results include stable IDs and exact next-tool arguments; no observation values. Organisation lookup requires two search characters and returns up to ten references. Access: publ params: query, kind, country, currency, publisher, limit, cursor |
catalogue_related | Follow evidence-linked catalogue relationships from a node ID returned by catalogue_search. Depth is one or two, limit is at most fifty; use the returned cursor for more results. Paths explain recorded metadata relationships, not causality or series equivalence. Retrieval tools enforce their existing data access rules. Access: public metadata relationships, no API key required. params: node_id*, depth, limit, cursor, relationship |
organisation_search | Find publication-cleared FX industry organisations by name or service, optionally within a business category. Returns at most ten directory references with canonical citation URLs; does not rank firms or export the database. Access: public directory references, no API key required. params: query*, category, limit |
organisation_profile | Read one sourced public organisation summary by slug, including services, original sources and a canonical FXMacroData citation URL. Directory references carry no claim of regulatory approval or endorsement. No claim evidence or contact records are returned. Access: one public organisation summary, no API key required. params: slug* |
official_datasets | One reader for the official datasets outside the headline indicators. `family` picks the set: financial_prices (government yield curves, securities, overnight benchmarks; by currency), native_history (gold ownership and custody, Treasury auctions, cash and debt, TIC positions, EIA energy; by source and year), official_dataset (balance of payments, international investment position, capital flows, params: family*, currency, dataset, source, year, country, start_date, end_date, filters, limit, offset |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.