MCP server

FXMacroData Official

io.github.fxmacrodata/fxmacrodata

Checked 25 Oct 2026, 20:29 UTC · Connected to it and listed its tools

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

Website Source

At a glance

Type

MCP server

Publisher

fxmacrodata.com (verified by the MCP Registry)

Status

Working at last check

Tools

56

Token cost

About 31,928 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

25 Oct 2026, 20:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.fxmacrodata]
url = "https://fxmacrodata.com/mcp"

Gemini CLI

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

Cursor

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

VS Code

{"servers":{"fxmacrodata":{"type":"http","url":"https://fxmacrodata.com/mcp"}}}

Antigravity

agy mcp add fxmacrodata https://fxmacrodata.com/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"fxmacrodata","server_url":"https://fxmacrodata.com/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"fxmacrodata","server_url":"https://fxmacrodata.com/mcp"}

Tools

• announcement_changes ~417 tokens
  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. Access: USD is available
• calendar_archive_coverage ~176 tokens
  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 subscription_required with
• calendar_event_versions ~374 tokens
  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. Access: requires an FXMac
• calendar_snapshot ~666 tokens
  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 establish historical s
• commodities ~443 tokens
  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, distillate_inventories, gasoline_inventories, gold, natural_gas, natural_gas_storage, oil_brent, oil_wti, platinum, silver
• commodities_visual_artifact ~314 tokens
  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_data ~554 tokens
  Get 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.
• cot_visual_artifact ~482 tokens
  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 subscribe link.
• data_catalogue ~527 tokens
  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, partial, or unavailable a
• event_impact_replay_task ~1243 tokens
  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. Returns analysis in the tool response. Access: USD is available without an API key; every oth
• event_predictions ~1980 tokens
  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 announcement_id/date/indicat
• financial_prices ~318 tokens
  Read persisted official financial price observations: government yield curves, individual securities, overnight benchmarks and reference prices. Preserves issuer, instrument, maturity, curve type and source precision. Requires an API key; an empty result means no stored observations for the selectio
• forex ~695 tokens
  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 chart metadata. Dail
• forex_visual_artifact ~514 tokens
  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'. Access: requires an F
• fx_backtest_task ~746 tokens
  Run 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. Returns a
• fx_intraday_reference_rates ~273 tokens
  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.
• fx_reference_sources ~91 tokens
  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 ~187 tokens
  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_trade_setup_task Moves money · ~355 tokens
  Build 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 anonymous call returns subscription_required with a subscribe link.
• indicator_intel_task ~986 tokens
  Build 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 key; every other currency returns subscription_required with a subscribe link.
• indicator_query ~2012 tokens
  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, current account, mone
• indicator_visual_artifact ~1274 tokens
  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 recent window. Broad hi
• known_at_time_task ~1166 tokens
  Return the slice of a macro series that would have been known at a specific timestamp, selecting verified value vintages before pagination. Returns analysis in the tool response. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.
• latest_announcements ~219 tokens
  Return 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 i
• latest_commodities ~111 tokens
  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.
• macro_briefing_task ~214 tokens
  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. Returns analysis in the tool response. Access: USD is available without an API key; every other currency returns sub
• macro_factor ~408 tokens
  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 subscription_require
• macro_heatmap_task ~1002 tokens
  Build 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.
• macro_news ~388 tokens
  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 and sentiment fields
• macro_regime_classifier_task ~306 tokens
  Classify 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 API key; every other currency returns subscription_required with a subscribe link
• macro_research_pack_task ~1070 tokens
  Bundles 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 key; every other currency returns subscription_required with a subscribe link.
• macro_war_room_task ~1198 tokens
  Build 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; every other currency returns subscription_required with a subscribe link.
• market_sessions ~225 tokens
  Returns 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
• mcp_auth_guide ~111 tokens
  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.
• mcp_capabilities ~141 tokens
  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, why visuals are not
