Daily Horoscope

Use this when someone asks about their Chinese zodiac animal (Rat, Ox, Tiger…), its element, which animals they match, or the Chinese horoscope for this year. Give the birth date when known (births in January–February depend on the Chinese New Year date); a birth year or the animal alone also works.

get_chinese_zodiac

Use this when someone wants to know their zodiac sign from their birthday, or their 'big three' (Sun, Moon and Rising signs). The birth date alone gives the Sun sign; add the birth time and the birthplace's coordinates for the Moon sign, Rising sign and other planets. If the user names a birth city, pass that city's approximate latitude and longitude. Only ask for a birth time or place if the user wants Moon or Rising.

find_my_sign

Use this when someone asks for the horoscope of a zodiac sign: today's, tomorrow's or yesterday's daily reading, or the weekly, monthly or yearly forecast. Returns the app's written reading (general, love, career, money, wellbeing), plus for daily readings the energy scores, lucky numbers, an affirmation and the next notable sky event. If the user does not know their sign, use find_my_sign first. Present it as entertainment and reflection — do not use it to make health, financial, legal or safety decisions.

get_horoscope

Use this when someone asks which days of a month are lucky or favourable for their zodiac sign — for beauty (e.g. a haircut), fitness, gardening, travel or home projects. Returns the app's monthly calendar of good days per activity as a calendar card. Present it as a light-hearted astrology calendar, not as advice for medical, financial or legal timing.

get_lucky_days

Use this when someone asks about the Moon today — its phase (new, waxing, full, waning…), how full it is, the lunar day — or for the app's daily Moon forecast. Also works for tomorrow or yesterday.

get_moon_phase

Use this when someone asks for their life path number, numerology chart, birthday number or personal year number from their birth date. Returns the numbers with short meanings. When content_language differs from the user's language, present the meanings in the user's language. Present it as entertainment and reflection.

get_numerology

Use this when someone asks where the planets are now, whether Mercury (or Venus, Mars, Jupiter, Saturn) is retrograde, when the next retrograde starts or ends, or when the next new or full moon is. Positions are calculated astronomically (tropical zodiac). Present astrological meanings as entertainment.

get_planet_transits

Use this when someone asks for a tarot reading or to draw tarot cards. Draws one card or a three-card past / present / future spread (each card upright or reversed) and returns each card's meaning. After the card shows, briefly interpret the cards in relation to what the user asked, using these meanings. Tarot is for reflection and fun: do not present it as predicting the future, and do not use it for health, pregnancy, legal, financial or safety questions — suggest a qualified person instead.

draw_tarot

Use this when someone asks how two zodiac signs get along — as partners, friends, family or colleagues (e.g. 'Are Aries and Leo compatible?'). Returns compatibility scores and the app's written match analysis. If the user gives birthdays instead of signs, use find_my_sign first. Frame it as light-hearted insight, never as advice to start, stay in or leave a relationship.

check_compatibility

Use this when someone asks what a zodiac sign is like: its personality strengths and weaknesses, ruling planet, element, best and most challenging matches, style, gift ideas and famous people born under it. For two specific signs together use check_compatibility; for a dated reading use get_horoscope.

get_sign_profile