Get the Moon's CURRENT (right-now) position and phase: zodiac sign, ecliptic longitude, phase name (e.g. "Waxing Gibbous"), and illumination percentage. Use this when the user asks "what sign is the moon in right now?", "what phase is the moon in today?", or "how full is the moon tonight?" — anything about the present moment, not a future/past date.

Args: tz: IANA timezone name for any timestamps in the response (e.g. "America/New_York", "Europe/London"). Defaults to "UTC".

List New Moon / First Quarter / Full Moon / Last Quarter events within a date range. Use this when the user asks "when is the next full moon?", "list the moon phases this month", or "when was the last new moon?". If no range is given, the API defaults to now through +90 days.

Args: from_date: Start of the range, ISO 8601 (e.g. "2026-08-01"). Omit for "starting now". to_date: End of the range, ISO 8601 (e.g. "2026-11-01"). Omit for "90 days from the start". tz: IANA timezone name for the returned event timestamps and any local-time labeling. Defaults to "UTC".

List Moon zodiac sign ingress events (the exact moments the Moon moves from one zodiac sign into the next) within a date range. Use this when the user asks "when does the moon enter Scorpio?", "what sign is the moon moving into next?", or wants a schedule of moon-sign changes. If no range is given, the API defaults to now through +90 days.

Args: from_date: Start of the range, ISO 8601 (e.g. "2026-08-01"). Omit for "starting now". to_date: End of the range, ISO 8601 (e.g. "2026-11-01"). Omit for "90 days from the start". tz: IANA timezone name for the returned event timestamps. Defaults to "UTC".

List Void-of-Course Moon windows (periods between the Moon's last major aspect in a sign and its ingress into the next sign) within a date range. Use this when the user asks "when is the moon void of course this week?" or "is the moon VOC right now?". If no range is given, the API defaults to now through +90 days.

Args: from_date: Start of the range, ISO 8601 (e.g. "2026-08-01"). Omit for "starting now". to_date: End of the range, ISO 8601 (e.g. "2026-11-01"). Omit for "90 days from the start". tz: IANA timezone name for the returned event timestamps. Defaults to "UTC".

Compute the natal (birth) Moon placement for a specific birth date and time: Moon zodiac sign, Moon phase at that moment, and illumination percentage. Use this when the user asks "what was my moon sign?" or gives a specific birth date/time and wants their Moon placement. If the user only knows their birth date and not the exact time, use the default "12:00" and tell them the sign may be inexact if the Moon changed signs that day.

Args: date: Birth date, ISO 8601 (e.g. "1994-03-21"). Required. time: Birth time in 24-hour HH:MM format (e.g. "14:30"). Defaults to "12:00" (noon) if unknown. tz: IANA timezone name for the birth location at the time of birth (e.g. "America/Chicago"). Defaults to "UTC" — for an accurate result this should be the timezone that was in effect at the birth location and date, not the user's current timezone.

List Mercury retrograde windows (paired start/end dates) within a date range. Use this when the user asks "when is the next Mercury retrograde?", "is Mercury retrograde right now?", or wants a schedule of upcoming retrograde periods. If no range is given, the API defaults to now through +90 days — for "is it retrograde right now" pass a range that starts before today.

Args: from_date: Start of the range, ISO 8601 (e.g. "2026-01-01"). Omit for "starting now". to_date: End of the range, ISO 8601 (e.g. "2026-12-31"). Omit for "90 days from the start".

List solstices, equinoxes, and cross-quarter days (the astronomical solar-year turning points) within a date range. Use this when the user asks "when is the next equinox?", "when does summer solstice happen this year?", or wants the solar calendar. If no range is given, the API defaults to now through +90 days.

Args: from_date: Start of the range, ISO 8601 (e.g. "2026-01-01"). Omit for "starting now". to_date: End of the range, ISO 8601 (e.g. "2026-12-31"). Omit for "90 days from the start". tz: IANA timezone name for the returned event timestamps. Defaults to "UTC".

List the Wheel of the Year sabbats (Samhain, Yule, Imbolc, Ostara, Beltane, Litha, Lughnasadh, Mabon) with their dates for a given year and hemisphere. Use this when the user asks "when is Samhain this year?", "list the sabbats for 2026", or asks about the pagan/wiccan wheel of the year. Southern hemisphere sabbat dates are offset by ~6 months from northern hemisphere ones (the seasonal correspondence flips).

Args: year: Calendar year (e.g. 2026). Omit to use the current year. hemisphere: Either "north" or "south". Defaults to "north".

FLAGSHIP tool: get a single merged, chronological "cosmic weather" feed combining every event type (moon phases, sign ingresses, void-of-course windows, Mercury retrogrades, solar terms, sabbats) for the next N days, plus a human-readable headline summarizing the period. Use this as the default/first tool when the user asks broad questions like "what's the cosmic weather this week?", "what's happening in the sky today?", "give me an astrology overview for the next few days", or anything that isn't obviously scoped to just one event type — it's the richest single call and usually answers the question without needing any other tool.

Args: days: How many days ahead to include, starting from now. Defaults to 7. Use larger values (e.g. 30) for "this month" style questions. tz: IANA timezone name for event timestamps and local-time labeling. Defaults to "UTC".

Check whether the Ephemeris & Cosmic-Weather API is currently reachable and healthy. Use this to diagnose connection problems before assuming a specific data tool is broken — e.g. if another tool call fails with a connection or timeout error, call this first to confirm whether the issue is the service being down versus something else. This endpoint requires no API key.