Skip to main content

FXMacroData

io.github.fxmacrodata/fxmacrodataVersion 1.0.1

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

Status

Responds303 msAnswered our handshake without sign-in.

Registry data may be out of date

We could not refresh it, so this page shows the last copy.
Last checked
Nov 14, 2026, 14:51 UTC
Latency
303 ms
Remotes responding
1 of 1
Sign-in
No sign-in
Hosting
Hosted outside the EU (detected)
Registry data as of
Nov 14, 2026, 21:12 UTC

Data from the official MCP Registry, checked by run.zero. How we check

Connect

Streamable HTTP
https://fxmacrodata.com/mcpResponds303 ms
No sign-in

Claude Code

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

Claude Desktop and claude.ai

Settings > Connectors > Add custom connector
Name: fxmacrodata
Remote MCP server URL: https://fxmacrodata.com/mcp

Cursor

{
  "mcpServers": {
    "fxmacrodata": {
      "url": "https://fxmacrodata.com/mcp"
    }
  }
}

VS Code

code --add-mcp '{"name":"fxmacrodata","type":"http","url":"https://fxmacrodata.com/mcp"}'

Built your own server? run.zero hosts MCP servers on European infrastructure.

Host your own MCP server on run.zero

Tools

52 tools

Tools of FXMacroData
Read-only
Idempotent
Open world
catalogue_relatedFollow 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.NoYesNot declaredYes
catalogue_searchFind 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: public catalogue metadata, no API key required.NoYesNot declaredYes
commoditiesGet historical price series for supported commodity indicators using the exact slugs advertised by this schema. Supported indicators: crude_oil_inventories, crude_oil_stocks, distillate_inventories, distillate_stocks, gasoline_inventories, gasoline_stocks, gold, natural_gas, natural_gas_storage, natural_gas_storage_level, oil_brent, oil_wti, platinum, silver. Access: API key required, else returns subscription_required with a subscribe link.NoYesNot declaredYes
cot_dataGet 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 available without an API key for the most recent 90 days on a 15-minute release delay; every other currency and the full history need an API key. Supported currencies: AUD, CAD, CHF, EUR, GBP, JPY, MXN, NZD, USD, XAU. Access: USD needs no API key; other currencies return subscription_required with a subscribe link.NoYesNot declaredYes
data_catalogueList 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 which publishers forecast which indicators and how far each archive runs (no forecast values); `fx_sources` lists official FX reference-rate publishers; `fx_universe` lists the pairs each one covers; `sources` returns a persisted source definition by its metadata `sha256`. Access: all currencies keyless.NoYesNot declaredYes
event_impact_replay_taskReplay 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.NoYesNot declaredYes
event_predictionsReturn 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 currency, e.g. usd or eur. The `indicator` parameter lists the accepted indicator slugs. Access: API key required, else returns subscription_required with a subscribe link.NoYesNot declaredYes
forexGet 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. Access: API key required, else returns subscription_required with a subscribe link.NoYesNot declaredYes
fx_backtest_taskRun 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.NoYesNot declaredYes
fx_trade_setup_taskBuild 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.NoYesNot declaredYes
geopolitical_eventFull 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.NoYesNot declaredYes
geopolitical_event_reactionPrecomputed 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.NoYesNot declaredYes
geopolitical_event_revisionsEvery 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.NoYesNot declaredYes
geopolitical_historySearch 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.NoYesNot declaredYes
geopolitical_sourcesLists 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.NoYesNot declaredYes
indicator_queryReturns 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 `pagination.has_more`, `partial_page.next_call` contains next-page arguments; `partial_page.pages_remaining` counts remaining pages. Official-only by default; prohibited private aggregator rows are always removed. Access: USD needs no API key; other currencies return subscription_required with a subscribe link.NoYesNot declaredYes
latest_announcementsReturn 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 currencies return subscription_required with a subscribe link.NoYesNot declaredYes
macro_briefing_taskBuild 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.NoYesNot declaredYes
macro_heatmap_taskBuild 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.NoYesNot declaredYes
macro_newsReturn 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. usd or eur. Access: USD needs no API key; other currencies return subscription_required with a subscribe link.NoYesNot declaredYes
market_sessionsReturns 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 API key required.NoYesNot declaredYes
mcp_capabilitiesExplains 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.NoYesNot declaredYes
official_datasetsOne 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, central-bank liquidity, FX intervention, auctions, external debt, credit conditions, wage settlements; by dataset and currency) and company_results (company trading updates as macro evidence; by country). Omit the selector to list what a family holds. Access: API key required, else returns subscription_required with a subscribe link.NoYesNot declaredYes
organisation_profileRead 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.NoYesNot declaredYes
organisation_searchFind 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.NoYesNot declaredYes
pingHealth check that confirms the FXMacroData API and MCP server are reachable. Returns the API health response.NoYesNot declaredYes
plot_visual_artifactBuild 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.NoYesNot declaredYes
press_releasesReturn 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.NoYesNot declaredYes
rate_curveReturn 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.NoYesNot declaredYes
rate_differentialsReturn 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.NoYesNot declaredYes
release_calendarGet 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` string with the indicator name and a `currency` code. Unbounded calls return future releases only. The optional `indicator` filter narrows to a single series, and optional `start_date` and `end_date` bounds select a month, week, day, or explicit date range. Supported currencies: lowercase 3-letter catalogue currency, e.g. usd or eur. The `indicator` parameter lists the accepted indicator slugs. Access: USD needs no API key; other currencies return subscription_required with a subscribe link.NoYesNot declaredYes
release_calendar_visual_artifactReturns 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` adds local times for a specific city or region. Supported currencies: lowercase 3-letter catalogue currency, e.g. usd or eur. The `indicator` parameter lists the accepted indicator slugs. Access: USD needs no API key; other currencies return subscription_required with a subscribe link.NoYesNot declaredYes
research_paper_append_journalAppend 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.NoNoNot declaredNo
research_paper_archiveArchive 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.YesNoNot declaredNo
research_paper_eventsRead 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.NoYesNot declaredNo
research_paper_flattenRequest paper position flattening and discard pending orders; new entries stay paused until the account is resumed. 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.YesNoNot declaredNo
research_paper_journalRead 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.NoYesNot declaredNo
research_paper_listList 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.NoYesNot declaredNo
research_paper_pausePause 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.NoNoNot declaredNo
research_paper_readRead 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.NoYesNot declaredNo
research_paper_resumeResume 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.NoNoNot declaredNo
research_paper_revise_journalAppend 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.NoNoNot declaredNo
research_paper_startCreate 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.NoNoNot declaredNo
research_paper_start_versionArchive 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.YesNoNot declaredNo
research_run_cancelCancel 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.YesNoNot declaredNo
research_run_listList 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.NoYesNot declaredNo
research_run_readRead 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.NoYesNot declaredNo
research_run_reveal_holdoutIrreversibly 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.YesNoNot declaredNo
research_run_submitQueue 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.NoNoNot declaredNo
risk_sentimentReturn 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.NoYesNot declaredYes
seasonalityGet 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.NoYesNot declaredYes
subscribe_for_mcp_accessReturns FXMacroData subscription options and a direct checkout path for unlocking MCP app visuals, charts, and advanced analytical tools.NoYesNot declaredYes

Details

Registry status
Active
Published
Apr 10, 2026
Updated
Apr 10, 2026
Categories (suggested)
Data and analyticsSuggested categories are assigned automatically from the registry text and may be wrong. Verified operators can correct them.
GDPR
Not declared

Are you the operator? Claim this listing