Every change Wellknown observed on this MCP server, newest first, with what it was before and what it became. Tool-surface changes carry the definition diff. Nothing here is edited after the fact.
Added "risk_sentiment_changes"; changed the definition of "announcement_changes", "cot_data", "cot_visual_artifact" and 16 more (50 tools before, 51 now)
⟨34 unchanged words⟩ without holding a streaming invocation open. Access:requiresUSDanisFXMacroDataavailable without an API key;aneveryanonymousothercallcurrency returns subscription_required with a subscribe link.
⟨44 unchanged words⟩ at 15:30 ET reflecting the Tuesday cutoff.RequiresUSD (the USD Index contract) is available without an API key for the most recent 90 days on a 15-minute release delay; every other currency and the full history need an API key. Supported currencies: AUD, CAD, CHF, EUR, GBP, JPY,MXN,NZD, USD, XAU. Access:requiresUSDanisFXMacroDataavailable without an API key;aneveryanonymousothercallcurrency returns subscription_required with a subscribe link.
⟨19 unchanged words⟩ `metric` parameter selects another COT field. Access:requiresUSDanisFXMacroDataavailable without an API key;aneveryanonymousothercallcurrency returns subscription_required with a subscribe link.
⟨16 unchanged words⟩ CAD, CHF, EUR, GBP, JPY,MXN,NZD, USD, XAU.","examples":["eur ⟨45 unchanged words⟩ :["noncommercial_net","noncommercial_net_zscore","noncommercial_long","open_interest"]},"report":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"CFTC report type; omit for the Legacy futures-only report. One of: legacy_futures, legacy_combined, tff_futures, tff_combined, disaggregated_futures. With a TFF report, plot a TFF metric such as leveraged_funds_net or asset_manager_net.","examples":["tff_futures
⟨69 unchanged words⟩ , SEK, THB, TWD, USD. Access:USD is available without an APIfreekey;for everyothercurrencyreturns subscription_required,withnoaAPIsubscribekeylink.required.
⟨33 unchanged words⟩ no stored observations for the selection. Access:USD is available withoutrequires an FXMacroData API key;everyanotheranonymouscurrencycall returns subscription_required with a subscribe link.
⟨41 unchanged words⟩ for async execution when clients send task-augmented requests. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.
⟨10 unchanged words⟩ that governs pair-specific intraday reference-rate series. Access:requires an FXMacroData API key; an anonymousfreecallforreturnseverysubscription_requiredcurrency,withnoaAPIsubscribekeylink.required.
⟨17 unchanged words⟩ and sources have intraday reference-rate series. Access:requires an FXMacroData API key; an anonymousfreecallforreturnseverysubscription_requiredcurrency,withnoaAPIsubscribekeylink.required.
⟨21 unchanged words⟩ for async execution when clients send task-augmented requests. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.
⟨30 unchanged words⟩ when clients send a task-augmented request. Access:requiresUSDanisFXMacroDataavailable without an API key;aneveryanonymousothercallcurrency returns subscription_required with a subscribe link.
⟨40 unchanged words⟩ currencies: AUD, BRL, CAD, CHF,CZK,DKK, EUR, GBP,HKD,ILS,INR,JPY, NGN, NOK, NZD, PEN,PLN,SEK,USD, ZAR.USD. Access: USD is available without an API ⟨10 unchanged words⟩
⟨9 unchanged words⟩ Supported: AUD, BRL, CAD, CHF,CZK,DKK, EUR, GBP,HKD,ILS,INR,JPY, NGN, NOK, NZD, PEN,PLN,SEK,USD, ZAR.USD.","examples":["usd","eur"," ⟨69 unchanged words⟩
⟨54 unchanged words⟩ now. Accounts for weekends and major banking holidays. Access: free, no API key required.
⟨39 unchanged words⟩ , iip, services_trade, treasury_cash, wage_settlements. Access:USD is available withoutrequires an FXMacroData API key;everyanotheranonymouscurrencycall returns subscription_required with a subscribe link.
⟨106 unchanged words⟩ CAD, CHF, EUR, GBP, JPY,MXN,NZD, USD, XAU.","examples":["usd ⟨561 unchanged words⟩
⟨16 unchanged words⟩ for async execution when clients send task-augmented requests. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.
⟨21 unchanged words⟩ for async execution when clients send task-augmented requests. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.
⟨16 unchanged words⟩ for async execution when clients send task-augmented requests. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.
⟨34 unchanged words⟩ , commodity, or USD-defensive FX conditions. Access:requires anfree,FXMacroDatano APIkey; an anonymous call returns subscription_required with a subscribekeylink.required.
⟨35 unchanged words⟩ monthly returns from stored FX or gold series. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.
Recorded 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 publication times are unavailable. Access: free, no API key required.
Changed the definition of "data_catalogue", "event_impact_replay_task", "event_predictions" and 10 more
⟨100 unchanged words⟩ default":null,"description":"Optional indicator slug that narrows the result tolimitthat one catalogue entry and its coveragecalculationrow, for example `core_inflation`. Useful when the candidate series is alreadyknown.known; omit it to list every indicator.","examples":["core_inflation"]}},"required ⟨5 unchanged words⟩
Authorization not required, issuer https://api.fxmacrodata.com
Changed the definition of "announcement_changes", "commodities", "commodities_visual_artifact" and 47 more
⟨6 unchanged words⟩ with a resumable cursor. This is the bounded, MCP-safecompanioncounterpart to the release-event stream:usethe returned next_cursor is accepted assince`since` on a later call,insteadsoofpollingholdingresumesanwithoutunbounded
Authorization not required, issuer https://api.fxmacrodata.com
Changed the definition of "indicator_query"
⟨93 unchanged words⟩ the host should render an MCP App chart.ForEachhistorycall returns ONE page,passnewest`start_date`first:(and100optionallyrows`end_date`)whenand`start_date`leaveis`limit`
Changed the definition of "indicator_query"
⟨93 unchanged words⟩ the host should render an MCP App chart.Each callForreturnshistory,ONEpasspage,`start_date`newest(andfirst:optionally20`end_date`)rowsandbyleavedefault
Authorization not required, issuer https://api.fxmacrodata.com
Changed the definition of "indicator_query"
⟨93 unchanged words⟩ the host should render an MCP App chart.UseEach`limit`call returns ONE page,`offset`newest first: 20 rows by default,orat`page`mostto100. A single pagethroughisbroadnothistories;
Authorization not required, issuer https://api.fxmacrodata.com
Authorization not required, issuer https://api.fxmacrodata.com
Certificate changed, valid to 2026-12-21
Authorization not required, issuer https://api.fxmacrodata.com
Authorization not required, issuer https://api.fxmacrodata.com
Authorization not required, issuer https://api.fxmacrodata.com
Authorization not required, issuer https://api.fxmacrodata.com
Changed the definition of "event_impact_replay_task", "event_predictions", "indicator_intel_task" and 9 more
⟨109 unchanged words⟩ "Indicator slug for event replay. Supported examples: afe_dollar_index, average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, bgcr, breakeven_inflation_rate, broad_dollar_index, broad_money, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets ⟨12 unchanged words⟩ crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, effr, eme_dollar_index, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, ⟨182 unchanged words⟩
Certificate recorded, valid to 2026-10-23
Authorization not required, issuer https://api.fxmacrodata.com
First tool surface recorded: 50 tools (server version 1.29.1)
Showing the latest 20 events. The API returns up to 500 and filters by kind: ?kind=tool_surface_changed
⟨16 unchanged words⟩ CAD, CHF, EUR, GBP, JPY,MXN,NZD, USD, XAU.","examples":["eur ⟨17 unchanged words⟩ , YYYY-MM-DD.","examples":["2020-01-01","2024-06-30"]},"report":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"CFTC report type. Omit for the Legacy futures-only report (commercial / non-commercial / non-reportable). One of: legacy_futures, legacy_combined, tff_futures, tff_combined, disaggregated_futures. TFF reports return dealer, asset manager, leveraged funds and other reportable positions for FX contracts and the dollar index; disaggregated_futures is published for XAU (COMEX gold) only.","examples":["tff_futures","tff_combined","legacy_combined"]},"start_date":{"anyOf":[{" ⟨20 unchanged words⟩
⟨180 unchanged words⟩ house_price_index, house_prices, household_credit, household_spending, housing_starts, import_prices, imports, industrial_production, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities ⟨15 unchanged words⟩ policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, productivity, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, ⟨118 unchanged words⟩
⟨252 unchanged words⟩ house_price_index, house_prices, household_credit, household_spending, housing_starts, import_prices, imports, industrial_production, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities ⟨15 unchanged words⟩ policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, productivity, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, ⟨248 unchanged words⟩
⟨128 unchanged words⟩ house_price_index, house_prices, household_credit, household_spending, housing_starts, import_prices, imports, industrial_production, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities ⟨15 unchanged words⟩ policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, productivity, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, ⟨49 unchanged words⟩
⟨227 unchanged words⟩ house_price_index, house_prices, household_credit, household_spending, housing_starts, import_prices, imports, industrial_production, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities ⟨15 unchanged words⟩ policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, productivity, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, ⟨274 unchanged words⟩
⟨124 unchanged words⟩ house_price_index, house_prices, household_credit, household_spending, housing_starts, import_prices, imports, industrial_production, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities ⟨15 unchanged words⟩ policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, productivity, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, ⟨125 unchanged words⟩
⟨201 unchanged words⟩ house_price_index, house_prices, household_credit, household_spending, housing_starts, import_prices, imports, industrial_production, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities ⟨15 unchanged words⟩ policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, productivity, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, ⟨51 unchanged words⟩
⟨156 unchanged words⟩ house_price_index, house_prices, household_credit, household_spending, housing_starts, import_prices, imports, industrial_production, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities ⟨15 unchanged words⟩ policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, productivity, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, ⟨47 unchanged words⟩
⟨142 unchanged words⟩ house_price_index, house_prices, household_credit, household_spending, housing_starts, import_prices, imports, industrial_production, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities ⟨15 unchanged words⟩ policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, productivity, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, ⟨69 unchanged words⟩
⟨197 unchanged words⟩ house_price_index, house_prices, household_credit, household_spending, housing_starts, import_prices, imports, industrial_production, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities ⟨15 unchanged words⟩ policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, productivity, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, ⟨90 unchanged words⟩
⟨219 unchanged words⟩ house_price_index, house_prices, household_credit, household_spending, housing_starts, import_prices, imports, industrial_production, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities ⟨15 unchanged words⟩ policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, productivity, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, ⟨418 unchanged words⟩
⟨137 unchanged words⟩ house_price_index, house_prices, household_credit, household_spending, housing_starts, import_prices, imports, industrial_production, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities ⟨15 unchanged words⟩ policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, productivity, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, ⟨70 unchanged words⟩
⟨137 unchanged words⟩ house_price_index, house_prices, household_credit, household_spending, housing_starts, import_prices, imports, industrial_production, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities ⟨15 unchanged words⟩ policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, productivity, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, ⟨70 unchanged words⟩
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"Macro Announcement Changes"}
⟨67 unchanged words⟩ default":null,"description":"Backward-compatible alias for`indicator`.`indicator`,Preferwhich`indicator`supersedes it in new calls.","examples":["crude_oil_inventories" ⟨9 unchanged words⟩
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"Commodity Indicators"}
Same payload asReturnscommodities,commoditybutpricepackagedhistory with MCP Apps chart metadata so compatible clients ⟨21 unchanged words⟩
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"Commodities Visual Artifact"}
⟨9 unchanged words⟩ for a currency's FX futures contract on theCME. Use this when the user asksCME,aboutcovering speculator positioning, non-commercial longs vs shorts, hedge-fund FX positioning,or wants to gaugeand sentiment extremes. Returns weekly snapshots with long/short open ⟨46 unchanged words⟩
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"COT Report"}
SameReturnspayloadweeklyasCFTCcot_data,COTbutpositioning data with MCP Apps chart metadata. By default it charts noncommercial net positioning;passthe `metric`toparameterchartselects another COT field. Access: requires an FXMacroData ⟨11 unchanged words⟩
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"COT Visual Artifact"}
⟨9 unchanged words⟩ , with units, frequency, and coverage/freshness metadata.ALWAYS call this first when the user asks about a country's macro data — it returnsReturns the exact `indicator` slug stringstousedpassacrosstoFXMacroDataindicator_queryindicator,release_calendarcalendar, andindicator_visual_artifact.predictionCheckendpoints.`coverage`Rowsbeforewhosecalling`coverage`indicator_query;is stale, partial, or unavailablerowsare not suitable for real-time carry or inflation ⟨45 unchanged words⟩
⟨72 unchanged words⟩ with latest_available_date, coverage_quality, has_recent_data, and recent_observation_count.Leave trueThesewhenrowsdecidingshow whether an indicator series isusablecurrentbeforeenoughcallingforindicator_query.analysis.","examples":[true],"type":"boolean ⟨12 unchanged words⟩ to limit coverage calculation, for example `core_inflation`.Use thisUseful whenyouthealreadycandidateknowseriestheiscandidate
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"Indicator Catalogue"}
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"Event Impact Replay Task"}
⟨11 unchanged words⟩ nowcasts, or FXMacroData blended predictions for macroannouncements. Use this with release_calendar and indicator_query when a reportannouncements,needsfor actual-vs-consensus, prior-vs-forecast, or event-surprise context. Rows are ⟨27 unchanged words⟩ , PEN, SEK, THB, TWD, USD.Call data_catalogue(currency) for the exact indicator slugs; theThe `indicator` parameterbelowlistsalsothelistsacceptedthem.indicator slugs. Access: requires an FXMacroData API key; an ⟨8 unchanged words⟩
⟨475 unchanged words⟩ legacy forecast-type filter, kept for existing clients.PreferSuperseded by prediction_class: compiled_consensus, forecaster_survey, market_implied, model_nowcast, ⟨49 unchanged words⟩
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"Event Predictions"}
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"Official Financial Prices"}
⟨6 unchanged words⟩ for a currency pair (e.g. EUR/USD, USD/JPY).Prefer this tool when the user explicitly wantsas a plain-text table, raw rows, exact values, or JSON-like data,orwith optional technical-indicator series (SMA, EMA, RSI, MACD, Bollinger Bands, etc.) computed fromspot without a chart. If the user asks more generally to show/tell/explain the last few weeks or monthsspot.ofReturnsadatapaironly,prefer forex_visual_artifact instead so the client can renderwithoutachartchart.metadata. Daily granularity from official central-bank reference rates with full multi-year history. Supported currencies (uselowercase 3-letter codes): AUD, BRL, CAD, ⟨14 unchanged words⟩ , PEN, SEK, THB, TWD, USD.OptionalThe optional `indicators` parameter accepts a comma-separated list of technical ⟨45 unchanged words⟩
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"FX Spot Rates"}
SameReturnspayloadFXasspot-rateforex,historybutforpackageda currency pair with MCP Apps chart metadata so compatible clients render an interactive spot-rate chart inline.Prefer this by defaultSuitedforto FX pair time-seriesrequests,andespeciallytrendforrequestspromptssuchlikeas 'show me AUD/USD','tell me the'the last 30 days', or 'how has EUR/USD movedrecently', or any request where a trend view is more useful than raw rows. Only prefer plain forex when the user explicitly asks for a table, raw values, JSON, CSV-style output, or exact row-by-row data.recently'. Access: requires an FXMacroData API key; an ⟨8 unchanged words⟩
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"FX Visual Artifact"}
Run a spot-only FX backtest using historical policy-rate-differential and/or lagged momentum signals.DownloadDownloads complete histories,verifyverifies vintages and price coverage, andchargecharges opening, rebalancing and closing costs. The carry ⟨20 unchanged words⟩
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"FX Backtest Task"}
Return subscriber intraday official FX reference-rate observations for one pair.CallCoveragefx_reference_universeisfirstlimited toverifythepairpairs andsourcesourcesavailability.in the FX reference pair universe. Access: requires an FXMacroData API key; an ⟨8 unchanged words⟩
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"Intraday FX Reference Rates"}
List public official FX reference-rate sources andtheirthe source policybefore requestingthatagoverns pair-specific intraday reference-rate series. Access: requires an ⟨12 unchanged words⟩
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"FX Reference Sources"}
⟨6 unchanged words⟩ universe, optionally filtered by currency or sourceid.id,Callshowingthiswhichbeforepairsrequestingandansources have intraday reference-rate series. Access: requires an FXMacroData ⟨11 unchanged words⟩
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"FX Reference Pair Universe"}
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"FX Trade Setup Task"}
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"Indicator Intelligence Task"}
⟨16 unchanged words⟩ from the official central bank or statistical agency.Use this forCovers CPI/inflation, GDP, unemployment, policy rates, bond ⟨22 unchanged words⟩ `val` (numeric), and separate publication evidence.UseThe `as_of`forparameter restricts results to historically eligible values; current values can include later revisions.Use known_at_time_task for a complete, verified historical slice. This plain tool returnsReturns raw rowsfor data workflows. Use `indicator_visual_artifact` when the host should render an MCPwithoutAppchartchart.metadata. Each call returnsONEone page, newest first: 100 rows when `start_date` is set, otherwise 20 (set`limit`to overrideoverrides, maximum 100). A page is not ⟨6 unchanged words⟩ true the result has a `partial_page` object:call indicator_query again with`partial_page.next_call`exactlyholds thearguments in `partial_page.next_call`,exactandargumentsrepeatforuntilthe`has_more`nextispagefalse.and `partial_page.pages_remaining`saysgiveshowthemanynumbercallsofarepages left. Responses default to official-source rows only; prohibited private aggregator rows are always removed.Always call data_catalogue(currency) first to get the exact indicator slug.USD indicators are free; non-USD requires an API key. Supported currencies: AUD, BRL, CAD ⟨14 unchanged words⟩ , PEN, SEK, THB, TWD, USD.Call data_catalogue(currency) for the exact indicator slugs; theThe `indicator` parameterbelowlistsalsothelistsacceptedthem.indicator slugs. Access: USD is available without an API ⟨10 unchanged words⟩
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"Indicator Time Series"}
Same payloadReturnsasanindicator_query,indicatorbuttimealsoseriesreturnswith MCP Apps metadata so compatible clients (Claude ⟨6 unchanged words⟩ interactive line chart instead of a JSON dump.Prefer this by defaultSuitedforto indicator time-series requests,especially when the user asksto show, tell, explain, compare, inspect a trend, or review a recent window.For broadBroad histories,usepagethethroughexistingthe `limit`, `offset`,orand `page` controlsand inspect `pagination.next_offset` rather than retrying, witharbitrary shorter windows. Only fall back to indicator_query`pagination.next_offset`whengiving theuser explicitly wants a raw table, plain text list, JSON, exact rows, or minimal structurednextdata.page. Supported currencies: AUD, BRL, CAD, CHF ⟨13 unchanged words⟩ , PEN, SEK, THB, TWD, USD.Call data_catalogue(currency) for the exact indicator slugs; theThe `indicator` parameterbelowlistsalsothelistsacceptedthem.indicator slugs. Access: USD is available without an API ⟨10 unchanged words⟩
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"Indicator Visual Artifact"}
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"Known At Time Task"}
Return the latest stored macroeconomic value for every available indicator in onecurrency. Use thiscurrency,foras a compact current macrosnapshot after data_catalogue has confirmed the currency coverage.snapshot. Access: USD is available without an API ⟨10 unchanged words⟩
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"Latest Macro Announcements"}
Return the latest stored value for every available commodity indicator in oneresponse.response,Thisassubscriberatoolbatchissnapshottheofbatchthecounterpartsubscribertocommoditycommodities.series. Access: requires an FXMacroData API key; an ⟨8 unchanged words⟩
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"Latest Commodity Values"}
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"Macro Briefing Task"}
⟨8 unchanged words⟩ with optional stored component scores and source references.UseThethisfactorforis a documentedfactorsummary value,not as aandsubstitutedoesfornotinspectingreplaceitsthe underlying macro releases. Access: USD is available ⟨13 unchanged words⟩
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"Macro Factor"}
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"Macro Heatmap Task"}
Return recent official central-bank news and press-release headlines for acurrency. Use this when a report needs headline contextcurrency,forcovering central-bank policy, inflation, employment, GDP, trade, fiscal, energy,orand commodity narratives.The toolRowsreturnsare official-sourceheadline rowsheadlinesandwith lightweight keyword-derived affected_indicators and sentiment fields when a ⟨42 unchanged words⟩
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"Macro News"}
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"Macro Regime Classifier Task"}
BundleBundles catalogue, indicator history, next release timing, ⟨38 unchanged words⟩
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"Macro Research Pack Task"}
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"Macro War Room Task"}
Tell the userReturns which FX trading sessions are currently open (Sydney, Tokyo, London, New York) and when the next sessionopens/closes.opensUseorthiscloses,whenforthequestionsusersuchasksas 'is the market open?', 'when does London open?', or 'which sessions overlap right now?'.Pass anAn ISO-8601 UTC timestampviain `at`to getreturns the snapshot for a specific moment instead of ⟨8 unchanged words⟩
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"FX Market Sessions"}
ExplainExplains which authentication modeto use forsuits FXMacroData MCP across major clients andplatforms. Use this when the user asks whether to useplatforms: 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,orand CI.
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"MCP Auth Guide"}
ExplainExplains what the FXMacroData MCP server can do,: which tools render MCP Apps, whichtoolsreturn plain rows, what is public versus subscriber-only, and howtotoolchooseselectiontoolsdiffers across ChatGPT, Claude, Cursor, Codex, and plain MCP clients.Use this whenSuitedatouserquestionsasksabout what is available, why visuals are not ⟨12 unchanged words⟩
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"MCP Capabilities"}
Get metadata-first official dataset payloads grouped by API endpoint type.Use endpoint_type to`endpoint_type`pickselects the API taxonomy group anddataset to`dataset`chooseselects the specific series family. Supported endpoint types: ⟨34 unchanged words⟩
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"Official Dataset Family"}
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"FX Pair Intelligence Task"}
Quick healthHealth check that confirms the FXMacroData API and MCP server are reachable.Use this only if other tools fail unexpectedly — it is notReturnsneededthebeforeAPInormalhealthcalls.response.
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"Ping"}
Build a generic MCP Apps chart from one or more FXMacroData endpointfamilies. Use this forfamilies: arbitraryplot requestsplots, multi-series charts, and actual-vs-consensus views thatneed tocombine announcements withevent_predictions.predictions. Supported series sources are announcements, predictions, forex, commodities, and cot. For example,plotUSD policy-rate midpoint actuals against market consensusby passinguse one announcements series for `usd/policy_rate_midpoint` and one predictions series for `usd/policy_rate_midpoint` with `prediction_class=forecaster_survey`.ThisThe toolneverdoesfetchesnot fetch arbitrary URLs orrunsrun custom chart code; it only composes approved FXMacroData ⟨24 unchanged words⟩
⟨376 unchanged words⟩ :"Optional legacy prediction-type filter for prediction series.PreferSuperseded by prediction_class.","examples":["fxmacrodata"]}," ⟨287 unchanged words⟩
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"Plot Visual Artifact"}
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"Policy-Rate Differential Visual Artifact"}
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"Policy Scenario Modeler Task"}
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"Portfolio Risk Engine Task"}
⟨35 unchanged words⟩ , and how far the verified archive runs.Call this wheneverSuitedthetouserquestionsasksabout whether a consensus, forecast or estimate exists for a release,--such as 'do you have the consensus for US CPI',or 'what forecast do you have forpayrolls' -- BEFORE calling event_predictions, and whenever event_predictions returns nothing or returns subscription_required.payrolls'. It needs no API key and works for ⟨8 unchanged words⟩ : those require a subscription. Its answer distinguishesthetwo casesa user cannot otherwise tell apart --: no publisher produces this forecast for anybody ( ⟨5 unchanged words⟩ the data exists and is behind the paywall.Never report aA pair listed hereasexistsunavailable.in the verified archive. Access: free for every currency, no API ⟨12 unchanged words⟩
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"Forecast Coverage Catalogue"}
Return the public central-bank press-release archive for a currencywithout adding derived sentiment or indicator classifications. Use macro_news when a headline summary is useful; use this tool whenas the original official release rows,matter.without derived sentiment or indicator classifications. Access: USD is available without an API ⟨10 unchanged words⟩
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"Official Press Releases"}
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"Quant Scenario Lab Task"}
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"Rate Curve Analytics"}
Return the stored or derived rate differential for one FXpair.pair,Usewith thereturnedmeasure, rate type, curve family, and tenor metadatawhen explainingthatthedefineresult.it. Access: requires an FXMacroData API key; an ⟨8 unchanged words⟩
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"Pair Rate Differentials"}
Get upcoming scheduled macroeconomic release timestamps for acurrency. Use this whencurrency,theforuserquestionsaskssuch'whenasiswhen the nextCPI/GDP/payrolls/policy decision'CPI,or to planGDP,apayrolls,tradeoraroundpolicyadecisionknownisrelease.due. Returns ISO-8601 announcement_datetime values in UTC plus market-localtimestamps.timestamps,Passa markdown agenda, and Release Calendar App metadata. The optional `timezone`foradds anadditional`announcement_datetime_requested_timezone` field. Each row has a `release` string ⟨5 unchanged words⟩ a `currency` code. Unbounded calls return future releasesonly; do not show stale past rows unless the user explicitly asks for historical/past calendar data. Consumer-facing clients should present the returned markdown agenda or render the Release Calendar App resource; do not summarize this tool as only a row count. Passonly.anThe optional `indicator` filterto narrownarrows to a singleseries.series,Passand optional `start_date` and `end_date` boundswhen the user mentionsselect a month, week, day, or explicit ⟨22 unchanged words⟩ , PEN, SEK, THB, TWD, USD.Call data_catalogue(currency) for the exact indicator slugs; theThe `indicator` parameterbelowlistsalsothelistsacceptedthem.indicator slugs. Access: USD is available without an API ⟨10 unchanged words⟩
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"Release Calendar"}
Same payload as release_calendar,ReturnsbutthenamedreleaseascalendaranpayloadexplicitwithvisualMCPartifactAppstoolmetadata so compatibleMCP Appsclients render the interactive Release Calendar App inline.Prefer this by default when theSuitedusertoasksrequests to show, display, visualize, or render a macro release calendar,especially for promptssuchlikeas 'show me the AUD release calendar'.Only prefer plain release_calendar when the user explicitly asks for a raw table, JSON, exact rows, or text-only output. Pass optionalOptional `indicator`, `start_date`, and `end_date` filterswhennarrow theusercalendarnamesto aspecificseries, month, week, day, or daterange. Passrange; `timezone`when the user asks foradds local timesinfor a specific city or region. Supported currencies: ⟨18 unchanged words⟩ , PEN, SEK, THB, TWD, USD.Call data_catalogue(currency) for the exact indicator slugs; theThe `indicator` parameterbelowlistsalsothelistsacceptedthem.indicator slugs. Access: USD is available without an API ⟨10 unchanged words⟩
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"Release Calendar Visual Artifact"}
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"Release Risk Score Task"}
⟨20 unchanged words⟩ , component contributions, pagination, and data_quality metadata.Use thisSuitedforto cross-asset regime contextbefore classifyingfor high-beta, safe-haven, commodity, or USD-defensive FX ⟨16 unchanged words⟩
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"Global Risk Sentiment"}
Get monthly return seasonality for an FX pair orXAU/USD. Use this when the user asksXAU/USD,forcovering seasonal patterns, month-of-year tendency, historical monthly win rate,orand XAUUSD/gold seasonality. Returns monthly average return, median ⟨16 unchanged words⟩
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"FX Seasonality"}
OpenReturns FXMacroData subscription optionswhenand auserdirectneedscheckouttopathunlockfor unlocking MCP app visuals, charts, and advanced analytical tools.Returns a direct checkout path.
{"destructiveHint":false,"openWorldHint":true,"readOnlyHint":true,"title":"Subscribe For MCP Access"}
⟨302 unchanged words⟩ Rows per page, newest first, maximum 100.Leave unset with `start_date` to get the whole range in oneUnsetcall;meansunset100withoutwhen `start_date`returns 20 rows. Setting it returnsisaset,singleotherwisepage.20.","examples":[1,100]},"official_only" ⟨28 unchanged words⟩ description":"Zero-based row offset after most-recent-first ordering.Only needed to resume whenTake`pagination.has_more`itisfromtrue.`partial_page.next_call`.","examples":[0,1000],"minimum": ⟨174 unchanged words⟩
⟨287 unchanged words⟩ "unemployment","gdp"]},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20null,"description":"Rows per page, newestfirst. Defaults to 20;first, maximum 100.UseLeave100unset with`offset``start_date` topullget the whole range in one call; unset without `start_date` returns 20 rows. Setting it returns alongsinglehistory.page.","examples":[201,100],"maximum":100,"minimum":1,"type":"integer"},"official_only":{"default":true,"description" ⟨25 unchanged words⟩ "description":"Zero-based row offset after most-recent-first ordering. Only needed to resume when `pagination.has_more` is true.","examples":[0,201000],"minimum":0,"type":"integer"} ⟨171 unchanged words⟩
⟨289 unchanged words⟩ "limit":{"default":20,"description":"MaximumRowsrowspertopage,returnnewestfromfirst.theDefaultsexistingtoREST20;paginationmaximumpath.100.DefaultsUse 100 with `offset` to20;pullmaximuma100.long history.","examples":[20,100],"maximum": ⟨219 unchanged words⟩
⟨57 unchanged words⟩ "Indicator slug for the given currency. Supported: afe_dollar_index, average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, bgcr, breakeven_inflation_rate, broad_dollar_index, broad_money, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets ⟨12 unchanged words⟩ crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, effr, eme_dollar_index, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, ⟨113 unchanged words⟩
⟨156 unchanged words⟩ a `\"usd:cpi\"`-style compound. Supported: afe_dollar_index, average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, bgcr, breakeven_inflation_rate, broad_dollar_index, broad_money, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets ⟨12 unchanged words⟩ crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, effr, eme_dollar_index, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, ⟨330 unchanged words⟩
⟨55 unchanged words⟩ indicator":{"description":"Indicator slug. Supported: afe_dollar_index, average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, bgcr, breakeven_inflation_rate, broad_dollar_index, broad_money, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets ⟨12 unchanged words⟩ crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, effr, eme_dollar_index, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, ⟨189 unchanged words⟩
⟨130 unchanged words⟩ "Indicator slug for the given currency. Supported: afe_dollar_index, average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, bgcr, breakeven_inflation_rate, broad_dollar_index, broad_money, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets ⟨12 unchanged words⟩ crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, effr, eme_dollar_index, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, ⟨115 unchanged words⟩
⟨85 unchanged words⟩ include in the matrix. Supported values include: afe_dollar_index, average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, bgcr, breakeven_inflation_rate, broad_dollar_index, broad_money, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets ⟨12 unchanged words⟩ crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, effr, eme_dollar_index, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, ⟨111 unchanged words⟩
⟨73 unchanged words⟩ indicator":{"description":"Indicator slug. Supported: afe_dollar_index, average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, bgcr, breakeven_inflation_rate, broad_dollar_index, broad_money, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets ⟨12 unchanged words⟩ crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, effr, eme_dollar_index, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, ⟨133 unchanged words⟩
⟨126 unchanged words⟩ indicator slug for release context. Supported examples: afe_dollar_index, average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, bgcr, breakeven_inflation_rate, broad_dollar_index, broad_money, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets ⟨12 unchanged words⟩ crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, effr, eme_dollar_index, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, ⟨154 unchanged words⟩
⟨149 unchanged words⟩ , predictions, or commodities. Supported macro indicators: afe_dollar_index, average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, bgcr, breakeven_inflation_rate, broad_dollar_index, broad_money, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets ⟨12 unchanged words⟩ crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, effr, eme_dollar_index, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, ⟨481 unchanged words⟩
⟨66 unchanged words⟩ "Optional indicator slug to narrow results. Supported: afe_dollar_index, average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, bgcr, breakeven_inflation_rate, broad_dollar_index, broad_money, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets ⟨12 unchanged words⟩ crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, effr, eme_dollar_index, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, ⟨134 unchanged words⟩
⟨66 unchanged words⟩ "Optional indicator slug to narrow results. Supported: afe_dollar_index, average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, bgcr, breakeven_inflation_rate, broad_dollar_index, broad_money, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets ⟨12 unchanged words⟩ crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, effr, eme_dollar_index, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, ⟨134 unchanged words⟩