Sun and moon times
get_sun_moon_timesSunrise, sunset, solar noon, civil, nautical and astronomical twilight, golden and blue hour, moonrise, moonset and moon phase for a location, one entry per day. Use it for any question about when the sun or moon rises, sets or gets dark; for the sun's angle at a given moment use get_solar_position, and for tides alongside the sun use get_tide_window. Pass elevation whenever you know it: it shifts sunrise and sunset at altitude. Defaults: from today, 7 days or the plan's limit if lower. Requires an API key on a paid Ephemerides plan.
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": {
"lat": "<lat>",
"lon": "<lon>"
},
"name": "get_sun_moon_times"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tz | No | IANA timezone for output timestamps, e.g. Europe/Dublin. Defaults to UTC. | |
| lat | Yes | Latitude in decimal degrees. | |
| lon | Yes | Longitude in decimal degrees. | |
| days | No | Number of days to return. The ceiling is plan-dependent. | |
| elevation | No | Metres. For sun and moon times this is the observer's height above the horizon they look across: on a sea cliff or island peak, their height above sea level; on a plateau or in a valley, close to zero. For irradiance it is height above sea level. Supply it when known: from a height the sun rises measurably earlier than the sea-level answer. Omit only if it is genuinely unknown. | |
| start_date | No | First day as YYYY-MM-DD. Defaults to today. |