Skip to main content
Glama

FX Context

by com.coco-pier
OverviewDiscussionsAdmin

get_upcoming_risks

get_upcoming_risks
Read-onlyIdempotent

Retrieve known scheduled macroeconomic and central-bank risks that may affect a supported FX instrument within a future time window.

Use this tool when the user asks what could move EURUSD, GBPUSD, or USDJPY, what macro risks are coming up, what is happening in the next 24 hours, this week, or over the next month, what upcoming macro risks or scheduled events exist, or when the next CPI, next NFP, next PCE, next Fed, next ECB, next BoE, or next BoJ event occurs.

The supported risks are U.S. CPI releases, U.S. Nonfarm Payrolls releases, U.S. PCE inflation releases, Federal Reserve monetary-policy decisions, ECB monetary-policy decisions, Bank of England monetary-policy decisions, and Bank of Japan monetary-policy decisions.

The horizon can extend up to 720 hours (30 days). scheduleCoverage reports, for each supported event type, the latest known scheduled date and whether the known calendar covers the whole window. If scheduleCoverageComplete is false, some event types may have additional events in the window that are not yet known; say so instead of treating the list as complete.

Results are based on official release calendars and contain scheduled events only. This tool does not predict market direction, include unscheduled news, or provide trading recommendations.

If no supported scheduled event exists within the requested horizon, an empty risk list is returned.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
instrumentNoFX instrument: EURUSD, GBPUSD, or USDJPY. Defaults to EURUSD.
horizonHoursNoFuture time window in hours. Defaults to 24. Maximum is 720 (30 days).

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
asOfYes
risksYes
windowEndYes
instrumentYes
horizonHoursYes
scheduleCoverageYes
scheduleCoverageCompleteYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed8 schema fields changed
    • changedInput schema / properties / horizonHours / description
      Previous value: -"Future time window in hours. Defaults to 24. Maximum is 168 (7 days)."New value: +"Future time window in hours. Defaults to 24. Maximum is 720 (30 days)."
    • addedOutput schema / $defs
      Added value: +{
+  "ScheduledEventType": {
+    "enum": [
+      "US_CPI",
+      "US_NONFARM_PAYROLLS",
+      "US_PCE",
+      "FEDERAL_RESERVE",
+      "ECB",
+      "BANK_OF_ENGLAND",
+      "BANK_OF_JAPAN"
+    ],
+    "type": "string"
+  }
+}
    • addedOutput schema / properties / risks / items / properties / eventType / $ref
      Added value: +"#/$defs/ScheduledEventType"
    • removedOutput schema / properties / risks / items / properties / eventType / enum
      Removed value: -[
-  "US_CPI",
-  "US_NONFARM_PAYROLLS",
-  "US_PCE",
-  "FEDERAL_RESERVE",
-  "ECB",
-  "BANK_OF_ENGLAND",
-  "BANK_OF_JAPAN"
-]
    • removedOutput schema / properties / risks / items / properties / eventType / type
      Removed value: -"string"
    • addedOutput schema / properties / scheduleCoverage
      Added value: +{
+  "items": {
+    "properties": {
+      "coversWindow": {
+        "type": "boolean"
+      },
+      "eventType": {
+        "$ref": "#/$defs/ScheduledEventType"
+      },
+      "latestKnownScheduledAt": {
+        "format": "date-time",
+        "type": "string"
+      }
+    },
+    "required": [
+      "coversWindow",
+      "eventType"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}
    • addedOutput schema / properties / scheduleCoverageComplete
      Added value: +{
+  "type": "boolean"
+}
    • changedOutput schema / required
      Previous value: -[
-  "asOf",
-  "horizonHours",
-  "instrument",
-  "risks",
-  "windowEnd"
-]New value: +[
+  "asOf",
+  "horizonHours",
+  "instrument",
+  "risks",
+  "scheduleCoverage",
+  "scheduleCoverageComplete",
+  "windowEnd"
+]
  2. Changed1 schema field changed
    • changedOutput schema / properties / risks / items / properties / eventType / enum
      Previous value: -[
-  "US_CPI",
-  "US_NONFARM_PAYROLLS",
-  "FEDERAL_RESERVE",
-  "ECB",
-  "BANK_OF_ENGLAND",
-  "BANK_OF_JAPAN"
-]New value: +[
+  "US_CPI",
+  "US_NONFARM_PAYROLLS",
+  "US_PCE",
+  "FEDERAL_RESERVE",
+  "ECB",
+  "BANK_OF_ENGLAND",
+  "BANK_OF_JAPAN"
+]
  3. Changed1 schema field changed
    • changedOutput schema / properties / risks / items / properties / eventType / enum
      Previous value: -[
-  "US_CPI",
-  "FEDERAL_RESERVE",
-  "ECB",
-  "BANK_OF_ENGLAND",
-  "BANK_OF_JAPAN"
-]New value: +[
+  "US_CPI",
+  "US_NONFARM_PAYROLLS",
+  "FEDERAL_RESERVE",
+  "ECB",
+  "BANK_OF_ENGLAND",
+  "BANK_OF_JAPAN"
+]
  4. Changed1 schema field changed
    • changedOutput schema / properties / risks / items / properties / eventType / enum
      Previous value: -[
-  "US_CPI",
-  "FEDERAL_RESERVE",
-  "ECB",
-  "BANK_OF_ENGLAND"
-]New value: +[
+  "US_CPI",
+  "FEDERAL_RESERVE",
+  "ECB",
+  "BANK_OF_ENGLAND",
+  "BANK_OF_JAPAN"
+]
  5. Changed1 schema field changed
    • changedOutput schema / properties / risks / items / properties / eventType / enum
      Previous value: -[
-  "US_CPI",
-  "FEDERAL_RESERVE",
-  "ECB"
-]New value: +[
+  "US_CPI",
+  "FEDERAL_RESERVE",
+  "ECB",
+  "BANK_OF_ENGLAND"
+]
  6. Changed1 schema field changed
    • changedInput schema / properties / instrument / description
      Previous value: -"FX instrument. Defaults to EURUSD."New value: +"FX instrument: EURUSD, GBPUSD, or USDJPY. Defaults to EURUSD."
  7. First observed

TDQS

Score is being calculated.

All FX Context toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources