{"data":{"name":"io.github.fxmacrodata/fxmacrodata","title":"FXMacroData","description":"Macroeconomic and FX time-series data for AI agents: indicators, calendars, COT, forex, commodities.","version":"1.0.1","websiteUrl":"https://fxmacrodata.com","repositoryUrl":"https://github.com/fxmacrodata/fxmacrodata","remotes":[{"url":"https://fxmacrodata.com/mcp","type":"streamable-http"}],"packages":[],"status":"active","isLatest":true,"publishedAt":"2026-04-10T14:24:50.828Z","updatedAt":"2026-04-10T14:24:50.828Z","source":"official-registry","verification":"official","confidence":100,"stars":null,"sources":[{"stars":null,"title":"FXMacroData","source":"official-registry","sourceId":"io.github.fxmacrodata/fxmacrodata","updatedAt":"2026-04-10T14:24:50.828Z","confidence":100,"websiteUrl":"https://fxmacrodata.com","description":"Macroeconomic and FX time-series data for AI agents: indicators, calendars, COT, forex, commodities.","verification":"official","repositoryUrl":"https://github.com/fxmacrodata/fxmacrodata"}],"toolIndex":{"tools":[{"serverName":"io.github.fxmacrodata/fxmacrodata","endpointFingerprint":"4252b288953fde9d64ff47259e560b8618155a5d8ad98bef4714bad4e5927973","name":"catalogue_related","title":"Follow Catalogue Relationships","description":"Follow evidence-linked catalogue relationships from a node ID returned by catalogue_search. Depth is one or two, limit is at most fifty; use the returned cursor for more results. Paths explain recorded metadata relationships, not causality or series equivalence. Retrieval tools enforce their existing data access rules. Access: public metadata relationships, no API key required.","inputSchema":{"type":"object","properties":{"node_id":{"description":"Exact opaque node ID from a catalogue result; do not construct an ID.","type":"string"},"depth":{"default":1,"description":"Relationship traversal depth: 1 (direct) or 2 (one additional hop).","type":"integer"},"limit":{"default":10,"description":"Maximum results per page, 1-50.","type":"integer"},"cursor":{"description":"Opaque next_cursor from the preceding result with unchanged filters; omit for page one.","type":["string","null"]},"relationship":{"description":"Optional edge type: published_by, about_country, cites_source or related_series.","type":["string","null"],"enum":["published_by","about_country","cites_source","related_series",null]}},"required":["node_id"]},"annotations":{"title":"Follow Catalogue Relationships","readOnlyHint":true,"destructiveHint":false,"openWorldHint":true},"definitionHash":"824e6088f57b9427acd85f49b4eca70dc97dbfa5ace4384a98b25417f5854859","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T13:47:39.518Z","metadataTrust":"untrusted"},{"serverName":"io.github.fxmacrodata/fxmacrodata","endpointFingerprint":"4252b288953fde9d64ff47259e560b8618155a5d8ad98bef4714bad4e5927973","name":"catalogue_search","title":"Search the Data Catalogue","description":"Search website dataset metadata or graph relationships. Access: public catalogue metadata, no API key required.","inputSchema":{"type":"object","properties":{"query":{"default":"","description":"Search text alias.","type":"string"},"kind":{"description":"Kind from facets; graph uses lowercase (default series).","type":["string","null"]},"country":{"description":"Graph country code.","type":["string","null"]},"currency":{"description":"Currency facet; either FX leg.","type":["string","null"]},"publisher":{"description":"Publisher facet or graph ID.","type":["string","null"]},"limit":{"default":10,"description":"Graph page size.","type":"integer"},"cursor":{"description":"Graph cursor from results.","type":["string","null"]},"view":{"default":"graph","description":"Website datasets or graph.","enum":["graph","datasets"],"type":"string"},"q":{"description":"Keyword search.","type":["string","null"]},"data_type":{"default":"","description":"Data type facet.","type":"string"},"topic":{"default":"","description":"Topic from facets.","type":"string"},"frequency":{"default":"","description":"Frequency facet.","type":"string"},"dataset":{"default":"","description":"Exact result ID.","type":"string"},"collection":{"default":"","description":"Parent collection ID.","type":"string"},"sort":{"default":"relevance","description":"Result sort order.","enum":["relevance","name","history"],"type":"string"},"page":{"default":1,"description":"One-based result page.","type":"integer"},"page_size":{"default":20,"description":"Page size, 1-50.","type":"integer"}}},"annotations":{"title":"Search the Data Catalogue","readOnlyHint":true,"destructiveHint":false,"openWorldHint":true},"definitionHash":"8bc66b34c486678a481934eebb5eb39e6d4516b7207701867f16eb18903c1b57","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T13:47:39.518Z","metadataTrust":"untrusted"},{"serverName":"io.github.fxmacrodata/fxmacrodata","endpointFingerprint":"4252b288953fde9d64ff47259e560b8618155a5d8ad98bef4714bad4e5927973","name":"commodities","title":"Commodity Indicators","description":"Get historical price series for supported commodity indicators using the exact slugs advertised by this schema. Supported indicators: crude_oil_inventories, crude_oil_stocks, distillate_inventories, distillate_stocks, gasoline_inventories, gasoline_stocks, gold, natural_gas, natural_gas_storage, natural_gas_storage_level, oil_brent, oil_wti, platinum, silver. Access: API key required, else returns subscription_required with a subscribe link.","inputSchema":{"type":"object","properties":{"indicator":{"description":"Commodity indicator slug. Supported: crude_oil_inventories, crude_oil_stocks, distillate_inventories, distillate_stocks, gasoline_inventories, gasoline_stocks, gold, natural_gas, natural_gas_storage, natural_gas_storage_level, oil_brent, oil_wti, platinum, silver.","examples":["crude_oil_inventories","crude_oil_stocks","distillate_inventories","distillate_stocks","gasoline_inventories","gasoline_stocks"],"type":["string","null"]},"symbol":{"description":"Backward-compatible alias for `indicator`, which supersedes it in new calls.","examples":["crude_oil_inventories","crude_oil_stocks","distillate_inventories","distillate_stocks","gasoline_inventories","gasoline_stocks"],"type":["string","null"]},"start_date":{"description":"Inclusive lower bound, YYYY-MM-DD.","examples":["2024-06-30"],"type":["string","null"]},"end_date":{"description":"Inclusive upper bound, YYYY-MM-DD.","examples":["2024-06-30"],"type":["string","null"]},"latest":{"default":false,"description":"Set true for one snapshot of the latest stored value of every commodity indicator; `indicator` is then not needed.","type":"boolean"}}},"annotations":{"title":"Commodity Indicators","readOnlyHint":true,"destructiveHint":false,"openWorldHint":true},"definitionHash":"a57762d81bf3489e13dd69415f4e76155158034c425749c3ef23b51ed765dc1d","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T13:47:39.518Z","metadataTrust":"untrusted"},{"serverName":"io.github.fxmacrodata/fxmacrodata","endpointFingerprint":"4252b288953fde9d64ff47259e560b8618155a5d8ad98bef4714bad4e5927973","name":"cot_data","title":"COT Report","description":"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. Updated every Friday at 15:30 ET reflecting the Tuesday cutoff. USD (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: USD needs no API key; other currencies return subscription_required with a subscribe link.","inputSchema":{"type":"object","properties":{"currency":{"description":"3-letter ISO currency code for the FX futures contract (case-insensitive). Supported: AUD, CAD, CHF, EUR, GBP, JPY, MXN, NZD, USD, XAU.","examples":["eur","jpy","gbp","aud"],"type":["string","null"]},"start_date":{"description":"Inclusive lower bound, YYYY-MM-DD.","examples":["2024-06-30"],"type":["string","null"]},"end_date":{"description":"Inclusive upper bound, YYYY-MM-DD.","examples":["2024-06-30"],"type":["string","null"]},"report":{"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"],"type":["string","null"]},"instrument":{"description":"Any CFTC contract by instrument id (rates, equity, energy, metals and micro contracts) instead of a currency. Use `list` to see the supported instrument/report combinations.","examples":["list","ust_10y","wti_crude"],"type":["string","null"]},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"description":"Rows per page for instrument reads (1-100)."},"offset":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"description":"Row offset for instrument reads."}}},"annotations":{"title":"COT Report","readOnlyHint":true,"destructiveHint":false,"openWorldHint":true},"definitionHash":"26365d42c484cefc3c8fbc59b8eb76117986006812b3b11cb9144acb5e1aad4b","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T13:47:39.518Z","metadataTrust":"untrusted"},{"serverName":"io.github.fxmacrodata/fxmacrodata","endpointFingerprint":"4252b288953fde9d64ff47259e560b8618155a5d8ad98bef4714bad4e5927973","name":"data_catalogue","title":"Indicator Catalogue","description":"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 are not suitable for real-time carry or inflation analysis. Other views, all free: `forecasts` shows which publishers forecast which indicators and how far each archive runs (no forecast values); `fx_sources` lists official FX reference-rate publishers; `fx_universe` lists the pairs each one covers; `sources` returns a persisted source definition by its metadata `sha256`. Access: all currencies keyless.","inputSchema":{"type":"object","properties":{"currency":{"description":"3-letter ISO currency code (case-insensitive). Required for the indicators and sources views; optional filter for the others. Supported: AUD, BRL, CAD, CHF, CNH, CNY, CZK, DKK, EUR, GBP, HUF, IDR, ILS, JPY, KRW, MXN, MYR, NGN, NOK, NZD, PEN, PLN, SEK, THB, TWD, USD.","examples":["usd","eur"],"type":["string","null"]},"include_coverage":{"default":true,"description":"Include coverage/freshness rows with latest_available_date, coverage_quality, has_recent_data, and recent_observation_count. These rows show whether an indicator series is current enough for analysis.","examples":[true],"type":"boolean"},"include_capabilities":{"default":false,"description":"Include machine-readable indicator capabilities when the API supports them, such as supported transformations, history availability, and release-calendar linkage.","examples":[false],"type":"boolean"},"indicator":{"description":"Optional indicator slug that narrows the result to that one catalogue entry and its coverage row, for example `core_inflation`. Useful when the candidate series is already known; omit it to list every indicator.","examples":["core_inflation"],"type":["string","null"]},"view":{"default":"indicators","description":"indicators (default): the indicator catalogue. forecasts: forecast coverage by publisher. fx_sources / fx_universe: official FX reference-rate publishers and the pairs they cover. sources: one persisted source definition, by `sha256`.","enum":["indicators","forecasts","fx_sources","fx_universe","sources"],"type":"string"},"source":{"description":"fx_universe only: official source id filter.","examples":["ecb_eurofxref_daily"],"type":["string","null"]},"sha256":{"description":"sources only: the metadata SHA256 from a catalogue row.","type":["string","null"]}}},"annotations":{"title":"Indicator Catalogue","readOnlyHint":true,"destructiveHint":false,"openWorldHint":true},"definitionHash":"14dd166b72c92a5556ef7f00e444edd942391af99ca9dc8d8a3654ac4c22df03","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T13:47:39.518Z","metadataTrust":"untrusted"},{"serverName":"io.github.fxmacrodata/fxmacrodata","endpointFingerprint":"4252b288953fde9d64ff47259e560b8618155a5d8ad98bef4714bad4e5927973","name":"event_impact_replay_task","title":"Event Impact Replay","description":"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. Access: USD needs no API key; other currencies return subscription_required with a subscribe link.","inputSchema":{"type":"object","properties":{"currency":{"description":"Currency for macro event series, 3-letter ISO code (case-insensitive). Supported: lowercase 3-letter catalogue currency, e.g. usd or eur.","examples":["usd","eur","gbp"],"type":"string"},"indicator":{"description":"Indicator slug for event replay. Supported examples: catalogue indicator slug, e.g. inflation or policy_rate.","examples":["inflation","policy_rate","gdp"],"type":"string"},"base":{"default":"eur","description":"FX base currency for market context, 3-letter ISO code (case-insensitive). Supported: lowercase 3-letter catalogue currency, e.g. usd or eur.","examples":["eur","gbp","aud","usd"],"type":["string","null"]},"quote":{"default":"usd","description":"FX quote currency for market context, 3-letter ISO code (case-insensitive). Supported: lowercase 3-letter catalogue currency, e.g. usd or eur.","examples":["usd","jpy","chf"],"type":["string","null"]},"lookback_events":{"default":12,"description":"Maximum number of recent events to include in replay.","examples":[6,12,24],"type":["integer","null"]},"start_date":{"description":"Optional inclusive lower bound, YYYY-MM-DD.","examples":["2024-06-30"],"type":["string","null"]},"end_date":{"description":"Optional inclusive upper bound, YYYY-MM-DD.","examples":["2024-06-30"],"type":["string","null"]}},"required":["currency","indicator"]},"annotations":{"title":"Event Impact Replay","readOnlyHint":true,"destructiveHint":false,"openWorldHint":true},"definitionHash":"425b26c20ce49560518ba1a62b9260e5bfccaa04487a70116086fda79676ec93","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T13:47:39.518Z","metadataTrust":"untrusted"},{"serverName":"io.github.fxmacrodata/fxmacrodata","endpointFingerprint":"4252b288953fde9d64ff47259e560b8618155a5d8ad98bef4714bad4e5927973","name":"event_predictions","title":"Event Predictions","description":"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/indicator and include prediction source metadata. Supported currencies: lowercase 3-letter catalogue currency, e.g. usd or eur. The `indicator` parameter lists the accepted indicator slugs. Access: API key required, else returns subscription_required with a subscribe link.","inputSchema":{"type":"object","properties":{"currency":{"description":"3-letter ISO currency code (case-insensitive). Supported: lowercase 3-letter catalogue currency, e.g. usd or eur.","examples":["usd","eur"],"type":"string"},"indicator":{"description":"Required indicator slug. Currency-wide prediction reads are not supported. Supported: catalogue indicator slug, e.g. inflation or policy_rate.","examples":["policy_rate","inflation"],"type":"string"},"prediction_type":{"description":"Optional legacy forecast-type filter, kept for existing clients. Superseded by prediction_class: compiled_consensus, forecaster_survey, expectations_survey, market_implied, model_nowcast, central_bank_projection, institutional_projection or fxmacrodata.","examples":["fxmacrodata"],"type":["string","null"]},"prediction_source":{"description":"Optional source slug filter, for example ecb_spf or philly_fed_spf.","examples":["ecb_spf","philly_fed_spf"],"type":["string","null"]},"start_date":{"description":"Optional inclusive lower bound by reference-period date, YYYY-MM-DD.","examples":["2024-06-30"],"type":["string","null"]},"end_date":{"description":"Optional inclusive upper bound by reference-period date, YYYY-MM-DD.","examples":["2024-06-30"],"type":["string","null"]},"limit":{"default":20,"description":"Maximum prediction groups to return. Defaults to 20; maximum 100.","examples":[20],"maximum":100,"minimum":1,"type":"integer"},"offset":{"default":0,"description":"Zero-based prediction-group offset.","examples":[0,20],"minimum":0,"type":"integer"},"page":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"description":"One-based page number. When supplied, overrides offset.","examples":[1]},"prediction_class":{"description":"Forecast production class: compiled_consensus, forecaster_survey, expectations_survey, market_implied, model_nowcast, central_bank_projection, institutional_projection or fxmacrodata.","type":["string","null"]},"as_of":{"description":"Historical publication cutoff with explicit timezone, or YYYY-MM-DD at UTC midnight. Later forecasts are excluded.","type":["string","null"]},"event_compatible_only":{"default":false,"description":"Restrict event-linked data to verified matching target periods, units and economic concepts. Native official_forecasts remain a separate section.","type":"boolean"},"pre_release_only":{"default":true,"description":"Require event-linked forecasts to have been generated before the announcement.","type":"boolean"},"official_limit":{"default":500,"description":"Maximum native-period official forecasts; 0 omits this section. Inspect official_forecasts_truncated.","maximum":2000,"minimum":0,"type":"integer"},"before_date":{"description":"Exclusive period-date cursor for event-linked groups; use the prior response's next_cursor.","type":["string","null"]},"seasonality":{"description":"Seasonal adjustment selector, matching the announcement series.","type":["string","null"]},"frequency":{"description":"Returned change basis selector, matching the announcement series.","type":["string","null"]},"annualization":{"description":"Annualization selector, matching the announcement series.","type":["string","null"]},"period_aggregation":{"description":"Period aggregation selector, matching the announcement series.","type":["string","null"]},"basis":{"description":"Real or nominal selector, matching the announcement series.","type":["string","null"]}},"required":["currency","indicator"]},"annotations":{"title":"Event Predictions","readOnlyHint":true,"destructiveHint":false,"openWorldHint":true},"definitionHash":"b9e63f9fc679f525693956d8e68888a9c9792c940d7fc344ea06813071755689","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T13:47:39.518Z","metadataTrust":"untrusted"},{"serverName":"io.github.fxmacrodata/fxmacrodata","endpointFingerprint":"4252b288953fde9d64ff47259e560b8618155a5d8ad98bef4714bad4e5927973","name":"forex","title":"FX Spot Rates","description":"Get raw historical FX spot-rate rows for a currency pair (e.g. EUR/USD) as a plain-text table, raw rows, exact values, or JSON-like data, without chart metadata. Daily official central-bank reference rates with multi-year history. Optional technical-indicator series (SMA, EMA, RSI, MACD, Bollinger Bands, etc.) are selected by comma-separated slugs in indicators; interval selects daily or intraday. Access: API key required, else returns subscription_required with a subscribe link.","inputSchema":{"type":"object","properties":{"base":{"description":"Base currency, 3-letter ISO code (case-insensitive). Supported: lowercase 3-letter catalogue currency, e.g. usd or eur.","examples":["eur","gbp","aud","usd"],"type":"string"},"quote":{"description":"Quote currency, 3-letter ISO code (case-insensitive). Supported: lowercase 3-letter catalogue currency, e.g. usd or eur.","examples":["usd","jpy","chf"],"type":"string"},"start_date":{"description":"Inclusive lower bound, YYYY-MM-DD. Defaults to ~5 years ago.","examples":["2024-06-30"],"type":["string","null"]},"end_date":{"description":"Inclusive upper bound, YYYY-MM-DD. Defaults to today.","examples":["2024-06-30"],"type":["string","null"]},"indicators":{"description":"Comma-separated technical-indicator slugs to attach to each row. Supported: adx_14, atr_14, bollinger_bands, cci_20, donchian_20, ema_12, ema_20, ema_200, ema_26, ema_50, macd, macd_histogram, macd_signal, rsi_14, sma_20, sma_200, sma_50, stochastic_14_3, williams_r_14, all.","examples":["sma_50,sma_200","rsi_14","ema_20,atr_14"],"type":["string","null"]},"interval":{"default":"daily","description":"daily (default): spot history. intraday: timestamped official intraday reference-rate fixings for the pair, bounded by start_time and end_time.","enum":["daily","intraday"],"type":"string"},"start_time":{"description":"intraday only: inclusive RFC 3339 lower bound.","examples":["2026-07-20T00:00:00Z"],"type":["string","null"]},"end_time":{"description":"intraday only: inclusive RFC 3339 upper bound.","type":["string","null"]}},"required":["base","quote"]},"annotations":{"title":"FX Spot Rates","readOnlyHint":true,"destructiveHint":false,"openWorldHint":true},"definitionHash":"7e442f4b6529324217ed86a34128613670264ee967327704c92e34d26a1475cf","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T13:47:39.518Z","metadataTrust":"untrusted"},{"serverName":"io.github.fxmacrodata/fxmacrodata","endpointFingerprint":"4252b288953fde9d64ff47259e560b8618155a5d8ad98bef4714bad4e5927973","name":"fx_backtest_task","title":"FX Backtest","description":"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. Access: API key required, else returns subscription_required with a subscribe link.","inputSchema":{"type":"object","properties":{"base":{"description":"Base currency, 3-letter ISO code. Supported: lowercase 3-letter catalogue currency, e.g. usd or eur.","examples":["eur","gbp","aud"],"type":"string"},"quote":{"description":"Quote currency, 3-letter ISO code. Supported: lowercase 3-letter catalogue currency, e.g. usd or eur.","examples":["usd","jpy","chf"],"type":"string"},"start_date":{"description":"Inclusive lower bound, YYYY-MM-DD.","examples":["2024-06-30"],"type":["string","null"]},"end_date":{"description":"Inclusive upper bound, YYYY-MM-DD.","examples":["2024-06-30"],"type":["string","null"]},"strategy":{"default":"carry_momentum","description":"Signal mode.","type":["string","null"],"enum":["carry","momentum","carry_momentum",null]},"momentum_lookback":{"default":5,"description":"Momentum lookback in observations for the momentum signal.","examples":[5,10,20],"type":["integer","null"]},"transaction_cost_bps":{"default":2,"description":"Per-side transaction cost in basis points applied on position changes.","examples":[1,2,5],"type":["number","null"]},"initial_capital":{"default":100000,"description":"Starting capital for equity-curve calculations.","examples":[10000,100000],"type":["number","null"]},"event_gated":{"default":false,"description":"When true, allow positions only after verified historical policy publications for either currency. This does not use future calendars or trade before a release.","examples":[true,false],"type":["boolean","null"]},"event_window_days":{"default":1,"description":"Additional calendar days after the first UTC decision following publication; 0 permits that first day only.","examples":[0,1,2],"type":["integer","null"]}},"required":["base","quote"]},"annotations":{"title":"FX Backtest","readOnlyHint":true,"destructiveHint":false,"openWorldHint":true},"definitionHash":"e5294d72874f1efde857a7917486d939d46acc8a98bf0bf4fa822017793e3e1a","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T13:47:39.518Z","metadataTrust":"untrusted"},{"serverName":"io.github.fxmacrodata/fxmacrodata","endpointFingerprint":"4252b288953fde9d64ff47259e560b8618155a5d8ad98bef4714bad4e5927973","name":"fx_trade_setup_task","title":"FX Trade Setup Analysis","description":"Build a trader-oriented FX pair setup using spot context, macro differentials, upcoming catalyst risk, and optional COT positioning. Set view for pair context only or a ranked event-risk score. Access: API key required, else returns subscription_required with a subscribe link.","inputSchema":{"type":"object","properties":{"base":{"description":"Base currency, 3-letter ISO code. Supported: lowercase 3-letter catalogue currency, e.g. usd or eur.","examples":["eur","gbp","aud"],"type":"string"},"quote":{"description":"Quote currency, 3-letter ISO code. Supported: lowercase 3-letter catalogue currency, e.g. usd or eur.","examples":["usd","jpy","chf"],"type":"string"},"horizon_events":{"description":"Maximum upcoming catalysts per leg to rank. Defaults to 4, or 6 for view='release_risk'.","examples":[3,4,6],"type":["integer","null"]},"include_cot":{"default":false,"description":"When true, attempt to include COT positioning context for both legs.","examples":[true,false],"type":["boolean","null"]},"view":{"default":"setup","description":"setup (default) builds the full trade setup. pair_intel returns spot, carry and policy-differential context. release_risk ranks upcoming event risk for the pair.","enum":["setup","pair_intel","release_risk"],"type":"string"},"start_date":{"description":"view='pair_intel' only: inclusive lower bound, YYYY-MM-DD.","examples":["2024-06-30"],"type":["string","null"]},"end_date":{"description":"view='pair_intel' only: inclusive upper bound, YYYY-MM-DD.","examples":["2024-06-30"],"type":["string","null"]}},"required":["base","quote"]},"annotations":{"title":"FX Trade Setup Analysis","readOnlyHint":true,"destructiveHint":false,"openWorldHint":true},"definitionHash":"97a748296bd8577a30132db1dcf8d760814c9b50d0bf3cd0106fbdcaae18f7a1","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T13:47:39.518Z","metadataTrust":"untrusted"},{"serverName":"io.github.fxmacrodata/fxmacrodata","endpointFingerprint":"4252b288953fde9d64ff47259e560b8618155a5d8ad98bef4714bad4e5927973","name":"geopolitical_event","title":"Geopolitical Event Details","description":"Full stored record of one official-source geopolitical event, by event_id, with separate incident, publication and capture dates; as_of returns it as known at a past cutoff. Access: API key required, else returns subscription_required with a subscribe link.","inputSchema":{"type":"object","properties":{"event_id":{"description":"Event ID from history results: exactly 64 lowercase hexadecimal characters.","type":"string"},"as_of":{"description":"Knowledge cutoff with timezone, e.g. 2024-06-30T23:59:59Z; omit for latest.","type":["string","null"]}},"required":["event_id"]},"annotations":{"title":"Geopolitical Event Details","readOnlyHint":true,"destructiveHint":false,"openWorldHint":true},"definitionHash":"1e6d2af6087c354e7c1d16d97beb78c08d6e1979a3cf5a39f70a569499ae6141","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T13:47:39.518Z","metadataTrust":"untrusted"},{"serverName":"io.github.fxmacrodata/fxmacrodata","endpointFingerprint":"4252b288953fde9d64ff47259e560b8618155a5d8ad98bef4714bad4e5927973","name":"geopolitical_event_reaction","title":"Geopolitical Event FX Context","description":"Precomputed FX reference-price moves for one currency pair around one geopolitical event, by event_id. Context only: not causation or a trading signal. Access: API key required, else returns subscription_required with a subscribe link.","inputSchema":{"type":"object","properties":{"event_id":{"description":"Event ID from history results: exactly 64 lowercase hexadecimal characters.","type":"string"},"pair":{"default":"EUR/USD","description":"Uppercase BASE/QUOTE currency pair, e.g. EUR/USD.","type":"string"},"as_of":{"description":"Knowledge cutoff with timezone, e.g. 2024-06-30T23:59:59Z; omit for latest.","type":["string","null"]}},"required":["event_id"]},"annotations":{"title":"Geopolitical Event FX Context","readOnlyHint":true,"destructiveHint":false,"openWorldHint":true},"definitionHash":"9fc66046574c781175f34d3075b54464e6d7aef889577486ba9f2cec88449b50","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T13:47:39.518Z","metadataTrust":"untrusted"},{"serverName":"io.github.fxmacrodata/fxmacrodata","endpointFingerprint":"4252b288953fde9d64ff47259e560b8618155a5d8ad98bef4714bad4e5927973","name":"geopolitical_event_revisions","title":"Geopolitical Event Revisions","description":"Every stored revision of one geopolitical event's source record, by event_id, showing how the publisher changed it over time; as_of limits it to what was known at a past cutoff. Access: API key required, else returns subscription_required with a subscribe link.","inputSchema":{"type":"object","properties":{"event_id":{"description":"Event ID from history results: exactly 64 lowercase hexadecimal characters.","type":"string"},"as_of":{"description":"Knowledge cutoff with timezone, e.g. 2024-06-30T23:59:59Z; omit for latest.","type":["string","null"]},"limit":{"default":50,"description":"Maximum rows per page, 1-100.","type":"integer"},"offset":{"default":0,"description":"Zero-based row offset; 0 starts the first page.","type":"integer"}},"required":["event_id"]},"annotations":{"title":"Geopolitical Event Revisions","readOnlyHint":true,"destructiveHint":false,"openWorldHint":true},"definitionHash":"d3f28a425fc969236d4b0ec638cdc778b8eef4b076966c9774ee8a286e086b41","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T13:47:39.518Z","metadataTrust":"untrusted"},{"serverName":"io.github.fxmacrodata/fxmacrodata","endpointFingerprint":"4252b288953fde9d64ff47259e560b8618155a5d8ad98bef4714bad4e5927973","name":"geopolitical_history","title":"Geopolitical Event History","description":"Search stored official sanctions (OFAC) and maritime-security (UKMTO) records by source, country, date or text. Each row carries the event_id the other geopolitical tools take and its revision history. Paged with limit and offset. Access: API key required, else returns subscription_required with a subscribe link.","inputSchema":{"type":"object","properties":{"source_id":{"description":"Official source ID from source coverage, e.g. ofac_actions; omit for all sources.","type":["string","null"]},"country":{"description":"Uppercase ISO 3166-1 alpha-2 country link, e.g. US; omit for all countries.","type":["string","null"]},"subtype":{"description":"Exact source-record subtype from history results; omit for all subtypes.","type":["string","null"]},"include_undated":{"default":false,"description":"Retain undated records when start_date or end_date filters are supplied.","type":"boolean"},"date_basis":{"default":"publication","description":"Which date start_date and end_date filter on.","enum":["occurrence","publication","effective","captured","publisher_update","issue"],"type":"string"},"start_date":{"description":"Inclusive lower date bound, YYYY-MM-DD, e.g. 2024-01-01.","type":["string","null"]},"end_date":{"description":"Inclusive upper date bound, YYYY-MM-DD, e.g. 2024-12-31.","type":["string","null"]},"as_of":{"description":"Knowledge cutoff with timezone, e.g. 2024-06-30T23:59:59Z; omit for latest.","type":["string","null"]},"search":{"description":"Text filter, at most 160 characters, e.g. sanctions.","type":["string","null"]},"after_revision":{"default":0,"description":"Return revisions newer than this non-negative watermark; 0 disables the incremental filter.","type":"integer"},"limit":{"default":50,"description":"Maximum rows per page, 1-100.","type":"integer"},"offset":{"default":0,"description":"Zero-based row offset; 0 starts the first page.","type":"integer"}}},"annotations":{"title":"Geopolitical Event History","readOnlyHint":true,"destructiveHint":false,"openWorldHint":true},"definitionHash":"936ecf2e779c3ac56d6bbef5f4bdbb3a68fe9e735e288980211786245c3cc1a7","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T13:47:39.518Z","metadataTrust":"untrusted"},{"serverName":"io.github.fxmacrodata/fxmacrodata","endpointFingerprint":"4252b288953fde9d64ff47259e560b8618155a5d8ad98bef4714bad4e5927973","name":"geopolitical_sources","title":"Geopolitical Source Coverage","description":"Lists the official geopolitical sources held: source_id values, record counts, collection outcomes and coverage limits. Takes no arguments. Access: API key required, else returns subscription_required with a subscribe link.","inputSchema":{"type":"object","properties":{}},"annotations":{"title":"Geopolitical Source Coverage","readOnlyHint":true,"destructiveHint":false,"openWorldHint":true},"definitionHash":"5094d84a28fb9e8dda04e04246f83dfbe785a1105d3dace18d68fe7e66cdf429","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T13:47:39.518Z","metadataTrust":"untrusted"},{"serverName":"io.github.fxmacrodata/fxmacrodata","endpointFingerprint":"4252b288953fde9d64ff47259e560b8618155a5d8ad98bef4714bad4e5927973","name":"indicator_query","title":"Indicator Time Series","description":"Returns one currency/indicator's persisted official-producer history using catalogue identifiers. Rows contain `date` (reference period), numeric `val` and separate publication evidence; no chart metadata. `as_of` selects historically eligible values; current values may include revisions. Newest-first pagination: default 100 rows with `start_date`, otherwise 20; `limit` maximum 100. When `pagination.has_more`, `partial_page.next_call` contains next-page arguments; `partial_page.pages_remaining` counts remaining pages. Official-only by default; prohibited private aggregator rows are always removed. Access: USD needs no API key; other currencies return subscription_required with a subscribe link.","inputSchema":{"type":"object","properties":{"currency":{"description":"3-letter ISO currency code (case-insensitive). Optional if `slug` is provided as a `\"usd:cpi\"`-style compound. Supported: lowercase 3-letter catalogue currency, e.g. usd or eur.","examples":["usd","eur"],"type":["string","null"]},"indicator":{"description":"Indicator slug for the given currency. Optional if `slug` is provided as a `\"usd:cpi\"`-style compound. Supported: catalogue indicator slug, e.g. inflation or policy_rate.","examples":["policy_rate","inflation"],"type":["string","null"]},"start_date":{"description":"Inclusive lower bound, YYYY-MM-DD.","examples":["2024-06-30"],"type":["string","null"]},"end_date":{"description":"Inclusive upper bound, YYYY-MM-DD.","examples":["2024-06-30"],"type":["string","null"]},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"description":"Rows per page, newest first, maximum 100. Unset means 100 when `start_date` is set, otherwise 20.","examples":[1,100]},"offset":{"default":0,"description":"Zero-based row offset after most-recent-first ordering. Take it from `partial_page.next_call`.","examples":[0,1000],"minimum":0,"type":"integer"},"page":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"description":"One-based page number. When supplied, the REST endpoint derives offset as `(page - 1) * limit`.","examples":[1,2]},"slug":{"description":"Optional compound `\"<currency>:<indicator>\"` slug (e.g. `\"usd:cpi\"`, `\"jpy:policy_rate\"`). Many small / open tool-calling models concatenate the two parts anyway. When supplied, overrides `currency` and `indicator`.","examples":["usd:cpi","jpy:policy_rate","eur:gdp"],"type":["string","null"]},"official_only":{"default":true,"description":"When true, return only official-source rows and remove explicit fallback observations. Prohibited private aggregator rows are always removed.","examples":[true],"type":"boolean"},"as_of":{"description":"Historical decision cutoff with explicit timezone, or YYYY-MM-DD at UTC midnight; verifies vintages before returning rows.","type":["string","null"]},"availability":{"default":"public","description":"Replay clock, used with as_of.","enum":["public","captured"],"type":"string"},"dataset_version":{"description":"Optional content version; use the first page's version on subsequent pages to reject changed data.","type":["string","null"]},"revisions":{"description":"Revision view: latest, first, final or all. Historical replay uses latest among vintages eligible at as_of.","type":["string","null"]},"series_mode":{"description":"Series mode. Historical replay defaults to raw.","type":["string","null"],"enum":["canonical","raw",null]},"value_mode":{"description":"Value mode. Historical replay defaults to unchanged source values and requires raw series mode.","type":["string","null"],"enum":["normalized","source",null]},"base":{"description":"Index or price base, such as 2024. `supported_options.base` lists the values for this indicator; each base is a separate official series and bases are never joined.","examples":["2024"],"type":["string","null"]},"date_basis":{"description":"Observation-date convention. Use only a value listed by this indicator's supported_options.date_basis; each convention reads a separate stored series without re-dating observations.","type":["string","null"],"enum":["effective_date","meeting_date",null]},"factor":{"description":"Instead of an indicator, return a precomputed macro factor score for `currency`, for example monetary_stance.","examples":["monetary_stance"],"type":["string","null"]},"include_components":{"description":"factor only: include the stored component scores.","type":["boolean","null"]},"include_sources":{"description":"factor only: include source endpoint references.","type":["boolean","null"]}}},"annotations":{"title":"Indicator Time Series","readOnlyHint":true,"destructiveHint":false,"openWorldHint":true},"definitionHash":"adee2696107452c4e22e65cb3b8453eca35b853334d347fbfcec0076deed2600","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T13:47:39.518Z","metadataTrust":"untrusted"},{"serverName":"io.github.fxmacrodata/fxmacrodata","endpointFingerprint":"4252b288953fde9d64ff47259e560b8618155a5d8ad98bef4714bad4e5927973","name":"latest_announcements","title":"Latest Macro Announcements","description":"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 ingestion evidence as unknown, and latency as not measured. Access: USD needs no API key; other currencies return subscription_required with a subscribe link.","inputSchema":{"type":"object","properties":{"currency":{"description":"3-letter ISO currency code (case-insensitive). Required for the latest view.","examples":["usd","eur"],"type":["string","null"]},"view":{"default":"latest","description":"latest (default): newest value per indicator for `currency`. changes: a resumable feed of newly ingested announcements across currencies; pass the returned next_cursor back as `since`.","enum":["latest","changes"],"type":"string"},"currencies":{"description":"changes only: comma-separated codes, `g10` or `all`.","examples":["usd,eur","g10"],"type":["string","null"]},"indicators":{"description":"changes only: comma-separated indicator slugs.","type":["string","null"]},"since":{"description":"changes only: previous next_cursor, ISO 8601 time or epoch seconds.","type":["string","null"]},"limit":{"anyOf":[{"maximum":500,"minimum":1,"type":"integer"},{"type":"null"}],"description":"changes only: page size, default 100."},"payload":{"description":"changes only: compact (default) or full rows.","type":["string","null"],"enum":["compact","full",null]}}},"annotations":{"title":"Latest Macro Announcements","readOnlyHint":true,"destructiveHint":false,"openWorldHint":true},"definitionHash":"817e9d73aa2c98fea990995593dee192ffed158638abf8bdbf344b1ce6889e56","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T13:47:39.518Z","metadataTrust":"untrusted"},{"serverName":"io.github.fxmacrodata/fxmacrodata","endpointFingerprint":"4252b288953fde9d64ff47259e560b8618155a5d8ad98bef4714bad4e5927973","name":"macro_briefing_task","title":"Macro Briefing","description":"Macro research or checkpointed morning changes across supported economic series. Access: USD needs no API key; other currencies return subscription_required with a subscribe link.","inputSchema":{"type":"object","properties":{"currency":{"description":"Catalogue currency code; optional for spoken. Morning uses currencies instead.","examples":["usd","eur"],"type":["string","null"]},"depth":{"default":"brief","description":"brief: currency summary; indicator: trend and catalysts; regime: macro regime; research_pack: indicator context; spoken: news to read aloud; morning: changes since last brief.","enum":["brief","indicator","regime","research_pack","spoken","morning"],"type":"string"},"indicator":{"description":"Catalogue slug; required for indicator and research_pack depths.","examples":["inflation","policy_rate"],"type":["string","null"]},"base":{"description":"research_pack only: pair base currency.","examples":["eur","gbp"],"type":["string","null"]},"quote":{"description":"research_pack only: pair quote currency.","examples":["usd","jpy"],"type":["string","null"]},"start_date":{"description":"History lower bound YYYY-MM-DD; ignored by brief, spoken, morning.","examples":["2024-06-30"],"type":["string","null"]},"end_date":{"description":"History upper bound YYYY-MM-DD; ignored by brief, spoken, morning.","examples":["2024-06-30"],"type":["string","null"]},"currencies":{"anyOf":[{"items":{"type":"string"},"maxItems":10,"type":"array"},{"type":"null"}],"description":"morning: 1-10 customer currency codes from data_catalogue, required.","examples":[["usd","eur"]]},"timezone":{"description":"morning: customer IANA timezone, required.","examples":["Australia/Sydney"],"type":["string","null"]},"checkpoint":{"anyOf":[{"maxLength":160000,"type":"string"},{"type":"null"}],"description":"morning: next_checkpoint from last delivered brief; omit initially for baseline."},"since":{"description":"morning: last-delivery ISO 8601 with UTC offset; only without checkpoint.","examples":["2026-11-13T07:00:00+11:00"],"type":["string","null"]}}},"annotations":{"title":"Macro Briefing","readOnlyHint":true,"destructiveHint":false,"openWorldHint":true},"definitionHash":"f2d1360c28800d957c4cce1aa76e3ab0ab7fd456b2d56243c7903148e7f6fe0f","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T13:47:39.518Z","metadataTrust":"untrusted"},{"serverName":"io.github.fxmacrodata/fxmacrodata","endpointFingerprint":"4252b288953fde9d64ff47259e560b8618155a5d8ad98bef4714bad4e5927973","name":"macro_heatmap_task","title":"Macro Heatmap","description":"Build a macro heatmap, pair cockpit or Macro Monitor. Access: USD needs no API key; other currencies return subscription_required with a subscribe link.","inputSchema":{"type":"object","properties":{"currencies":{"description":"Comma-separated 3-letter currency codes (lowercase preferred). Supported values include: lowercase 3-letter catalogue currency, e.g. usd or eur.","examples":["usd,eur,gbp,jpy","aud,cad,chf,nzd","usd,sek,nok,pln"],"type":["string","null"]},"indicators":{"description":"Comma-separated indicator slugs to include in the matrix. Supported values include: catalogue indicator slug, e.g. inflation or policy_rate.","examples":["policy_rate,inflation,gdp","inflation,unemployment,retail_sales"],"type":["string","null"]},"start_date":{"description":"Optional inclusive lower bound, YYYY-MM-DD.","examples":["2024-06-30"],"type":["string","null"]},"end_date":{"description":"Optional inclusive upper bound, YYYY-MM-DD.","examples":["2024-06-30"],"type":["string","null"]},"mode":{"default":"heatmap","description":"heatmap: cross-currency matrix; war_room: single-pair cockpit; monitor: histories, FX, coverage and releases.","enum":["heatmap","war_room","monitor"],"type":"string"},"base":{"description":"mode='war_room' only: pair base currency, 3-letter code.","examples":["eur","gbp"],"type":["string","null"]},"quote":{"description":"mode='war_room' only: pair quote currency. Defaults to usd.","examples":["usd","jpy"],"type":["string","null"]},"currency":{"description":"mode='war_room' only: spotlight currency. Defaults to usd.","examples":["usd","eur"],"type":["string","null"]},"indicator":{"description":"mode='war_room' only: spotlight indicator. Defaults to inflation.","examples":["inflation","policy_rate"],"type":["string","null"]},"timezone":{"default":"UTC","description":"Monitor display timezone, an IANA name.","examples":["UTC","Australia/Sydney"],"type":"string"}}},"annotations":{"title":"Macro Heatmap","readOnlyHint":true,"destructiveHint":false,"openWorldHint":true},"definitionHash":"dcf44826a21be289e073f1a4726ced07f82daf0f2cc99f48621ed51ee5b89730","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T13:47:39.518Z","metadataTrust":"untrusted"},{"serverName":"io.github.fxmacrodata/fxmacrodata","endpointFingerprint":"4252b288953fde9d64ff47259e560b8618155a5d8ad98bef4714bad4e5927973","name":"macro_news","title":"Macro News","description":"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 when a headline is classifiable. Supported currencies: lowercase 3-letter catalogue currency, e.g. usd or eur. Access: USD needs no API key; other currencies return subscription_required with a subscribe link.","inputSchema":{"type":"object","properties":{"currency":{"description":"3-letter ISO currency code (case-insensitive). Supported: lowercase 3-letter catalogue currency, e.g. usd or eur.","examples":["usd","eur"],"type":"string"},"lookback_days":{"default":7,"description":"Maximum age of returned headlines in calendar days when headline timestamps are available.","examples":[7,30],"maximum":90,"minimum":1,"type":"integer"},"limit":{"default":20,"description":"Maximum number of headline rows to request.","examples":[10,20],"maximum":50,"minimum":1,"type":"integer"},"offset":{"default":0,"description":"Zero-based headline offset.","examples":[0],"minimum":0,"type":"integer"}},"required":["currency"]},"annotations":{"title":"Macro News","readOnlyHint":true,"destructiveHint":false,"openWorldHint":true},"definitionHash":"bfa7f5538693fec0595d3a37b50e57e91cd33c3862101290d366d77f556f2e15","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T13:47:39.518Z","metadataTrust":"untrusted"},{"serverName":"io.github.fxmacrodata/fxmacrodata","endpointFingerprint":"4252b288953fde9d64ff47259e560b8618155a5d8ad98bef4714bad4e5927973","name":"market_sessions","title":"FX Market Sessions","description":"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 a specific moment instead of now. Accounts for weekends and major banking holidays. Access: free, no API key required.","inputSchema":{"type":"object","properties":{"at":{"description":"Optional ISO-8601 UTC timestamp; defaults to now. Use to snapshot session state at a specific moment.","examples":["2025-06-15T13:30:00Z","2025-12-25T00:00:00Z"],"type":["string","null"]}}},"annotations":{"title":"FX Market Sessions","readOnlyHint":true,"destructiveHint":false,"openWorldHint":true},"definitionHash":"4fccf267f44b51eb33f2740fe64b75b1e417ffe7589f097bf75e7a4f859931a0","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T13:47:39.518Z","metadataTrust":"untrusted"},{"serverName":"io.github.fxmacrodata/fxmacrodata","endpointFingerprint":"4252b288953fde9d64ff47259e560b8618155a5d8ad98bef4714bad4e5927973","name":"mcp_capabilities","title":"MCP Capabilities","description":"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 showing, or how to get the same result in a different interface.","inputSchema":{"type":"object","properties":{"topic":{"default":"overview","description":"overview (default) explains tools, visuals and access; auth explains whether to use OAuth, an API key or a bearer token for a given client.","enum":["overview","auth"],"type":"string"}}},"annotations":{"title":"MCP Capabilities","readOnlyHint":true,"destructiveHint":false,"openWorldHint":true},"definitionHash":"1f6df3122a37295532d0f68756450a605c246387ce2e1eebe5ef5cd77aaad0d3","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T13:47:39.518Z","metadataTrust":"untrusted"},{"serverName":"io.github.fxmacrodata/fxmacrodata","endpointFingerprint":"4252b288953fde9d64ff47259e560b8618155a5d8ad98bef4714bad4e5927973","name":"organisation_search","title":"Find FX Industry Organisations","description":"Find 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 database. Access: public directory references, no API key required.","inputSchema":{"type":"object","properties":{"query":{"description":"Organisation name or service search, 2-120 characters, e.g. currency exchange.","type":"string"},"category":{"description":"Exact business category ID from directory results; omit to search all categories.","type":["string","null"]},"limit":{"default":10,"description":"Maximum directory references, 1-10.","type":"integer"}},"required":["query"]},"annotations":{"title":"Find FX Industry Organisations","readOnlyHint":true,"destructiveHint":false,"openWorldHint":true},"definitionHash":"da053906e8f634d5041356a74778ebe9eecefa8cebb171d25c7fa49e876952ba","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T13:47:39.518Z","metadataTrust":"untrusted"},{"serverName":"io.github.fxmacrodata/fxmacrodata","endpointFingerprint":"4252b288953fde9d64ff47259e560b8618155a5d8ad98bef4714bad4e5927973","name":"ping","title":"Ping","description":"Health check that confirms the FXMacroData API and MCP server are reachable. Returns the API health response.","inputSchema":{"type":"object","properties":{}},"annotations":{"title":"Ping","readOnlyHint":true,"destructiveHint":false,"openWorldHint":true},"definitionHash":"45dfb28e2488f3cd772cc884081e94b84244d39a76bdb3386299f5472147f192","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T13:47:39.518Z","metadataTrust":"untrusted"},{"serverName":"io.github.fxmacrodata/fxmacrodata","endpointFingerprint":"4252b288953fde9d64ff47259e560b8618155a5d8ad98bef4714bad4e5927973","name":"plot_visual_artifact","title":"Plot Chart","description":"Build a generic MCP Apps chart: single or multi-series charts, including actual-vs-consensus views combining announcements with predictions. Rate-differential plots show both policy rates and their spread. Charts FXMacroData data only; no arbitrary URLs or custom code. Access: USD needs no API key; other currencies return subscription_required with a subscribe link.","inputSchema":{"type":"object","properties":{"query":{"description":"Optional natural-language request to preserve in the payload title/context.","examples":["plot USD policy-rate midpoint actual vs market consensus","compare AUD and USD inflation"],"type":["string","null"]},"series":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"description":"Optional list of series specs. Each spec supports `source` (announcements, predictions, forex, commodities, cot), `currency`, `indicator`, `base`, `quote`, `label`, `y_key`, `metric`, `prediction_class`, `prediction_source`, `start_date`, `end_date`, `limit`, `offset`, and `page`.","examples":[[{"currency":"usd","indicator":"policy_rate_midpoint","label":"USD policy midpoint actual","source":"announcements"},{"currency":"usd","indicator":"policy_rate_midpoint","label":"Dealer survey median","prediction_class":"forecaster_survey","source":"predictions"}]]},"source":{"description":"Single-series source when `series` is omitted. Supported values: announcements, predictions, forex, commodities, cot, rate_differential (needs base and quote).","examples":["announcements","forex","rate_differential"],"type":["string","null"]},"currency":{"description":"Single-series currency for announcements, predictions, or COT. Supported macro currencies: lowercase 3-letter catalogue currency, e.g. usd or eur. Supported COT currencies: AUD, CAD, CHF, EUR, GBP, JPY, MXN, NZD, USD, XAU.","examples":["usd","eur"],"type":["string","null"]},"indicator":{"description":"Single-series indicator for announcements, predictions, or commodities. Supported macro indicators: catalogue indicator slug, e.g. inflation or policy_rate. Supported commodity indicators: crude_oil_inventories, crude_oil_stocks, distillate_inventories, distillate_stocks, gasoline_inventories, gasoline_stocks, gold, natural_gas, natural_gas_storage, natural_gas_storage_level, oil_brent, oil_wti, platinum, silver.","examples":["policy_rate","inflation"],"type":["string","null"]},"base":{"description":"Base currency for single-series forex plots. Supported: lowercase 3-letter catalogue currency, e.g. usd or eur.","examples":["eur","aud","usd"],"type":["string","null"]},"quote":{"description":"Quote currency for single-series forex plots. Supported: lowercase 3-letter catalogue currency, e.g. usd or eur.","examples":["usd","jpy","chf"],"type":["string","null"]},"prediction_type":{"description":"Optional legacy prediction-type filter for prediction series. Superseded by prediction_class.","examples":["fxmacrodata"],"type":["string","null"]},"prediction_source":{"description":"Optional prediction source filter for prediction series.","examples":["ny_fed_sme","philly_fed_spf"],"type":["string","null"]},"x_axis":{"default":"date","description":"Field to use as the shared x-axis. Supported: date, announcement_datetime, announcement_datetime_local, generated_at, observation_datetime.","examples":["date","announcement_datetime"],"type":"string"},"y_key":{"description":"Single-series metric field. Defaults by source: val for announcements and commodities, predicted_value for predictions, rate for forex, noncommercial_net for COT.","examples":["val","predicted_value","rate"],"type":["string","null"]},"y_label":{"description":"Optional y-axis label for the chart.","examples":["Policy Rate Midpoint","Value"],"type":["string","null"]},"title":{"description":"Optional chart title. Defaults to query or an auto-generated title.","examples":["USD policy-rate actual vs consensus"],"type":["string","null"]},"chart_kind":{"default":"line","description":"Initial chart view. Supported: line, area, bar, dot, step.","examples":["line","step"],"type":"string"},"start_date":{"description":"Inclusive lower bound, YYYY-MM-DD.","examples":["2024-06-30"],"type":["string","null"]},"end_date":{"description":"Inclusive upper bound, YYYY-MM-DD.","examples":["2024-06-30"],"type":["string","null"]},"limit":{"default":20,"description":"Maximum rows per source. Defaults to 20; maximum 100.","examples":[20,100],"maximum":100,"minimum":1,"type":"integer"},"offset":{"default":0,"description":"Zero-based row offset per source.","examples":[0,20],"minimum":0,"type":"integer"},"page":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"description":"One-based page number per source.","examples":[1]}}},"annotations":{"title":"Plot Chart","readOnlyHint":true,"destructiveHint":false,"openWorldHint":true},"definitionHash":"ed7221e8b9a136c7342e3bc4f695d48054f7dc8f8975ec4b5cca59a09d754b95","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T13:47:39.518Z","metadataTrust":"untrusted"}],"endpoints":[{"endpointFingerprint":"4252b288953fde9d64ff47259e560b8618155a5d8ad98bef4714bad4e5927973","protocol":"streamable-http","status":"indexed","toolCount":50,"observedAt":"2026-11-19T13:47:39.518Z"}],"authentication":"unknown"},"connectionConfigurations":{"status":"ready","authentication":"not embedded","clients":{"Claude Desktop":{"mcpServers":{"io.github.fxmacrodata/fxmacrodata":{"url":"https://fxmacrodata.com/mcp"}}},"Cursor":{"mcpServers":{"io.github.fxmacrodata/fxmacrodata":{"url":"https://fxmacrodata.com/mcp"}}},"VS Code":{"servers":{"io.github.fxmacrodata/fxmacrodata":{"type":"http","url":"https://fxmacrodata.com/mcp"}}}}},"resourceType":"mcp-server","callable":true,"runtime":{"callable":true,"protocols":["mcp"]},"interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://fxmacrodata.com/mcp"}],"profile":{"apiVersion":"1","schemaVersion":"1","id":"mcp-server:io.github.fxmacrodata%2Ffxmacrodata","resourceType":"mcp-server","canonicalUrl":"https://www.agentsjunction.com/api/v1/servers/io.github.fxmacrodata%2Ffxmacrodata","name":"io.github.fxmacrodata/fxmacrodata","description":"Macroeconomic and FX time-series data for AI agents: indicators, calendars, COT, forex, commodities.","interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://fxmacrodata.com/mcp"}],"capabilities":[],"identity":{"source":"official-registry","websiteUrl":"https://fxmacrodata.com","repositoryUrl":"https://github.com/fxmacrodata/fxmacrodata","version":"1.0.1"},"verification":{"state":"official","confidence":100},"operations":{"resourceType":"mcp-server","name":"io.github.fxmacrodata/fxmacrodata","status":"online","lastCheckedAt":"2026-11-20T04:17:08.611Z","lastSuccessfulCheck":"2026-11-20T04:17:08.611Z","latencyMs":128,"consecutiveFailures":0,"isStale":false,"checks":{"endpointReachable":true,"protocolValid":true,"agentCardValid":null,"mcpHandshakeValid":true},"lastSeen":null,"lastSuccessfulInteraction":null,"lastHealthCheck":"2026-11-20T04:17:08.611Z","source":{"type":"health-check","url":null},"observedAt":"2026-11-20T04:17:08.611Z"},"security":null,"timestamps":{"createdAt":"2026-04-10T14:24:50.828Z","updatedAt":"2026-04-10T14:24:50.828Z","observedAt":"2026-11-20T04:17:08.611Z"},"compatibility":{"serverVersion":"1.0.1","protocolVersions":[{"protocol":"mcp","version":null}]}}}}