Find the eclipses of a year for a birth chart
get_eclipsesCalculates the solar and lunar eclipses of a year against a birth chart: each eclipse's date and type, the sidereal sign and nakshatra it falls in, the house it falls in counted from the rising sign and from the birth Moon, and the traditional reading of that count from the Moon sign. For a place it also says whether the eclipse is visible there, the local times of each contact and the Sutak window. Use it when someone asks about upcoming eclipses (grahan), whether one is visible where they live, its Sutak times, or where an eclipse falls in their chart.
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": {
"birth_date": "<birth_date>",
"birth_time": "<birth_time>",
"birth_place": "<birth_place>"
},
"name": "get_eclipses"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | No | Optional. The calendar year, from last year to ten years ahead. Defaults to this year. | |
| latitude | No | Optional. Latitude of the birth place in decimal degrees, north positive. Give it only together with longitude, when the user supplied coordinates or the place could not be found by name. | |
| longitude | No | Optional. Longitude of the birth place in decimal degrees, east positive. Give it only together with latitude. | |
| birth_date | Yes | Date of birth as YYYY-MM-DD, for example 1990-01-15 for 15 January 1990. People write dates in different orders: day first in India and most countries, month first in the United States. Convert what the person wrote to YYYY-MM-DD yourself. If an all-number date could be read two ways, such as 05-06-1990, ask which number is the day before calling; never assume. | |
| birth_time | Yes | Local clock time of birth at the birth place, 24-hour HH:MM, for example 10:30, or 16:26 for 4:26 PM. If the person gave an hour from 1 to 12 without AM or PM, ask which before calling. Ask the user if the time is unknown; do not guess it. | |
| birth_place | Yes | City and country of birth, for example "Mumbai, India". | |
| viewing_place | No | Optional. City and country to check visibility and local times for. Defaults to the birth place. | |
| viewing_latitude | No | Optional. Latitude of the viewing place. Only together with viewing_longitude. | |
| viewing_longitude | No | Optional. Longitude of the viewing place. Only together with viewing_latitude. |