Tools / Night Sky
Night Sky icon

Night Sky

Stars, planets, and moon phases

See which planets and stars are visible from any location, get moon phases, sunrise/sunset times, upcoming eclipses, and celestial events like equinoxes, solstices, meteor showers, and asteroid approaches. Data from the US Naval Observatory and NASA JPL.

5 skillsv0.02
What's Visible

Find which planets and bright stars are visible from a location at a given time. Returns all celestial objects above the horizon with altitude, compass direction, and object type.

Returns: List of visible celestial objects (planets and bright stars) above the horizon, sorted by altitude with compass directions
Parameters
latitude *numberLatitude of the observation location (e.g. 34.05 for Los Angeles)
longitude *numberLongitude of the observation location (e.g. -118.24 for Los Angeles)
datestringDate in YYYY-MM-DD format (default: today)
timestringTime in HH:MM format, 24-hour (default: 21:00)
timezone_offsetnumberHours offset from UTC (e.g. -7 for PDT, 0 for UTC, 1 for CET). Default 0.
Example
What planets and stars are visible tonight from Los Angeles
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "night-sky",
  "skill": "whats_visible",
  "input": {
    "latitude": 34.05,
    "longitude": -118.24,
    "time": "21:00",
    "timezone_offset": -7
  }
}' \
  https://api.toolrouter.com/v1/tools/call
Moon Phase

Get the current moon phase, illumination percentage, moonrise and moonset times, and the dates of the next four major phases. Provide coordinates for location-specific moonrise/moonset times.

Returns: Current moon phase, illumination, moonrise/moonset times, and upcoming phase dates
Parameters
datestringDate in YYYY-MM-DD format (default: today)
latitudenumberLatitude for moonrise/moonset times (optional)
longitudenumberLongitude for moonrise/moonset times (optional)
timezone_offsetnumberHours offset from UTC (default 0)
Example
Current moon phase and upcoming phases
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "night-sky",
  "skill": "moon_phase",
  "input": {
    "date": "2026-03-22"
  }
}' \
  https://api.toolrouter.com/v1/tools/call
Sun & Moon Times

Get sunrise, sunset, moonrise, moonset, civil twilight begin and end, moon phase, and total daylight hours for any location and date. Essential for planning outdoor activities, photography, or stargazing.

Returns: Sunrise, sunset, moonrise, moonset, twilight times, moon phase, and daylight hours
Parameters
latitude *numberLatitude of the location (e.g. 40.71 for New York)
longitude *numberLongitude of the location (e.g. -74.01 for New York)
datestringDate in YYYY-MM-DD format (default: today)
timezone_offsetnumberHours offset from UTC (default 0)
Example
Sunrise and sunset for New York today
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "night-sky",
  "skill": "sun_and_moon_times",
  "input": {
    "latitude": 40.71,
    "longitude": -74.01,
    "timezone_offset": -4
  }
}' \
  https://api.toolrouter.com/v1/tools/call
Eclipse Forecast

Get upcoming solar and lunar eclipses for a given year, including dates, types (total, annular, partial, penumbral), and timing. Solar eclipse data from the US Naval Observatory; lunar eclipses from NASA GSFC catalog (2025-2040).

Returns: List of solar and lunar eclipses for the year with dates, types, and UTC times
Parameters
yearnumberYear to check for eclipses (default: current year)
Example
All solar and lunar eclipses in 2026
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "night-sky",
  "skill": "eclipse_forecast",
  "input": {
    "year": 2026
  }
}' \
  https://api.toolrouter.com/v1/tools/call
Celestial Events

Get a combined timeline of upcoming astronomical events including equinoxes, solstices, meteor shower peaks, and asteroid close approaches to Earth. Data from the US Naval Observatory and NASA JPL, plus well-known annual meteor shower dates.

Returns: Combined chronological timeline of equinoxes, solstices, meteor shower peaks, and asteroid close approaches
Parameters
start_datestringStart date in YYYY-MM-DD format (default: today)
daysnumberNumber of days to look ahead (default: 30, max: 365)
Example
Celestial events in the next 30 days
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "night-sky",
  "skill": "celestial_events",
  "input": {
    "start_date": "2026-03-22"
  }
}' \
  https://api.toolrouter.com/v1/tools/call
Loading reviews...
Loading activity...
v0.022026-03-22
  • eclipse_forecast now includes lunar eclipses alongside solar eclipses
  • celestial_events now includes major meteor shower peaks (Quadrantids, Lyrids, Eta Aquariids, Perseids, Orionids, Leonids, Geminids, Ursids)
v0.012026-03-22
  • Initial release with 5 skills: whats_visible, moon_phase, sun_and_moon_times, eclipse_forecast, celestial_events

Quick Start

MCP (Claude Code)
claude mcp add --transport stdio \
  --env TOOLROUTER_API_KEY=YOUR_API_KEY \
  toolrouter -- npx -y toolrouter-mcp
REST API
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{"tool":"night-sky","skill":"whats_visible","input":{}}' \
  https://api.toolrouter.com/v1/tools/call

Frequently Asked Questions

What can I see from my location tonight?

`whats_visible` shows planets and bright stars above the horizon for a specific latitude and longitude, sorted by altitude with compass direction.

Can it tell me sunrise, sunset, moonrise, and moonset?

Yes. `sun_and_moon_times` returns sunrise, sunset, moonrise, moonset, civil twilight, and daylight hours. `moon_phase` adds the current phase and the next major phases.

Does it include eclipses and meteor showers?

`eclipse_forecast` lists upcoming solar and lunar eclipses by year, and `celestial_events` adds equinoxes, solstices, meteor shower peaks, and asteroid close approaches.

Do I need exact coordinates and a time zone?

For location-based results, pass latitude, longitude, and `timezone_offset`. `moon_phase` can work from a date alone if you only need phase timing.