compare_saved_profiles
ChatGPTUse this when the user asks for synastry, relationship dynamics, or compatibility themes between two different profiles they have saved. Returns placements and aspect patterns, not a compatibility score or deterministic relationship verdict. Call list_profiles first when either profile id is unknown.
find_supportive_timing_windows
ChatGPTUse this when the user asks for reflective timing windows for a career, business, relationship, contract, home, or travel goal. Returns symbolic planning signals and caveats, never a guarantee or a replacement for legal, financial, safety, consent, deadline, or market considerations.
get_composite_chart
ChatGPTUse this when the user asks about the shared chart or overall bond between two different saved profiles. A composite chart treats the relationship as a symbolic third entity; use compare_saved_profiles instead for person-to-person synastry. Returns chart evidence, never a relationship score or verdict. Call list_profiles first when either profile id is unknown.
get_current_sky
ChatGPTUse this when the user asks where the planets are on a date, which planets are retrograde, or wants a factual current-sky snapshot that does not require a personal chart.
get_lunar_return_for_profile
ChatGPTUse this when the user asks for a saved person's current lunar-return cycle, monthly return chart, or next lunar-return date. Returns the return on or before the requested date plus the following return; unknown birth times omit houses and angles and are explicitly approximate.
get_moon_forecast
ChatGPTUse this when the user asks about the Moon's current sign or phase, void-of-course timing, the next major lunar phases, or a short lunar forecast.
get_natal_chart
ChatGPTUse this when the user asks for a saved person's birth chart; Sun, Moon, Rising or Ascendant, or Venus sign; natal placements, houses, angles, aspects, or enduring chart patterns. Unknown-time profiles omit time-dependent houses and angles. Call list_profiles first when the profile id is unknown.
get_relationship_weather_for_profiles
ChatGPTUse this when the user asks how today's sky or a specified UTC date symbolically touches the shared relationship chart of two saved profiles. Requires The Astro Diary Plus. Returns deterministic transit-to-composite aspect evidence only, not meteorological weather, behavioral prediction, compatibility scoring, or generated prose. Call list_profiles first when either profile id is unknown.
get_saturn_return_for_profile
ChatGPTUse this when the user asks whether a saved person is near a Saturn return on a date or wants exact direct and retrograde pass dates. Returns the current angular orb and interpolated conjunction passes; it does not predict specific events.
get_secondary_progressions_for_profile
ChatGPTUse this when the user asks for a saved person's progressed chart, progressed Moon, or progressed-to-natal aspects on a date. Returns calculated chart evidence and clearly labels secondary progressions as a symbolic day-for-a-year technique.
get_solar_return_for_profile
ChatGPTUse this when the user asks for a saved person's solar return or birthday-to-birthday chart. With no year, returns the next upcoming solar return. Unknown birth times produce an approximate result without houses or angles.
get_transit_highlights_for_profile
ChatGPTUse this when the user asks for the strongest personal transit days across a short period rather than one specific date. Scans daily samples and returns up to eight highlighted days; call get_transits_for_profile for a detailed single-day snapshot.
get_transit_passages_for_profile
ChatGPTCalculate estimated in-orb beginnings, exact-angle crossings, endings and repeated passages for one specified transit-to-natal aspect. Use a known saved profile. These are interpolated astronomical timings, not predicted events or moods.
get_transits_for_profile
ChatGPTUse this when the user asks what is astrologically active for a saved person on a specific date. Returns current planetary positions and their aspects to that natal chart.
get_upcoming_events_for_profile
ChatGPTUse this when the user asks what is coming up astrologically across several days for a saved profile: ingresses, stations, retrograde periods, lunar phases, eclipses, shared-sky aspects, and reliable contacts to the natal chart. Use get_transits_for_profile for a detailed single-day snapshot and get_moon_forecast for a Moon-only forecast.
list_profiles
ChatGPTUse this when a personalized astrology calculation needs the id of the user's own profile or another person they have saved in The Astro Diary. Do not call it for requests to create, rename, edit, share, publish, or send profiles or charts: those are not supported.
open_astro_workspace
ChatGPTOpen the interactive Astro Diary workspace when the user wants to see or explore a chart, lunar forecast, personal timeline, relationship comparison, returns, or timing windows. Use saved profile IDs only from list_profiles. For relationships, pass both people as profileId and otherProfileId, and variant composite or weather when the user asked for that view. For timing, pass the user's goal and horizonDays. The workspace also opens from the sidebar or a conversation tab.
save_diary_reflection
ChatGPTAppend the exact reflection the user explicitly asked to save to their own Astro Diary page. Confirm the text and local calendar date before calling. Never save a suggested mood as a fact without user approval. Does not expose existing diary contents or replace them.
search_profile_mentions
ChatGPTSearch your own saved profiles for the composer mention picker. Returns names and opaque profile references, never birth data.
