Build a generic MCP Apps chart: single or multi-series charts, including actual-vs-consensus views combining announcements with predictions. Rate-differential plots show both policy rates and their spread. Charts FXMacroData data only; no arbitrary URLs or custom code. Access: USD needs no API key; other currencies return subscription_required with a subscribe link.
View input schema
{
"type": "object",
"properties": {
"query": {
"description": "Optional natural-language request to preserve in the payload title/context.",
"examples": [
"plot USD policy-rate midpoint actual vs market consensus",
"compare AUD and USD inflation"
],
"type": [
"string",
"null"
]
},
"series": {
"anyOf": [
{
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "Optional list of series specs. Each spec supports `source` (announcements, predictions, forex, commodities, cot), `currency`, `indicator`, `base`, `quote`, `label`, `y_key`, `metric`, `prediction_class`, `prediction_source`, `start_date`, `end_date`, `limit`, `offset`, and `page`.",
"examples": [
[
{
"currency": "usd",
"indicator": "policy_rate_midpoint",
"label": "USD policy midpoint actual",
"source": "announcements"
},
{
"currency": "usd",
"indicator": "policy_rate_midpoint",
"label": "Dealer survey median",
"prediction_class": "forecaster_survey",
"source": "predictions"
}
]
]
},
"source": {
"description": "Single-series source when `series` is omitted. Supported values: announcements, predictions, forex, commodities, cot, rate_differential (needs base and quote).",
"examples": [
"announcements",
"forex",
"rate_differential"
],
"type": [
"string",
"null"
]
},
"currency": {
"description": "Single-series currency for announcements, predictions, or COT. Supported macro currencies: lowercase 3-letter catalogue currency, e.g. usd or eur. Supported COT currencies: AUD, CAD, CHF, EUR, GBP, JPY, MXN, NZD, USD, XAU.",
"examples": [
"usd",
"eur"
],
"type": [
"string",
"null"
]
},
"indicator": {
"description": "Single-series indicator for announcements, predictions, or commodities. Supported macro indicators: catalogue indicator slug, e.g. inflation or policy_rate. Supported commodity indicators: crude_oil_inventories, crude_oil_stocks, distillate_inventories, distillate_stocks, gasoline_inventories, gasoline_stocks, gold, natural_gas, natural_gas_storage, natural_gas_storage_level, oil_brent, oil_wti, platinum, silver.",
"examples": [
"policy_rate",
"inflation"
],
"type": [
"string",
"null"
]
},
"base": {
"description": "Base currency for single-series forex plots. Supported: lowercase 3-letter catalogue currency, e.g. usd or eur.",
"examples": [
"eur",
"aud",
"usd"
],
"type": [
"string",
"null"
]
},
"quote": {
"description": "Quote currency for single-series forex plots. Supported: lowercase 3-letter catalogue currency, e.g. usd or eur.",
"examples": [
"usd",
"jpy",
"chf"
],
"type": [
"string",
"null"
]
},
"prediction_type": {
"description": "Optional legacy prediction-type filter for prediction series. Superseded by prediction_class.",
"examples": [
"fxmacrodata"
],
"type": [
"string",
"null"
]
},
"prediction_source": {
"description": "Optional prediction source filter for prediction series.",
"examples": [
"ny_fed_sme",
"philly_fed_spf"
],
"type": [
"string",
"null"
]
},
"x_axis": {
"default": "date",
"description": "Field to use as the shared x-axis. Supported: date, announcement_datetime, announcement_datetime_local, generated_at, observation_datetime.",
"examples": [
"date",
"announcement_datetime"
],
"type": "string"
},
"y_key": {
"description": "Single-series metric field. Defaults by source: val for announcements and commodities, predicted_value for predictions, rate for forex, noncommercial_net for COT.",
"examples": [
"val",
"predicted_value",
"rate"
],
"type": [
"string",
"null"
]
},
"y_label": {
"description": "Optional y-axis label for the chart.",
"examples": [
"Policy Rate Midpoint",
"Value"
],
"type": [
"string",
"null"
]
},
"title": {
"description": "Optional chart title. Defaults to query or an auto-generated title.",
"examples": [
"USD policy-rate actual vs consensus"
],
"type": [
"string",
"null"
]
},
"chart_kind": {
"default": "line",
"description": "Initial chart view. Supported: line, area, bar, dot, step.",
"examples": [
"line",
"step"
],
"type": "string"
},
"start_date": {
"description": "Inclusive lower bound, YYYY-MM-DD.",
"examples": [
"2024-06-30"
],
"type": [
"string",
"null"
]
},
"end_date": {
"description": "Inclusive upper bound, YYYY-MM-DD.",
"examples": [
"2024-06-30"
],
"type": [
"string",
"null"
]
},
"limit": {
"default": 20,
"description": "Maximum rows per source. Defaults to 20; maximum 100.",
"examples": [
20,
100
],
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"description": "Zero-based row offset per source.",
"examples": [
0,
20
],
"minimum": 0,
"type": "integer"
},
"page": {
"anyOf": [
{
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"description": "One-based page number per source.",
"examples": [
1
]
}
}
}