AstroWay Platform

Stream Retrograde Alerts

astroway_stream_retrograde_alerts

All planets retro state + next stations.

[Group: Real-time Streaming] [Endpoint: POST /v1/stream/retrograde-alerts] [Cost: 10 credits (Tier 1)]

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

Input Schema

Name	Required	Description	Default
`fields`	No	Compact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
`precision`	No	Compact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output Schema

Name	Required	Description	Default
`planets`	No
`pricing`	No
`timestamp`	No
`transport`	No
`sseUpgrade`	No
`nextEventAt`	No
`tickSeconds`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed13 schema fields changedNov 7, 2026

removedOutput schema / properties / nextEventAt / anyOf

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

addedOutput schema / properties / nextEventAt / type
```
Added value: +[
+  "string",
+  "null"
+]
```

changedOutput schema / properties / planets / anyOf

Previous value: -[
-  {
-    "items": {
-      "anyOf": [
-        {
-          "additionalProperties": {},
-          "properties": {
-            "currentLongitude": {
-              "anyOf": [
-                {
-                  "type": "number"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "currentlyRetrograde": {
-              "anyOf": [
-                {
-                  "type": "boolean"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "daysToStation": {
-              "anyOf": [
-                {
-                  "type": "number"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "nextStationAt": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "nextStationType": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "planet": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "sign": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "speed": {
-              "anyOf": [
-                {
-                  "type": "number"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            }
-          },
-          "type": "object"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "type": "array"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "items": {
+      "anyOf": [
+        {
+          "additionalProperties": {},
+          "properties": {
+            "currentLongitude": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "currentlyRetrograde": {
+              "type": [
+                "boolean",
+                "null"
+              ]
+            },
+            "daysToStation": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "nextStationAt": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "nextStationType": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "planet": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "sign": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "speed": {
+              "type": [
+                "number",
+                "null"
+              ]
+            }
+          },
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "type": "array"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / pricing / anyOf

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

addedOutput schema / properties / pricing / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedOutput schema / properties / sseUpgrade / anyOf

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

addedOutput schema / properties / sseUpgrade / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedOutput schema / properties / tickSeconds / anyOf

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

addedOutput schema / properties / tickSeconds / type
```
Added value: +[
+  "number",
+  "null"
+]
```

removedOutput schema / properties / timestamp / anyOf

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

addedOutput schema / properties / timestamp / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedOutput schema / properties / transport / anyOf

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

addedOutput schema / properties / transport / type
```
Added value: +[
+  "string",
+  "null"
+]
```

First observedOct 5, 2026

TDQS

B3.2/5.0

Behavior3/5

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

Annotations already declare openWorldHint=true, idempotentHint=false, destructiveHint=false, and notably readOnlyHint=false, so the agent knows this is a non-idempotent, non-destructive, world-touching call. The description adds genuinely useful context beyond that — POST endpoint and a concrete 10-credit Tier 1 cost — but says nothing about whether this is a live stream or a one-shot snapshot, nor about rate limits or payload cadence, which matters for a tool whose name and path both say "stream".

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?

One telegraphic line of substance plus three bracketed metadata lines — zero filler and the payload summary is front-loaded. The main line is a sentence fragment ("All planets retro state") rather than a complete statement, which slightly reduces immediate readability but not economy.

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

Completeness3/5

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

An output schema exists, so return values need not be explained, and the two optional params are fully documented in schema. What is missing for a streaming/credit-metered tool is the delivery model (stream vs. single response), what "next stations" means in terms of horizon, and whether the 10-credit cost is per call or per stream — gaps an agent would need to know before invoking.

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%: `fields` and `precision` are fully documented in the schema, including the dotted-path syntax and the 0–15 precision range, so the description carries no additional burden. The description adds no parameter meaning of its own, which is the correct baseline when the schema does the work.

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?

"All planets retro state + next stations" names the exact resource and the two things returned (current retrograde state and upcoming stations), which is more specific than the tool name alone. It does not distinguish this from near-neighbors such as astroway_webhooks_retrograde_start / astroway_webhooks_retrograde_end or astroway_stream_transit_alerts, so an agent cannot rule out the siblings from the text alone.

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

Usage Guidelines2/5

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

There is no when-to-use guidance, no exclusions, and no pointer to alternatives. The only orienting signals are the bracketed Group/Endpoint/Cost metadata, which tell the agent where the call goes but not when to choose it over the webhook retrograde tools or the transit-alert stream.

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

All AstroWay Platform tools Inspect

Try in Browser

Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?