find_festival_dates
ChatGPTReturns the date or dates of a named Hindu festival or fast in a year, computed from tithi (lunar day) and lunar month, including leap (adhika) month handling. Each date is flagged past or upcoming relative to today, with the classical rule used. Difference from the observances tools: this looks up one named festival across a year; the observances tools list what falls on a given date or date range. Use when a user asks when a festival falls. Inputs: festival (e.g. Rath Yatra, Diwali, Holi, Janmashtami, Maha Shivaratri, Ganesh Chaturthi, Navratri, Dussehra, Raksha Bandhan, Karva Chauth, Chhath, Guru Purnima, Ram Navami, Akshaya Tritiya, Ekadashi, Purnima, Amavasya); year (default current year); place or latitude, longitude, timezone_offset. Limits: Ekadashi, Purnima and Amavasya return every occurrence in the year. Festivals not in its rule table return an error message. Scope: astrological calculation only; not medical, financial, investment or legal advice.
get_alternative_dasha_systems
ChatGPTReturns Mahadasha sequences with start dates for dasha systems other than Vimshottari and Yogini, chosen in the systems argument. 43 systems are available. Available systems (43): ashtottari, yoga_vimsottari, shodasottari, dwadasottari, dwisatpathi, naisargika, tara, tithi_yogini, tithi_ashtottari, aayu, buddhi_gathi, kaala, karaka, chathuraaseethi_sama, karana_chathuraaseethi_sama, panchottari, sataatbika, shastihayani, shattrimsa_sama, chara, narayana, shoola, sthira, brahma, mandooka, varnada, trikona, moola, kalachakra, chakra, kendradhi_rasi, lagnamsaka, navamsa_dasha, padhanadhamsa, paryaaya, sandhya, sudasa, tara_lagna, yogardha, saptharishi_nakshathra, drig, nirayana, mudda. Use when a user asks for a specific named dasha system. Limit: this tool uses one calculation method for Chara dasha. Sign-based systems show sign lords, not planet lords. Inputs: birth year, month, day, hour (0-23) and minute; place (a city name) or latitude, longitude and timezone_offset in hours; optional ayanamsa (default LAHIRI). Also systems (list of system names). Scope: astrological calculation only; not medical, financial, investment or legal advice.
get_annual_solar_return_chart
ChatGPTReturns the Varsha Pravesh (Tajaka annual chart or solar return): the chart cast for the moment the Sun returns to its birth position in a chosen year, with planets and houses. Use when a user asks about a particular year of life. If target_year is 0 it uses the most recent solar return (current year). Inputs: birth year, month, day, hour (0-23) and minute; place (a city name) or latitude, longitude and timezone_offset in hours; optional ayanamsa (default LAHIRI). Also target_year. Limits: years far from the present (about 150 or more) can fail because ephemeris data is unavailable for that year; in that case an error message is returned instead of a chart. Scope: astrological calculation only; not medical, financial, investment or legal advice.
get_arudha_image_points
ChatGPTReturns the Arudha Padas (Jaimini method): one 'image' point per house showing how that area of life appears to the world. A1 or Arudha Lagna is public image, A7 partner image, A10 career image, A11 income image. Also returns Graha Arudhas (image points for each planet). Difference from the sahams tool: arudhas are sign-based image points, sahams are calculated degree points. Use when a user asks how they are perceived. Inputs: birth year, month, day, hour (0-23) and minute; place (a city name) or latitude, longitude and timezone_offset in hours; optional ayanamsa (default LAHIRI). Scope: astrological calculation only; not medical, financial, investment or legal advice.
get_ashtakavarga
ChatGPTReturns the Ashtakavarga: a bindu (point) scoring of each zodiac sign. Gives the Sarvashtakavarga (SAV, combined totals per sign, typically 19-42) and the Bhinnashtakavarga (BAV, per planet, 0-8 per sign), plus Sodhya Pindas (reduced bindus used in transit work). Classical rule of thumb: SAV 30 or more is strong, 25-29 average, under 25 weak. Use when a user asks which signs or houses are strong or weak, or how transits may land. Inputs: birth year, month, day, hour (0-23) and minute; place (a city name) or latitude, longitude and timezone_offset in hours; optional ayanamsa (default LAHIRI). Scope: astrological calculation only; not medical, financial, investment or legal advice.
get_astrology_data_for_question
ChatGPTReturns one of two Vedic (Jyotisha) outputs; the branch is chosen deterministically from the question text. Branch 1, daily panchanga: used when the lower-cased question contains any of these words: panchang, panchanga, tithi, today, aaj, festival, vrat, rahu kaal, rahu kalam, rahu kal, muhurta, muhurat, auspicious, good time, shubh, yamaganda, gulika. Returns the daily panchanga (Hindu calendar timings) for the given calendar date and place. Branch 2, birth chart summary: used when none of those words appear. Returns the bundled birth-chart summary for the given birth details. Use when a user asks a general astrology question that does not name a specific calculation. Inputs: question (text, used only to choose the branch); year, month, day (the birth date for branch 2, the calendar date for branch 1); hour (0-23) and minute (used by branch 2 only); name (optional label, branch 2 only); place (a city name) or latitude, longitude and timezone_offset in hours; optional ayanamsa (default LAHIRI). For branch 1, place and the date are used; when the question says today, aaj or now, the date is today's date at the place and the year, month and day arguments are ignored; name, hour, minute and ayanamsa are ignored. Limits: it only chooses between those two outputs. Results are classical interpretation material, not guaranteed predictions. Nothing is stored. Scope: astrological calculation only; not medical, financial, investment or legal advice.
get_birth_chart
ChatGPTReturns the birth chart: the D1 Rasi (sign) chart and the Chalit (house-midpoint) chart. For each planet: sign, nakshatra (lunar mansion), pada, degrees, Rasi house, Chalit house and dignity, plus combustion, retrograde, planetary war and Parivartana (sign exchange) flags, house midpoints (Bhava Madhya) and Lagna (ascendant) details. Use when a user asks for their chart, ascendant, planet placements or nakshatra. It holds positions only; it does not include dashas, yogas or doshas. Inputs: birth year, month, day, hour (0-23) and minute; place (a city name) or latitude, longitude and timezone_offset in hours; optional ayanamsa (default LAHIRI). Also takes name (label only). Scope: astrological calculation only; not medical, financial, investment or legal advice.
get_birth_chart_summary
ChatGPTReturns, in one response, a bundled birth-chart summary: D1 chart, birth panchanga, Vimshottari dasha, ashtakavarga, tara chakra, ghatak chakra, yogas and doshas. Difference from the single birth chart tool: that returns planet positions only, this adds the dasha, scoring, yoga and dosha outputs in one request. It does not include divisional charts, shadbala, chara karakas, arudhas, sahams, sphutas, annual chart, alternative dasha systems, special lagnas or muhurta. Use when a user gives birth details and asks for a general reading, so one request returns the main chart data. Inputs: name; birth year, month, day, hour (0-23), minute; place or latitude, longitude, timezone_offset; optional place_name and ayanamsa (default LAHIRI). Scope: astrological calculation only; not medical, financial, investment or legal advice.
get_birth_panchanga_and_compatibility_traits
ChatGPTReturns the Panchanga at the moment of birth (the five-limb Hindu calendar: tithi, nakshatra with pada, yoga, karana, weekday) plus the Avakahada Chakra (Gana, Nadi, Paya, Yoni and Vashya, traits used for temperament, constitution and marriage matching). Difference from the daily panchanga tool: this describes a birth moment, the daily one describes a calendar date. Use when a user asks for their birth tithi, nakshatra, Gana, Nadi or similar traits. Inputs: birth year, month, day, hour (0-23) and minute; place (a city name) or latitude, longitude and timezone_offset in hours; optional ayanamsa (default LAHIRI). Scope: astrological calculation only; not medical, financial, investment or legal advice.
get_chara_karakas
ChatGPTReturns the Jaimini Chara Karakas, the seven variable significators. The seven planets Sun to Saturn are ranked by degree within sign: Atmakaraka (highest degree, soul's focus), Amatyakaraka (career), Bhratrikaraka (siblings), Matrikaraka (mother), Putrakaraka (children), Gnatikaraka (rivals), Darakaraka (lowest degree, spouse). Raw degrees are included for checking. The standard 7-karaka scheme is used; an 8-karaka variant is included for reference only. Use when a user asks about the soul indicator, spouse indicator or other Jaimini significators. Inputs: birth year, month, day, hour (0-23) and minute; place (a city name) or latitude, longitude and timezone_offset in hours; optional ayanamsa (default LAHIRI). Scope: astrological calculation only; not medical, financial, investment or legal advice.
get_critical_degrees_and_kp_sublords
ChatGPTReturns a bundle of advanced chart techniques: Mrityu Bhaga (planets at classically sensitive 'critical' degrees), Marana Karaka Sthana (a planet in its weakest house), the 64th Navamsa lord and 22nd Drekkana lord (specialist eighth-house techniques), KP sub-lords (Krishnamurti Paddhati five-level sub-lord chain for every planet) and Pushkara Bhaga (planets at classically favourable degrees). Use when a user asks for one of these techniques by name. These are specialist methods. Inputs: birth year, month, day, hour (0-23) and minute; place (a city name) or latitude, longitude and timezone_offset in hours; optional ayanamsa (default LAHIRI). Scope: astrological calculation only; not medical, financial, investment or legal advice.
get_daily_panchanga
ChatGPTReturns the daily Panchanga for a calendar date and place: sunrise, sunset and moonrise; the five limbs (tithi, nakshatra, yoga, karana, weekday); Rahu Kaalam, Yamaganda Kaalam and Gulika Kaalam (periods classically avoided for new work, travel and decisions); Abhijit Muhurta (midday window), Brahma Muhurta (pre-dawn window), Durmuhurtam, Amrit Kaalam, Varjyam, and the 24-hour Shubha Hora (planetary hour) sequence. Times are local to the place. Difference from the muhurta tool: this is the longer list, adding moonrise, Brahma Muhurta, Varjyam and the hora sequence; the muhurta tool is shorter and takes an ayanamsa. Use when a user asks about a day's timings or today's panchang. Inputs: year, month, day; place (a city name) or latitude, longitude and timezone_offset in hours. Scope: astrological calculation only; not medical, financial, investment or legal advice.
get_dasha_periods
ChatGPTReturns the Vimshottari (120-year) and Yogini (36-year) dasha sequences, which are the planetary period systems used to time life themes. Includes every Mahadasha and Antardasha (main and sub period) with start and end dates, and marks the periods active now. Use when a user asks about their current period, when a period ends, or what comes next. Inputs: birth year, month, day, hour (0-23) and minute; place (a city name) or latitude, longitude and timezone_offset in hours; optional ayanamsa (default LAHIRI). Limits: only these two dasha systems; other systems are in the alternative dasha systems tool. Scope: astrological calculation only; not medical, financial, investment or legal advice.
get_divisional_charts
ChatGPTReturns divisional charts (Vargas), which are sub-charts used to study one life area each. Choose them in charts_requested. Available: D2 (Hora), D3 (Drekkana), D4 (Chaturthamsa), D5, D6, D7 (Saptamsa, children), D8, D9 (Navamsa, spouse), D10 (Dasamsa, career), D11, D12 (Dwadasamsa, parents), D16, D20, D24 (Siddhamsa, education), D27, D30 (Trimsamsa), D40, D45, D60. Each chart gives planet positions and the Lagna sign; Vargottama status (same sign in D1 and D9) is included per planet. House numbers count from that chart's own Lagna sign. Use when a user asks about a specific life area (marriage, career, children, education, parents). Inputs: birth year, month, day, hour, minute; place or latitude, longitude, timezone_offset; charts_requested (list of chart names); optional ayanamsa (default LAHIRI). Scope: astrological calculation only; not medical, financial, investment or legal advice.
get_doshas
ChatGPTReturns the classical doshas (chart afflictions) checked for the birth chart: Kala Sarpa, Manglik (Mars), Pitru Dosha, Guru Chandala, Ganda Moola, Shrapit, Ghata and Kalathra. Gives present or absent for each, with a short definition of the pattern. Remedy descriptions are not included. Use when a user asks whether a named dosha is in their chart. Inputs: birth year, month, day, hour (0-23) and minute; place (a city name) or latitude, longitude and timezone_offset in hours; optional ayanamsa (default LAHIRI). Scope: astrological calculation only; not medical, financial, investment or legal advice.
get_ghatak_chakra_inauspicious_factors
ChatGPTReturns the Ghatak Chakra: the classically inauspicious tithi, weekday, nakshatra and month for the person's Janma Rasi (Moon sign). It is a fixed classical lookup table, not an ephemeris calculation. Use when a user wants to know which tithis, weekdays, nakshatras or months to avoid for important events. Inputs: birth year, month, day, hour (0-23) and minute; place (a city name) or latitude, longitude and timezone_offset in hours; optional ayanamsa (default LAHIRI). Scope: astrological calculation only; not medical, financial, investment or legal advice.
get_kundali_matching
ChatGPTReturns Ashtakoota (8-fold) Guna Milan scores for two people from their Moon nakshatras: Varna, Vashya, Tara, Yoni, Graha Maitri, Gana, Bhakoot and Nadi, and a total out of 36. The score is a traditional calculation, not a judgment on a relationship. Use when a user asks for the Guna Milan score of two birth charts. Inputs: each partner's nakshatra number (1-27: 1 Ashwini, 2 Bharani, 3 Krittika, 4 Rohini, 5 Mrigashira, 6 Ardra, 7 Punarvasu, 8 Pushya, 9 Ashlesha, 10 Magha, 11 Purva Phalguni, 12 Uttara Phalguni, 13 Hasta, 14 Chitra, 15 Swati, 16 Vishakha, 17 Anuradha, 18 Jyeshtha, 19 Moola, 20 Purva Ashadha, 21 Uttara Ashadha, 22 Shravana, 23 Dhanishta, 24 Shatabhisha, 25 Purva Bhadrapada, 26 Uttara Bhadrapada, 27 Revati) and pada (1-4); optionally each partner's birth date, time and place; optional ayanamsa. Nakshatra numbers appear in the birth chart and birth panchanga outputs. Scope: astrological calculation only; not medical, financial, investment or legal advice.
get_muhurta_timings_for_date
ChatGPTReturns muhurta (auspicious and inauspicious timing) data for a date and place: sunrise and sunset, Amrit Kaalam, Abhijit Muhurta, Rahukalam, Yamagandam, Gulika Kalam, Durmuhurtam, and that day's panchanga limbs (tithi, paksha, nakshatra, yoga, karana, weekday). Times are local to the place. Difference from the daily panchanga tool: this is the shorter list and takes an ayanamsa; the daily tool also gives moonrise, Brahma Muhurta, Varjyam and the 24-hour hora (planetary hour) sequence. Use when a user asks whether a date or time suits an activity. Inputs: year, month, day; place (a city name) or latitude, longitude and timezone_offset in hours; optional ayanamsa (default LAHIRI). Limits: Choghadiya and hora sequences are not part of this output. Scope: astrological calculation only; not medical, financial, investment or legal advice.
get_next_eclipses
ChatGPTReturns the next solar and lunar eclipses after a given date: type, date and visibility details. In Vedic astrology eclipses are linked to the Rahu-Ketu axis. Use when a user asks when the next eclipse is. Inputs: year, month, day to search from; place (a city name) or latitude, longitude and timezone_offset in hours. Scope: astrological calculation only; not medical, financial, investment or legal advice.
get_observances_for_date
ChatGPTReturns the Hindu festivals and vrata (fasting) days for one calendar date, such as Ekadashi, Amavasya, Purnima and Durgashtami. Difference from the other observance tools: this covers a single date; the range tool covers many dates, and the festival date tool looks up one named festival. Use when a user asks what religious observance falls on a given day. Inputs: year, month, day; place (a city name) or latitude, longitude and timezone_offset in hours. Scope: astrological calculation only; not medical, financial, investment or legal advice.
get_observances_for_date_range
ChatGPTReturns the Hindu festivals and vrata (fasting) days across a date range in one response, for example a full year for a calendar. Only dates that have an observance are listed, each with its names. An optional festival_name_contains text filters the names. Difference from the single-date observances tool: this scans a range of dates in one request. Use when a user asks for a calendar or list of observances over a period. Inputs: start year, month, day; end year, month, day; place or latitude, longitude, timezone_offset; optional festival_name_contains. Limits: the range is capped at 400 days per request. Scope: astrological calculation only; not medical, financial, investment or legal advice.
get_pancha_pakshi
ChatGPTReturns Pancha Pakshi Shastra, a Tamil bird-based timing system. From the birth nakshatra it assigns one of five birds (Vulture, Owl, Crow, Cock, Peacock) and gives that bird's activity pattern through the day. Use when a user asks for Pancha Pakshi or bird-based daily timing. Inputs: birth year, month, day, hour (0-23) and minute; place (a city name) or latitude, longitude and timezone_offset in hours; optional ayanamsa (default LAHIRI). Scope: astrological calculation only; not medical, financial, investment or legal advice.
get_raja_yoga_details
ChatGPTReturns the Raja Yoga combinations (classical indicators of authority and success) found in the chart, including Dharma-Karmadhipati Raja Yoga: forming planet pairs, yoga name, BPHS description and interpretation text. Limit: the combination existing does not show it is active; classically it acts during the dasha of the forming planets. Difference from the general yogas tool: this lists only Raja Yoga patterns, with fuller detail on each. Inputs: birth year, month, day, hour (0-23) and minute; place (a city name) or latitude, longitude and timezone_offset in hours; optional ayanamsa (default LAHIRI). Scope: astrological calculation only; not medical, financial, investment or legal advice.
get_sahams_sensitive_points
ChatGPTReturns the Sahams (also called Arabic Parts): 36 classical calculated degree points, each tied to a life area, for example Punya (merit), Vidya (education), Yasas (fame), Vivaha (marriage), Puthra (children), Rajya (career) and Karma. Shows the sign and house of each point. The day or night birth formula is chosen from the Sun's position. Limit: day and night births use different formulas for some points; the formula follows the Sun's position at the birth time. Inputs: birth year, month, day, hour (0-23) and minute; place (a city name) or latitude, longitude and timezone_offset in hours; optional ayanamsa (default LAHIRI). Scope: astrological calculation only; not medical, financial, investment or legal advice.
get_shadbala
ChatGPTReturns Shadbala, the six-source measure of planetary strength: total score and Rupas (units) for the seven classical planets, with the classical minimum Rupas (Sun 6.5, Moon 6, Mars 5, Mercury 7, Jupiter 6.5, Venus 5.5, Saturn 5), plus Vimsopaka Bala (a 20-point strength score drawn from divisional charts). Use when a user asks which planets are strong or weak in their chart. Inputs: birth year, month, day, hour (0-23) and minute; place (a city name) or latitude, longitude and timezone_offset in hours; optional ayanamsa (default LAHIRI). Scope: astrological calculation only; not medical, financial, investment or legal advice.
get_special_lagnas_and_upagrahas
ChatGPTReturns special Lagnas (alternative ascendants: Hora, Ghati, Bhava, Varnada, Sree, Pranapada, Indu) and the Upagrahas (shadow points: Kaala, Mrityu, Artha Praharaka, Yama Ghantaka, Gulika, Mandi). These belong to Jaimini and advanced Parashari methods. Use when a user asks for one of these points by name. Inputs: birth year, month, day, hour (0-23) and minute; place (a city name) or latitude, longitude and timezone_offset in hours; optional ayanamsa (default LAHIRI). Scope: astrological calculation only; not medical, financial, investment or legal advice.
get_sphuta_composite_points
ChatGPTReturns the Sphutas: sensitive degree points derived by combining planets. Includes Tri-Sphuta (Sun, Moon, Lagna), Yoga Sphuta, Yogi and Avayogi points, Prana and Deha Sphutas, Tithi Sphuta and others. Used in advanced timing and compatibility work. Inputs: birth year, month, day, hour (0-23) and minute; place (a city name) or latitude, longitude and timezone_offset in hours; optional ayanamsa (default LAHIRI). Scope: astrological calculation only; not medical, financial, investment or legal advice.
get_tara_chakra_star_categories
ChatGPTReturns the Tara Chakra: the nine nakshatra categories counted from the birth star (Janma, Sampat, Vipat, Kshema, Pratyari, Sadhana, Naidhana, Mitra, Atimitra), classed as supportive or hostile. Classical use: the challenging categories (Vipat, Pratyari, Naidhana) are traditionally read as muting transit results; supportive ones mark favourable timing windows. Use when a user asks whether a star or day suits their birth nakshatra. Inputs: birth year, month, day, hour (0-23) and minute; place (a city name) or latitude, longitude and timezone_offset in hours; optional ayanamsa (default LAHIRI). Scope: astrological calculation only; not medical, financial, investment or legal advice.
get_transit_events
ChatGPTReturns upcoming sky events from a given date: planets currently retrograde, the next retrograde or direct station of each planet, the next major conjunctions (such as Jupiter-Saturn) and the next nakshatra entry of the major planets. Use when a user asks about retrogrades, current transits or planetary conjunctions. Inputs: year, month, day to start from; place or latitude, longitude, timezone_offset. Scope: astrological calculation only; not medical, financial, investment or legal advice.
get_yogas
ChatGPTReturns the yogas (classical planetary combinations) found in the birth chart: Pancha Mahapurusha, Dhana, Raja, Neecha Bhanga, Viparita Raja, Sunapha/Anapha/Duradhara, Kemadruma, Adhi and others. Limit: a listed yoga shows the combination exists in the chart; it does not show that the yoga is active now. Classically a yoga acts when the dasha of its forming planets runs. Use when a user asks about special combinations in their chart. Inputs: birth year, month, day, hour (0-23) and minute; place (a city name) or latitude, longitude and timezone_offset in hours; optional ayanamsa (default LAHIRI). Scope: astrological calculation only; not medical, financial, investment or legal advice.
lookup_timezone
ChatGPTReturns the historically correct UTC offset for a birth date, time and location, using timezone rules in force on that date (for example US daylight-saving changes, India before and after 1945, wartime UK time). Use when a user is unsure of the timezone offset to use for a birth chart. Inputs: year (1700-2200), month, day, hour, minute, and latitude and longitude, which are required. A place name is not accepted; a (0, 0) location returns an error. Returns JSON with timezone (name), offset_hours (the value to pass as timezone_offset to the other tools), offset_string and datetime_local. Scope: astrological calculation only; not medical, financial, investment or legal advice.