FXMacroData
by @fxmacrodata · io.github.fxmacrodata/fxmacrodata
Macroeconomic and FX time-series data for AI agents: indicators, calendars, COT, forex, commodities.
- Category
- Finance and payments
- Connection
- Remote (HTTP)
- Tools
- 39 reported
- Status
- Online
Connect it to your AI
Claude Code
claude mcp add --transport http fxmacrodata https://fxmacrodata.com/mcpClaude, ChatGPT, Cursor and other apps
Add it as a custom connector with this URL (Streamable HTTP):
https://fxmacrodata.com/mcpCursor, VS Code and other apps (mcp.json)
{
"mcpServers": {
"fxmacrodata": {
"url": "https://fxmacrodata.com/mcp"
}
}
}Tools it offers
39 tools, as the server itself reported during our check on Oct 31, 2026.
pingHealth check that confirms the FXMacroData API and MCP server are reachable. Returns the API health response.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 plaisubscribe_for_mcp_accessReturns FXMacroData subscription options and a direct checkout path for unlocking MCP app visuals, charts, and advanced analytical tools.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, andrisk_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 crosmacro_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 hearelease_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-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, suevent_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-forlatest_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 scheduledpress_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 is available without an API key; every otherrate_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: requires an FXrate_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: requires an FXMacroData API key; an anonymous call returns subscriptioforexGet 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, BollingerseasonalityGet 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 rindicator_queryGet 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, bonplot_visual_artifactBuild 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 aremacro_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. Returns analysis in the tool responsindicator_intel_taskBuild an intelligence pack for one indicator by combining chart-ready series data, derived analytics, and nearest release timing context. Returns analysis in the tool response. Access: USD is available without an API keypair_intel_taskBuild an intelligence pack for an FX pair by combining policy-rate spread context, spot-rate context, and release-timing metadata. Returns analysis in the tool response. Access: requires an FXMacroData API key; an anonymmacro_heatmap_taskBuild a cross-currency macro heatmap from indicator time series and return a matrix with latest values, recent changes, and z-scores. Returns analysis in the tool response.policy_scenario_modeler_taskRun a policy-rate spread what-if scenario for an FX pair and estimate directional spot impact using an explicit heuristic elasticity assumption. Returns analysis in the tool response. Access: requires an FXMacroData APImacro_war_room_taskBuild a multi-panel macro market cockpit that combines FX sessions, upcoming release queue, pair context, and generated risk alerts. Returns analysis in the tool response. Access: USD is available without an API key; eveevent_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. Returns analyquant_scenario_lab_taskRun an expanded quant-style policy scenario for an FX pair with deterministic projection, stress percentiles, and horizon assumptions. Returns analysis in the tool response. Access: requires an FXMacroData API key; an anmacro_regime_classifier_taskClassify a currency's macro regime using policy rate, inflation, GDP, and unemployment context, with explicit assumptions and confidence notes. Returns analysis in the tool response. Access: USD is available without an Arelease_risk_score_taskScore upcoming releases for a currency pair using release-calendar proximity and indicator-level heuristics. Returns analysis in the tool response. Access: requires an FXMacroData API key; an anonymous call returns subscportfolio_risk_engine_taskAnalyze a multi-position FX book for concentration, stress exposure, and event-driven catalyst risk. Returns analysis in the tool response. Access: requires an FXMacroData API key; an anonymous call returns subscription_fx_trade_setup_taskBuild a trader-oriented FX pair setup using spot context, macro differentials, upcoming catalyst risk, and optional COT positioning. Returns analysis in the tool response. Access: requires an FXMacroData API key; an anonfx_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 costsresearch_runSubmit, list, read, cancel or explicitly reveal a sealed holdout of a private persisted research job. Requires an active paid subscription. Submit queues a bounded worker calculation; read retrieves its saved report. Noresearch_paperList, read or start an owned reference paper account; inspect paged event summaries, control entries or append a version-linked journal note. Journal reads return five notes per offset, with long text explicitly shortenemacro_research_pack_taskBundles catalogue, indicator history, next release timing, and optional FX pair context into one persistent-host-friendly research payload. Returns analysis in the tool response. Access: USD is available without an API kmarket_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 sessionscot_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 extrcommoditiesGet historical price series for supported commodity indicators using the exact slugs advertised by this schema. Requires an API key. Supported indicators: crude_oil_inventories, distillate_inventories, gasoline_inventoriorganisation_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 databorganisation_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 eviofficial_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
Questions
What is the FXMacroData MCP server?
Macroeconomic and FX time-series data for AI agents: indicators, calendars, COT, forex, commodities. It is made by @fxmacrodata and listed in the official MCP Registry as io.github.fxmacrodata/fxmacrodata. MCP (Model Context Protocol) is the open standard that lets AI apps like Claude, ChatGPT and Cursor use outside tools.
How do I add FXMacroData to Claude?
In the Claude app or claude.ai, open Settings, then Connectors, choose "Add custom connector" and paste https://fxmacrodata.com/mcp. In Claude Code, run: claude mcp add --transport http fxmacrodata https://fxmacrodata.com/mcp
How do I add FXMacroData to ChatGPT?
ChatGPT can use remote MCP servers as connectors. In ChatGPT settings, under Apps and Connectors, turn on developer mode if asked, create a new connector and paste https://fxmacrodata.com/mcp.
How do I add FXMacroData to Cursor?
Open Cursor settings, go to MCP, choose "Add new MCP server" (or edit ~/.cursor/mcp.json) and add: { "mcpServers": { "fxmacrodata": { "url": "https://fxmacrodata.com/mcp" } } }
Does FXMacroData work right now?
Yes. It responded when we last checked on 31 Oct 2026. We check remote MCP servers every day.
What can FXMacroData do?
It gives your AI 39 tools, including ping, mcp_capabilities, subscribe_for_mcp_access, data_catalogue, risk_sentiment. The full list is on this page.
Is this your server? Get the badge for your README
Markdown (GitHub README)
[](https://chen.media/mcp/github-fxmacrodata-fxmacrodata)HTML (switches to dark mode on its own)
<a href="https://chen.media/mcp/github-fxmacrodata-fxmacrodata"><picture><source media="(prefers-color-scheme: dark)" srcset="https://chen.media/mcp/badge/github-fxmacrodata-fxmacrodata.svg?theme=dark"><img src="https://chen.media/mcp/badge/github-fxmacrodata-fxmacrodata.svg" alt="Listed on chen.media/mcp" height="40"></picture></a>More in Finance and payments
See allStripeVerified maker
stripe.comMCP server integrating with Stripe - tools for customers, products, payments, and more.
Las Vegas Guide — Resort Fees, Strip Walk Times & 160+ Venues
lasvegasguide.comOut-the-door Las Vegas hotel resort fees, 13.38% tax receipts, Strip walk routing, and show dates.
0523 Public — Taiwan Logistics & Customs
0523.twTaiwan parcel forwarding tools: freight and import-tax quotes, CCC tariff lookup, import rules.
Konverter Pro
konverter-pro.deGerman bank statements, PayPal, SumUp and Stripe reports to verified DATEV, Lexware or MT940
Unitrader
unitrader.aiLearn how Unitrader's AI trader works, see what it did today, and pick up trading basics.
Annalist Financial Statements
@rawsd10Financial statements, ratios, findings, screens and peer comparisons from official filings. Keyless.