GetForecasts
GetForecasts returns the latest generated probabilistic forecasts; the degraded flag distinguishes a backend outage from a healthy empty set.
Authorizations
User-issued WorldMonitor API key.
Query Parameters
Forecast domain to retrieve, such as geopolitics, markets, or climate.
conflict, market, supply_chain, political, military, cyber, infrastructure Optional geographic or thematic region filter for forecasts.
Optional JMESPath expression applied server-side to project or reduce the JSON response before it is returned (mirrors the MCP jmespath argument). Invalid expressions, expressions larger than 1024 UTF-8 bytes, or projections that exceed the 256 KB output cap return HTTP 400 with a {_jmespath_error, original_keys} envelope. Grammar and worked examples: https://www.worldmonitor.app/docs/mcp-jmespath.
Response
Successful response
Warning: Values > 2^53 may lose precision in JavaScript
True when the forecast backend could not read the canonical cache. Distinguishes an outage from a healthy empty forecast set.
True when forecasts are served from a stale fallback. Currently false for this endpoint because get-forecasts does not have a stale fallback cache.
Stable machine-readable reason when degraded=true, empty otherwise. Value: "forecast_backend_unavailable" on Redis/backend read failures.
