all_upgrahas
ChatGPTCalculates shadow sub-planets that reveal hidden malefic influences not visible from the main 9 planets. Gulika (most important, son of Saturn) is a strong sensitizing signal for the house it occupies. Mandi in H7 = classical sensitivity in partnerships; in H1 = sensitivity in vitality/self; in H2 = classical caution around finances. Also provides Mrityu Bhaga (a classical critical degree) — a planet at this exact degree is considered notably weakened in its expression. Use for: 'why is this house not giving results despite good planets', 'are there hidden obstacles in my chart', any unexplained chronic difficulty in a life area. Interpret: check Gulika and Mandi house placement first — their presence is a strong malefic signal.
analyze_kala_sarpa_dosha
ChatGPTDetermines if all 7 planets are hemmed between Rahu and Ketu (north and south lunar nodes), traditionally associated with themes of delay, an unconventional path, and cycles of challenge followed by breakthrough. The dosha name indicates direction (Kala Sarpa vs Kala Amrita) and the specific axis involved shapes which life areas are most affected. Use for: 'why do I keep facing delays in everything', 'is there a karmic obstacle in my chart', 'why is life so non-linear for me', any chart where classical promises are not delivering. Interpret: yoga_present=false = no KSD. If present, check life_areas — those domains face karmic delay. Peak period (when dosha is most intense) aligns with Rahu/Ketu dasha periods.
analyze_mangal_dosha
ChatGPTAssesses Mars placement relative to the traditional marriage houses (1,2,4,7,8,12) with a severity score and classical cancellation rules. Mild/Moderate/Severe dosha = increasing friction, delay, or conflict in marriage/partnerships. Includes classical cancellation exceptions that reduce or nullify the dosha. Use for: 'do I have Mangal Dosha', 'is Mars affecting my marriage', 'what does Mangal Dosha mean for compatibility', 'how is Mars positioned relative to my partnership houses'. Interpret: has_mangal_dosha=true + severity=Severe + no exceptions = genuine obstacle; severity=Mild + multiple exceptions = minimal concern; always cross-check with mangal_dosha_compatibility for partner matching.
ashtakoot_matching
ChatGPTThe classical 8-factor 36-point marriage compatibility system: Varna (1pt), Vashya (2pt), Tara (3pt), Yoni (4pt), Graha Maitri (5pt), Gana (6pt), Bhakoot (7pt), Nadi (8pt). Score interpretation: below 18 = traditionally inadvisable; 18-24 = acceptable; 24-28 = good; 28-32 = very good; above 32 = excellent. Nadi dosha (0 points) is the most serious compatibility block. Always call alongside mangal_dosha_compatibility for complete marriage assessment. Use for: 'are we compatible', 'should we marry', 'what is our matching score', 'why do we fight so much', any two-person marriage or partnership compatibility question. Interpret: check Nadi first (Nadi dosha = genetic incompatibility); then Bhakoot (emotional/mental alignment); then Gana (nature match: Deva/Manushya/Rakshasa).
bhavat_bhavam
ChatGPTComputes the secondary house mirror for each primary house — the 'house of a house' principle. H7's bhavat bhavam = H1 (7th from 7th, partner mirrors self); H10's bhavat bhavam = H7 (10th from 10th = career reputation mirrors partnerships); H4's bhavat bhavam = H7 (home stability reflects in marriage). Reveals deeper connections between life domains not visible from the primary house. Includes condition assessment (Strong/Moderate/Weak) and lord relationship (Harmonious/Conflicting/Neutral). Use for: 'why is my marriage connected to career struggles', 'deeper analysis of H7/H10/H4', any question where the primary house analysis is insufficient. Interpret: bhavat_bhavam_condition=Weak = the secondary mirror is damaged; lord_relationship=Conflicting = the two domains actively work against each other.
get_reading
ChatGPTPrimary entry for ANY astrology question. Pass the user's question + birth_data; the server routes, computes the chart data, and returns flags telling you what to do next. Obey the returned next_action.
houses_data
ChatGPTThe life-area decoder — maps each of the 12 houses to its domain and reveals who rules it, what occupies it, and how strong it is. H1=self/body, H2=wealth/speech/family, H3=courage/siblings, H4=home/mother/happiness, H5=children/intellect/past-life merit, H6=conflict/wellbeing/debts, H7=marriage/partnerships, H8=longevity/obstacles/hidden, H9=fortune/father/dharma, H10=career/status/profession, H11=gains/income/fulfilment, H12=expenses/losses/liberation. Use for: any life-area specific question — career (H10), marriage (H7), wealth (H2,H11), health (H1,H6), children (H5), spirituality (H9,H12). Interpret: lord in own house or exalted = domain flourishes; lord debilitated or in H6/H8/H12 = domain suffers.
mangal_dosha_compatibility
ChatGPTAnalyzes Mangal Dosha cross-match between two charts — whether both partners' Mars doshas cancel each other (same severity = mutual cancellation = acceptable match). If one partner has severe Mangal Dosha and the other has none, the mismatch creates sustained friction. Always call alongside ashtakoot_matching — this is the Mars-specific complement to the guna score. Use for: 'do our Mangal Doshas cancel', 'is our Mars compatibility okay', 'we both have Mangal Dosha — is that fine', any marriage compatibility question involving Mars. Interpret: both_same_severity=true = doshas cancel, no issue; one_severe_one_none = serious mismatch; both_none = no concern at all.
planets_ashtakavarga
ChatGPTQuantifies how favorable each planet's transit is through each house using a 0-8 bindu point system. The most reliable transit strength indicator — 4+ bindus = good transit results, below 4 = difficult. Always call alongside planets_transits to know if a transit will actually manifest positively. Use for: 'will this transit help me', 'how strong is Jupiter transiting my 7th house', any predictive transit analysis. Interpret: bindus 7-8 = excellent transit results; 5-6 = good; 4 = adequate; 1-3 = transit causes difficulty despite being in a 'favorable' house; 0 = no support at all. A planet showing favorable=true in planets_transits but only 2 bindus = weak actual result.
planets_avasthas
ChatGPTReveals a planet's current state — whether it is awake/asleep, young/old, or humiliated by enemy association. A planet in 'dead' or 'sleeping' avastha cannot deliver results even if strongly placed. Use for: 'why is my Venus not giving results despite being in a good house', 'is a planet capable of delivering', understanding why expected outcomes are delayed or blocked. Interpret: Baladi state — Bala (infant/young, weak but developing), Kumara (youth, emerging), Yuva (young adult, strongest delivery), Vriddha (old, declining), Mrita (dead, cannot deliver). Deeptadi — Deetha (brilliant, full results), Svastha (comfortable, good results), Mudita (happy), Shanta (peaceful), Dukhita (suffering), Vikala (distressed), Khala (wicked), Kopita (angry). Lajjita (humiliated by malefic association) = planet ashamed, gives results with shame/embarrassment.
planets_d60_amsa
ChatGPTThe D60 Shastiamsa — the most refined divisional chart, showing past-life karmic imprint on each planet. Each planet falls in one of 60 named amsas with a specific nature: Saumya (S) = benefic/auspicious karma, Krura (K) = malefic/challenging karma, Preta/Purisha = severely inauspicious (defiling/obstructing karma). Use for: 'why does X keep happening despite nothing explaining it in D1', 'what is the karmic theme of my life', 'past life karma reading', 'why does a strong planet give bad results', spiritual or karmic depth analysis. Interpret: a planet in a Krura amsa carries obstructing karma in its domain even if well-placed in D1. Preta/Purisha = most severe past-karma obstacle for that planet's significations.
planets_data
ChatGPTThe foundational natal map — house placement, sign, exact degree, directional movement (direct/retrograde), house lordship, and combustion status for all 9 Vedic planets plus ascendant. This is ALWAYS the first tool to call for any natal chart question — all other tools build on this foundation. Use for: any chart reading, 'where is my Moon', 'what sign is my ascendant', 'which house does Venus rule in my chart', as the base for all subsequent analysis. Interpret: house=placement in natal chart; sign=zodiac sign; degree=exact position; lordship_houses=which life areas this planet governs; is_combust=true means planet is weakened by Sun proximity.
planets_dignity
ChatGPTShows how comfortable each planet is in its sign — exalted (peak strength), own sign (at home), moolatrikona, neutral, enemy, or debilitated (weakest). Determines the inherent quality of a planet's expression. Use for: 'is my Jupiter strong', 'why is Mars giving bad results', 'which planets are well-placed in my chart', assessing sign-based planetary strength before reading life areas. Interpret: Exalted (Ex) = planet at maximum power, gives exceptional results in its domain; Own sign (O) = planet comfortable, reliable results; Moolatrikona (M) = strong, slightly below own; Neutral (N) = average expression; Enemy (En) = uncomfortable, inconsistent; Debilitated (D) = weakest, struggles to give results, needs neechabhanga to recover.
planets_divisional_charts
ChatGPTGenerates specific divisional (varga) charts: D9=marriage/soul quality, D10=career/profession, D7=children, D12=parents/ancestry, D20=spirituality, D30=misfortune/character. Use for: 'will my career succeed' (D10), 'what is my marriage like' (D9), 'will I have children' (D7), 'what is my spiritual path' (D20). Pass divisions=[9] for marriage, [10] for career, [7] for children. Interpret: planet in own sign or exalted in a divisional chart = that life area strongly supported by that planet; planet debilitated in D10 = career struggles regardless of D1 placement; lagna lord strong in D9 = good marriage overall; lagna lord weak in D9 = marriage brings challenges.
planets_functional_classification
ChatGPTIdentifies which planets are benefic (helpful) vs malefic (harmful) specifically for this person's ascendant sign — the same planet can help one lagna and hurt another. Use for: 'which planets are good for me', 'is Saturn good or bad in my chart', 'which planet should I strengthen', interpreting any planet's role in this chart. Interpret: functional_benefic = planet actively helps this lagna's life purpose; functional_malefic = planet creates obstacles/disruptions for this lagna; neutral = mixed or context-dependent results. Always read dasha and transit results through this lens.
planets_modifiers
ChatGPTIdentifies exception conditions that override a planet's expected behavior: retrograde (planet gives results in delayed, unusual, or internalized ways), combustion (within 6° of Sun = planet loses its individual signification, cannot deliver fully), planetary war (two planets within 1° = weaker planet is severely damaged), and exact exaltation/debilitation degree (peak strength or peak weakness). Always check BEFORE interpreting any planet's results — a strong exalted planet that is also combust is severely compromised. Use for: 'why is my planet not giving expected results', 'is retrograde Mercury affecting me', 'which planets are in exception states', any chart where results seem contradictory to placement. Interpret: retrograde+strong placement = results come, but through struggle; combust = signification of that planet is suppressed in the person's life.
planets_nakshatra
ChatGPTReveals the star-level (nakshatra) placement of each planet — the sub-quality, ruling deity, and pada that shapes HOW a planet expresses. Two planets in the same sign behave very differently based on their nakshatra. Critical for reading texture, timing dasha cycles precisely, and interpreting sub-periods. Use for: 'what nakshatra is my Moon in', 'why does my Sun behave unusually in Gemini', 'what is the quality of my dasha period', karma and spiritual readings. Interpret: nakshatra lord = the sub-ruler whose themes color the planet's expression (e.g., Moon in Bharani ruled by Yama = karmic themes of transformation); pada 1-4 maps to D9 houses (pada 1=Aries D9 etc.); nakshatra lord's natal condition determines if nakshatra themes manifest positively or negatively.
planets_shadbala
ChatGPTThe classical six-fold quantitative strength score for each planet — the most comprehensive single metric of planetary power. Output includes total rupas, minimum required rupas, and a verdict (Exceptional/Strong/Adequate/Weak). A planet below minimum rupas cannot fully deliver its results even if well-placed. Use for: 'is my Mars strong enough to give career results', 'why is my Venus not performing despite being in own sign', any question about whether a planet has the strength to manifest its promise. Interpret: total_rupas vs required_rupas = actual strength vs needed threshold.
planets_shodasvarga
ChatGPTShows each planet's position across 16 key divisional charts simultaneously — the full varga matrix. Each varga reveals a specific life dimension: D1=physical life, D9=marriage/soul, D10=career, D7=children, D12=parents, D16=vehicles/comforts, D20=spirituality, D30=misfortune, D60=karma. Use for: 'give me a complete multi-dimensional chart reading', 'how is my career destiny' (check D10), 'what is my marriage quality' (check D9). Interpret: a planet strong in D1 but weak in D10 = good personality but career struggles. Vargottama (same sign in D1 and D9) = exceptionally strong planet.
planets_sputha_aspects
ChatGPTCalculates exact degree-based aspect strength (0-100%) between every planet pair. Unlike sign-based classical aspects, sputha reveals precisely how strongly planets influence each other. A 43% aspect is weak influence; 85%+ is strong activation. Use for: 'how strongly does Saturn aspect my Moon', 'is Jupiter really protecting my 7th house', 'why is there conflict between two planets', understanding precise planetary relationships. Interpret: high aspect % = strong mutual influence; near 0% = planets barely interact despite being in the same sign or aspecting by sign.
planets_transits
ChatGPTShows where current planets are transiting relative to natal houses, with favorable/unfavorable verdict from lagna and Moon. This is the real-time cosmic weather — the external triggers activating the natal chart. from_date/to_date are OPTIONAL — omit them to default to the next 12 months from today; pass them only for a specific window (from_date can equal to_date for a single day). Use for: 'how will today/this week/this month be', 'when will Jupiter help my career', 'why is this period so difficult', any timing or prediction question. ALWAYS pair with planets_ashtakavarga to verify bindu count (transit favorable only if 4+ bindus in that house). ALWAYS pair with planets_vimshottari_dasha — transit without dasha context is incomplete. Interpret: favorable=true + high bindus + dasha lord transiting well = strong positive period.
planets_vimshottari_dasha
ChatGPTThe primary timing tool — reveals which planet's 120-year cycle is currently 'running' at three levels: mahadasha (major period, years), antardasha (sub-period, months), pratyantar dasha (micro-period, weeks). The dasha lord determines WHICH natal promise is being activated RIGHT NOW. from_date can equal to_date for a single day. Use for: 'when will I get married/job/child', 'how will this year be', 'what period am I in', 'why is this time so difficult or successful', any prediction question. ALWAYS call alongside planets_transits — dasha sets the theme, transit triggers the event. Interpret: if dasha lord is well-placed natally AND transiting favorably = high probability of good results. Dasha lord debilitated or combust = results delayed or blocked despite favorable transits.
planets_vimsopaka_bala
ChatGPTMeasures each planet's aggregate strength across 16 divisional charts on a 0-20 scale. Complements shadbala: a planet can have modest D1 strength but high vimsopaka, meaning it delivers subtly but reliably across all life dimensions. Score 15-20=very strong, 10-15=good, below 10=weak. Use for: 'how strong is my planet overall across all life areas', 'why does this planet give inconsistent results', deep strength analysis beyond shadbala. Interpret: high vimsopaka + weak shadbala = planet works better at a spiritual/deeper level; strong shadbala + weak vimsopaka = planet is powerful in D1 but not consistently across vargas.
planets_yoga_dosha
ChatGPTIdentifies destiny-shaping planetary combinations — yogas (positive: wealth, power, fame) and doshas (negative: obstacles, delays, reduction of benefic results). Examples: Raja yoga=authority/leadership, Dhana yoga=wealth, Vipareet Raja yoga=rise through adversity, Kendradhipati dosha=benefic planet loses strength when owning both quadrant and trine. Use for: 'will I be successful/wealthy/powerful', 'why do I keep facing obstacles', 'what is my life's dominant theme', any question about life destiny patterns. Interpret: yoga status Y=active/formed, N=not formed. Check yoga_cancelled field — a cancelled yoga means the combination exists but is neutralized.
