FXMacroData
io.github.fxmacrodata/fxmacrodataMacroeconomic and FX time-series data for AI agents: indicators, calendars, COT, forex, commodities.
Tools · 48
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.
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, Curso…
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, Clau…
Open subscription options when a user needs to unlock MCP app visuals, charts, and advanced analytical tools. Returns a direct checkout path.
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 …
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 meta…
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, e…
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. Retu…
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 …
Return stored forecasts, consensus-style predictions, central-bank projections, survey forecasts, IMF forecasts, nowcasts, or FXMacroData blended predictions for macro announcements. Use this with rel…
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.
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 ins…
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 …
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 underlyi…
List public official FX reference-rate sources and their source policy before requesting a pair-specific intraday reference-rate series.
List the public FX reference-rate pair universe, optionally filtered by currency or source id. Call this before requesting an intraday reference-rate series.
Return subscriber intraday official FX reference-rate observations for one pair. Call fx_reference_universe first to verify pair and source availability.
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.
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.
Return the latest stored value for every available commodity indicator in one response. This subscriber tool is the batch counterpart to commodities.
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 technic…
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 mo…
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, unemp…
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 announcemen…
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…
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…
Same payload as commodities, but packaged with MCP Apps chart metadata so compatible clients render an interactive commodity chart inline.
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.
Build a two-series chart comparing base and quote policy-rate history to visualize the rate differential setup for an FX pair.
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 Tas…
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-…
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-augment…
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-augm…
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 sen…
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-augme…
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.
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-aug…
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 …
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…
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.
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.
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-augme…
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.
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…
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 Londo…
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, …
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, nat…
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: …
Resources · 9
Upgrade card with a direct CTA to start subscription checkout.
ui://fxmacrodata/subscribe-cta.html
Interactive chart UI for indicator_visual_artifact results.
ui://fxmacrodata/indicator-chart.html
Interactive multi-series chart UI for pair-comparison visual tools.
ui://fxmacrodata/comparison-chart.html
Interactive heatmap UI for cross-currency indicator exploration.
ui://fxmacrodata/macro-heatmap.html
Interactive policy-spread scenario modeler for FX pairs.
ui://fxmacrodata/scenario-modeler.html
Interactive calendar and agenda view for upcoming macroeconomic releases.
ui://fxmacrodata/release-calendar.html
Interactive market cockpit with sessions, releases, pair context, and alerts.
ui://fxmacrodata/macro-war-room.html
Interactive replay timeline that maps announcement events to market context.
ui://fxmacrodata/event-impact-replay.html
Interactive quant-style scenario distributions and stress bands for FX pairs.
ui://fxmacrodata/quant-scenario-lab.html
Prompts · 15
Daily macro briefing for a currency: latest policy rate, inflation, unemployment, GDP, and the next scheduled release. Uses data_catalogue, indicator_query, and release_calendar.
Decision-day brief for a central bank: current stance, inflation/labor backdrop, and the next scheduled meeting.
Multi-factor analysis of a currency pair: spot + technicals, rate differential, COT positioning.
Persistent-host-friendly workflow for preparing a central-bank decision preview using regime classification, next meeting timing, and scenario framing.
Summarize a release after the print using event replay, point-in-time integrity, and pair context.
Pair-focused risk workflow using release scoring, pair intelligence, and macro regime context.
Persistent planning workflow for the week ahead using release risk ranking and research-pack context.
Audit freshness, provenance, row counts, and missing-data flags before summarizing a series.
Rank upcoming macro releases for an FX pair and map event timing to market sessions.
Check which macro rows were market-visible at an as-of timestamp before backtest-style reasoning.
Create a hypothetical research brief for an event-gated FX backtest with costs and caveats.
Scan a JSON list of FX positions for macro event concentration and stress assumptions.
Use CFTC positioning as a positioning-extreme overlay for supported currencies.
Connect commodity series to commodity-sensitive FX pairs using FXMacroData only.
Route chart/plot requests to MCP Apps visual artifact tools and return short interpretation plus chart output.
Similar MCP servers embedding-nearest
How to use
Add to your Claude Desktop / Cursor / Cline MCP config:
{
"mcpServers": {
"fxmacrodata": {
"url": "https://fxmacrodata.com/mcp",
"transport": "streamable-http"
}
}
}