chuk-mcp-celestial

Get a complete sky summary — all planets, moon phase, and darkness — in one call.

Returns which planets are visible, their positions and brightness, the current moon phase, and whether the sky is dark enough for observation. This is the recommended tool for "what's in the sky tonight?" questions.

Args: date: Date in YYYY-MM-DD format (e.g., "2026-2-10") time: Time in HH:MM format, 24-hour (e.g., "21:00"). UTC unless timezone specified. latitude: Observer's latitude in decimal degrees (-90 to 90) longitude: Observer's longitude in decimal degrees (-180 to 180) timezone: Timezone offset from UTC in hours (e.g., 0 for GMT, -5 for EST, 1 for CET). When provided, the time parameter is interpreted as local time.

Returns: SkyResponse: GeoJSON Feature containing: - properties.data.visible_planets: Planets above horizon and not lost in sunlight, sorted brightest first. Each has altitude, azimuth, direction, magnitude, constellation, and visibility status. - properties.data.all_planets: All 8 planets regardless of visibility - properties.data.moon: Current phase and illumination percentage - properties.data.is_dark: True if sun is below -6 degrees (civil twilight) - properties.data.summary: One-line text summary for quick display

Tips for LLMs: - Use this instead of calling get_planet_position 8 times - The summary field gives a quick human-readable answer - visible_planets are sorted brightest first (lowest magnitude) - direction field gives compass bearing: "S" = look south, "NE" = northeast - is_dark=False means it's daytime or twilight — planets may not be visible even if above horizon - Combine with weather forecast to check if skies are clear enough to observe

Example: sky = await get_sky( date="2026-2-10", time="21:00", latitude=51.99, longitude=0.84, timezone=0 ) for p in sky.properties.data.visible_planets: print(f"{p.planet}: {p.direction}, magnitude {p.magnitude}, in {p.constellation}") print(sky.properties.data.summary)