Server definition
- Hash
- sha256:c778e4837f996dc83f81c970ceed7dc90793f1eda754644bcc4362af775cb1c3
- What it is
- What a remote MCP server returned when asked what it offers: 50 tools
The blob, as servednamed by its sha256
{
"instructions": "FXMacroData is a read-only MCP server for official-source FX, macroeconomic, and central-bank data across 22 production catalogue currencies: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD. Search this server when the user asks about currency pairs, FX spot rates, policy rates, CPI/inflation, GDP, unemployment, payrolls/NFP, PCE/PPI, retail sales, trade balance, current account, bond yields, commodities, COT positioning, FX sessions, economic calendars, central-bank decisions, or macro event risk.\n\nACCESS MODEL - read this before choosing a tool. Without an API key only USD is available: USD announcements, USD catalogue discovery, USD official news, and the USD release calendar. Every other currency, plus FX rates, COT, commodities, predictions, visual artifacts and the *_task tools, returns a subscription_required result until the user connects a key. Without a key, USD announcement data is also delivered on a 15-minute delay: a release becomes readable 15 minutes after it is published, and the result carries a freemium_delay object naming the cutoff and when a withheld release becomes available. When that object reports a withheld release, say so plainly - the number exists and has been published, the free tier just cannot show it yet - and offer the subscribe link rather than presenting the older value as current. A connected key removes the delay. When the user has not connected a key and asks about a non-USD currency, first answer the equivalent USD question to show the data is real, then tell them the currency they asked for needs a subscription and give them the subscribe link from the tool result. Never describe a subscription_required result as the data being unavailable, missing, or broken - it means the data exists and is behind a subscription. Call subscribe_for_mcp_access when the user wants to unlock it. One exception to the USD-only rule: prediction_coverage answers for every currency without a key, because it carries only the forecast catalogue - which publisher covers which indicator, what class of forecast it is, and how far the archive runs - and never a forecast value. Call it before event_predictions whenever the user asks whether a consensus or forecast exists for a release, and whenever event_predictions comes back empty or subscription_required: it is the only way to tell 'no publisher produces this for anybody, on any plan' from 'this exists and needs a subscription'.\n\nUse mcp_capabilities when a user asks what this server can do, which tools work in their interface, or why a visual did not render. Use mcp_auth_guide when a user asks whether to use OAuth, bearer tokens, or API keys for a specific MCP client. Use data_catalogue first to discover valid indicator slugs. Use indicator_query for exact rows, tables, JSON, or point-in-time values; release_calendar for exact upcoming release rows; event_predictions for consensus/forecast rows to join with release events; macro_news for recent official central-bank headlines; release_calendar_visual_artifact for app-rendered economic calendars; forex for spot-rate history; seasonality for monthly FX or XAU/USD return seasonality; market_sessions for current FX sessions; cot_data for CFTC positioning; commodities for supported energy and precious-metals series. Use plot_visual_artifact for generic plots, multi-series charts, or actual-vs-consensus charts that combine announcements with predictions. Prefer *_visual_artifact tools by default for time-series answers. For prompts like show me, tell me, chart, compare, explain, or last 30 days, prefer the visual artifact tool for that data family. Prefer release_calendar_visual_artifact for economic calendar display requests when the host supports MCP Apps; use release_calendar when the user explicitly wants raw calendar rows. Use *_task tools for analysis, replay, model, backtest, score risk, build a research pack, or summarize a multi-day trend request.\n\nNormalize currency codes to lowercase 3-letter codes and dates to YYYY-MM-DD. Map country names to currencies when obvious. Interpret common trader shorthand aggressively: aud l30d price = AUD/USD over the last 30 days. eurusd ytd -> EUR/USD year-to-date FX series; xauusd seasonality -> seasonality for the stored gold/USD series; jpy cot -> latest JPY COT positioning. Interpret shorthand such as eurusd, audusd, usdjpy, xauusd, l30d, ytd, mom, qoq, yoy, cpi, nfp, pce, ppi, cot, fed rate, ecb rate, boj rate, carry, hawkish, and dovish. If the user gives a single currency plus a price-style request, assume the FX pair versus USD. Only prefer the plain data tools when the user explicitly asks for a table, raw rows, JSON, or exact point-in-time values. Do not invent macro values; if data is unavailable, say so. Use announcement_datetime for point-in-time reasoning.\n\nAuth: USD announcement data, USD catalogue discovery, USD official news, and the USD release calendar are public. OAuth is preferred only when the MCP host performs an OAuth flow, and FXMacroData OAuth authorization requires a valid API key so the access token maps to the customer's plan. API-key query and bearer fallbacks are supported for private local clients. Non-USD catalogue, calendar, indicators, COT, commodities, analytics, and app visuals require a paid API key. When a host does not render MCP Apps, rely on each tool's plain text fallback and structuredContent instead of telling the user the data is unavailable.\n\nTool routing. Discovery: always call data_catalogue(currency) first when the user asks about a country's macro data; it returns the exact indicator slugs for indicator_query, indicator_visual_artifact, release_calendar, release_calendar_visual_artifact and event_predictions. Check its coverage rows before calling indicator_query: stale, partial or unavailable rows are not suitable for real-time carry or inflation analysis. Use latest_announcements for a compact current snapshot after data_catalogue has confirmed coverage. Visual versus plain: indicator_visual_artifact, forex_visual_artifact, commodities_visual_artifact, cot_visual_artifact and release_calendar_visual_artifact are the default for show, tell, explain, compare, trend or recent-window requests (for example 'show me AUD/USD', 'how has EUR/USD moved recently', 'show me the AUD release calendar'). Fall back to indicator_query, forex, commodities, cot_data or release_calendar only when the user explicitly asks for a raw table, plain text, JSON, CSV-style output or exact rows; forex is also the tool for technical-indicator series without a chart. For broad visual histories, page with limit, offset or page and pagination.next_offset rather than retrying with shorter windows. plot_visual_artifact is the tool for actual-vs-consensus charts that combine announcements with event_predictions. Pagination and point-in-time: indicator_query returns one page per call; when pagination.has_more is true, call indicator_query again with exactly the arguments in partial_page.next_call and repeat until has_more is false. Use known_at_time_task for a complete, verified historical slice as known at a timestamp. For announcement_changes, pass the returned next_cursor as since on the next call instead of holding a streaming call open. Calendar: release_calendar returns future releases only when unbounded; do not show stale past rows unless the user asks for historical calendar data. Pass start_date and end_date when the user names a month, week, day or date range, and timezone when they ask for local times. Present the returned markdown agenda or the Release Calendar App; do not summarize a calendar result as only a row count. Forecasts: use event_predictions with release_calendar and indicator_query for actual-vs-consensus, prior-vs-forecast or event-surprise context. Never report a pair listed by prediction_coverage as unavailable. News: use macro_news for headline context with derived sentiment and press_releases when the original official release rows matter. FX reference rates: call fx_reference_sources or fx_reference_universe before fx_intraday_reference_rates to verify pair and source availability. Other routing: latest_commodities is the batch snapshot and commodities the history; macro_factor gives a documented factor value, not a substitute for inspecting its underlying releases; when explaining rate_differentials, use the returned measure, rate type, curve family and tenor; use risk_sentiment for cross-asset regime context before classifying high-beta, safe-haven, commodity or USD-defensive FX conditions; use seasonality for month-of-year patterns, market_sessions for is-the-market-open questions, and cot_data for speculator positioning. Use ping only if other tools fail unexpectedly; it is not needed before normal calls.",
"tools": [
{
"description": "Poll recently ingested macro announcement changes with a resumable cursor. This is the bounded, MCP-safe counterpart to the release-event stream: the returned next_cursor is accepted as `since` on a later call, so polling resumes without holding a streaming invocation open. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.",
"inputSchema": {
"properties": {
"currencies": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional comma-separated currency codes, `g10`, or `all`. Without subscriber access, results are limited to the public scope.",
"examples": [
"usd,eur",
"g10"
]
},
"indicators": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional comma-separated announcement indicator slugs.",
"examples": [
"inflation,policy_rate"
]
},
"limit": {
"default": 100,
"description": "Maximum matching change events to return.",
"examples": [
50,
100
],
"maximum": 500,
"minimum": 1,
"type": "integer"
},
"payload": {
"default": "compact",
"description": "Event payload shape: compact trigger rows or full announcement rows.",
"examples": [
"compact",
"full"
],
"type": "string"
},
"since": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional previous next_cursor, ISO 8601 timestamp, or Unix epoch seconds.",
"examples": [
"2026-07-21T00:00:00Z"
]
}
},
"title": "announcement_changesArguments",
"type": "object"
},
"name": "announcement_changes",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "announcement_changesOutput",
"type": "object"
}
},
{
"description": "Get historical price series for supported commodity indicators using the exact slugs advertised by this schema. Requires an API key. Supported indicators: crude_oil_inventories, gold, natural_gas, natural_gas_storage, oil_brent, oil_wti, platinum, silver. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.",
"inputSchema": {
"properties": {
"end_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Inclusive upper bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
},
"indicator": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Commodity indicator slug. Supported: crude_oil_inventories, gold, natural_gas, natural_gas_storage, oil_brent, oil_wti, platinum, silver.",
"examples": [
"crude_oil_inventories",
"gold",
"natural_gas",
"natural_gas_storage",
"oil_brent",
"oil_wti"
]
},
"start_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Inclusive lower bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
},
"symbol": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Backward-compatible alias for `indicator`, which supersedes it in new calls.",
"examples": [
"crude_oil_inventories",
"gold",
"natural_gas",
"natural_gas_storage",
"oil_brent",
"oil_wti"
]
}
},
"title": "commoditiesArguments",
"type": "object"
},
"name": "commodities",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "commoditiesOutput",
"type": "object"
}
},
{
"description": "Returns commodity price history with MCP Apps chart metadata so compatible clients render an interactive commodity chart inline. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.",
"inputSchema": {
"properties": {
"end_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Inclusive upper bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
},
"indicator": {
"description": "Commodity indicator slug. Supported: crude_oil_inventories, gold, natural_gas, natural_gas_storage, oil_brent, oil_wti, platinum, silver.",
"examples": [
"crude_oil_inventories",
"gold",
"natural_gas",
"natural_gas_storage",
"oil_brent",
"oil_wti"
],
"type": "string"
},
"start_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Inclusive lower bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
}
},
"required": [
"indicator"
],
"title": "commodities_visual_artifactArguments",
"type": "object"
},
"name": "commodities_visual_artifact",
"outputSchema": null
},
{
"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. Requires an API key. Supported currencies: AUD, CAD, CHF, EUR, GBP, JPY, MXN, NZD, USD, XAU. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.",
"inputSchema": {
"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"
},
"end_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Inclusive upper bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
},
"start_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Inclusive lower bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
}
},
"required": [
"currency"
],
"title": "cot_dataArguments",
"type": "object"
},
"name": "cot_data",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "cot_dataOutput",
"type": "object"
}
},
{
"description": "Returns weekly CFTC COT positioning data with MCP Apps chart metadata. By default it charts noncommercial net positioning; the `metric` parameter selects another COT field. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.",
"inputSchema": {
"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"
},
"end_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Inclusive upper bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
},
"metric": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": "noncommercial_net",
"description": "Field to plot from each COT row. Typical values: noncommercial_net, noncommercial_net_zscore, noncommercial_long, noncommercial_short, open_interest.",
"examples": [
"noncommercial_net",
"noncommercial_net_zscore",
"noncommercial_long",
"open_interest"
]
},
"start_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Inclusive lower bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
}
},
"required": [
"currency"
],
"title": "cot_visual_artifactArguments",
"type": "object"
},
"name": "cot_visual_artifact",
"outputSchema": null
},
{
"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. Supported currencies (lowercase 3-letter codes): AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.",
"inputSchema": {
"properties": {
"currency": {
"description": "3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"usd",
"eur",
"gbp",
"jpy"
],
"type": "string"
},
"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"
},
"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"
},
"indicator": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional indicator slug to limit coverage calculation, for example `core_inflation`. Useful when the candidate series is already known.",
"examples": [
"core_inflation"
]
}
},
"required": [
"currency"
],
"title": "data_catalogueArguments",
"type": "object"
},
"name": "data_catalogue",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "data_catalogueOutput",
"type": "object"
}
},
{
"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. Supports MCP Tasks for async execution when clients send task-augmented requests. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.",
"inputSchema": {
"properties": {
"base": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": "eur",
"description": "FX base currency for market context, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"eur",
"gbp",
"aud",
"usd"
]
},
"currency": {
"description": "Currency for macro event series, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"usd",
"eur",
"gbp"
],
"type": "string"
},
"end_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional inclusive upper bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
},
"indicator": {
"description": "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, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, 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, fx_reserves, gdp, gdp_growth_q4_yoy, gold_reserves, gov_bond_10y, gov_bond_15y, gov_bond_1_5m, gov_bond_1m, gov_bond_1y, gov_bond_20y, gov_bond_25y, gov_bond_2m, gov_bond_2y, gov_bond_30y, gov_bond_3m, gov_bond_3y, gov_bond_40y, gov_bond_4m, gov_bond_4y, gov_bond_5y, gov_bond_6m, gov_bond_6y, gov_bond_7y, gov_bond_8y, gov_bond_9y, government_debt, house_price_index, house_prices, household_credit, household_spending, housing_starts, imports, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, obfr, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, retail_sales_control_group, retail_sales_ex_autos, retail_sales_ex_autos_and_gas, risk_free_rate, secondary_income_balance, sight_deposits, snb_balance_sheet, sofr_average_180d, sofr_average_30d, sofr_average_90d, sofr_index, terms_of_trade, tgcr, trade_balance, trade_weighted_index, trimmed_mean_inflation, unemployment, wage_price_index, wages.",
"examples": [
"inflation",
"policy_rate",
"gdp"
],
"type": "string"
},
"lookback_events": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": 12,
"description": "Maximum number of recent events to include in replay.",
"examples": [
6,
12,
24
]
},
"quote": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": "usd",
"description": "FX quote currency for market context, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"usd",
"jpy",
"chf"
]
},
"start_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional inclusive lower bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
}
},
"required": [
"currency",
"indicator"
],
"title": "event_impact_replay_taskArguments",
"type": "object"
},
"name": "event_impact_replay_task",
"outputSchema": null
},
{
"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: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD. The `indicator` parameter lists the accepted indicator slugs. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.",
"inputSchema": {
"properties": {
"annualization": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Annualization selector, matching the announcement series."
},
"as_of": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Historical publication cutoff with explicit timezone, or YYYY-MM-DD at UTC midnight. Later forecasts are excluded."
},
"basis": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Real or nominal selector, matching the announcement series."
},
"before_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Exclusive period-date cursor for event-linked groups; use the prior response's next_cursor."
},
"currency": {
"description": "3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"usd",
"eur",
"gbp",
"jpy"
],
"type": "string"
},
"end_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional inclusive upper bound by reference-period date, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
},
"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"
},
"frequency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Returned change basis selector, matching the announcement series."
},
"indicator": {
"description": "Required indicator slug. Currency-wide prediction reads are not supported. 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, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, 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, fx_reserves, gdp, gdp_growth_q4_yoy, gold_reserves, gov_bond_10y, gov_bond_15y, gov_bond_1_5m, gov_bond_1m, gov_bond_1y, gov_bond_20y, gov_bond_25y, gov_bond_2m, gov_bond_2y, gov_bond_30y, gov_bond_3m, gov_bond_3y, gov_bond_40y, gov_bond_4m, gov_bond_4y, gov_bond_5y, gov_bond_6m, gov_bond_6y, gov_bond_7y, gov_bond_8y, gov_bond_9y, government_debt, house_price_index, house_prices, household_credit, household_spending, housing_starts, imports, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, obfr, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, retail_sales_control_group, retail_sales_ex_autos, retail_sales_ex_autos_and_gas, risk_free_rate, secondary_income_balance, sight_deposits, snb_balance_sheet, sofr_average_180d, sofr_average_30d, sofr_average_90d, sofr_index, terms_of_trade, tgcr, trade_balance, trade_weighted_index, trimmed_mean_inflation, unemployment, wage_price_index, wages.",
"examples": [
"policy_rate",
"inflation",
"unemployment",
"gdp"
],
"type": "string"
},
"limit": {
"default": 20,
"description": "Maximum prediction groups to return. Defaults to 20; maximum 100.",
"examples": [
20
],
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"official_limit": {
"default": 500,
"description": "Maximum native-period official forecasts; 0 omits this section. Inspect official_forecasts_truncated.",
"maximum": 2000,
"minimum": 0,
"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"
}
],
"default": null,
"description": "One-based page number. When supplied, overrides offset.",
"examples": [
1
]
},
"period_aggregation": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Period aggregation selector, matching the announcement series."
},
"pre_release_only": {
"default": true,
"description": "Require event-linked forecasts to have been generated before the announcement.",
"type": "boolean"
},
"prediction_class": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Forecast production class: compiled_consensus, forecaster_survey, market_implied, model_nowcast, central_bank_projection, institutional_projection or fxmacrodata."
},
"prediction_source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional source slug filter, for example ecb_spf or philly_fed_spf.",
"examples": [
"ecb_spf",
"philly_fed_spf"
]
},
"prediction_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional legacy forecast-type filter, kept for existing clients. Superseded by prediction_class: compiled_consensus, forecaster_survey, market_implied, model_nowcast, central_bank_projection, institutional_projection or fxmacrodata.",
"examples": [
"fxmacrodata"
]
},
"seasonality": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Seasonal adjustment selector, matching the announcement series."
},
"start_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional inclusive lower bound by reference-period date, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
}
},
"required": [
"currency",
"indicator"
],
"title": "event_predictionsArguments",
"type": "object"
},
"name": "event_predictions",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "event_predictionsOutput",
"type": "object"
}
},
{
"description": "Read persisted official financial price observations: government yield curves, individual securities, overnight benchmarks and reference prices. Preserves issuer, instrument, maturity, curve type and source precision. Requires an API key; an empty result means no stored observations for the selection. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.",
"inputSchema": {
"properties": {
"currency": {
"type": "string"
},
"end_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"instrument_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"issuer": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"limit": {
"default": 100,
"type": "integer"
},
"measure": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"offset": {
"default": 0,
"type": "integer"
},
"source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"start_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"currency"
],
"title": "financial_pricesArguments",
"type": "object"
},
"name": "financial_prices",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "financial_pricesOutput",
"type": "object"
}
},
{
"description": "Get raw historical FX spot-rate rows for a currency pair (e.g. EUR/USD, USD/JPY) as a plain-text table, raw rows, exact values, or JSON-like data, with optional technical-indicator series (SMA, EMA, RSI, MACD, Bollinger Bands, etc.) computed from spot. Returns data only, without chart metadata. Daily granularity from official central-bank reference rates with full multi-year history. Supported currencies (lowercase 3-letter codes): AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD. The optional `indicators` parameter accepts a comma-separated list of technical indicator slugs to attach to each row. Supported indicator values: 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. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.",
"inputSchema": {
"properties": {
"base": {
"description": "Base currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"eur",
"gbp",
"aud",
"usd"
],
"type": "string"
},
"end_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Inclusive upper bound, YYYY-MM-DD. Defaults to today.",
"examples": [
"2020-01-01",
"2024-06-30"
]
},
"indicators": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"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"
]
},
"quote": {
"description": "Quote currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"usd",
"jpy",
"chf"
],
"type": "string"
},
"start_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Inclusive lower bound, YYYY-MM-DD. Defaults to ~5 years ago.",
"examples": [
"2020-01-01",
"2024-06-30"
]
}
},
"required": [
"base",
"quote"
],
"title": "forexArguments",
"type": "object"
},
"name": "forex",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "forexOutput",
"type": "object"
}
},
{
"description": "Returns FX spot-rate history for a currency pair with MCP Apps chart metadata so compatible clients render an interactive spot-rate chart inline. Suited to FX pair time-series and trend requests such as 'show me AUD/USD', 'the last 30 days', or 'how has EUR/USD moved recently'. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.",
"inputSchema": {
"properties": {
"base": {
"description": "Base currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"eur",
"gbp",
"aud",
"usd"
],
"type": "string"
},
"end_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Inclusive upper bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
},
"indicators": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional technical indicators to include in the raw payload. 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"
]
},
"quote": {
"description": "Quote currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"usd",
"jpy",
"chf"
],
"type": "string"
},
"start_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Inclusive lower bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
}
},
"required": [
"base",
"quote"
],
"title": "forex_visual_artifactArguments",
"type": "object"
},
"name": "forex_visual_artifact",
"outputSchema": null
},
{
"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. Supports MCP Tasks for async execution when clients send task-augmented requests.",
"inputSchema": {
"properties": {
"base": {
"description": "Base currency, 3-letter ISO code. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"eur",
"gbp",
"aud"
],
"type": "string"
},
"end_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Inclusive upper bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
},
"event_gated": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"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
]
},
"event_window_days": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": 1,
"description": "Additional calendar days after the first UTC decision following publication; 0 permits that first day only.",
"examples": [
0,
1,
2
]
},
"initial_capital": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": 100000,
"description": "Starting capital for equity-curve calculations.",
"examples": [
10000,
100000
]
},
"momentum_lookback": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": 5,
"description": "Momentum lookback in observations for the momentum signal.",
"examples": [
5,
10,
20
]
},
"quote": {
"description": "Quote currency, 3-letter ISO code. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"usd",
"jpy",
"chf"
],
"type": "string"
},
"start_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Inclusive lower bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
},
"strategy": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": "carry_momentum",
"description": "Signal mode: carry, momentum, or carry_momentum.",
"examples": [
"carry_momentum",
"carry",
"momentum"
]
},
"transaction_cost_bps": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": 2,
"description": "Per-side transaction cost in basis points applied on position changes.",
"examples": [
1,
2,
5
]
}
},
"required": [
"base",
"quote"
],
"title": "fx_backtest_taskArguments",
"type": "object"
},
"name": "fx_backtest_task",
"outputSchema": null
},
{
"description": "Return subscriber intraday official FX reference-rate observations for one pair. Coverage is limited to the pairs and sources in the FX reference pair universe. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.",
"inputSchema": {
"properties": {
"base": {
"description": "Base currency code.",
"examples": [
"eur"
],
"type": "string"
},
"end_time": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional inclusive RFC 3339 source timestamp.",
"examples": [
"2026-07-21T00:00:00Z"
]
},
"quote": {
"description": "Quote currency code.",
"examples": [
"usd"
],
"type": "string"
},
"start_time": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional inclusive RFC 3339 source timestamp.",
"examples": [
"2026-07-20T00:00:00Z"
]
}
},
"required": [
"base",
"quote"
],
"title": "fx_intraday_reference_ratesArguments",
"type": "object"
},
"name": "fx_intraday_reference_rates",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "fx_intraday_reference_ratesOutput",
"type": "object"
}
},
{
"description": "List public official FX reference-rate sources and the source policy that governs pair-specific intraday reference-rate series. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.",
"inputSchema": {
"properties": {},
"title": "fx_reference_sourcesArguments",
"type": "object"
},
"name": "fx_reference_sources",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "fx_reference_sourcesOutput",
"type": "object"
}
},
{
"description": "List the public FX reference-rate pair universe, optionally filtered by currency or source id, showing which pairs and sources have intraday reference-rate series. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.",
"inputSchema": {
"properties": {
"currency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional 3-letter currency filter.",
"examples": [
"usd"
]
},
"source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional official source id filter.",
"examples": [
"ecb_eurofxref_daily"
]
}
},
"title": "fx_reference_universeArguments",
"type": "object"
},
"name": "fx_reference_universe",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "fx_reference_universeOutput",
"type": "object"
}
},
{
"description": "Build a trader-oriented FX pair setup using spot context, macro differentials, upcoming catalyst risk, and optional COT positioning. Supports MCP Tasks for async execution when clients send task-augmented requests.",
"inputSchema": {
"properties": {
"base": {
"description": "Base currency, 3-letter ISO code. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"eur",
"gbp",
"aud"
],
"type": "string"
},
"horizon_events": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": 4,
"description": "Maximum upcoming catalysts per leg to rank.",
"examples": [
3,
4,
6
]
},
"include_cot": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": false,
"description": "When true, attempt to include COT positioning context for both legs.",
"examples": [
true,
false
]
},
"quote": {
"description": "Quote currency, 3-letter ISO code. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"usd",
"jpy",
"chf"
],
"type": "string"
}
},
"required": [
"base",
"quote"
],
"title": "fx_trade_setup_taskArguments",
"type": "object"
},
"name": "fx_trade_setup_task",
"outputSchema": null
},
{
"description": "Build an intelligence pack for one indicator by combining chart-ready series data, derived analytics, and nearest release timing context. Supports MCP Tasks for async execution when clients send task-augmented requests. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.",
"inputSchema": {
"properties": {
"currency": {
"description": "3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"usd",
"eur",
"gbp",
"jpy"
],
"type": "string"
},
"end_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Inclusive upper bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
},
"indicator": {
"description": "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, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, 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, fx_reserves, gdp, gdp_growth_q4_yoy, gold_reserves, gov_bond_10y, gov_bond_15y, gov_bond_1_5m, gov_bond_1m, gov_bond_1y, gov_bond_20y, gov_bond_25y, gov_bond_2m, gov_bond_2y, gov_bond_30y, gov_bond_3m, gov_bond_3y, gov_bond_40y, gov_bond_4m, gov_bond_4y, gov_bond_5y, gov_bond_6m, gov_bond_6y, gov_bond_7y, gov_bond_8y, gov_bond_9y, government_debt, house_price_index, house_prices, household_credit, household_spending, housing_starts, imports, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, obfr, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, retail_sales_control_group, retail_sales_ex_autos, retail_sales_ex_autos_and_gas, risk_free_rate, secondary_income_balance, sight_deposits, snb_balance_sheet, sofr_average_180d, sofr_average_30d, sofr_average_90d, sofr_index, terms_of_trade, tgcr, trade_balance, trade_weighted_index, trimmed_mean_inflation, unemployment, wage_price_index, wages.",
"examples": [
"policy_rate",
"inflation",
"unemployment",
"gdp"
],
"type": "string"
},
"start_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Inclusive lower bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
}
},
"required": [
"currency",
"indicator"
],
"title": "indicator_intel_taskArguments",
"type": "object"
},
"name": "indicator_intel_task",
"outputSchema": null
},
{
"description": "Get a paginated historical time series of a single macroeconomic indicator for a currency, sourced directly from the official central bank or statistical agency. Covers CPI/inflation, GDP, unemployment, policy rates, bond yields, payrolls, retail sales, PCE, PPI, trade balance, current account, money supply, and similar series. Each row returns `date` (economic reference period), `val` (numeric), and separate publication evidence. The `as_of` parameter restricts results to historically eligible values; current values can include later revisions. Returns raw rows without chart metadata. Each call returns one page, newest first: 100 rows when `start_date` is set, otherwise 20 (`limit` overrides, maximum 100). A page is not the full history. When `pagination.has_more` is true the result has a `partial_page` object: `partial_page.next_call` holds the exact arguments for the next page and `partial_page.pages_remaining` gives the number of pages left. Responses default to official-source rows only; prohibited private aggregator rows are always removed. USD indicators are free; non-USD requires an API key. Supported currencies: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD. The `indicator` parameter lists the accepted indicator slugs. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.",
"inputSchema": {
"properties": {
"as_of": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Historical decision cutoff with explicit timezone, or YYYY-MM-DD at UTC midnight; verifies vintages before returning rows."
},
"availability": {
"default": "public",
"description": "Replay clock: public or captured. Used with as_of.",
"type": "string"
},
"currency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "3-letter ISO currency code (case-insensitive). Optional if `slug` is provided as a `\"usd:cpi\"`-style compound. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"usd",
"eur",
"gbp",
"jpy"
]
},
"dataset_version": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional content version; use the first page's version on subsequent pages to reject changed data."
},
"end_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Inclusive upper bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
},
"indicator": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Indicator slug for the given currency. Optional if `slug` is provided as 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, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, 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, fx_reserves, gdp, gdp_growth_q4_yoy, gold_reserves, gov_bond_10y, gov_bond_15y, gov_bond_1_5m, gov_bond_1m, gov_bond_1y, gov_bond_20y, gov_bond_25y, gov_bond_2m, gov_bond_2y, gov_bond_30y, gov_bond_3m, gov_bond_3y, gov_bond_40y, gov_bond_4m, gov_bond_4y, gov_bond_5y, gov_bond_6m, gov_bond_6y, gov_bond_7y, gov_bond_8y, gov_bond_9y, government_debt, house_price_index, house_prices, household_credit, household_spending, housing_starts, imports, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, obfr, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, retail_sales_control_group, retail_sales_ex_autos, retail_sales_ex_autos_and_gas, risk_free_rate, secondary_income_balance, sight_deposits, snb_balance_sheet, sofr_average_180d, sofr_average_30d, sofr_average_90d, sofr_index, terms_of_trade, tgcr, trade_balance, trade_weighted_index, trimmed_mean_inflation, unemployment, wage_price_index, wages.",
"examples": [
"policy_rate",
"inflation",
"unemployment",
"gdp"
]
},
"limit": {
"anyOf": [
{
"maximum": 100,
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Rows per page, newest first, maximum 100. Unset means 100 when `start_date` is set, otherwise 20.",
"examples": [
1,
100
]
},
"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"
},
"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"
}
],
"default": null,
"description": "One-based page number. When supplied, the REST endpoint derives offset as `(page - 1) * limit`.",
"examples": [
1,
2
]
},
"revisions": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Revision view: latest, first, final or all. Historical replay uses latest among vintages eligible at as_of."
},
"series_mode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Series mode: canonical or raw. Historical replay defaults to raw."
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"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"
]
},
"start_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Inclusive lower bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
},
"value_mode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Value mode: normalized or source. Historical replay defaults to unchanged source values and requires raw series mode."
}
},
"title": "indicator_queryArguments",
"type": "object"
},
"name": "indicator_query",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "indicator_queryOutput",
"type": "object"
}
},
{
"description": "Returns an indicator time series with MCP Apps metadata so compatible clients (Claude Desktop, ChatGPT, Codex, etc.) render an interactive line chart instead of a JSON dump. Suited to indicator time-series requests to show, tell, explain, compare, inspect a trend, or review a recent window. Broad histories page through the `limit`, `offset`, and `page` controls, with `pagination.next_offset` giving the next page. Supported currencies: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD. The `indicator` parameter lists the accepted indicator slugs. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.",
"inputSchema": {
"properties": {
"currency": {
"description": "3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"usd",
"eur",
"gbp",
"jpy"
],
"type": "string"
},
"end_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Inclusive upper bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
},
"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, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, 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, fx_reserves, gdp, gdp_growth_q4_yoy, gold_reserves, gov_bond_10y, gov_bond_15y, gov_bond_1_5m, gov_bond_1m, gov_bond_1y, gov_bond_20y, gov_bond_25y, gov_bond_2m, gov_bond_2y, gov_bond_30y, gov_bond_3m, gov_bond_3y, gov_bond_40y, gov_bond_4m, gov_bond_4y, gov_bond_5y, gov_bond_6m, gov_bond_6y, gov_bond_7y, gov_bond_8y, gov_bond_9y, government_debt, house_price_index, house_prices, household_credit, household_spending, housing_starts, imports, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, obfr, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, retail_sales_control_group, retail_sales_ex_autos, retail_sales_ex_autos_and_gas, risk_free_rate, secondary_income_balance, sight_deposits, snb_balance_sheet, sofr_average_180d, sofr_average_30d, sofr_average_90d, sofr_index, terms_of_trade, tgcr, trade_balance, trade_weighted_index, trimmed_mean_inflation, unemployment, wage_price_index, wages.",
"examples": [
"policy_rate",
"inflation",
"unemployment",
"gdp"
],
"type": "string"
},
"limit": {
"default": 20,
"description": "Maximum rows to render from the existing REST pagination path. Defaults to 20; maximum 100.",
"examples": [
20,
100
],
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"description": "Zero-based row offset after most-recent-first ordering.",
"examples": [
0,
20
],
"minimum": 0,
"type": "integer"
},
"page": {
"anyOf": [
{
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "One-based page number. When supplied, the REST endpoint derives offset as `(page - 1) * limit`.",
"examples": [
1,
2
]
},
"start_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Inclusive lower bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
}
},
"required": [
"currency",
"indicator"
],
"title": "indicator_visual_artifactArguments",
"type": "object"
},
"name": "indicator_visual_artifact",
"outputSchema": null
},
{
"description": "Return the slice of a macro series that would have been known at a specific timestamp, selecting verified value vintages before pagination. Supports MCP Tasks for async execution when clients send task-augmented requests. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.",
"inputSchema": {
"properties": {
"as_of": {
"description": "UTC ISO-8601 timestamp or YYYY-MM-DD cutoff (start of UTC day). Only verified value vintages eligible on the selected availability clock are returned.",
"examples": [
"2025-01-31T13:30:00Z",
"2025-01-31"
],
"type": "string"
},
"availability": {
"default": "public",
"description": "Historical availability clock: public source-publication evidence or captured per-value observation evidence.",
"type": "string"
},
"currency": {
"description": "3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"usd",
"eur",
"gbp",
"jpy"
],
"type": "string"
},
"dataset_version": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional content version returned by a previous replay; a changed dataset returns an error."
},
"end_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional inclusive upper bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
},
"indicator": {
"description": "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, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, 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, fx_reserves, gdp, gdp_growth_q4_yoy, gold_reserves, gov_bond_10y, gov_bond_15y, gov_bond_1_5m, gov_bond_1m, gov_bond_1y, gov_bond_20y, gov_bond_25y, gov_bond_2m, gov_bond_2y, gov_bond_30y, gov_bond_3m, gov_bond_3y, gov_bond_40y, gov_bond_4m, gov_bond_4y, gov_bond_5y, gov_bond_6m, gov_bond_6y, gov_bond_7y, gov_bond_8y, gov_bond_9y, government_debt, house_price_index, house_prices, household_credit, household_spending, housing_starts, imports, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, obfr, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, retail_sales_control_group, retail_sales_ex_autos, retail_sales_ex_autos_and_gas, risk_free_rate, secondary_income_balance, sight_deposits, snb_balance_sheet, sofr_average_180d, sofr_average_30d, sofr_average_90d, sofr_index, terms_of_trade, tgcr, trade_balance, trade_weighted_index, trimmed_mean_inflation, unemployment, wage_price_index, wages.",
"examples": [
"policy_rate",
"inflation",
"unemployment",
"gdp"
],
"type": "string"
},
"start_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional inclusive lower bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
}
},
"required": [
"currency",
"indicator",
"as_of"
],
"title": "known_at_time_taskArguments",
"type": "object"
},
"name": "known_at_time_task",
"outputSchema": null
},
{
"description": "Return the latest stored macroeconomic value for every available indicator in one currency, as a compact current macro snapshot. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.",
"inputSchema": {
"properties": {
"currency": {
"description": "3-letter ISO currency code (case-insensitive).",
"examples": [
"usd",
"eur",
"gbp",
"jpy"
],
"type": "string"
}
},
"required": [
"currency"
],
"title": "latest_announcementsArguments",
"type": "object"
},
"name": "latest_announcements",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "latest_announcementsOutput",
"type": "object"
}
},
{
"description": "Return the latest stored value for every available commodity indicator in one response, as a batch snapshot of the subscriber commodity series. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.",
"inputSchema": {
"properties": {},
"title": "latest_commoditiesArguments",
"type": "object"
},
"name": "latest_commodities",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "latest_commoditiesOutput",
"type": "object"
}
},
{
"description": "Build a compact macro briefing for a currency by combining catalogue, key macro series, release-calendar, prediction, news, risk-sentiment, COT, seasonality, and FX technical context. Supports MCP Tasks for async execution when clients send a task-augmented request. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.",
"inputSchema": {
"properties": {
"currency": {
"description": "3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"usd",
"eur",
"gbp",
"jpy"
],
"type": "string"
}
},
"required": [
"currency"
],
"title": "macro_briefing_taskArguments",
"type": "object"
},
"name": "macro_briefing_task",
"outputSchema": null
},
{
"description": "Return a precomputed macro factor for one currency, with optional stored component scores and source references. The factor is a documented summary value and does not replace the underlying macro releases. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.",
"inputSchema": {
"properties": {
"currency": {
"description": "3-letter ISO currency code (case-insensitive).",
"examples": [
"usd",
"eur",
"gbp",
"jpy"
],
"type": "string"
},
"end_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional inclusive end date, YYYY-MM-DD."
},
"factor": {
"description": "Factor slug, for example monetary_stance.",
"examples": [
"monetary_stance"
],
"type": "string"
},
"include_components": {
"default": false,
"description": "Include stored component scores when available.",
"type": "boolean"
},
"include_sources": {
"default": false,
"description": "Include public source endpoint references when available.",
"type": "boolean"
},
"limit": {
"default": 20,
"description": "Maximum rows to return.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"description": "Zero-based row offset.",
"minimum": 0,
"type": "integer"
},
"start_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional inclusive start date, YYYY-MM-DD."
}
},
"required": [
"currency",
"factor"
],
"title": "macro_factorArguments",
"type": "object"
},
"name": "macro_factor",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "macro_factorOutput",
"type": "object"
}
},
{
"description": "Build a cross-currency macro heatmap from indicator time series and return a matrix with latest values, recent changes, and z-scores. Supports MCP Tasks for async execution when clients send task-augmented requests.",
"inputSchema": {
"properties": {
"currencies": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Comma-separated 3-letter currency codes (lowercase preferred). Supported values include: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"usd,eur,gbp,jpy",
"aud,cad,chf,nzd",
"usd,sek,nok,pln"
]
},
"end_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional inclusive upper bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
},
"indicators": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Comma-separated indicator slugs to 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, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, 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, fx_reserves, gdp, gdp_growth_q4_yoy, gold_reserves, gov_bond_10y, gov_bond_15y, gov_bond_1_5m, gov_bond_1m, gov_bond_1y, gov_bond_20y, gov_bond_25y, gov_bond_2m, gov_bond_2y, gov_bond_30y, gov_bond_3m, gov_bond_3y, gov_bond_40y, gov_bond_4m, gov_bond_4y, gov_bond_5y, gov_bond_6m, gov_bond_6y, gov_bond_7y, gov_bond_8y, gov_bond_9y, government_debt, house_price_index, house_prices, household_credit, household_spending, housing_starts, imports, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, obfr, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, retail_sales_control_group, retail_sales_ex_autos, retail_sales_ex_autos_and_gas, risk_free_rate, secondary_income_balance, sight_deposits, snb_balance_sheet, sofr_average_180d, sofr_average_30d, sofr_average_90d, sofr_index, terms_of_trade, tgcr, trade_balance, trade_weighted_index, trimmed_mean_inflation, unemployment, wage_price_index, wages.",
"examples": [
"policy_rate,inflation,gdp",
"inflation,unemployment,retail_sales"
]
},
"start_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional inclusive lower bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
}
},
"title": "macro_heatmap_taskArguments",
"type": "object"
},
"name": "macro_heatmap_task",
"outputSchema": null
},
{
"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: AUD, BRL, CAD, CHF, CZK, DKK, EUR, GBP, HKD, ILS, INR, JPY, NGN, NOK, NZD, PEN, PLN, SEK, USD, ZAR. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.",
"inputSchema": {
"properties": {
"currency": {
"description": "3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CZK, DKK, EUR, GBP, HKD, ILS, INR, JPY, NGN, NOK, NZD, PEN, PLN, SEK, USD, ZAR.",
"examples": [
"usd",
"eur",
"gbp",
"jpy"
],
"type": "string"
},
"limit": {
"default": 20,
"description": "Maximum number of headline rows to request.",
"examples": [
10,
20
],
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"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"
},
"offset": {
"default": 0,
"description": "Zero-based headline offset.",
"examples": [
0
],
"minimum": 0,
"type": "integer"
}
},
"required": [
"currency"
],
"title": "macro_newsArguments",
"type": "object"
},
"name": "macro_news",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "macro_newsOutput",
"type": "object"
}
},
{
"description": "Classify a currency's macro regime using policy rate, inflation, GDP, and unemployment context, with explicit assumptions and confidence notes. Supports MCP Tasks for async execution when clients send task-augmented requests. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.",
"inputSchema": {
"properties": {
"currency": {
"description": "3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"usd",
"eur",
"gbp",
"jpy"
],
"type": "string"
},
"end_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional inclusive upper bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
},
"start_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional inclusive lower bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
}
},
"required": [
"currency"
],
"title": "macro_regime_classifier_taskArguments",
"type": "object"
},
"name": "macro_regime_classifier_task",
"outputSchema": null
},
{
"description": "Bundles catalogue, indicator history, next release timing, and optional FX pair context into one persistent-host-friendly research payload. Supports MCP Tasks for async execution when clients send task-augmented requests. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.",
"inputSchema": {
"properties": {
"base": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional FX base currency for pair context.",
"examples": [
"eur",
"usd"
]
},
"currency": {
"description": "3-letter ISO currency code. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"usd",
"eur",
"gbp",
"jpy"
],
"type": "string"
},
"end_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional inclusive upper bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
},
"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, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, 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, fx_reserves, gdp, gdp_growth_q4_yoy, gold_reserves, gov_bond_10y, gov_bond_15y, gov_bond_1_5m, gov_bond_1m, gov_bond_1y, gov_bond_20y, gov_bond_25y, gov_bond_2m, gov_bond_2y, gov_bond_30y, gov_bond_3m, gov_bond_3y, gov_bond_40y, gov_bond_4m, gov_bond_4y, gov_bond_5y, gov_bond_6m, gov_bond_6y, gov_bond_7y, gov_bond_8y, gov_bond_9y, government_debt, house_price_index, house_prices, household_credit, household_spending, housing_starts, imports, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, obfr, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, retail_sales_control_group, retail_sales_ex_autos, retail_sales_ex_autos_and_gas, risk_free_rate, secondary_income_balance, sight_deposits, snb_balance_sheet, sofr_average_180d, sofr_average_30d, sofr_average_90d, sofr_index, terms_of_trade, tgcr, trade_balance, trade_weighted_index, trimmed_mean_inflation, unemployment, wage_price_index, wages.",
"examples": [
"policy_rate",
"inflation",
"unemployment",
"gdp"
],
"type": "string"
},
"quote": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional FX quote currency for pair context.",
"examples": [
"usd",
"jpy"
]
},
"start_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional inclusive lower bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
}
},
"required": [
"currency",
"indicator"
],
"title": "macro_research_pack_taskArguments",
"type": "object"
},
"name": "macro_research_pack_task",
"outputSchema": null
},
{
"description": "Build a multi-panel macro market cockpit that combines FX sessions, upcoming release queue, pair context, and generated risk alerts. Supports MCP Tasks for async execution when clients send task-augmented requests. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.",
"inputSchema": {
"properties": {
"base": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Base currency for pair context, 3-letter ISO code (case-insensitive). Defaults to the release currency when omitted. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"eur",
"gbp",
"aud",
"usd"
]
},
"currency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": "usd",
"description": "Release currency used for queue and spotlight indicator. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"usd",
"eur",
"gbp"
]
},
"end_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional inclusive upper bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
},
"indicator": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": "inflation",
"description": "Spotlight 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, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, 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, fx_reserves, gdp, gdp_growth_q4_yoy, gold_reserves, gov_bond_10y, gov_bond_15y, gov_bond_1_5m, gov_bond_1m, gov_bond_1y, gov_bond_20y, gov_bond_25y, gov_bond_2m, gov_bond_2y, gov_bond_30y, gov_bond_3m, gov_bond_3y, gov_bond_40y, gov_bond_4m, gov_bond_4y, gov_bond_5y, gov_bond_6m, gov_bond_6y, gov_bond_7y, gov_bond_8y, gov_bond_9y, government_debt, house_price_index, house_prices, household_credit, household_spending, housing_starts, imports, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, obfr, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, retail_sales_control_group, retail_sales_ex_autos, retail_sales_ex_autos_and_gas, risk_free_rate, secondary_income_balance, sight_deposits, snb_balance_sheet, sofr_average_180d, sofr_average_30d, sofr_average_90d, sofr_index, terms_of_trade, tgcr, trade_balance, trade_weighted_index, trimmed_mean_inflation, unemployment, wage_price_index, wages.",
"examples": [
"inflation",
"policy_rate",
"gdp"
]
},
"quote": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": "usd",
"description": "Quote currency for pair context, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"usd",
"jpy",
"chf"
]
},
"start_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional inclusive lower bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
}
},
"title": "macro_war_room_taskArguments",
"type": "object"
},
"name": "macro_war_room_task",
"outputSchema": null
},
{
"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.",
"inputSchema": {
"properties": {
"at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"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"
]
}
},
"title": "market_sessionsArguments",
"type": "object"
},
"name": "market_sessions",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "market_sessionsOutput",
"type": "object"
}
},
{
"description": "Explains which authentication mode suits FXMacroData MCP across major clients and platforms: OAuth, an API key, or a bearer token, for ChatGPT/OpenAI Apps, Claude/Anthropic, Microsoft/VS Code/Copilot-style clients, AstrBot, Cursor, Codex, local scripts, and CI.",
"inputSchema": {
"properties": {},
"title": "mcp_auth_guideArguments",
"type": "object"
},
"name": "mcp_auth_guide",
"outputSchema": null
},
{
"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": {
"properties": {},
"title": "mcp_capabilitiesArguments",
"type": "object"
},
"name": "mcp_capabilities",
"outputSchema": null
},
{
"description": "Get metadata-first official dataset payloads grouped by API endpoint type. `endpoint_type` selects the API taxonomy group and `dataset` selects the specific series family. Supported endpoint types: monetary_policy, fiscal_policy, international_trade, statistics_releases. Supported datasets: auction_metrics, bop, capital_flows, cb_liquidity, credit_conditions, external_debt, fx_intervention, iip, services_trade, treasury_cash, wage_settlements. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.",
"inputSchema": {
"properties": {
"component": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Required only when dataset='bop'. Supported bop components: goods_balance, services_balance, primary_income, secondary_income, current_account, capital_account, financial_account.",
"examples": [
"current_account",
"services_balance",
"financial_account"
]
},
"currency": {
"description": "3-letter ISO currency code (case-insensitive).",
"examples": [
"usd",
"eur",
"gbp",
"jpy"
],
"type": "string"
},
"dataset": {
"description": "Dataset slug within the selected endpoint_type. Supported: auction_metrics, bop, capital_flows, cb_liquidity, credit_conditions, external_debt, fx_intervention, iip, services_trade, treasury_cash, wage_settlements.",
"examples": [
"cb_liquidity",
"treasury_cash",
"bop",
"credit_conditions"
],
"type": "string"
},
"endpoint_type": {
"description": "Endpoint taxonomy group from the API structure. Supported: monetary_policy, fiscal_policy, international_trade, statistics_releases.",
"examples": [
"monetary_policy",
"fiscal_policy",
"international_trade",
"statistics_releases"
],
"type": "string"
}
},
"required": [
"endpoint_type",
"dataset",
"currency"
],
"title": "official_dataset_familyArguments",
"type": "object"
},
"name": "official_dataset_family",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "official_dataset_familyOutput",
"type": "object"
}
},
{
"description": "Build an intelligence pack for an FX pair by combining policy-rate spread context, spot-rate context, and release-timing metadata. Supports MCP Tasks 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.",
"inputSchema": {
"properties": {
"base": {
"description": "Base currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"eur",
"gbp",
"aud",
"usd"
],
"type": "string"
},
"end_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Inclusive upper bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
},
"quote": {
"description": "Quote currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"usd",
"jpy",
"chf"
],
"type": "string"
},
"start_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Inclusive lower bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
}
},
"required": [
"base",
"quote"
],
"title": "pair_intel_taskArguments",
"type": "object"
},
"name": "pair_intel_task",
"outputSchema": null
},
{
"description": "Health check that confirms the FXMacroData API and MCP server are reachable. Returns the API health response.",
"inputSchema": {
"properties": {},
"title": "pingArguments",
"type": "object"
},
"name": "ping",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "pingOutput",
"type": "object"
}
},
{
"description": "Build a generic MCP Apps chart from one or more FXMacroData endpoint families: arbitrary plots, multi-series charts, and actual-vs-consensus views that combine announcements with predictions. Supported series sources are announcements, predictions, forex, commodities, and cot. For example, USD policy-rate midpoint actuals against market consensus use one announcements series for `usd/policy_rate_midpoint` and one predictions series for `usd/policy_rate_midpoint` with `prediction_class=forecaster_survey`. The tool does not fetch arbitrary URLs or run custom chart code; it only composes approved FXMacroData API surfaces into the comparison chart app. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.",
"inputSchema": {
"properties": {
"base": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Base currency for single-series forex plots. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"eur",
"aud",
"usd"
]
},
"chart_kind": {
"default": "line",
"description": "Initial chart view. Supported: line, area, bar, dot, step.",
"examples": [
"line",
"step"
],
"type": "string"
},
"currency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Single-series currency for announcements, predictions, or COT. Supported macro currencies: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD. Supported COT currencies: AUD, CAD, CHF, EUR, GBP, JPY, MXN, NZD, USD, XAU.",
"examples": [
"usd",
"eur",
"gbp",
"jpy"
]
},
"end_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Inclusive upper bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
},
"indicator": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Single-series indicator for announcements, 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, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, 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, fx_reserves, gdp, gdp_growth_q4_yoy, gold_reserves, gov_bond_10y, gov_bond_15y, gov_bond_1_5m, gov_bond_1m, gov_bond_1y, gov_bond_20y, gov_bond_25y, gov_bond_2m, gov_bond_2y, gov_bond_30y, gov_bond_3m, gov_bond_3y, gov_bond_40y, gov_bond_4m, gov_bond_4y, gov_bond_5y, gov_bond_6m, gov_bond_6y, gov_bond_7y, gov_bond_8y, gov_bond_9y, government_debt, house_price_index, house_prices, household_credit, household_spending, housing_starts, imports, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, obfr, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, retail_sales_control_group, retail_sales_ex_autos, retail_sales_ex_autos_and_gas, risk_free_rate, secondary_income_balance, sight_deposits, snb_balance_sheet, sofr_average_180d, sofr_average_30d, sofr_average_90d, sofr_index, terms_of_trade, tgcr, trade_balance, trade_weighted_index, trimmed_mean_inflation, unemployment, wage_price_index, wages. Supported commodity indicators: crude_oil_inventories, gold, natural_gas, natural_gas_storage, oil_brent, oil_wti, platinum, silver.",
"examples": [
"policy_rate",
"inflation",
"unemployment",
"gdp"
]
},
"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"
}
],
"default": null,
"description": "One-based page number per source.",
"examples": [
1
]
},
"prediction_source": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional prediction source filter for prediction series.",
"examples": [
"ny_fed_sme",
"philly_fed_spf"
]
},
"prediction_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional legacy prediction-type filter for prediction series. Superseded by prediction_class.",
"examples": [
"fxmacrodata"
]
},
"query": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"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"
]
},
"quote": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Quote currency for single-series forex plots. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"usd",
"jpy",
"chf"
]
},
"series": {
"anyOf": [
{
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"default": 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": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Single-series source when `series` is omitted. Supported values: announcements, predictions, forex, commodities, cot.",
"examples": [
"announcements",
"predictions",
"forex"
]
},
"start_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Inclusive lower bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional chart title. Defaults to query or an auto-generated title.",
"examples": [
"USD policy-rate actual vs consensus"
]
},
"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": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"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"
]
},
"y_label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional y-axis label for the chart.",
"examples": [
"Policy Rate Midpoint",
"Value"
]
}
},
"title": "plot_visual_artifactArguments",
"type": "object"
},
"name": "plot_visual_artifact",
"outputSchema": null
},
{
"description": "Build a two-series chart comparing base and quote policy-rate history to visualize the rate differential setup for an FX pair. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.",
"inputSchema": {
"properties": {
"base": {
"description": "Base currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"eur",
"gbp",
"aud",
"usd"
],
"type": "string"
},
"end_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Inclusive upper bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
},
"quote": {
"description": "Quote currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"usd",
"jpy",
"chf"
],
"type": "string"
},
"start_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Inclusive lower bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
}
},
"required": [
"base",
"quote"
],
"title": "policy_rate_differential_visual_artifactArguments",
"type": "object"
},
"name": "policy_rate_differential_visual_artifact",
"outputSchema": null
},
{
"description": "Run a policy-rate spread what-if scenario for an FX pair and estimate directional spot impact using an explicit heuristic elasticity assumption. Supports MCP Tasks 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.",
"inputSchema": {
"properties": {
"base": {
"description": "Base currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"eur",
"gbp",
"aud",
"usd"
],
"type": "string"
},
"elasticity_per_100bps": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": 0.8,
"description": "Heuristic percent change in FX spot for a 100 bps spread change. Used as a scenario assumption, not a forecast guarantee.",
"examples": [
0.5,
0.8,
1.2
]
},
"end_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional inclusive upper bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
},
"policy_shock_bps": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional alias for shock_bps for compatibility with host-side app payloads.",
"examples": [
25,
50
]
},
"quote": {
"description": "Quote currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"usd",
"jpy",
"chf"
],
"type": "string"
},
"shock_bps": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": 25,
"description": "Policy shock size in basis points (100 bps = 1.00 percentage point).",
"examples": [
25,
50,
-25
]
},
"shock_leg": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": "base",
"description": "Which leg receives the policy shock: base or quote.",
"examples": [
"base",
"quote"
]
},
"start_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional inclusive lower bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
}
},
"required": [
"base",
"quote"
],
"title": "policy_scenario_modeler_taskArguments",
"type": "object"
},
"name": "policy_scenario_modeler_task",
"outputSchema": null
},
{
"description": "Analyze a multi-position FX book for concentration, stress exposure, and event-driven catalyst risk. Supports MCP Tasks for async execution when clients send task-augmented requests.",
"inputSchema": {
"properties": {
"horizon_events": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": 4,
"description": "Maximum release events to consider per currency leg.",
"examples": [
3,
4,
8
]
},
"positions_json": {
"description": "JSON array of FX positions. Each item should include base, quote, side (long/short), and notional. Example: [{\"base\":\"eur\",\"quote\":\"usd\",\"side\":\"long\",\"notional\":100000}]",
"examples": [
"[{\"base\":\"eur\",\"quote\":\"usd\",\"side\":\"long\",\"notional\":100000},{\"base\":\"gbp\",\"quote\":\"usd\",\"side\":\"short\",\"notional\":80000}]"
],
"type": "string"
},
"stress_shock_pct": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": 1,
"description": "Stress shock in percent applied to each pair.",
"examples": [
0.5,
1,
2
]
}
},
"required": [
"positions_json"
],
"title": "portfolio_risk_engine_taskArguments",
"type": "object"
},
"name": "portfolio_risk_engine_task",
"outputSchema": null
},
{
"description": "List which publishers produce pre-release forecasts for a currency's indicators, what class of forecast each one is (compiled consensus, forecaster survey, market implied, model nowcast, central-bank projection), whether any of them is a genuine consensus, and how far the verified archive runs. Suited to questions about 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 for payrolls'. It needs no API key and works for every served currency. It returns no forecast values: those require a subscription. Its answer distinguishes two cases: no publisher produces this forecast for anybody (no subscription adds it), versus the data exists and is behind the paywall. A pair listed here exists in the verified archive. Access: free for every currency, no API key required. It returns coverage metadata only; forecast values need a subscription.",
"inputSchema": {
"properties": {
"currency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional 3-letter currency code. Omit for the cross-currency summary; pass one for per-indicator detail.",
"examples": [
"usd",
"eur",
"jpy"
]
}
},
"title": "prediction_coverageArguments",
"type": "object"
},
"name": "prediction_coverage",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "prediction_coverageOutput",
"type": "object"
}
},
{
"description": "Return the public central-bank press-release archive for a currency as the original official release rows, without derived sentiment or indicator classifications. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.",
"inputSchema": {
"properties": {
"currency": {
"description": "3-letter ISO currency code (case-insensitive).",
"examples": [
"usd",
"eur",
"gbp",
"jpy"
],
"type": "string"
},
"limit": {
"default": 20,
"description": "Maximum rows to return.",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"description": "Zero-based row offset.",
"minimum": 0,
"type": "integer"
}
},
"required": [
"currency"
],
"title": "press_releasesArguments",
"type": "object"
},
"name": "press_releases",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "press_releasesOutput",
"type": "object"
}
},
{
"description": "Run an expanded quant-style policy scenario for an FX pair with deterministic projection, stress percentiles, and horizon assumptions. Supports MCP Tasks for async execution when clients send task-augmented requests.",
"inputSchema": {
"properties": {
"annualized_volatility_pct": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": 8,
"description": "Annualized volatility assumption (percent) for stress-band construction.",
"examples": [
6,
8,
12
]
},
"base": {
"description": "Base currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"eur",
"gbp",
"aud",
"usd"
],
"type": "string"
},
"elasticity_per_100bps": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": 0.8,
"description": "Heuristic percent FX move per 100 bps spread change.",
"examples": [
0.5,
0.8,
1.2
]
},
"end_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional inclusive upper bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
},
"horizon_days": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": 30,
"description": "Scenario horizon in calendar days.",
"examples": [
7,
30,
90
]
},
"quote": {
"description": "Quote currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"usd",
"jpy",
"chf"
],
"type": "string"
},
"shock_bps": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": 50,
"description": "Policy shock size in basis points (100 bps = 1.00 percentage point).",
"examples": [
25,
50,
-25
]
},
"shock_leg": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": "base",
"description": "Which leg receives the policy shock: base or quote.",
"examples": [
"base",
"quote"
]
},
"start_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional inclusive lower bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
}
},
"required": [
"base",
"quote"
],
"title": "quant_scenario_lab_taskArguments",
"type": "object"
},
"name": "quant_scenario_lab_task",
"outputSchema": null
},
{
"description": "Return official government-nominal curve nodes, slopes, or derived forward segments for one currency. This is a subscriber data tool and preserves the endpoint's requested view and method metadata. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.",
"inputSchema": {
"properties": {
"currency": {
"description": "3-letter currency code.",
"examples": [
"usd",
"eur",
"gbp",
"jpy"
],
"type": "string"
},
"curve_family": {
"default": "government_nominal",
"description": "Official curve family.",
"type": "string"
},
"date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional target date, YYYY-MM-DD."
},
"method": {
"default": "derived_from_spot_nodes",
"description": "Forward derivation method when view is forwards.",
"type": "string"
},
"metric": {
"default": "spot",
"description": "Curve metric.",
"type": "string"
},
"view": {
"default": "nodes",
"description": "Curve view: nodes, slopes, or forwards.",
"examples": [
"nodes",
"slopes",
"forwards"
],
"type": "string"
}
},
"required": [
"currency"
],
"title": "rate_curveArguments",
"type": "object"
},
"name": "rate_curve",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "rate_curveOutput",
"type": "object"
}
},
{
"description": "Return the stored or derived rate differential for one FX pair, with the measure, rate type, curve family, and tenor metadata that define it. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.",
"inputSchema": {
"properties": {
"base": {
"description": "Base currency code.",
"examples": [
"aud"
],
"type": "string"
},
"curve_family": {
"default": "government_nominal",
"description": "Curve family when rate_type is forward.",
"type": "string"
},
"end_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional inclusive end date, YYYY-MM-DD."
},
"end_tenor_years": {
"default": 5,
"description": "End tenor in years for forward differentials.",
"type": "number"
},
"limit": {
"default": 20,
"description": "Maximum rows to return.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"measure": {
"default": "auto",
"description": "Shared rate measure to compare across the pair.",
"examples": [
"auto",
"policy_rate",
"gov_bond_10y"
],
"type": "string"
},
"offset": {
"default": 0,
"description": "Zero-based row offset.",
"minimum": 0,
"type": "integer"
},
"quote": {
"description": "Quote currency code.",
"examples": [
"usd"
],
"type": "string"
},
"rate_type": {
"default": "spot",
"description": "Differential type: spot or forward.",
"examples": [
"spot",
"forward"
],
"type": "string"
},
"start_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional inclusive start date, YYYY-MM-DD."
},
"start_tenor_years": {
"default": 2,
"description": "Start tenor in years for forward differentials.",
"type": "number"
}
},
"required": [
"base",
"quote"
],
"title": "rate_differentialsArguments",
"type": "object"
},
"name": "rate_differentials",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "rate_differentialsOutput",
"type": "object"
}
},
{
"description": "Get upcoming scheduled macroeconomic release timestamps for a currency, for questions such as when the next CPI, GDP, payrolls, or policy decision is due. Returns ISO-8601 announcement_datetime values in UTC plus market-local timestamps, a markdown agenda, and Release Calendar App metadata. The optional `timezone` adds an `announcement_datetime_requested_timezone` field. Each row has a `release` string with the indicator name and a `currency` code. Unbounded calls return future releases only. The optional `indicator` filter narrows to a single series, and optional `start_date` and `end_date` bounds select a month, week, day, or explicit date range. Supported currencies: AUD, BRL, CAD, CHF, CNH, CNY, COMM, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD. The `indicator` parameter lists the accepted indicator slugs. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.",
"inputSchema": {
"properties": {
"currency": {
"description": "3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, COMM, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"usd",
"eur",
"gbp",
"jpy"
],
"type": "string"
},
"end_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional inclusive upper bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
},
"indicator": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "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, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, 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, fx_reserves, gdp, gdp_growth_q4_yoy, gold_reserves, gov_bond_10y, gov_bond_15y, gov_bond_1_5m, gov_bond_1m, gov_bond_1y, gov_bond_20y, gov_bond_25y, gov_bond_2m, gov_bond_2y, gov_bond_30y, gov_bond_3m, gov_bond_3y, gov_bond_40y, gov_bond_4m, gov_bond_4y, gov_bond_5y, gov_bond_6m, gov_bond_6y, gov_bond_7y, gov_bond_8y, gov_bond_9y, government_debt, house_price_index, house_prices, household_credit, household_spending, housing_starts, imports, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, obfr, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, retail_sales_control_group, retail_sales_ex_autos, retail_sales_ex_autos_and_gas, risk_free_rate, secondary_income_balance, sight_deposits, snb_balance_sheet, sofr_average_180d, sofr_average_30d, sofr_average_90d, sofr_index, terms_of_trade, tgcr, trade_balance, trade_weighted_index, trimmed_mean_inflation, unemployment, wage_price_index, wages.",
"examples": [
"policy_rate",
"inflation",
"unemployment",
"gdp"
]
},
"start_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional inclusive lower bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
},
"timezone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional IANA timezone for an additional converted timestamp, for example America/Sao_Paulo.",
"examples": [
"America/Sao_Paulo",
"Australia/Sydney"
]
}
},
"required": [
"currency"
],
"title": "release_calendarArguments",
"type": "object"
},
"name": "release_calendar",
"outputSchema": null
},
{
"description": "Returns the release calendar payload with MCP Apps metadata so compatible clients render the interactive Release Calendar App inline. Suited to requests to show, display, visualize, or render a macro release calendar, such as 'show me the AUD release calendar'. Optional `indicator`, `start_date`, and `end_date` filters narrow the calendar to a series, month, week, day, or date range; `timezone` adds local times for a specific city or region. Supported currencies: AUD, BRL, CAD, CHF, CNH, CNY, COMM, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD. The `indicator` parameter lists the accepted indicator slugs. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.",
"inputSchema": {
"properties": {
"currency": {
"description": "3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, COMM, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"usd",
"eur",
"gbp",
"jpy"
],
"type": "string"
},
"end_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional inclusive upper bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
},
"indicator": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "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, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, 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, fx_reserves, gdp, gdp_growth_q4_yoy, gold_reserves, gov_bond_10y, gov_bond_15y, gov_bond_1_5m, gov_bond_1m, gov_bond_1y, gov_bond_20y, gov_bond_25y, gov_bond_2m, gov_bond_2y, gov_bond_30y, gov_bond_3m, gov_bond_3y, gov_bond_40y, gov_bond_4m, gov_bond_4y, gov_bond_5y, gov_bond_6m, gov_bond_6y, gov_bond_7y, gov_bond_8y, gov_bond_9y, government_debt, house_price_index, house_prices, household_credit, household_spending, housing_starts, imports, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, obfr, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, retail_sales_control_group, retail_sales_ex_autos, retail_sales_ex_autos_and_gas, risk_free_rate, secondary_income_balance, sight_deposits, snb_balance_sheet, sofr_average_180d, sofr_average_30d, sofr_average_90d, sofr_index, terms_of_trade, tgcr, trade_balance, trade_weighted_index, trimmed_mean_inflation, unemployment, wage_price_index, wages.",
"examples": [
"policy_rate",
"inflation",
"unemployment",
"gdp"
]
},
"start_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional inclusive lower bound, YYYY-MM-DD.",
"examples": [
"2020-01-01",
"2024-06-30"
]
},
"timezone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional IANA timezone for an additional converted timestamp, for example America/Sao_Paulo.",
"examples": [
"America/Sao_Paulo",
"Australia/Sydney"
]
}
},
"required": [
"currency"
],
"title": "release_calendar_visual_artifactArguments",
"type": "object"
},
"name": "release_calendar_visual_artifact",
"outputSchema": null
},
{
"description": "Score upcoming releases for a currency pair using release-calendar proximity and indicator-level heuristics. Supports MCP Tasks for async execution when clients send task-augmented requests.",
"inputSchema": {
"properties": {
"base": {
"description": "Base currency, 3-letter ISO code. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"eur",
"gbp",
"usd"
],
"type": "string"
},
"horizon_events": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": 6,
"description": "Maximum release events per currency to score.",
"examples": [
4,
6,
10
]
},
"quote": {
"description": "Quote currency, 3-letter ISO code. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.",
"examples": [
"usd",
"jpy",
"chf"
],
"type": "string"
}
},
"required": [
"base",
"quote"
],
"title": "release_risk_score_taskArguments",
"type": "object"
},
"name": "release_risk_score_task",
"outputSchema": null
},
{
"description": "Return the global risk-on/risk-off sentiment series used for FX regime analysis. The result includes a derived composite score, regime label, component contributions, pagination, and data_quality metadata. Suited to cross-asset regime context for high-beta, safe-haven, commodity, or USD-defensive FX conditions. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.",
"inputSchema": {
"properties": {
"end_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional inclusive end date in YYYY-MM-DD format.",
"examples": [
"2026-06-30"
]
},
"start_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional inclusive start date in YYYY-MM-DD format.",
"examples": [
"2026-06-01"
]
}
},
"title": "risk_sentimentArguments",
"type": "object"
},
"name": "risk_sentiment",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "risk_sentimentOutput",
"type": "object"
}
},
{
"description": "Get monthly return seasonality for an FX pair or XAU/USD, covering seasonal patterns, month-of-year tendency, historical monthly win rate, and XAUUSD/gold seasonality. Returns monthly average return, median return, win rate, sample size, dispersion, and per-year monthly returns from stored FX or gold series.",
"inputSchema": {
"properties": {
"end_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Inclusive upper bound, YYYY-MM-DD. Defaults to today.",
"examples": [
"2020-01-01",
"2024-06-30"
]
},
"instrument": {
"description": "Six-letter pair such as EURUSD, AUDUSD, USDJPY, or XAUUSD. Slashes and separators are accepted by the REST endpoint only when passed as a single string.",
"examples": [
"XAUUSD",
"EURUSD",
"AUDUSD"
],
"type": "string"
},
"lookback_years": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": 10,
"description": "Number of years to include, 2-30. Defaults to 10.",
"examples": [
10
]
},
"month": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional month filter, 1-12 or name such as July.",
"examples": [
"July"
]
}
},
"required": [
"instrument"
],
"title": "seasonalityArguments",
"type": "object"
},
"name": "seasonality",
"outputSchema": {
"properties": {
"result": {
"additionalProperties": true,
"title": "Result",
"type": "object"
}
},
"required": [
"result"
],
"title": "seasonalityOutput",
"type": "object"
}
},
{
"description": "Returns FXMacroData subscription options and a direct checkout path for unlocking MCP app visuals, charts, and advanced analytical tools.",
"inputSchema": {
"properties": {},
"title": "subscribe_for_mcp_accessArguments",
"type": "object"
},
"name": "subscribe_for_mcp_access",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:c778e4837f996dc83f81c970ceed7dc90793f1eda754644bcc4362af775cb1c3 | sha256sum