MoveSurge

Explained price moves

explained_moves

Read-only

Abnormal price moves that MoveSurge detected first and then investigated, each with the cause it found, the evidence, a confidence level and how the move followed through. Use for 'why did oil / the Nasdaq / a stock suddenly move' when no single headline explains it. Only moves whose cause was established with medium or high confidence are published.

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": "explained_moves"
  }
}

Input Schema

Name	Required	Description
`asset`	No	Restrict to one instrument symbol, e.g. WTI or NQ.
`hours`	No	Look back 1-1440 hours; default 72. Older results are historical investigations.
`limit`	No	Max results (1-50, default 10).
`end_utc`	No	Exclusive end timestamp with timezone. Overrides the relative look-back window.
`start_utc`	No	Inclusive start timestamp with timezone, e.g. 2026-10-14T00:00:00-04:00.

Output Schema

Name	Required	Description
`count`	Yes
`error`	No
`moves`	Yes
`as_of_utc`	No
`data_note`	No
`data_status`	No
`query_window`	No
`window_hours`	No
`withheld_rows`	No
`returned_counts`	No
`availability_note`	No
`newest_result_utc`	No
`measured_news_moves`	No	Only when no investigation matched: the largest price moves measured around headlines in the same window. Not investigations.
`measured_news_moves_basis`	No
`latest_published_investigation_utc`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedOct 31, 2026

addedOutput schema / properties / measured_news_moves

Added value: +{
+  "description": "Only when no investigation matched: the largest price moves measured around headlines in the same window. Not investigations.",
+  "items": {
+    "properties": {
+      "category": {
+        "type": "string"
+      },
+      "context": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "headline": {
+        "type": "string"
+      },
+      "id": {
+        "type": "string"
+      },
+      "impact": {
+        "type": "string"
+      },
+      "market_reaction": {
+        "properties": {
+          "instruments": {
+            "items": {
+              "properties": {
+                "baseline_kind": {
+                  "type": "string"
+                },
+                "baseline_utc": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "currency": {
+                  "type": "string"
+                },
+                "label": {
+                  "description": "Display name of the measured series.",
+                  "type": "string"
+                },
+                "move_10m_pct": {
+                  "description": "Percent move 10 minutes after the headline, measured from price_before.",
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "move_1m_pct": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "notes": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "price_10m": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "price_1m": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "price_before": {
+                  "description": "Price immediately before the headline crossed.",
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "samples": {
+                  "items": {
+                    "properties": {
+                      "change_pct": {
+                        "type": [
+                          "number",
+                          "null"
+                        ]
+                      },
+                      "minutes": {
+                        "type": "integer"
+                      },
+                      "price": {
+                        "type": [
+                          "number",
+                          "null"
+                        ]
+                      },
+                      "sample_utc": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      }
+                    },
+                    "type": "object"
+                  },
+                  "type": "array"
+                },
+                "session": {
+                  "type": "string"
+                },
+                "symbol": {
+                  "type": "string"
+                },
+                "volume": {
+                  "type": "string"
+                },
+                "volume_quality": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "volume_ratio_10m": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "window_minutes": {
+                  "type": "integer"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "interpretation": {
+            "type": "string"
+          },
+          "measured_from": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "price_data_status": {
+        "type": "string"
+      },
+      "published_et": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "published_utc": {
+        "format": "date-time",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "read_through": {
+        "items": {
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "related_companies": {
+        "type": "object"
+      },
+      "screen_matches": {
+        "items": {
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "tickers": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "url": {
+        "format": "uri",
+        "type": "string"
+      },
+      "why": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "id",
+      "headline"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedOutput schema / properties / measured_news_moves_basis
```
Added value: +{
+  "type": "string"
+}
```

Changed8 schema fields changedOct 19, 2026

addedInput schema / properties / end_utc

Added value: +{
+  "description": "Exclusive end timestamp with timezone. Overrides the relative look-back window.",
+  "type": "string"
+}

changedInput schema / properties / hours / description

Previous value: -"Look-back window in hours (1-336, default 72)."New value: +"Look back 1-1440 hours; default 72. Older results are historical investigations."

addedInput schema / properties / start_utc

Added value: +{
+  "description": "Inclusive start timestamp with timezone, e.g. 2026-10-14T00:00:00-04:00.",
+  "type": "string"
+}

addedOutput schema / properties / availability_note
```
Added value: +{
+  "type": "string"
+}
```
addedOutput schema / properties / error
```
Added value: +{
+  "type": "string"
+}
```
addedOutput schema / properties / latest_published_investigation_utc
```
Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
```
addedOutput schema / properties / query_window
```
Added value: +{
+  "type": "object"
+}
```
addedOutput schema / properties / withheld_rows
```
Added value: +{
+  "type": "object"
+}
```

Changed6 schema fields changedOct 18, 2026
- addedOutput schema / properties / as_of_utc
```
Added value: +{
+  "type": "string"
+}
```
- addedOutput schema / properties / data_note
```
Added value: +{
+  "type": "string"
+}
```
- addedOutput schema / properties / data_status
```
Added value: +{
+  "type": "string"
+}
```
- addedOutput schema / properties / moves / items / properties / url
```
Added value: +{
+  "type": "string"
+}
```
- addedOutput schema / properties / newest_result_utc
```
Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
```
- addedOutput schema / properties / returned_counts
```
Added value: +{
+  "type": "object"
+}
```
AddedOct 3, 2026

TDQS

A4/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already cover the read-only, non-destructive, closed-world profile, so the description earns credit for adding the publication filter (medium/high confidence only) and the evidence/confidence payload. It does not discuss result volume, ordering, or rate limits, which keeps it from a 5.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three sentences, front-loaded with what the tool returns, then usage, then a coverage caveat. Every sentence carries information an agent needs.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present, return-field detail is a bonus rather than a requirement, and the description still sketches the payload. The remaining gap is how this relates to sibling mover/headline tools when a headline does explain the move.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so symbol, hour window, limit and timestamp bounds are already fully documented in the schema. The description adds nothing about parameter behavior; baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names the resource precisely (abnormal moves that were detected and then investigated) and enumerates what each record carries: cause, evidence, confidence and follow-through. This clearly separates it from a raw movers list, though no sibling tool is named to nail the boundary.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives an explicit trigger ('why did oil / the Nasdaq / a stock suddenly move') plus a qualifying condition ('when no single headline explains it'), which implicitly routes headline-driven questions elsewhere. It stops short of naming the alternative tool or stating when not to use it.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All MoveSurge tools Inspect

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

Need Help?