FXMacroData

Live MCP · Streamable HTTP OAuth 2.0 + PKCE

Give your AI assistant a live macro data terminal: official-source indicators, release calendars, FX spot context, COT, commodities, chart apps, and task-ready research workflows inside the tools you already use.

Start with a live announcement endpoint. Authentication stays in theapi_keyquery parameter for direct browser and script testing.

EUR inflation example GET /api/v1/announcements/eur/inflation

curl "https://api.fxmacrodata.com/v1/announcements/eur/inflation?api_key=YOUR_API_KEY"

Start with the public MCP surface for USD lookup and discovery up to 100 no-key requests/day. Add paid access when your assistant needs higher-volume USD use, non-USD indicators, full USD history, COT, commodities, task workflows, or protected data calls through OAuth or/mcp?api_key=YOUR_API_KEY.

USD recent data up to 100 no-key requests/day, plus FX rates, catalogue, calendar, sessions, and client testing.

Full trader access with a 14-day trial for protected MCP tools, API rows, dashboards, and AI research workflows.

Private licensing, custom privacy posture, audit expectations, and platform usage patterns for larger desks.

FXMacroData MCP turns a general-purpose AI assistant into a macro-aware research agent. Instead of asking a model to guess from stale training data, the assistant can call live tools for policy rates, inflation, GDP, labor data, release calendars, FX rates, COT positioning, commodities, and official dataset families. The result is a conversation that can cite actual data rows, use release timestamps, and keep the analysis grounded in the same production API that powers the FXMacroData dashboard.

Ask for a EUR/USD macro setup, compare policy-rate differentials, review the next event risks, or build a pre-central-bank briefing without leaving Claude, ChatGPT, Cursor, VS Code, or your preferred agent host.

Use point-in-time release timestamps, backtest tasks, event-gated filters, portfolio risk scoring, and reusable research packs to keep exploratory notebooks and agent-generated analysis aligned with live macro data.

Give Cursor, Continue, Cline, Windsurf, Replit Agent, Zed, Kiro, and JetBrains a single remote MCP endpoint that can discover indicators, validate examples, and generate macro-aware app or notebook code.

Compatible MCP Apps hosts can render interactive chart resources for indicator series, FX rates, policy-rate comparisons, release calendars, heatmaps, scenario models, event replays, and quant labs.

Calldata_catalogue,indicator_query,forex, andrelease_calendarwhen you need rows, timestamps, JSON, tables, or exact values.

Best prompt: "Get USD inflation from 2024-01-01 to 2025-01-01."

Call visual artifact tools when the answer should include an interactive chart, release-calendar view, heatmap, scenario model, or event replay inside the chat.

Best prompt: "Show me a chart of AUD policy rates since 2020."

Call task tools when the assistant should assemble several data sources into a decision-ready output, such as a trade setup, risk score, backtest, or research pack.

Best prompt: "Build a EUR/USD trade setup with catalysts and invalidation notes."

Prompt-aware hosts can discover curated workflows for macro briefings, pair risk checks, post-release summaries, week-ahead plans, and chart routing.

Best prompt: "Run the FX pair risk check prompt for EUR/USD."

FXMacroData MCP responses include a compactmcp_metadatablock on the response and, for source-backed datasets,result.data_quality. Check these fields before using a result in a trade note, backtest, alert, notebook, or automated research workflow.

Inspectlatest_available_date,last_updated,data_lag_days, andis_stalebefore treating data as current.

Usesource_type,source_name,is_proxy,is_derived, andis_fallbackto label source quality.

Start withdata_catalogueusinginclude_coverage=true; reviewcoverage_summaryand row-levelcoverage_quality.

For point-in-time workflows, checkpoint_in_time_safe,has_announcement_datetime,row_count_before_pagination, andreturned_count.

{ "mcp_metadata": { "source_type": "official", "latest_available_date": "2026-06-19", "data_lag_days": 3, "is_proxy": false, "is_derived": false, "is_fallback": false, "point_in_time_safe": true, "row_count_before_pagination": 250, "returned_count": 100 }, "result": { "data_quality": { "is_official": true, "is_proxy": false, "is_fallback": false, "is_stale": false, "has_announcement_datetime": true, "point_in_time_safe": true, "latest_available_date": "2026-06-19", "source_type": "official", "source_name": "BLS", "row_count": 100, "quality_scope": "full_result" } } }

If a required freshness, source, or coverage field is missing, continue only as exploratory context and state that provenance or freshness is unknown. Do not silently treat a valid tool response as analysis-ready.

MCP indicator tools use the same REST pagination contract as/api/v1/announcements/{currency}/{indicator}. For long histories, request a broad date window once and walk pages withpagination.next_offset; do not retry arbitrary shorter windows unless the user asked for a specific sub-period.

data_catalogue(currency="nzd", include_coverage=true, include_capabilities=true)

Use catalogue coverage dates, capabilities, exact slugs, andmcp_metadata.coverage_summarybefore querying a sparse indicator.

indicator_query(currency="nzd", indicator="gov_bond_10y", limit=100, offset=0)

Usepageoroffset;pagetakes precedence.

Checkpagination.page_includes_latest_available. Empty valid windows returnNO_DATA_IN_REQUESTED_WINDOWwith coverage dates.

Start with the bare MCP URL only when your host can launch the FXMacroData OAuth flow. For manual client screens that ask for a URL and bearer-token environment variable, keep the bare URL and point the bearer-token field at your FXMacroData API-key environment variable.

What's the EUR vs USD interest rate differential, and what does it mean for EUR/USD?

indicator_query(currency="eur", indicator="policy_rate")

indicator_query(currency="usd", indicator="policy_rate")

Based on the latest central bank data from FXMacroData, the Fed rate of 5.50% exceeds the ECB rate of 4.25% by 125 basis points. This USD rate premium is a structurally bearish factor for EUR/USD — higher US yields attract capital flows that support dollar strength relative to the euro.

FXMacroData MCP Apps span release calendars, indicator visuals, pair-comparison analysis, cross-currency heatmaps, scenario tooling, war-room workflows, event replay, quant distributions, and subscription unlock flows. Each image below is captured from a real local MCP app render; the final in-chat experience depends on whether the host mounts MCP Apps resources inline.

Indicator chart app with premium analysis cards and signal pills.

Indicator control stack in action: Area + MA(5) + Trend overlays.

Comparison app surface for line, spread, ratio, normalized, and z-score modes.

Macro heatmap app with mode toggles and matrix scale legend.

Policy scenario modeler for spread shocks and projected spot outputs.

Macro war room cockpit for pair context, release queue, and risk alerts.

Event impact replay timeline for point-in-time market context reviews.

Quant scenario lab for stress distribution inputs and percentile outputs.

Plot the USD policy rate since 2020 as a chart

indicator_visual_artifact(currency="usd", indicator="policy_rate", start_date="2020-01-01")

USD / POLICY_RATE 15 points · latest 2024-12 = 4.50%

6%<!-- --> <!-- -->4%<!-- --> <!-- -->2%<!-- --> <!-- -->0%<!-- --> <!-- -->2020<!-- --> <!-- -->2022<!-- --> <!-- -->2023<!-- --> <!-- -->2024<!-- --> <!-- -->5.50%<!-- --> <!-- -->4.50%

FX Macrodata · indicator_visual_artifact · interactive in Claude

Here is the USD policy rate (Fed funds rate) from 2020 to 2024. The rate was held near zero through 2021, then the Fed launched its fastest hiking cycle in decades — rising from 0.25% to a peak of 5.50% by mid-2023. The first cuts began in late 2024, bringing the rate back to 4.50%.

MCP Apps are best when the answer should stay interactive inside the conversation. FXMacroData now exposes release-calendar, charting, pair intelligence, macro heatmap, policy scenario, macro war room, event replay, and quant lab app flows. For persistent hosts like Claude Code and Gemini-driven coding agents, the server also exposes task-capable non-visual research workflows that can be polled and reused across a long thread.

"Show me the USD GDP release calendar in Sao Paulo time"

release_calendar(currency="usd", indicator="gdp", timezone="America/Sao_Paulo") -> ui://fxmacrodata/release-calendar.html

"Show me a chart of AUD policy rate history"

indicator_visual_artifact(currency="aud", indicator="policy_rate")

"Compare EUR and USD policy rates with carry context"

pair_intel_task(base="eur", quote="usd")

"Show me the strongest and weakest macro prints across G10"

macro_heatmap_task(currencies="usd,eur,gbp,jpy", indicators="policy_rate,inflation,gdp")

"What happens if the Fed hikes 50 bps more?"

policy_scenario_modeler_task(base="usd", quote="jpy", shock_leg="base", shock_bps=50)

"Build me a live EUR/USD macro war room for USD GDP"

macro_war_room_task(base="eur", quote="usd", currency="usd", indicator="gdp")

"Replay USD GDP surprises against EUR/USD"

event_impact_replay_task(currency="usd", indicator="gdp", base="eur", quote="usd", lookback_events=12)

"Run a 30-day stress distribution for EUR/USD after a base-leg shock"

quant_scenario_lab_task(base="eur", quote="usd", shock_leg="base", shock_bps=50, annualized_volatility_pct=8, horizon_days=30)

- ▸ Streamable HTTP endpoint athttps://mcp.fxmacrodata.com
- ▸ Plain JSON responses for proxy/CDN compatibility
- ▸ Stateless HTTP requests, so every call carries its own auth context

Visual tools return structured data plusui://resource metadata so compatible hosts can render chart and workflow apps inline.

ui://fxmacrodata/event-impact-replay.html

ui://fxmacrodata/quant-scenario-lab.html

Advanced workflow tools can be called like normal tools. Hosts that support experimental MCP Tasks can also create a task, poll status withtasks/get, and retrieve the final payload when complete.

macro_briefing_task known_at_time_task fx_backtest_task macro_research_pack_task portfolio_risk_engine_task

Prompt-aware clients can discover reusable FX workflows throughprompts/listand invoke them withprompts/get. The publicprompt librarymirrors these routines with copyable prompts, guardrails, and machine-readable feeds.