Find Eclipses
find_eclipsesSearch lunar and solar eclipses in a date range up to 30 years. Returns the sign and longitude of the eclipsed luminary, and optionally shows local solar eclipse visibility.
Instructions
Find lunar and solar eclipses in a date range (max 30 years), with the sign and longitude of the eclipsed luminary — the astrologically relevant datum.
When latitude/longitude are provided, each solar eclipse also reports whether it is visible from that location and how much of the Sun is obscured there.
Examples:
"Eclipses in 2026" -> { from_datetime: "2026-01-01", to_datetime: "2027-01-01" }
"Will I see the August 2026 eclipse from Riga?" -> add latitude: 56.95, longitude: 24.11
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": {
"from_datetime": "<from_datetime>",
"to_datetime": "<to_datetime>"
},
"name": "find_eclipses"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| types | No | Restrict to lunar or solar eclipses. Default: both. | |
| latitude | No | Observer latitude for local solar-eclipse visibility. | |
| longitude | No | Observer longitude for local solar-eclipse visibility. | |
| to_datetime | Yes | End of the search window (max 30 years after start). | |
| from_datetime | Yes | Start of the search window. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| eclipses | Yes |