Retrograde Status
ephemeris_retrograde_statusCheck whether one planet or all ten are retrograde at a given datetime, returning status, speed and station proximity for astrological or historical queries.
Instructions
Use this when the user asks 'is Mercury retrograde right now', 'was Mars retrograde when I was born' or 'which planets are retrograde at the moment'. Returns is_retrograde, speed and station proximity for one planet (Mercury is planet_id=2) or all ten.
CREDIT COST: 1 credit per planet (10 for all).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"datetime": "<datetime>"
},
"name": "ephemeris_retrograde_status"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| datetime | Yes | ISO 8601; zone required (`Z`/offset, or local time plus `timezone`). | |
| timezone | No | IANA zone for a local datetime. | |
| planet_id | No | 0 Sun, 1 Moon, 2–9 Mercury–Pluto. 1 credit; omit for all ten (10 credits). |