Gate News MCP

news_prediction_get_event_signal

Read-onlyIdempotent

[Read] Single event signal from dws_external_event_signal_hf by event_ref (venue:venue_event_id). window 1h/24h/7d (default 24h). Returns outcome_probabilities, volume_flow, directional_context, optional markets[] (default include_markets=true). depth_summary always null—use get_market_orderbook for live depth. daily_ranking when rank index configured. Discover event_ref -> search_events. include_orderbook_summary ignored. Read-only public research data. No account access, no order placement or fund transfers. Not investment advice.

Input Schema

TableJSON Schema

Name	Required	Description
`venue`	No	Optional; each non-empty value must equal event_ref venue or invalid_param.
`window`	No	Recency filter on part_hour; default 24h. Allowed: 1h, 24h, 7d (case-insensitive).
`event_ref`	Yes	Required. venue:venue_event_id (split on first colon; id may contain more colons). Discover via search_events.
`include_markets`	No	Omitted or null defaults true. false omits markets[]; true parses embedded markets or enriches from predictionMarketIndex.
`include_orderbook_summary`	No	Deprecated and ignored; depth_summary is always null—use get_market_orderbook.

Output Schema

TableJSON Schema

Name	Required	Description
`window`	No
`markets`	No
`partial`	Yes
`duration_ms`	Yes
`signal_time`	Yes
`volume_flow`	Yes
`daily_ranking`	No	nullable
`depth_summary`	Yes	nullable
`event_identity`	Yes
`missing_sources`	Yes
`source_data_status`	Yes
`directional_context`	Yes
`outcome_probabilities`	Yes
`cross_venue_divergence`	No	nullable

Schema Changelog

Changes observed during successful MCP inspections.

Changed73 schema fields changedAug 27, 2026

addedInput schema / additionalProperties
```
Added value: +false
```

changedInput schema / properties / include_markets / type

Previous value: -"boolean"New value: +[
+  "null",
+  "boolean"
+]

changedInput schema / properties / venue / type

Previous value: -"array"New value: +[
+  "null",
+  "array"
+]

addedOutput schema / additionalProperties
```
Added value: +false
```
addedOutput schema / properties / cross_venue_divergence / description
```
Added value: +"nullable"
```

removedOutput schema / properties / cross_venue_divergence / oneOf

Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / cross_venue_divergence / type
```
Added value: +[
+  "null",
+  "number"
+]
```
addedOutput schema / properties / daily_ranking / additionalProperties
```
Added value: +false
```
addedOutput schema / properties / daily_ranking / description
```
Added value: +"nullable"
```

removedOutput schema / properties / daily_ranking / oneOf

