Astera Tarot & Astrology

Use when the user asks a reflective yes/no Tarot question. Pass the actual question. Astera draws one card, returns its canonical yes/no/maybe mapping and shows one branded card visual; never change the mapped answer or substitute another card. Do not use Tarot yes/no as the deciding basis for medical, legal, financial, emergency or other safety-critical decisions.

draw_tarot_yes_no

Use when the user asks for Astera's deterministic 12-position birth-date Tarot archetype portrait. Returns the production formula, position-specific meanings and one branded 12-card visual. This is a reflective Tarot framework, not astronomical calculation or deterministic prediction.

calculate_tarot_archetype_profile

Calculates Astera relationship synastry from two complete birth datasets. Use when the user asks to compare two birth charts or requests relationship synastry. This tool never requires sign-in for an ordinary request: anonymous or Free users receive the dual-wheel Free snapshot, while a verified existing Astera Premium entitlement automatically receives the full synastry result. Ask for each person's city/locality plus country and IANA timezone, never raw coordinates or street addresses. Use compare_zodiac_signs when only signs are known. Use get_full_synastry_analysis only when the user explicitly requests a full/detailed interpretation and OAuth may need to be initiated.

calculate_synastry

Use when the user asks for Moon sign, Moon phase, illumination, lunar age, lunar day or Astera lunar-day guidance for a date. Astronomy is derived from Swiss Ephemeris Sun/Moon positions. Do not use for a natal Moon placement or personal transit forecast.

get_lunar_calendar

Use only when the user explicitly requests a full or detailed personal transit forecast for today, week or month. Requires a connected account with an existing active Astera Premium entitlement. For an ordinary daily personal forecast, get_daily_personal_horoscope is the appropriate base tool; this full-analysis tool is only for an explicit full/detailed forecast request.

get_personal_horoscope

Calculates a personal horoscope from birth data and current transits. Use when the user asks for a personalized horoscope for today or tomorrow. This tool never requires sign-in for an ordinary request: anonymous or Free users receive the Free daily snapshot, while a verified existing Astera Premium entitlement automatically receives Premium-depth output. Ask for birth city/locality plus country and IANA timezone, never raw coordinates or a street address. For tomorrow, pass tomorrow's date. Use get_general_horoscope when only a zodiac sign is known.

get_daily_personal_horoscope

Calculates and renders an Astera Solar Return chart. Use when the user asks for a Solar Return or yearly return chart. This tool never requires sign-in for an ordinary request: anonymous or Free users receive the branded Free year snapshot, while a verified existing Astera Premium entitlement automatically receives the full Solar Return result. It requires the physical return city/locality plus country and its IANA timezone; never ask for raw coordinates or a street address. Use get_full_solar_return_analysis only when the user explicitly requests a full/detailed interpretation and OAuth may need to be initiated.

calculate_solar_return

Calculates and renders an Astera natal chart from user-provided birth data. Use when the user asks to calculate, build, visualize, or interpret a personal natal or birth chart. This tool never requires sign-in for an ordinary request: anonymous or Free users receive the branded Free snapshot, while a verified existing Astera Premium entitlement automatically receives the full natal result. Ask for city/locality plus country and IANA timezone, never raw coordinates or a street address. Use get_full_natal_analysis only when the user explicitly asks for a full/detailed interpretation and OAuth may need to be initiated.

calculate_natal_chart

Use when the user asks for lightweight compatibility between two zodiac signs and does not provide two complete birth datasets. Returns element, modality and angular relationship without a fake percentage. Use calculate_synastry instead for two birth charts.

compare_zodiac_signs

Use when the user asks to connect/sign in to their Astera account, verify an existing Astera Premium purchase, or make the Premium status from the mobile/web Astera account available in ChatGPT. This tool requires OAuth authentication. After the browser sign-in completes, Astera reads the same Firebase Auth UID and existing Firestore premium_tarot entitlement used by the app. It does not create a second subscription system.

connect_astera_account