• native_history ~330 tokens
  Read one source and year of gold ownership/custody, Treasury auctions, cash/debt, TIC positions or EIA energy fundamentals. Keep native dimensions and unknown historical publication times. Omit source to list definitions; an API key is required.
• official_dataset_family ~521 tokens
  Get metadata-first official dataset payloads grouped by API endpoint type. `endpoint_type` selects the API taxonomy group and `dataset` selects the specific series family. Supported endpoint types: monetary_policy, fiscal_policy, international_trade, statistics_releases. Supported datasets: auction_
• pair_intel_task ~361 tokens
  Build 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 anonymous call returns subscription_required with a subscribe link.
• ping ~62 tokens
  Health check that confirms the FXMacroData API and MCP server are reachable. Returns the API health response.
• plot_visual_artifact ~2282 tokens
  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. For example, USD polic
• policy_rate_differential_visual_artifact ~363 tokens
  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.
• policy_scenario_modeler_task ~602 tokens
  Run 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 API key; an anonymous call returns subscription_required with a subscribe link.
• portfolio_risk_engine_task ~331 tokens
  Analyze 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_required with a subscribe link.
• positioning ~208 tokens
  Read persisted CFTC contract positioning. Omit instrument to list supported instrument/report combinations. Main and micro contracts, futures-only and combined reports remain separate. Position dates are not publication timestamps. Requires an API key.
• prediction_coverage ~369 tokens
  List which publishers produce pre-release forecasts for a currency's indicators, what class of forecast each one is (compiled consensus, forecaster survey, market implied, model nowcast, central-bank projection), whether any of them is a genuine consensus, and how far the verified archive runs. Suit
• press_releases ~216 tokens
  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.
• quant_scenario_lab_task ~620 tokens
  Run 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 anonymous call returns subscription_required with a subscribe link.
• rate_curve ~320 tokens
  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_required with a subscr
• rate_differentials ~476 tokens
  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.
• release_calendar ~1261 tokens
  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 App metadata. The opti
• release_calendar_visual_artifact ~1210 tokens
  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 `indicator`, `start_date`, an
• release_risk_score_task ~298 tokens
  Score 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 subscription_required with a subscribe link.
• risk_sentiment ~230 tokens
  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, or USD-defensive FX
• risk_sentiment_changes ~229 tokens
  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 publication times are unav
• seasonality ~372 tokens
  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 from stored FX or gol
• subscribe_for_mcp_access ~81 tokens
  Returns FXMacroData subscription options and a direct checkout path for unlocking MCP app visuals, charts, and advanced analytical tools.

Browse

• GitHub tools
• Calendars
• Forms and surveys
• GitHub and code hosting
• Government and public data

Related MCP servers

• Theaslangroupllc Pulsenetwork
  914 paid market-data & token-safety endpoints — keyless x402 USDC: Base, Solana, XRPL, +8 chains
• FX Reference Rates
  ECB FX rates, cloud GPU and LLM API prices, World Bank country macro data; pay per call via x402
• agentshop — cross-country economic reports
  Economic reports for 20 economies, 2015-2025. Search free, pay per fetch in USDC on Base via x402.
• Market Indicators
  Calculate SMA, EMA, RSI, MACD, Bollinger Bands, ATR, stochastic and VWAP over a price series.
• OwlChart
  Live market data for AI: open interest on 13 exchanges, liquidity magnets, ETF flows, alerts
• GCC Brokers
  GCC Brokers instrument specs, swaps, trading hours, quotes, accounts and economic calendar.
• Antevo Executive Brief
  Market and world intelligence — the daily editorial read, risk radar and dated archive.
• SocialForex
  Live forex, gold & crypto quotes, economic calendar, screener, currency strength, lot-size calc

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.fxmacrodata/fxmacrodata.svg)](https://aptlynx.net/servers/io.github.fxmacrodata/fxmacrodata)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents