Find Returns
find_returnsFind the exact dates of solar, lunar, or planetary returns by specifying a celestial body and a search window, calculated from the natal birth time.
Instructions
Find the exact moments a body returns to its natal longitude — solar returns (the astrological "birthday", one per year), lunar returns (one per ~27.3 days), or any planetary return (e.g. Saturn return, one per ~29.5 years).
Examples:
"My solar return in 2026, born 1990-03-15 15:45 Riga" -> { body: "Sun", natal_datetime: "1990-03-15T15:45", natal_timezone: "Europe/Riga", from_datetime: "2026-01-01", to_datetime: "2027-01-01" }
"When is my Saturn return?" -> body: "Saturn" with a multi-year window around ages 27–31.
To cast the full chart for a return moment, pass the returned datetime to compute_natal_chart with the person's current location.
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": {
"body": "<body>",
"natal_datetime": "<natal_datetime>",
"from_datetime": "<from_datetime>",
"to_datetime": "<to_datetime>"
},
"name": "find_returns"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | Yes | Which body's return to find, e.g. "Sun", "Saturn". | |
| to_datetime | Yes | End of the search window (max 120 years after start). | |
| from_datetime | Yes | Start of the search window. | |
| natal_datetime | Yes | Birth date and time. | |
| natal_timezone | No | IANA timezone the datetime is local to, e.g. "Europe/Riga" or "America/New_York". Omit when the datetime already carries Z or a UTC offset. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| returns | Yes |