FXMacroData
by fxmacrodata.com in Markets & finance
Macroeconomic and FX time-series data for AI agents: indicators, calendars, COT, forex, commodities.
https://fxmacrodata.com/mcp
Last 30 days
- Uptime
- 100%
- Response time
- 294 ms typical, 294 ms slowest 5%
- Last check
- 1 h ago
- Next check
- in 5 h
How to call it
Add it to any MCP client that supports remote servers.
{
"mcpServers": {
"fxmacrodata": {
"type": "http",
"url": "https://fxmacrodata.com/mcp"
}
}
}54 tools
- ping
Health check that confirms the FXMacroData API and MCP server are reachable. Returns the API health response.
- 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,
- mcp_auth_guide
Explains which authentication mode suits FXMacroData MCP across major clients and platforms: OAuth, an API key, or a bearer token, for ChatGPT/OpenAI Apps, Claude/Anthropic, Microsoft/VS Code/Copilot-style clients, AstrBot, Cursor, Codex, local scripts, and CI.
- subscribe_for_mcp_access
Returns FXMacroData subscription options and a direct checkout path for unlocking MCP app visuals, charts, and advanced analytical tools.
- 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, parti
- 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,
- risk_sentiment_changes
Poll retained risk-sentiment additions, score revisions, and input-metadata changes. Pass pagination.next_after_sequence as after_sequence on the next page or poll. Recording timestamps describe when FXMacroData stored each change; earlier untracked revisions and publisher public
- 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
- 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 Ap
- calendar_snapshot
Return persisted economic-event schedules, importance and cancellation states at an explicit historical cutoff. Accepted mode requires actual capture and parser acceptance by the cutoff. Reconstruction additionally admits qualified official notices recovered later; it does not es
- calendar_event_versions
Return immutable schedule and importance versions for a stable archive event ID, including explicit publisher cancellations and source capture evidence. Capture, acceptance and documentary publisher clocks remain distinct. Checkpoint and cursor pin subsequent history pages. Acces
- calendar_archive_coverage
Inspect persisted official-calendar captures, parser outcomes, configured sources and coverage limitations for a currency. Successful capture does not prove complete historical calendar or speech coverage. Access: requires an FXMacroData API key; an anonymous call returns subscri
- 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 `indicato
- 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 announce
- latest_announcements
Return the latest stored macroeconomic value for every available indicator in one currency, as a compact current macro snapshot. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.
- announcement_changes
Poll recently ingested macro announcement changes with a resumable cursor. This is the bounded, MCP-safe counterpart to the release-event stream: the returned next_cursor is accepted as `since` on a later call, so polling resumes without holding a streaming invocation open. Acces
- 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 is available without an API key; every other currency returns subscription_required with a subscribe link
- macro_factor
Return a precomputed macro factor for one currency, with optional stored component scores and source references. The factor is a documented summary value and does not replace the underlying macro releases. Access: USD is available without an API key; every other currency returns
- fx_reference_sources
List public official FX reference-rate sources and the source policy that governs pair-specific intraday reference-rate series. Access: free for every currency, no API key required.
- fx_reference_universe
List the public FX reference-rate pair universe, optionally filtered by currency or source id, showing which pairs and sources have intraday reference-rate series. Access: free for every currency, no API key required.
- fx_intraday_reference_rates
Return subscriber intraday official FX reference-rate observations for one pair. Coverage is limited to the pairs and sources in the FX reference pair universe. Access: requires an FXMacroData API key; an anonymous call returns 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: requires an FXMacroData API key; an anonymous call returns subscription_re
- 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: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.
- latest_commodities
Return the latest stored value for every available commodity indicator in one response, as a batch snapshot of the subscriber commodity series. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.
- forex
Get raw historical FX spot-rate rows for a currency pair (e.g. EUR/USD, USD/JPY) as a plain-text table, raw rows, exact values, or JSON-like data, with optional technical-indicator series (SMA, EMA, RSI, MACD, Bollinger Bands, etc.) computed from spot. Returns data only, without
- 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 f
- indicator_query
Get a paginated historical time series of a single macroeconomic indicator for a currency, sourced directly from the official central bank or statistical agency. Covers CPI/inflation, GDP, unemployment, policy rates, bond yields, payrolls, retail sales, PCE, PPI, trade balance, c
- plot_visual_artifact
Build a generic MCP Apps chart from one or more FXMacroData endpoint families: arbitrary plots, multi-series charts, and actual-vs-consensus views that combine announcements with predictions. Supported series sources are announcements, predictions, forex, commodities, and cot. Fo
- indicator_visual_artifact
Returns an indicator time series with MCP Apps metadata so compatible clients (Claude Desktop, ChatGPT, Codex, etc.) render an interactive line chart instead of a JSON dump. Suited to indicator time-series requests to show, tell, explain, compare, inspect a trend, or review a rec
- forex_visual_artifact
Returns FX spot-rate history for a currency pair with MCP Apps chart metadata so compatible clients render an interactive spot-rate chart inline. Suited to FX pair time-series and trend requests such as 'show me AUD/USD', 'the last 30 days', or 'how has EUR/USD moved recently'. A
- commodities_visual_artifact
Returns commodity price history with MCP Apps chart metadata so compatible clients render an interactive commodity chart inline. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.
- cot_visual_artifact
Returns weekly CFTC COT positioning data with MCP Apps chart metadata. By default it charts noncommercial net positioning; the `metric` parameter selects another COT field. Access: USD is available without an API key; every other currency returns subscription_required with a subs
- policy_rate_differential_visual_artifact
Build a two-series chart comparing base and quote policy-rate history to visualize the rate differential setup for an FX pair. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.
- 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. Supports MCP Tasks for async execution when clients send a task-augmented request. Access: USD i
- indicator_intel_task
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. Access: USD is available without an API key; every other cur
- pair_intel_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-augmented requests. Access: requires an FXMacroData API key; an anonymous call returns
- 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. Supports MCP Tasks for async execution when clients send task-augmented requests.
- policy_scenario_modeler_task
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. Access: requires an FXMacroData API key; an anonymous
- macro_war_room_task
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. Access: USD is available without an API key; every other currency
- 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. Supports MCP Tasks for async execution when clients send task-augmented r
Security scan
- No findings. We scan names, descriptions and tool definitions for hidden instructions and other prompt-injection patterns.
Recent checks
| When | Result | HTTP | Time |
|---|---|---|---|
| 1 h ago | Passed | 200 | 294 ms |
| 11 h ago | Passed | 200 | 422 ms |