Sunrise, Sunset, Twilight, Golden Hour and Moon Times for a Date and Place (Sunrise-Sunset.org)

sunrisesunset/sun-times

Returns the sun and moon times for one date at one latitude and longitude: sunrise, sunset, solar noon, day length, the three twilights, dawn, dusk, golden hour, blue hour, solar azimuths, moonrise, moonset, moon phase and illumination. Times are ISO 8601 in the place's own timezone, or in a timezone you name. Polar days give null times and a sun_status of polar_day or polar_night. Sun data by Sunrise-Sunset.org, served by Eden Engine; not an official Sunrise-Sunset.org product.

activeper callv1

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

Sunrise-Sunset.org

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.

Install it Create an account

agent

// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "sunrisesunset/sun-times" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "sunrisesunset/sun-times" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "sunrisesunset/sun-times", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "sunrisesunset/sun-times", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not 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

input_schema.json

{
  "type": "object",
  "required": [
    "lat",
    "lng",
    "date"
  ],
  "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": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "The day, YYYY-MM-DD, for example 2026-10-20. An explicit date is required so the answer does not change under a cache."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "required": [
    "date",
    "tzid",
    "lat",
    "lng",
    "sun_status"
  ],
  "properties": {
    "lat": {
      "type": "number"
    },
    "lng": {
      "type": "number"
    },
    "date": {
      "type": "string",
      "description": "The calendar day, YYYY-MM-DD."
    },
    "dawn": {
      "type": [
        "string",
        "null"
      ]
    },
    "dusk": {
      "type": [
        "string",
        "null"
      ]
    },
    "tzid": {
      "type": "string",
      "description": "IANA timezone the times are expressed in."
    },
    "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
}