Plot Chart
plot_visual_artifactRead-only
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.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "plot_visual_artifact"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| base | No | Base currency for single-series forex plots. Supported: lowercase 3-letter catalogue currency, e.g. usd or eur. | |
| page | No | One-based page number per source. | |
| limit | No | Maximum rows per source. Defaults to 20; maximum 100. | |
| query | No | Optional natural-language request to preserve in the payload title/context. | |
| quote | No | Quote currency for single-series forex plots. Supported: lowercase 3-letter catalogue currency, e.g. usd or eur. | |
| title | No | Optional chart title. Defaults to query or an auto-generated title. | |
| y_key | No | Single-series metric field. Defaults by source: val for announcements and commodities, predicted_value for predictions, rate for forex, noncommercial_net for COT. | |
| offset | No | Zero-based row offset per source. | |
| series | No | 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`. | |
| source | No | Single-series source when `series` is omitted. Supported values: announcements, predictions, forex, commodities, cot, rate_differential (needs base and quote). | |
| x_axis | No | Field to use as the shared x-axis. Supported: date, announcement_datetime, announcement_datetime_local, generated_at, observation_datetime. | date |
| y_label | No | Optional y-axis label for the chart. | |
| currency | No | 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. | |
| end_date | No | Inclusive upper bound, YYYY-MM-DD. | |
| indicator | No | 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, distillate_inventories, gasoline_inventories, gold, natural_gas, natural_gas_storage, oil_brent, oil_wti, platinum, silver. | |
| chart_kind | No | Initial chart view. Supported: line, area, bar, dot, step. | line |
| start_date | No | Inclusive lower bound, YYYY-MM-DD. | |
| prediction_type | No | Optional legacy prediction-type filter for prediction series. Superseded by prediction_class. | |
| prediction_source | No | Optional prediction source filter for prediction series. |