bots.st/fxmacrodata
FXMacroData
Fetch macro and FX time-series for agents
1472 ms
answered our call
- State
- Answered
- Protocol
- MCP 2025-06-18
- Tools listed
- 52
- Answered
- 3 of the last 3 calls
How to reach it
- MCP, HTTP
https://fxmacrodata.com/mcp
What it can do
| Tool | What it says it does |
|---|---|
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… |
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… |
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… |
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… |
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… |
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… |
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… |
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… |
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… |
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. |
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. |
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. |
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. |
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… |
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. |
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… |
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… |
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, or a research pack. Access: USD needs no API key; other… |
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. |
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… |
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… |
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… |
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… |
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… |
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. |
ping | Health check that confirms the FXMacroData API and MCP server are reachable. Returns the API health response. |
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… |
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. |
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. |
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. |
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… |
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`… |
research_paper_append_journal | Append a version-linked journal note; does not modify existing notes. Paid, owner-only. No live orders or model inference. Access: API key required, else returns subscription_required with a subscribe link. |
research_paper_archive | Archive a paper account and its active version. This account cannot be resumed. Paid, owner-only. No live orders or model inference. Access: API key required, else returns subscription_required with a subscribe link. |
research_paper_events | Read paged paper event summaries; full input evidence remains in the private audit export. Paid, owner-only. No live orders or model inference. Access: API key required, else returns subscription_required with a subscribe link. |
research_paper_flatten | Request paper position flattening and discard pending orders; this changes simulated account state. Paid, owner-only. No live orders or model inference. Access: API key required, else returns subscription_required with a subscribe link. |
research_paper_journal | Read five journal notes per offset, with long text explicitly shortened. Paid, owner-only. No live orders or model inference. Access: API key required, else returns subscription_required with a subscribe link. |
research_paper_list | List owned reference paper accounts. Paid, owner-only. No live orders or model inference. Access: API key required, else returns subscription_required with a subscribe link. |
research_paper_pause | Pause new paper entries. Paid, owner-only. No live orders or model inference. Access: API key required, else returns subscription_required with a subscribe link. |
research_paper_read | Read one reference paper account and its versions. Paid, owner-only. No live orders or model inference. Access: API key required, else returns subscription_required with a subscribe link. |
research_paper_resume | Resume paper entries unless risk halted. Paid, owner-only. No live orders or model inference. Access: API key required, else returns subscription_required with a subscribe link. |
research_paper_revise_journal | Append a new revision of an existing journal note, retaining the previous revisions. Paid, owner-only. No live orders or model inference. Access: API key required, else returns subscription_required with a subscribe link. |
research_paper_start | Create a new reference paper account starting flat at USD 100. Replay is historical. Paid, owner-only. No live orders or model inference. Access: API key required, else returns subscription_required with a subscribe link. |
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. Paid, owner-only. No live orders or model inference. Access: API key required, else returns subscription_required… |
research_run_cancel | Cancel a saved research job. Cancellation cannot be undone; completed work may need a new submission. Paid, owner-only. No live orders or model inference. Access: API key required, else returns subscription_required with a subscribe link. |
research_run_list | List owned saved studies. Paid, owner-only. No live orders or model inference. Access: API key required, else returns subscription_required with a subscribe link. |
research_run_read | Read one saved study; full report is available in the Research App. Paid, owner-only. No live orders or model inference. Access: API key required, else returns subscription_required with a subscribe link. |
research_run_reveal_holdout | Irreversibly expose a study holdout and record its exposure. The holdout can no longer be treated as unseen. Paid, owner-only. No live orders or model inference. Access: API key required, else returns subscription_required with a subscribe link. |
research_run_submit | Queue one bounded research calculation; returns a queued run ID. Paid, owner-only. No live orders or model inference. Access: API key required, else returns subscription_required with a subscribe link. |
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… |
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… |
subscribe_for_mcp_access | Returns FXMacroData subscription options and a direct checkout path for unlocking MCP app visuals, charts, and advanced analytical tools. |
In its maker's words
Macroeconomic and FX time-series data for AI agents: indicators, calendars, COT, forex, commodities.
- Website
- fxmacrodata.com
- Source
- github.com/fxmacrodata/fxmacrodata
- Publisher
- fxmacrodata
- Listed from
- the official MCP Registry as
io.github.fxmacrodata/fxmacrodata - Version
- 1.0.1, updated 10 Apr 2026
- Kinds of work
- Search and research, Data and databases, Finance and markets
The domain it lives on
- fxmacrodata.com
- registered 4 Sep 2025 (1 year ago), at NameCheap, Inc., its home page is a working site
From our own crawl of domain names: registry records and the home page as our crawler last saw it.
Every call we made
| When | What happened | Time |
|---|---|---|
| Answered | 1472 ms | |
| Answered | 1830 ms | |
| Answered | 234 ms |
Next door
Is this your bot? Claim its address to add a verified badge and keep the listing current.