Solar position and irradiance
get_solar_positionThe sun's position at one instant: azimuth, altitude, zenith, declination, hour angle and equation of time, plus clear-sky irradiance (GHI, DNI and DHI in W/m²) when include asks for it and the plan covers it. Use it for where the sun is at a given moment; for its track through a whole day use get_solar_path, and for rise and set times use get_sun_moon_times. timestamp defaults to now. Positions are NREL SPA-equivalent on JPL DE421; irradiance comes from the Bird clear-sky model. Requires an API key on a paid Solar 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_solar_position"
}
}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. | |
| include | No | position (default) or position,irradiance. | |
| 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. | |
| timestamp | No | ISO 8601 instant, e.g. 2026-06-21T12:00:00Z. Defaults to now. |