Removed value: -[
-  {
-    "properties": {
-      "daily_rank_by_venue": {
-        "additionalProperties": {
-          "properties": {
-            "fastest_rising": {
-              "oneOf": [
-                {
-                  "type": "integer"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "volume_delta": {
-              "oneOf": [
-                {
-                  "type": "integer"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            }
-          },
-          "type": "object"
-        },
-        "type": "object"
-      },
-      "probability_delta_today": {
-        "oneOf": [
-          {
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "volume_delta_usd_today": {
-        "oneOf": [
-          {
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      }
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / daily_ranking / properties

Added value: +{
+  "daily_rank_by_venue": {
+    "additionalProperties": {
+      "additionalProperties": false,
+      "properties": {
+        "fastest_rising": {
+          "description": "nullable",
+          "type": [
+            "null",
+            "integer"
+          ]
+        },
+        "volume_delta": {
+          "description": "nullable",
+          "type": [
+            "null",
+            "integer"
+          ]
+        }
+      },
+      "type": "object"
+    },
+    "type": "object"
+  },
+  "probability_delta_today": {
+    "description": "nullable",
+    "type": [
+      "null",
+      "number"
+    ]
+  },
+  "volume_delta_usd_today": {
+    "description": "nullable",
+    "type": [
+      "null",
+      "number"
+    ]
+  }
+}

addedOutput schema / properties / daily_ranking / type
```
Added value: +[
+  "null",
+  "object"
+]
```
addedOutput schema / properties / depth_summary / additionalProperties
```
Added value: +false
```
addedOutput schema / properties / depth_summary / description
```
Added value: +"nullable"
```

removedOutput schema / properties / depth_summary / oneOf

Removed value: -[
-  {
-    "properties": {
-      "best_no_ask": {
-        "oneOf": [
-          {
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "best_no_bid": {
-        "oneOf": [
-          {
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "best_yes_ask": {
-        "oneOf": [
-          {
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "best_yes_bid": {
-        "oneOf": [
-          {
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "spread_yes": {
-        "oneOf": [
-          {
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      }
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / depth_summary / properties

Added value: +{
+  "best_no_ask": {
+    "description": "nullable",
+    "type": [
+      "null",
+      "number"
+    ]
+  },
+  "best_no_bid": {
+    "description": "nullable",
+    "type": [
+      "null",
+      "number"
+    ]
+  },
+  "best_yes_ask": {
+    "description": "nullable",
+    "type": [
+      "null",
+      "number"
+    ]
+  },
+  "best_yes_bid": {
+    "description": "nullable",
+    "type": [
+      "null",
+      "number"
+    ]
+  },
+  "spread_yes": {
+    "description": "nullable",
+    "type": [
+      "null",
+      "number"
+    ]
+  }
+}

addedOutput schema / properties / depth_summary / type
```
Added value: +[
+  "null",
+  "object"
+]
```
addedOutput schema / properties / directional_context / additionalProperties
```
Added value: +true
```
addedOutput schema / properties / event_identity / additionalProperties
```
Added value: +false
```
addedOutput schema / properties / event_identity / properties / category_ai_primary / description
```
Added value: +"nullable"
```
removedOutput schema / properties / event_identity / properties / category_ai_primary / oneOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / event_identity / properties / category_ai_primary / type
```
Added value: +[
+  "null",
+  "string"
+]
```
changedOutput schema / properties / event_identity / properties / status_tags / type
```
Previous value: -"array"New value: +[
+  "null",
+  "array"
+]
```
addedOutput schema / properties / markets / items / additionalProperties
```
Added value: +false
```
addedOutput schema / properties / markets / items / properties / liquidity_usd / description
```
Added value: +"nullable"
```
removedOutput schema / properties / markets / items / properties / liquidity_usd / oneOf
```
Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / markets / items / properties / liquidity_usd / type
```
Added value: +[
+  "null",
+  "number"
+]
```
addedOutput schema / properties / markets / items / properties / market_category_ai_primary / description
```
Added value: +"nullable"
```
removedOutput schema / properties / markets / items / properties / market_category_ai_primary / oneOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / markets / items / properties / market_category_ai_primary / type
```
Added value: +[
+  "null",
+  "string"
+]
```
addedOutput schema / properties / markets / items / properties / mid_yes_probability / description
```
Added value: +"nullable"
```
removedOutput schema / properties / markets / items / properties / mid_yes_probability / oneOf
```
Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / markets / items / properties / mid_yes_probability / type
```
Added value: +[
+  "null",
+  "number"
+]
```
addedOutput schema / properties / markets / items / properties / price_bar_time / description
```
Added value: +"nullable"
```
removedOutput schema / properties / markets / items / properties / price_bar_time / oneOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / markets / items / properties / price_bar_time / type
```
Added value: +[
+  "null",
+  "string"
+]
```
addedOutput schema / properties / markets / items / properties / probability_change_6h / description
```
Added value: +"nullable"
```
removedOutput schema / properties / markets / items / properties / probability_change_6h / oneOf
```
Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / markets / items / properties / probability_change_6h / type
```
Added value: +[
+  "null",
+  "number"
+]
```
addedOutput schema / properties / markets / items / properties / volume_24h_usd / description
```
Added value: +"nullable"
```
removedOutput schema / properties / markets / items / properties / volume_24h_usd / oneOf
```
Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / markets / items / properties / volume_24h_usd / type
```
Added value: +[
+  "null",
+  "number"
+]
```
addedOutput schema / properties / markets / items / properties / volume_total_usd / description
```
Added value: +"nullable"
```
removedOutput schema / properties / markets / items / properties / volume_total_usd / oneOf
```
Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / markets / items / properties / volume_total_usd / type
```
Added value: +[
+  "null",
+  "number"
+]
```

changedOutput schema / properties / markets / type

Previous value: -"array"New value: +[
+  "null",
+  "array"
+]

changedOutput schema / properties / missing_sources / type

Previous value: -"array"New value: +[
+  "null",
+  "array"
+]

addedOutput schema / properties / outcome_probabilities / additionalProperties
```
Added value: +false
```
addedOutput schema / properties / outcome_probabilities / properties / no_probability / description
```
Added value: +"nullable"
```
removedOutput schema / properties / outcome_probabilities / properties / no_probability / oneOf
```
Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / outcome_probabilities / properties / no_probability / type
```
Added value: +[
+  "null",
+  "number"
+]
```
addedOutput schema / properties / outcome_probabilities / properties / probability_change_1h / description
```
Added value: +"nullable"
```
removedOutput schema / properties / outcome_probabilities / properties / probability_change_1h / oneOf
```
Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / outcome_probabilities / properties / probability_change_1h / type
```
Added value: +[
+  "null",
+  "number"
+]
```
addedOutput schema / properties / outcome_probabilities / properties / probability_change_24h / description
```
Added value: +"nullable"
```
removedOutput schema / properties / outcome_probabilities / properties / probability_change_24h / oneOf
```
Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / outcome_probabilities / properties / probability_change_24h / type
```
Added value: +[
+  "null",
+  "number"
+]
```
addedOutput schema / properties / outcome_probabilities / properties / probability_change_6h / description
```
Added value: +"nullable"
```
removedOutput schema / properties / outcome_probabilities / properties / probability_change_6h / oneOf
```
Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / outcome_probabilities / properties / probability_change_6h / type
```
Added value: +[
+  "null",
+  "number"
+]
```
addedOutput schema / properties / outcome_probabilities / properties / yes_probability / description
```
Added value: +"nullable"
```
removedOutput schema / properties / outcome_probabilities / properties / yes_probability / oneOf
```
Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / outcome_probabilities / properties / yes_probability / type
```
Added value: +[
+  "null",
+  "number"
+]
```
addedOutput schema / properties / volume_flow / additionalProperties
```
Added value: +false
```
addedOutput schema / properties / volume_flow / properties / total_liquidity_usd / description
```
Added value: +"nullable"
```
removedOutput schema / properties / volume_flow / properties / total_liquidity_usd / oneOf
```
Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / volume_flow / properties / total_liquidity_usd / type
```
Added value: +[
+  "null",
+  "number"
+]
```
addedOutput schema / properties / volume_flow / properties / total_volume_usd_24h / description
```
Added value: +"nullable"
```
removedOutput schema / properties / volume_flow / properties / total_volume_usd_24h / oneOf
```
Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / volume_flow / properties / total_volume_usd_24h / type
```
Added value: +[
+  "null",
+  "number"
+]
```
addedOutput schema / properties / volume_flow / properties / volume_delta_usd_today / description
```
Added value: +"nullable"
```
removedOutput schema / properties / volume_flow / properties / volume_delta_usd_today / oneOf
```
Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "null"
-  }
-]
```
addedOutput schema / properties / volume_flow / properties / volume_delta_usd_today / type
```
Added value: +[
+  "null",
+  "number"
+]
```

Changed5 schema fields changedMay 22, 2026

changedInput schema / properties / event_ref / description

Previous value: -"Required. Format venue:venue_event_id (e.g. polymarket:107711)."New value: +"Required. venue:venue_event_id (split on first colon; id may contain more colons). Discover via search_events."

changedInput schema / properties / include_markets / description

Previous value: -"Include parsed markets[] from source_markets_json; default true."New value: +"Omitted or null defaults true. false omits markets[]; true parses embedded markets or enriches from predictionMarketIndex."

changedInput schema / properties / include_orderbook_summary / description

Previous value: -"Deprecated; depth_summary is always null in current version."New value: +"Deprecated and ignored; depth_summary is always null—use get_market_orderbook."

changedInput schema / properties / venue / description

Previous value: -"Optional venue filter; must match event_ref venue when set."New value: +"Optional; each non-empty value must equal event_ref venue or invalid_param."

changedInput schema / properties / window / description

Previous value: -"Signal window; default 24h. Allowed: 1h, 24h, 7d."New value: +"Recency filter on part_hour; default 24h. Allowed: 1h, 24h, 7d (case-insensitive)."

Changed45 schema fields changedMay 20, 2026

addedOutput schema / properties / cross_venue_divergence / oneOf

Added value: +[
+  {
+    "type": "number"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / cross_venue_divergence / type
```
Removed value: -"number"
```

addedOutput schema / properties / daily_ranking / oneOf

Added value: +[
+  {
+    "properties": {
+      "daily_rank_by_venue": {
+        "additionalProperties": {
+          "properties": {
+            "fastest_rising": {
+              "oneOf": [
+                {
+                  "type": "integer"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "volume_delta": {
+              "oneOf": [
+                {
+                  "type": "integer"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "type": "object"
+        },
+        "type": "object"
+      },
+      "probability_delta_today": {
+        "oneOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "volume_delta_usd_today": {
+        "oneOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / daily_ranking / properties

Removed value: -{
-  "daily_rank_by_venue": {
-    "additionalProperties": {
-      "properties": {
-        "fastest_rising": {
-          "type": "integer"
-        },
-        "volume_delta": {
-          "type": "integer"
-        }
-      },
-      "type": "object"
-    },
-    "type": "object"
-  },
-  "probability_delta_today": {
-    "type": "number"
-  },
-  "volume_delta_usd_today": {
-    "type": "number"
-  }
-}

removedOutput schema / properties / daily_ranking / required

Removed value: -[
-  "volume_delta_usd_today",
-  "probability_delta_today"
-]

removedOutput schema / properties / daily_ranking / type
```
Removed value: -"object"
```

addedOutput schema / properties / depth_summary / oneOf

Added value: +[
+  {
+    "properties": {
+      "best_no_ask": {
+        "oneOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "best_no_bid": {
+        "oneOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "best_yes_ask": {
+        "oneOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "best_yes_bid": {
+        "oneOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "spread_yes": {
+        "oneOf": [
+          {
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / depth_summary / properties

Removed value: -{
-  "best_no_ask": {
-    "type": "number"
-  },
-  "best_no_bid": {
-    "type": "number"
-  },
-  "best_yes_ask": {
-    "type": "number"
-  },
-  "best_yes_bid": {
-    "type": "number"
-  },
-  "spread_yes": {
-    "type": "number"
-  }
-}

removedOutput schema / properties / depth_summary / type
```
Removed value: -"object"
```
addedOutput schema / properties / event_identity / properties / category_ai_primary / oneOf
```
Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]
```
removedOutput schema / properties / event_identity / properties / category_ai_primary / type
```
Removed value: -"string"
```

changedOutput schema / properties / event_identity / required

Previous value: -[
-  "event_ref",
-  "venue",
-  "venue_event_id",
-  "venue_event_title",
-  "category_ai_primary",
-  "status_tags",
-  "market_count"
-]New value: +[
+  "event_ref",
+  "venue",
+  "venue_event_id",
+  "venue_event_title",
+  "status_tags",
+  "market_count"
+]

addedOutput schema / properties / markets / items / properties / liquidity_usd / oneOf
```
Added value: +[
+  {
+    "type": "number"
+  },
+  {
+    "type": "null"
+  }
+]
```
removedOutput schema / properties / markets / items / properties / liquidity_usd / type
```
Removed value: -"number"
```
addedOutput schema / properties / markets / items / properties / market_category_ai_primary / oneOf
```
Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]
```
removedOutput schema / properties / markets / items / properties / market_category_ai_primary / type
```
Removed value: -"string"
```
addedOutput schema / properties / markets / items / properties / mid_yes_probability / oneOf
```
Added value: +[
+  {
+    "type": "number"
+  },
+  {
+    "type": "null"
+  }
+]
```
removedOutput schema / properties / markets / items / properties / mid_yes_probability / type
```
Removed value: -"number"
```
addedOutput schema / properties / markets / items / properties / price_bar_time / oneOf
```
Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]
```
removedOutput schema / properties / markets / items / properties / price_bar_time / type
```
Removed value: -"string"
```
addedOutput schema / properties / markets / items / properties / probability_change_6h / oneOf
```
Added value: +[
+  {
+    "type": "number"
+  },
+  {
+    "type": "null"
+  }
+]
```
removedOutput schema / properties / markets / items / properties / probability_change_6h / type
```
Removed value: -"number"
```
addedOutput schema / properties / markets / items / properties / volume_24h_usd / oneOf
```
Added value: +[
+  {
+    "type": "number"
+  },
+  {
+    "type": "null"
+  }
+]
```
removedOutput schema / properties / markets / items / properties / volume_24h_usd / type
```
Removed value: -"number"
```
addedOutput schema / properties / markets / items / properties / volume_total_usd / oneOf
```
Added value: +[
+  {
+    "type": "number"
+  },
+  {
+    "type": "null"
+  }
+]
```
removedOutput schema / properties / markets / items / properties / volume_total_usd / type
```
Removed value: -"number"
```
addedOutput schema / properties / outcome_probabilities / properties / no_probability / oneOf
```
Added value: +[
+  {
+    "type": "number"
+  },
+  {
+    "type": "null"
+  }
+]
```
removedOutput schema / properties / outcome_probabilities / properties / no_probability / type
```
Removed value: -"number"
```
addedOutput schema / properties / outcome_probabilities / properties / probability_change_1h / oneOf
```
Added value: +[
+  {
+    "type": "number"
+  },
+  {
+    "type": "null"
+  }
+]
```
removedOutput schema / properties / outcome_probabilities / properties / probability_change_1h / type
```
Removed value: -"number"
```
addedOutput schema / properties / outcome_probabilities / properties / probability_change_24h / oneOf
```
Added value: +[
+  {
+    "type": "number"
+  },
+  {
+    "type": "null"
+  }
+]
```
removedOutput schema / properties / outcome_probabilities / properties / probability_change_24h / type
```
Removed value: -"number"
```
addedOutput schema / properties / outcome_probabilities / properties / probability_change_6h / oneOf
```
Added value: +[
+  {
+    "type": "number"
+  },
+  {
+    "type": "null"
+  }
+]
```
removedOutput schema / properties / outcome_probabilities / properties / probability_change_6h / type
```
Removed value: -"number"
```
addedOutput schema / properties / outcome_probabilities / properties / yes_probability / oneOf
```
Added value: +[
+  {
+    "type": "number"
+  },
+  {
+    "type": "null"
+  }
+]
```
removedOutput schema / properties / outcome_probabilities / properties / yes_probability / type
```
Removed value: -"number"
```

removedOutput schema / properties / outcome_probabilities / required

Removed value: -[
-  "yes_probability",
-  "no_probability",
-  "probability_change_1h",
-  "probability_change_6h",
-  "probability_change_24h"
-]

addedOutput schema / properties / volume_flow / properties / total_liquidity_usd / oneOf
```
Added value: +[
+  {
+    "type": "number"
+  },
+  {
+    "type": "null"
+  }
+]
```
removedOutput schema / properties / volume_flow / properties / total_liquidity_usd / type
```
Removed value: -"number"
```
addedOutput schema / properties / volume_flow / properties / total_volume_usd_24h / oneOf
```
Added value: +[
+  {
+    "type": "number"
+  },
+  {
+    "type": "null"
+  }
+]
```
removedOutput schema / properties / volume_flow / properties / total_volume_usd_24h / type
```
Removed value: -"number"
```
addedOutput schema / properties / volume_flow / properties / volume_delta_usd_today / oneOf
```
Added value: +[
+  {
+    "type": "number"
+  },
+  {
+    "type": "null"
+  }
+]
```
removedOutput schema / properties / volume_flow / properties / volume_delta_usd_today / type
```
Removed value: -"number"
```

changedOutput schema / properties / volume_flow / required

Previous value: -[
-  "total_volume_usd_24h",
-  "total_liquidity_usd",
-  "volume_delta_usd_today",
-  "source"
-]New value: +[
+  "source"
+]

changedOutput schema / required

Previous value: -[
-  "partial",
-  "missing_sources",
-  "event_identity",
-  "signal_time",
-  "source_data_status",
-  "outcome_probabilities",
-  "depth_summary",
-  "volume_flow",
-  "daily_ranking",
-  "cross_venue_divergence",
-  "directional_context",
-  "duration_ms"
-]New value: +[
+  "partial",
+  "missing_sources",
+  "event_identity",
+  "signal_time",
+  "source_data_status",
+  "outcome_probabilities",
+  "depth_summary",
+  "volume_flow",
+  "directional_context",
+  "duration_ms"
+]

AddedMay 20, 2026

TDQS

A4.6/5.0

Behavior4/5

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

Annotations already declare readOnlyHint, openWorldHint, idempotentHint, and destructiveHint, covering safety. The description adds further context: it is public research data, involves no account access, order placement, or fund transfers, and explicitly states 'Not investment advice'. It also discloses conditional behavior (daily_ranking only when rank index configured) and that include_orderbook_summary is ignored. This goes beyond the annotation set but doesn't fully exhaust every behavioral nuance given the rich annotations.

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

Conciseness4/5

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

The description is a compact single paragraph that front-loads the core purpose before listing outputs and caveats. Every sentence adds distinct information: primary resource, window behavior, return fields, depth disclaimers, discovery path, deprecations, and legal disclaimers. It is efficient but slightly dense, reading more like a specification than a prose explanation, which slightly reduces readability.

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

Completeness5/5

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

Given an output schema exists, the description appropriately skips return-type details. It covers all non-schema context: the window options, default behavior for include_markets, the null depth_summary and the proper alternative, the conditional daily_ranking, the discovery route for event_ref, the deprecated parameter, and the read-only/public nature. Nothing essential for calling this tool correctly is missing.

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

Parameters4/5

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

Schema description coverage is 100%, so the baseline is 3. The description adds meaningful context beyond the schema: it clarifies the event_ref format (split on first colon), specifies the window allowed values, states the default for include_markets, and notes that include_orderbook_summary is deprecated/ignored. This extra explanation enhances parameter understanding without redundancy.

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

Purpose5/5

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

The description explicitly states the tool reads a single event signal from a specific table (dws_external_event_signal_hf) keyed by event_ref in the format venue:venue_event_id. It lists the primary output fields and explicitly contrasts with get_market_orderbook for depth and search_events for discovery, distinguishing it from all sibling tools.

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

Usage Guidelines5/5

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

Clear guidance is provided: when to discover event_ref via search_events and when to use get_market_orderbook for live depth instead of this tool (since depth_summary is always null). It also notes that include_orderbook_summary is ignored, steering agents away from a parameter that won't affect behavior.

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

All Gate News MCP 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.