chuk-mcp-celestial

Get upcoming moon phases starting from a given date.

Returns the next N moon phase occurrences (New Moon, First Quarter, Full Moon, Last Quarter) with exact times. Useful for planning astronomical observations, photography, or understanding lunar cycles.

Args: date: Start date in YYYY-MM-DD format. No leading zeros required (e.g., "2024-1-5" is valid). Valid range: 1700-01-01 to 2100-12-31 num_phases: Number of phases to return (1-99). Default is 12 (about 3 months of phases). Each lunar cycle has 4 phases, so 12 phases = 3 complete cycles.

Returns: MoonPhasesResponse: Contains: - phasedata: List of phase occurrences with exact dates and times - Each phase includes: phase name, year, month, day, time (in UT1)

Tips for LLMs: - All times are in Universal Time (UT1), not local time - A complete lunar cycle is about 29.5 days (4 phases) - Use num_phases=4 for the next month, 12 for next quarter, 48 for next year - Moon phases are useful for: astronomy, photography (full moon lighting), fishing/hunting (activity patterns), gardening (traditional planting cycles)

Example: # Get next 12 moon phases starting from May 3, 2009 phases = await get_moon_phases("2009-5-3", num_phases=12) for phase in phases.phasedata: print(f"{phase.phase} on {phase.year}-{phase.month}-{phase.day} at {phase.time} UT")