Sunrise, Sunset and Moon Times for a Date Range up to a Year (Sunrise-Sunset.org)
sunrisesunset/sun-times-range
Returns the sun and moon times for every day from a start date to an end date at one latitude and longitude, up to 366 days in a single call: per day the sunrise, sunset, solar noon, day length, twilights, golden hour, blue hour, moonrise, moonset and moon phase. The range counts as one call whatever its length. Sun data by Sunrise-Sunset.org, served by Eden Engine; not an official Sunrise-Sunset.org product.
Price
$0.0026 per call
You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.
Data source
Sun data by Sunrise-Sunset.org (https://sunrise-sunset.org). Served by Eden Engine; not an official Sunrise-Sunset.org product.
Use it
Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.
Connect once and your AI can find and run this tool, and any other it needs.
// 1. search: find the tool
omnial_search({ query: "what you need" })
// 2. inspect: price and input schema
omnial_inspect({ tool: "sunrisesunset/sun-times-range" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "sunrisesunset/sun-times-range" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "sunrisesunset/sun-times-range", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "sunrisesunset/sun-times-range", input: { /* ... */ } })
// 5. settle: the call is charged when it finishes, nothing to doNot connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.
Pricing
Every charge this tool can incur.
| Charge | Price |
|---|---|
Per call | $0.0026 |
- Updated
- Oct 21, 2026
Input and output schemas
Input schema
{
"type": "object",
"required": [
"lat",
"lng",
"date_start",
"date_end"
],
"properties": {
"tz": {
"type": "string",
"pattern": "^[A-Za-z0-9_+\\-/]+$",
"maxLength": 64,
"minLength": 3,
"description": "Optional IANA timezone name such as Europe/Madrid or America/Los_Angeles to express the times in. Leave out to use the location's own timezone. Abbreviations like PST are refused."
},
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitude in decimal degrees, -90 to 90, for example 36.72016."
},
"lng": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitude in decimal degrees, -180 to 180, for example -4.42034."
},
"date_end": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day, YYYY-MM-DD, at most 366 days after the first."
},
"date_start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First day, YYYY-MM-DD."
}
},
"additionalProperties": false
}Output schema
{
"type": "object",
"required": [
"days"
],
"properties": {
"lat": {
"type": "number"
},
"lng": {
"type": "number"
},
"days": {
"type": "array",
"items": {
"type": "object",
"required": [
"date"
],
"properties": {
"date": {
"type": "string",
"description": "The calendar day, YYYY-MM-DD."
},
"dawn": {
"type": [
"string",
"null"
]
},
"dusk": {
"type": [
"string",
"null"
]
},
"sunset": {
"type": [
"string",
"null"
],
"description": "Sunset, ISO 8601 with offset; null when the sun does not set that day."
},
"moonset": {
"type": [
"string",
"null"
]
},
"sunrise": {
"type": [
"string",
"null"
],
"description": "Sunrise, ISO 8601 with offset; null when the sun does not rise that day."
},
"moonrise": {
"type": [
"string",
"null"
]
},
"blue_hour": {
"type": [
"object",
"null"
],
"description": "{morning, evening}, each {begin, end}.",
"additionalProperties": true
},
"day_length": {
"type": [
"integer",
"null"
],
"description": "Seconds of daylight; 0 in polar night, null on a transition day."
},
"last_light": {
"type": [
"string",
"null"
]
},
"moon_phase": {
"type": [
"string",
"null"
],
"description": "Phase name such as First Quarter."
},
"solar_noon": {
"type": [
"string",
"null"
],
"description": "Solar noon."
},
"sun_status": {
"type": "string",
"description": "normal, polar_day or polar_night."
},
"utc_offset": {
"type": "string",
"description": "UTC offset of the timezone that day."
},
"first_light": {
"type": [
"string",
"null"
]
},
"golden_hour": {
"type": [
"object",
"null"
],
"description": "{morning, evening}, each {begin, end}.",
"additionalProperties": true
},
"solar_position": {
"type": [
"object",
"null"
],
"description": "Azimuths at sunrise, sunset and solar noon, and the noon altitude, in degrees.",
"additionalProperties": true
},
"moon_illumination": {
"type": [
"number",
"null"
],
"description": "Percent of the moon lit."
},
"civil_twilight_end": {
"type": [
"string",
"null"
]
},
"civil_twilight_begin": {
"type": [
"string",
"null"
]
},
"nautical_twilight_end": {
"type": [
"string",
"null"
]
},
"nautical_twilight_begin": {
"type": [
"string",
"null"
]
},
"astronomical_twilight_end": {
"type": [
"string",
"null"
]
},
"astronomical_twilight_begin": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
},
"description": "One entry per day, in date order."
},
"tzid": {
"type": "string",
"description": "IANA timezone the times are expressed in."
}
},
"additionalProperties": true
}