All MCP tools

Build the complete KP birth chart in one call. Returns '{ planets[9], houses[12], dasha (mahadasha+antardasha+pratyantardasha), significators (4-level matrix), rulingPlanets, currentDasha }'. Each planet entry has sidereal longitude, sign, star, sub-lord, dignity, retrograde, combustion. Each house cusp has sign, sign lord, star lord, sub-lord (CSL). Use when: you need an overview or are starting any reading. Avoid follow-up calls to 'get_planets' / 'get_house_cusps' / 'get_dasha_periods' / 'get_significators', this tool already returns all of them.

Run Cuspal Sub Lord (CSL) promise analysis across 25 life events. The CSL is the planet ruling the sub-division at a house cusp, KP's deciding factor for whether any event is promised in the chart. Returns '{ events: { Marriage, Career, Childbirth, Foreign Travel, ... }: { verdict: PROMISED|DENIED|MIXED_ACTIVE, coveragePct, supportingHouses[], detrimentalHouses[], cslChain } }'. Use when: starting any life-event question, call this BEFORE timing tools.

Returns the orthodox KP cascade for both nodes (Rahu and Ketu), with conjoined planets, star lord, aspecting planets, and dispositor (sign lord), showing which planets contribute to each node's significations via which mechanism. Per KP Reader 1 p.158 and Reader 6 p.221/286. Use to debug or audit any reading whose verdict depends on a node being CSL or fruitful significator.

Compute Vimshottari dasha, KP's 120-year planetary period system. Levels: mahadasha (main period, years), antardasha (sub-period, months), pratyantardasha (sub-sub-period, days). Returns '{ mahadashas: [{ planet, startDate, endDate, subPeriods }], currentDasha: { mahadasha, antardasha, pratyantardasha } }'. Use when: you only need raw dasha periods. For event-relevance scoring, prefer 'get_smart_current_dasha' or 'get_event_dasha'.

KP 4-level significator matrix linking the 9 planets to the 12 houses they activate. Levels: **L1** = planet in star of house occupant (strongest), **L2** = planet directly occupying the house, **L3** = planet in star of cusp lord, **L4** = planet is the cusp lord. Returns '{ byHouse: { 1..12: [{ planet, level, throughPlanet }] }, byPlanet: { Sun..Ketu: [...] } }'. Use after 'analyze_natal_promise' to drill into WHY a dasha period activates a specific event.

Compute the Ruling Planets (RP), the cosmic snapshot at any moment, used for KP timing verification. Returns 5 RPs: ascendant sign lord, ascendant star lord, ascendant sub-lord, Moon star lord, Moon sub-lord, day lord (weekday). When RPs overlap with an event's significators, the timing is confirmed; when they don't, the event won't manifest at this moment regardless of dasha. Returns '{ ascSignLord, ascStarLord, ascSubLord, moonStarLord, moonSubLord, dayLord, rankedRPs[] }'.

Find muhurta (auspicious time slot) for one or more events. A muhurta is a window where house, planet, and Ruling Planet conditions align favourably for initiating action. Returns '{ events: { eventName: { windows: [{ startUTC, endUTC, score, supportingFactors[] }] } } }'. Use when: scheduling a marriage, business launch, surgery, travel start. For high-precision triangulation (3-condition simultaneous match), prefer 'get_muhurta_advanced'.

Generate a 12-month forecast with month-by-month predictions. Shows dasha periods, activated houses, themes, and overall tone for each month.

Enhanced KP event timing: checks all 3 dasha levels (MD+AD+PD must jointly signify required houses), filters against Ruling Planets (fruitful significators only), integrates transit hierarchy for year/month/day narrowing. Use this instead of find_event_timing for precise, methodologically correct KP timing.

Enhanced KP horary chart with Moon connectivity validation. If query_event is provided, validates whether Moon signifies the relevant houses. If Moon is disconnected, the question is premature and prediction is flagged as unreliable. Always provide query_event for proper KP horary analysis.

Single-moment transit snapshot, checks 4 KP transit rules at one point in time. Returns '{ queryDatetime, transitPlanets[], activatedHouses[], dashaTriggers[], rulesPassed[], rulesFailed[] }'. Use when: 'what's happening now astrologically?'. For precise event-timing narrowing (Saturn → year, Jupiter → month, Sun → week, Moon → day) use 'get_transit_timing_hierarchy' instead. For triple-confirmation + Lagna minute-prediction use 'get_transit_advanced'.

Current Moon position with sign, star lord, sub-lord, and minutes remaining in the current sub. Moon's sub-lord changes every 2-3 hours and is the fastest hand on the KP timing clock. Returns '{ moonLongitude, sign, starLord, subLord, kpNumber, minutesRemainingInSub, nextSubLord, nextSubStartUTC }'. Use for: real-time micro-timing or 'is right now a good moment for X' queries.

Hours until each planet's KP sub-lord changes next. Sub-lord boundaries are when transit influence shifts. Returns '{ planets: { Sun..Ketu: { currentSubLord, nextSubLord, hoursUntilChange, nextChangeUTC } } }'. For all sub-lord crossings within a date window (with minute-precision binary search) use 'get_transit_crossings'.

All KP sub-lord boundary crossings for the requested planets within a date window (max 366 days). Uses 1-hour coarse scan + binary-search refinement to minute precision. Returns '{ crossings: [{ planet, crossingTimeUTC, fromKP, toKP, fromSubLord, toSubLord, isNakshatraChange, isSignChange }], totalCrossings, planetsSearched }'.

Ruling Planets (RP) computed at regular intervals over a window (e.g. every 60 min for 24 h). Returns '{ intervals: [{ datetime, ascSignLord, ascStarLord, ascSubLord, moonStarLord, moonSubLord, dayLord, rankedRPs[] }] }'. Use when: scanning a day or week for the moment whose RP set best matches a target event's significators.

Detect 5 classical chart afflictions (doshas). **Manglik** (Mars in 1/2/4/7/8/12, marriage friction), **Kalsarpa** (all 7 visible planets between Rahu and Ketu, for variant typing use 'get_kalsarpa_variants'), **Sadhesati** (7.5-yr Saturn transit, for phase breakdown use 'get_sade_sati_phases'), **Pitra Dosha** (paternal-lineage karma signature), **Kemadruma** (Moon isolation, no planets in 2nd/12th from Moon). Returns '{ doshas: [{ name, present, severity: None|Mild|Moderate|Severe, cancellations[], remedies[] }] }'.

[Vedic Parashari] Detect classical planetary yogas, special combinations producing distinctive life patterns. Includes Raja Yoga (kendra-trikona lord conjunction → power), Dhana Yoga (2nd-11th wealth flow), Gajakesari (Jupiter in kendra from Moon → fame), Budh-Aditya (Sun-Mercury → intellect), Pancha Mahapurusha (5 'great person' configurations), Lakshmi, Saraswati, Amala, Vish, Chatursagara. Returns '{ yogas: [{ name, category, present, strength, formingPlanets[], description, effects }], totalPresent, beneficYogas, maleficYogas }'. For Vipreet/Neecha-Bhanga/Adhi/Lunar/Chandra-Mangal yogas, use 'get_yogas_advanced'. For Sun yogas (Vasi/Vesi/Ubhayachari) use 'get_sun_yogas'.

KP-based 7-factor compatibility analysis between two charts. Factors: Moon compatibility, Venus-Mars attraction, Jupiter harmony, sub-lord matching, dasha sync, dignity match, and aspect harmony. Returns '{ overallScore (0-100), factors: [{ name, score, weight, details }], verdict: EXCELLENT|GOOD|AVERAGE|POOR }'. For KP-rigorous 6-CSL-factor analysis (which explicitly REPLACES Vedic Porutham) use 'get_compatibility_advanced'. For traditional 36-point Vedic Guna Milan use 'get_ashta_koota_milan'.

Career analysis from the 10th-house CSL (Cuspal Sub Lord). Returns '{ businessVsEmploymentScore, dominantMode: BUSINESS|EMPLOYMENT, professionIndicators: [{ industry, signal, weight }], rulingPlanetApplications, tenthHouseCsl, tenthHouseCslStarLord }'. For richer career signature (8 named categories: IT/government/business/military/medicine/law/arts/education) use 'get_career_signature'. For profession nature description (sector, employment mode, leadership/technical/creative scores) use 'get_profession_description'. For job-change vs promotion timing use 'get_career_advanced'.

Refine an uncertain birth time by testing ±30 min around the stated time against known life events. Requires at least 1 known event with date and houses that should have been active. Returns '{ candidates: [{ datetime, score, eventMatches[] }], bestCandidate, originalTime, refinedTime }'. For RP-confirmation rectification using event location (more rigorous) use 'get_rectification_advanced'. For finding entirely-unknown birth time use 'find_birth_time'.

Vedic Panchang for any date and location. Returns '{ tithi (lunar day), nakshatra (lunar mansion), yoga (Sun-Moon angular relationship), karana (half-tithi), rahuKaal: { startUTC, endUTC }, yamagandaKaal, gulikaiKaal, sunriseUTC, sunsetUTC, weekday }'. Use when: you need today's auspicious / inauspicious windows. **Pass the date you want Panchang for (e.g., today's date), NOT the person's birth date.** For 1.5-hour Choghadiya windows use 'get_choghadiya_today'.

Sidereal positions for all 9 KP planets (Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu). Returns '{ Sun..Ketu: { siderealLongitude, sign, signLord, signDegree, nakshatra, starLord, subLord, kpNumber (1-249), pada, dignity (EXALTED/OWN/FRIEND/NEUTRAL/ENEMY/DEBILITATED), isRetrograde, isCombust, combustionGrade (NONE/ORDINARY/FULL), house } }'. For combustion-only analysis use 'get_combust_planets'.

Placidus house-cusp positions for the 12 houses. Each cusp returns '{ siderealLongitude, sign, signLord, signDegree, nakshatra, starLord, subLord, kpNumber }'. The sub-lord (CSL, Cuspal Sub Lord) is the deciding planet for that house's significations per KP methodology. For boundary-flag warnings (cusps within 10 arc-minutes of a sub-lord boundary), see 'get_boundary_warnings'.

[Vedic Parashari, non-KP reference] Navamsa (D9) divisional chart per BPHS ch.6. Each natal sign divided into 9 padas of 3°20'. Used in Vedic tradition for marriage assessment, dharma, and overall planetary strength. Returns '{ d9Ascendant, planets: [{ d9Sign, d9Lord, d9Dignity, d9House, isVargottama }] }'. Note: KP methodology uses 'analyze_natal_promise' (CSL-based) for marriage, NOT D9. This tool is for cross-system / Vedic-Parashari consumers.

[Vedic Parashari, non-KP reference] Dasamsa (D10) divisional chart per BPHS ch.6. Each natal sign divided into 10 parts of 3°. Used in Vedic tradition for career analysis. Returns '{ d10Ascendant, planets: [{ d10Sign, d10Lord, d10House, isVargottama }], d10HouseLords, careerIndicators: { d10_10thLord, planetsIn10th, strongestCareerPlanet } }'. Note: KP methodology uses 'get_profession_indicators' (10th-house CSL) and 'get_career_signature' for career, NOT D10. This tool is for cross-system / Vedic-Parashari consumers.

Per-planet nakshatra (lunar mansion) details + planet friendship tables. Each nakshatra spans 13°20' and is divided into 4 padas (3°20' each). Returns '{ planets: { Sun..Ketu: { nakshatra, nakshatraIndex, pada (1-4), navamsaSign, padaDeity } }, friendshipTable: { perPlanet: { friends[], neutrals[], enemies[] } }, naturalRelationships, temporaryRelationships }'.

Planetary aspects + 5-factor house strength scores (0-100) + deep retrograde analysis. Returns '{ aspects: [{ from, to, type: OPPOSITION/TRINE/SQUARE/SEXTILE, separationDeg, strength }], houseStrength: { 1..12: { total, aspectScore, occupantScore, lordScore, dignityScore, planetScore } }, retrogradeBlock: { perPlanet, naturalCycleStatus } }'. For full Shadbala (6-fold strength of planets) use 'get_shadbala'. For full Bhava Bala (6-fold strength of houses) use 'get_bhava_bala'.

[Vedic Parashari] Sarvashtakavarga and Bhinnashtakavarga bindu tables, Parashari planetary-strength system using bindus (points) per sign per planet. Returns '{ sarvashtakavarga: { 1..12 (signs): totalBindus }, bhinnashtakavarga: { Sun..Saturn: { 1..12: bindus } }, totalBindus }'. Higher bindus = better activation of that sign. Used alongside dasha for transit-strength weighting.

Current running dasha (mahadasha + antardasha + pratyantardasha) annotated with house significations, themes, and percentage-scored event activations. Smarter than raw 'get_dasha_periods', converts MD/AD/PD lords into 'Marriage 100% active, Career 67% active, Travel 33% active' rankings. Returns '{ currentDasha: { md, ad, pd }, activatedHouses[], activeEvents: [{ event, activationPct }], themes[], rulingPlanetSync }'. Use when: 'what period am I in?' / 'what's happening in my life now?'.

Find which Vimshottari dasha periods activate a specific life event. Filters to periods where MD+AD lords jointly signify the required houses; ranks by signification coverage. Returns '{ event, requiredHouses[], periods: [{ md, ad, startDate, endDate, coveragePct, supportingHouses[] }], eventResolution }'. If 'event' is omitted, the engine derives the most active event from the running MD+AD signification with RP tie-break. For 3-level (MD+AD+PD) timing + RP filtering + transit hierarchy, prefer 'find_event_timing_v2'.

Full Vimshottari timeline (mahadashas + antardashas) annotated with house significations and event-potential scoring for each period. Compact compared to raw 120-yr calendar (~47KB vs ~116KB). Returns '{ timeline: [{ md, ad, startDate, endDate, signifiedHouses[], eventPotential: { Marriage, Career, ... } }] }'. Use when: 'show me my full life timeline' / 'which dasha is best for X?'.

Complete 120-year Vimshottari dasha calendar with all 9 mahadashas and their full antardasha sub-periods nested. Returns '{ mahadashas: [{ planet, startDate, endDate, antardashas: [{ planet, startDate, endDate }] }] }'. Heavy payload, use only when full life-timeline export is needed. For event-relevance ranking prefer 'get_annotated_dasha'.

Daily sidereal positions for all 9 KP planets across one month. No birth data required. Returns '{ year, month, days: [{ date, planets: { Sun..Ketu: { siderealLongitude, sign, isRetrograde, dailyMotion } } }] }'. Use for: external transit-planning workflows or generating ephemeris tables.

Find an UNKNOWN birth time using the KP Ruling Planets method. Scans all 1440 minutes of a birth date for candidate windows whose ascendant sign/star/sub-lords match the RPs at a query moment (typically when the querent asked the question). Optional validation against known life events. Returns '{ candidates: [{ time, ascSignLord, ascStarLord, ascSubLord, score, eventMatches }], bestCandidate }'. For *refining* an approximately-known time, use 'rectify_birth_time' instead.

Get fruitful significators for an event, meaning planets that appear in BOTH the 4-level significator matrix AND the current Ruling Planets. L1/L2 (strongest) are prioritized over L3/L4. Essential for precise KP timing: only fruitful significators can deliver event results.

KP transit timing hierarchy: Saturn narrows to ~2.5yr window, Jupiter to the year, Sun to the month, Moon to the day. Checks retrograde invalidation (transit in star of retrograde natal planet = invalid trigger). Requires fruitful significators internally.

Advanced CSL (Cuspal Sub Lord) analysis with 4 deepening layers: (1) multi-cusp convergence, all related cusps checked independently, (2) cuspal interlink event scoring, (3) 6-level sub-lord constellation mapping (sign→star→sub→sub's sign→sub's star→sub's sub), (4) cusp-degree sensitivity flag (boundary conditions within 10 arc-minutes). Returns '{ multiCuspConvergence, interlinkScore, sublordChain[6], sensitivityFlags[] }'. Essential for thorough promise analysis on borderline charts.

Advanced retrograde analysis: 3-state CSL interpretation (delayed/denied/sudden fulfillment based on star lord retrogression), retrograde dasha lord transit activation dates (Jupiter/Saturn crossing natal retro degree), and slow-planet station window mapping (suppression windows when retrograde over significator). Scan range up to 2 years.

Advanced dasha analysis: stellium detection (mutual nakshatra network between MD/AD/PD lords), contradiction resolution (L1/L2 vs L3/L4 strength when lords conflict), Sookshma-Prana integration (hour-level timing using 4th and 5th dasha levels), and MD junction overlap windows (high-probability timing at mahadasha boundaries).

Advanced transit timing: triple transit confirmation (Jupiter star+sub AND Sun sign AND Moon nakshatra simultaneously on significator), Rahu-Ketu axis tracking (amplification/termination over significator positions), Moon sub-division tracking (2-3hr windows over 72hrs), and Lagna minute-level prediction (8-12min windows for exact event timing). The highest resolution KP timing available.

Advanced Ruling Planet (RP) analysis. Two layers: (1) weighted RP strength hierarchy (Lagna star lord=5, Moon star lord=4, Lagna sign lord=3, Moon sign lord=2, day lord=1) and (2) RP-Dasha synchronization check (does the predicted dasha lord appear in current RPs as FULLY / PARTIALLY / NOT synchronized?). Returns '{ rankedRPs: [{ planet, rank, weight }], dashaSyncStatus }'.

Advanced horary analysis: number intuition analysis (checks if chosen KP number's sub-lord independently signifies query houses, classifying it as self-confirmatory vs weakly chosen) and horary-natal cross-validation (compares fruitful significators between both charts: convergence means highest confidence prediction, divergence means suspect birth time).

KP medical timing: surgery window analysis (1st+6th+8th houses active, Moon in 11th significator nakshatra for recovery, no retrograde transit chain) and recovery vs chronic differentiation (compares 6th CSL star lord's signification level for 11th house vs 8th house: higher 11th = recovery, higher 8th = chronic).

KP oncology-specific lens. Decodes the body-part risk from the 6th cusp sign (12-sign to body-part map per KP Reader 3 ch.19-22), scores 6 named malignancy signatures (Jupiter-Rahu tumor, Saturn-Mars chronic-inflammation, Moon-Rahu lymphatic-malignancy, Saturn-Rahu slow-growth, Mars-Ketu genetic-predisposition, Sun-Saturn bone/marrow), and produces a recurrence-vs-cure verdict from 6th CSL star lord's 8th-house vs 11th-house signification dominance. Returns treatment-window dasha periods (1+5+11 jointly active) and disease-onset windows (6+8+12 active). Supplementary lens, not diagnostic; never a substitute for medical evaluation.

Multi-disease watch-decade panel scoring 8 chronic conditions: cardiac, diabetes, kidney, liver, neurological, mental-health, respiratory, skeletal. Each disease gets (a) a 0-100 signature strength from key planets afflicting 6/8/12 plus sign affinity on 6th cusp plus 6th-CSL match, (b) a severity classification (LOW/MODERATE/HIGH/CRITICAL), (c) watch-decade dasha bands (ONSET_RISK / AGGRAVATION / CRITICAL) drawn from MD+AD where the disease's key planets activate. Books: KP Reader 3 ch.19-22. Supplementary lens, not diagnostic; never a substitute for medical evaluation.

KP fertility-readiness lens. Promise check: 5th-cusp sub-lord must signify 2/5/11 (promise) and not 1/4/10 (denial), not retrograde, star lord not retrograde. Outputs overall verdict (NATURAL / IVF_OR_ASSISTED / DELAYED / DENIED / MIXED), Jupiter karaka health check, 5th-cusp sign affinity (fruitful: Cancer/Scorpio/Pisces; barren: Aries/Gemini/Leo/Virgo), per-child analysis (1st = 5th house, 2nd = 7th, 3rd = 9th), natural-conception dasha windows, IVF/assisted-reproduction signals (retrograde 5th CSL, Saturn/Mars/Rahu in 5th), miscarriage risk score (5+8 mixed-active). Books: KP Reader 4 children chapters, Aryan Astrology Research Centre, bestkpastrologer.com (Partha Sarathi Rout). Supplementary lens, not diagnostic; never a substitute for clinical fertility evaluation. Hard-disable any gender-of-child output for IN deployments (illegal under PCPNDT).

KP bhadhakasthana selection by lagna mobility class (KP Reader 3 ch.1 p.153). Movable lagna (Aries/Cancer/Libra/Capricorn) maps to 11th house, fixed lagna (Taurus/Leo/Scorpio/Aquarius) maps to 9th house, dual lagna (Gemini/Virgo/Sagittarius/Pisces) maps to 7th house. Returns the bhadhaka cusp's CSL, its star lord, all signifying planets, and a danger flag when the bhadhaka CSL also signifies maraka houses (2/7/8/12).

Flags every house cusp and natal planet that sits within 10 arc-minutes of a sub-lord boundary. Per KP Reader 1 a 6 arc-minute (1 Kala) shift can flip the sub-lord and invert the prediction. CRITICAL means within 6 arc-minutes (sub-lord could flip on small ayanamsa or birth-time correction). CAUTION means within 10 arc-minutes. Run this before relying on borderline CSL verdicts; it is the cheapest credibility check available.

KP financial/speculative analysis: Jupiter-Rahu combination detection (highest-probability speculative gain when both signify 5th/2nd/11th and are jointly active in dasha) and 8th-12th loss confirmation (maps high-risk dasha periods and Moon transit dates when loss significators dominate).

KP three-stage foreign settlement analysis: Stage 1 (decision to leave, houses 3+12), Stage 2 (journey, houses 9+12), Stage 3 (permanent settlement, 4th house connected to 12th). Each stage has independent CSL promise check and dasha timing. Verifies stages are chronologically sequential.

KP second marriage prediction: 8th house (2nd from 7th) CSL analysis for second partnership. Checks houses [2,8,11] for second marriage promise. Finds timing windows in dasha periods after first marriage activation.

Calendar of peak-risk dasha windows for marital separation, plus structured trigger detection. Returns: trigger strength (1/6/10 signified by 7th CSL star lord), Saturn/Rahu amplifier flag, peak-risk windows ranked by net risk score (separation houses minus marriage houses), sequential mixed-active pattern flag (marriage promised AND separation promised). Books: KP Reader 4 divorce chapters, Advanced T32. Supplementary lens, not legal advice; describes pattern risk, not predetermined outcome.

KP-rigorous compatibility analysis for two partners. Replaces Vedic Porutham (which KP rejects per Reader 4) with 6 CSL-based factors: LOVE (5th CSL by 5th CSL into 2/5/11), MARRIAGE (7 by 7 into 2/7/11), FINANCE (2 by 2 into 2/11), UNION (11 by 11 into 2/7/11), DENIAL_ABSENCE (no 6/8/12 from 7th CSL), and DASHA_SYNC (overlapping 7th-house dasha windows when both partners are simultaneously active in marriage-house periods). Returns 6 scored factors, dasha-sync windows, overall verdict (EXCELLENT/GOOD/AVERAGE/BELOW_AVERAGE/POOR), and explicit Porutham-rejection note.

KP property purchase analysis. 4th cusp signifies 4+11 maps to BUY; signifies 3/12 without 4/11 maps to AVOID; retrograde 4th CSL with promise maps to DEFER; 6+9 dominance maps to RENT_ONLY. Returns verdict, risk flags (retrograde, 12th-house foreign-property risk, 3rd-house relocation tendency, rental pattern), and best-purchase windows when verdict is BUY/DEFER. Books: KP Reader 3 ch.13-14, 43-44, KP Reader 6 cases 41-47.

KP timing for visa, immigration paperwork, contracts, and other documentation processes. Surfaces the 3rd-house Stage 1 from foreign-settlement as a discrete approval-milestone analysis. Returns verdict (PROMISED/DELAYED/DENIED), 3rd CSL signification of 3+9+11 (documentation promise group), all documentation-window dasha periods, and a filtered approval-likely subset (Jupiter-active windows with no retrograde impact). Books: KP Reader 3 ch.24-26.

KP accident-window detection. Identifies dasha periods with malefic activation (Mars / Saturn / Rahu) signifying risk houses, and classifies each window by accident class: VEHICULAR (3rd house), WORKPLACE (6+10), SURGICAL (1+8), ASSAULT (6+12), or GENERIC (4 or 8 with malefic). Severity bands: MINOR / MODERATE / SEVERE / LIFE_THREATENING. Returns ranked risk windows, aggregate type distribution, and the peak window. Books: KP Reader 3 ch.22, KP Reader 6 case 50, J5 p.50 worked accident case 23-7-1963. Supplementary safety lens, not deterministic; flags caution windows, never predicts certain harm.

KP job change vs promotion differentiation: checks if 5th house (12th from 6th = end of current employment) is activated in the current antardasha. 5th active + 10th = job change. 10th+11th without 5th = promotion within same organization.

KP litigation and detention analysis: litigation outcome prediction (compares 11th house L1/L2 strength vs 7th house activation, Jupiter transit for judgment year) and bail/detention timing (12th house AD = detention window, next 11th house AD = release, Moon transit = specific date).

Calendar wrapper around legal-analysis. Returns structured filing-window dates (Jupiter transits through 11th-house significators), a single judgment-month label, bail/detention windows by AD, appeal windows when verdict is UNFAVORABLE, and an imprisonment-risk score (0-100). Books: KP Reader 3 ch.47, 57-60, 69-72, pages 481, 498. Not legal advice; for advisor or litigant strategy support only, never a substitute for licensed counsel.

KP horary direction-finding for lost articles, theft, and missing persons. Takes a question_number (1-249) and a query_type ('theft' | 'lost' | 'missing_person'). Returns cardinal direction (E/W/N/S, derived from a planet in Kendhra or lagna fallback), distance class (SAME_PLACE / NEAR / MODERATE / FAR / ABROAD, from 7th significator's sub-lord house), in-house location (gate / middle / backyard, from lagna drekkana), recovery verdict (PROMISED / DELAYED / NOT_RECOVERED / WITHHELD), recovery dasha candidates, and a thief description with stature, age, sex, colour, shape, and whether the thief is a known relative, stranger, or neighbour. All rules grounded in KP Reader VI Slokas 1-4, 47, 49-59 and pages 50, 51, 64, 235, 237, 245. Investigative lens; not a substitute for police investigation in theft or missing-person cases.

Derives a structured spouse description from the 7th CSL's star lord per Advanced Technique T31. Returns profession class (industry archetype), age relationship (older / younger / same), geographic background (local / NRI-or-foreign-born / foreign), wealth relative to native (wealthier / comparable / poorer), personality archetype, and physical archetype. Designed for matrimonial-platform embeds.

Derives the type of profession (not timing) from the 10th CSL's star lord per Advanced Technique T34. Returns primary and secondary industry, sector class (government / private / self), employment mode (employment vs business per R3 ch.29-31), work type, leadership / technical / creative scores (each 0-100), and a qualitative salary band. Use alongside get_career_advanced (which handles career timing) and get_career_signature (which scores career-category fit).

Scores the chart against 8 named career categories (IT/software, government, business, military/defence, medicine, law, arts/creative, education/academia) per KP Reader 3 ch.27-43 signatures. Each category gets a 0-100 score with concrete signature hits. Also emits cross-cutting axes: sector class (government / private / self / mixed), employment mode (employment / business / mixed), and leadership / technical / creative scores (each 0-100). Use this for 'what is this person suited for'; pair with get_profession_description for 'describe the actual profession' and get_career_advanced for 'when promotion vs job-change'.

Scores the chart against 7 education tracks (IAS/Civil Services, IIT/Engineering, IIM/Management, Medicine, Law, PhD/Research, Arts/Creative) per KP Reader 3 ch.15, 25-26, 45 plus applied web canon. Each track gets a 0-100 score with concrete signature hits. Also returns scholarshipProbability (2nd+4th+11th+Jupiter), abroadEducationPromise (9th+12th+4th+Rahu over 9/12), and exam-success windows: dasha periods (next 15 years) where MD+AD light up the canonical exam houses [4, 9, 11], ranked PEAK/STRONG/WEAK.

When a querent asks the same question at multiple distinct moments (different times of day, different days), the significators that appear in every session's fruitful set carry the highest predictive certainty (T17). This tool takes at least 2 session moments and an event and computes the intersection of fruitful significators across sessions. Returns per-session details, ranked consensus list (planet, sessionCount, bestLevel), unanimous and near-unanimous planets, and a verdict: STRONG_UNANIMOUS / STRONG_PARTIAL / MIXED / WEAK.

For an ongoing situation (court case, prolonged job search, long illness), the practitioner casts horary charts at intervals and tracks how the CSL signification evolves. Pass at least 2 session moments and a topic; the engine builds each chart, runs the topic CSL verdict, and emits per-session snapshots (verdict, coverage_pct, supporting/detrimental houses, delta vs previous). Trend mapping: OSCILLATING, RESOLUTION_NEAR (coverage trending up, verdict improving), WORSENING (coverage falling, new detrimental houses), STABLE_FAVORABLE, or STABLE_UNFAVORABLE. T22 from docs/KP/3.Advance Techniques KP.md.

Minute-by-minute scan of a target trading day finding personal-chart windows where (a) Lagna sub-lord signifies any of the KP speculation houses [2, 5, 11], (b) Moon's sub-lord is clear of [6, 8, 12] problem houses, and (c) no Saturn/Jupiter retrograde invalidation. Per-window: HH:MM bands, lagna sub-lord, speculative coverage, moon clearance, retrograde flags, score 0-100. Day label: STRONG_FAVORABLE / WEAK_FAVORABLE / NEUTRAL / UNFAVORABLE relative to the native's personal chart. THIS IS PERSONAL PATTERN MATCHING, NOT FINANCIAL ADVICE OR BUY/SELL SIGNALS; tool output must never be presented as a market call, trade recommendation, or alpha signal. Defaults to NSE hours (09:00-15:30 IST) at Mumbai; override via trading_*_utc + trading_lat/lon.

Compares 2+ candidate natal charts and an election-day moment per KP Reader 3 ch.41-43 and R6 cases 90-92, 111. For each candidate: natal political-success score (cov[9,10,11] minus 0.5x cov[8,12]) plus election-day amplifiers (RP overlap, Jupiter transit through 11th-house significator, polling-close Lagna match). Returns likelyWinner, runnerUp, marginQualitative (HIGH / MODERATE / LOW / TOO_CLOSE_TO_CALL), and electionDayMuhurtaScore. Discreet B2B signal for political consultancy tooling, never standalone advice; do not present as a poll or vote forecast.

Qualitative lifespan-band estimation per KP Reader 3 ch.1 p.153 (Bhadhakasthana) and Reader 5 longevity transits. Returns: bhadhakasthana house (selected by lagna mobility, movable=11, fixed=9, dual=7 per KSK), maraka houses [2, 7, 12], 1st-CSL star lord signature, lifespanBand (SHORT / MIDDLE / LONG / INDETERMINATE), expectedAgeBand (qualitative band only, never an exact age), balarishtaWarning, and criticalWindows[] (dasha periods activating bhadhaka/maraka houses, ranked CAUTION / NOTABLE / PEAK_RISK with ageStart/End). BY DESIGN THIS TOOL DOES NOT AND CANNOT PREDICT DEATH DATES OR MOMENTS; outputs are qualitative bands and risk windows only. Restricted in some jurisdictions without consent; B2B advisor-tooling signal, never consumer-facing.

Takes two birth datetimes (typically 1-10 minutes apart) and computes how the twins' KP charts diverge: per-cusp longitude shift, sign / sign-lord / star-lord / sub-lord deltas, dasha balance diff (first MD lord, balance fraction, MD-end delta-days), per-event verdict / coverage / CSL deltas, and 'first material divergence age' (earliest age where MD or AD lords meaningfully differ). KP-precision proof-of-concept lens; the single strongest counter-argument to 'all twins get the same chart'.

Tests 8 weighted KP signals (5th CSL signifies 7+12, 7th CSL signifies 5+8, Venus+Mars in {5,7,8,12}, Rahu in 5/7/12, and others) and emits a riskBand NONE/LOW/MODERATE/NOTABLE/HIGH for the native's own self-reflection. Sensitive lens; B2B counselor-tooling only and strictly opt-in. Never disclose to a partner or third party; KP signatures describe predisposition only, never behaviour, and conscious choice dominates outcome.

Per contestant: natalScore = cov[1,5,11] minus 0.5x cov[6,7], plus match-day amplifiers (RP overlap x 5, match-start Lagna sub-lord in contestant RPs +10). Returns likelyWinner, runnerUp, and margin (CLEAR if delta is at least 15, NARROW if at least 5, otherwise EVEN_MATCH). Entertainment and curiosity lens only; never a betting recommendation, sportsbook signal, or wagering advice.

Sensitive child-survival risk lens for paediatric / fertility / IVF advisor tooling, scored on a child's natal chart. Distinct from get_longevity_balarishta (which targets adults). Tests classical balarishta combinations (Moon in 6/8/12 plus Saturn/Mars affliction, Saturn/Mars on lagna, 8th lord in 1st, 5th CSL signifies 8/12) plus mitigating signals (Jupiter in kendra, full 2+5+11 promise, Moon dignified). Score 0-100 maps to riskBand NONE/LOW/NOTABLE/HIGH. Supplementary lens, not diagnostic. B2B advisor-tooling only; never communicate raw output to a parent or caregiver.

Hybrid Ayurvedic-Jyotisha lens. Maps planets to doshas (Saturn/Rahu/Mercury to Vata, Sun/Mars/Ketu to Pitta, Moon/Jupiter/Venus to Kapha) weighted by house importance (1H strongest, then 6/8/12 health, then 4 vital fluids, and so on) and adds the lagna-sign element bonus. Returns vata/pitta/kapha percentage triple summing to 100, primary plus secondary dosha, prakritiCombo (single / dual / TRIDOSHIC), and per-planet contributions. Hybrid discussion starter, not a clinical Ayurvedic prakriti reading and not standalone health advice; supplementary lens only.

Per KP Reader 3 ch.48 and R5/R6 cases. Scores every planet for affliction (combust, debilitated, retrograde without dignity, in 6/8/12) with dignity offset, and emits remedial mantras for the most-afflicted planet, the bhadhakasthana lord (always), and any secondary affliction. Each recommendation includes beejMantra, extendedMantra (Vedic stotram), recommended weekday, repetition count (108), 40-day duration, and rationale. Strict KP framing: mitigation practice, not cure or guarantee.

Unified mundane-KP endpoint for a national chart (for example India 1947-08-15 IST) or a company incorporation chart. Returns: current MD/AD lord by house signification (B21), epidemic signature scorer (B22, Mercury+Moon+Ketu+6/8/12 cluster), weather signature (B23, water-sign Moon, cardinal lagna, Saturn/Venus/Mars on 4th; sparsely covered in books), disaster signature (B24, Mars-Rahu axis, Mars on 8, Rahu on 4). Each scorer returns signatures[] (only fired ones contribute), score 0-100, riskBand NONE/LOW/NOTABLE/HIGH/CRITICAL, notes. Includes topScorer for quick triage. Strict 9-graha (no outer planets). Historical and content-marketing lens, not an engineering-grade forecast; never present output as confirmed prediction of disasters, epidemics, or weather events.

KP auspicious moment triangulation: scans future hours/days for windows where 3 conditions are simultaneously met. (1) Lagna sub-lord signifies event houses, (2) Moon in fruitful significator nakshatra, (3) Day Lord is a fruitful significator. 3/3 = fully auspicious, 2/3 = workable. Used for scheduling marriages, surgeries, business launches.

Advanced KP birth time rectification: for each known life event (with date AND location), computes Ruling Planets at that event moment and checks overlap with the rectified chart's fruitful significators. Combines RP alignment score with dasha match score for the most rigorous rectification available in KP.

Per-planet Astangat / combustion analysis. Returns each non-Sun planet's arc-distance from the Sun, applicable combustion threshold (with retrograde reduction for Mercury / Venus), grade (NONE / ORDINARY / FULL, full = within 5° of Sun, blocking significations entirely), severity, and the canonical significations weakened or blocked. Books: KP Reader 1 ch.7, classical dignity literature.

Detects planets that occupy the same sign in D1 (natal) and D9 (Navamsa), i.e. vargottama. Vargottama placements have doubly reinforced significations and are treated as a strength multiplier in matching, career, and longevity assessments. Returns each planet's natal sign, D9 sign, vargottama flag, strength multiplier (1.0 or 2.0), and the count and names of all vargottama planets.

Detects Kala Sarpa Yoga and identifies the specific variant by Rahu's house (1: Anant, 2: Kulik, 3: Vasuki, 4: Shankhpal, 5: Padma, 6: Mahapadma, 7: Takshak, 8: Karkotak, 9: Shankhachoor, 10: Ghatak, 11: Vishadhar, 12: Sheshnag). Returns full vs partial classification (PARTIAL = 1-2 planets just outside the Rahu-Ketu axis), arc direction, theme description per variant, effects, and remedies. Books: KP Reader 3 ch.42, Sanatan Veda canon.

Detects classical yogas not covered by detect_yogas: Vipreet Raja (Harsha 6th-lord, Sarala 8th-lord, Vimala 12th-lord placed in dusthanas), Neecha Bhanga Raja Yoga (4 cancellation rules for debilitated planets), Adhi Yoga (benefics in 6/7/8 from Moon), Sunafa (planets in 2nd from Moon), Anafa (12th from Moon), Durdhura (both 2nd and 12th from Moon), and Chandra-Mangal (Moon-Mars conjunction or opposition). Each yoga returns presence, strength, forming planets, description, and effects.

Saturn's 7.5-year transit through 12th, 1st, and 2nd signs from the natal Moon, decomposed into the three named phases (Vraya / Janma / Patha) per cycle. Returns each cycle (past + current + future, up to 4) with absolute start/end dates, per-phase intensity scores (Janma highest), themes, current-phase status, days remaining in current phase, and auxiliary windows for Ashtama Shani (Saturn in 8th from Moon) and Ardha-ashtama (Saturn in 4th from Moon). Books: KP Reader 5, KP Reader 3 ch.51.

Computes when transit Saturn returns to its natal sidereal longitude, the canonical adulthood / mid-life / elder-stage thresholds (~age 28-30, 58-60, 87-90). Each return event includes the primary direct-crossing date plus any retrograde back-passes (1 or 3 crossings per return), duration in days, and a stage-appropriate interpretation. Books: KP Reader 5, classical Vedic canon.

Computes when transit Jupiter returns to its natal sidereal longitude. ~12-year cycle marks expansion / opportunity waves; canonical first return ~age 12, second ~24, fifth ~60. Each return event includes the primary direct-crossing date, retrograde back-passes if any, duration, and a stage-appropriate interpretation. Books: KP Reader 5.

KP Reader 5 Vedha rules: Saturn favourable in 3/6/11 from natal Moon with Vedha at 12/9/5; Jupiter favourable in 2/5/7/9/11 with Vedha at 12/4/3/10/8. Returns each slow planet's house from natal Moon, whether the favourable rule applies, whether the Vedha house is occupied (by which planets), the no-Vedha exceptions (Sun-Saturn, Moon-Mercury), and a final verdict (FAVOURABLE_CLEAR / FAVOURABLE_BUT_VEDHA / NEUTRAL / UNFAVOURABLE_HOUSE). Books: KP Reader 5.

Locates upcoming solar and lunar eclipses (next N months, default 24) by detecting syzygies near the lunar nodes (within 18° solar limit, 12° lunar limit) and measures arc-distance from each eclipse degree to natal sensitive points (Lagna, MC, all 9 luminaries / planets). Each natal hit gets a severity band: CRITICAL ≤1°, PROXIMAL ≤5°. Books: KP Reader 5, classical eclipse interpretation. Use to flag windows of intensified life themes; never frame as deterministic prediction.

Identifies the lagna's yoga karaka, the planet that simultaneously rules a kendra (1/4/7/10) and trikona (1/5/9), making it the chart's most beneficial planet. Returns the primary (and secondary candidate where contended), placement, sign/house, current dasha activation status (MD/AD), and the rationale (which kendra-trikona houses it rules).

Last 1/8 of every mahadasha, the classical 'Chidra' window of transition, anti-climax, and karmic close-out. Returns each MD's Chidra start/end dates, the broader 1/4 window, and current/past/future flags. Use to advise pausing major launches as a mahadasha approaches its close. Books: KP Reader 3 ch.51.

Bhrigu Bindu = midpoint of natal Moon and Rahu, a karmic destiny point that activates strongly when transited by slow planets (Saturn, Jupiter, Rahu, Ketu). Returns BB's longitude, sign, house, star/sub lord, and a chronological list of upcoming slow-planet crossings over BB across the next N years (default 10). Modern KP / cross-system; framed as karmic windows, not deterministic events.

Per-relative analysis using natural karakas: Father (Sun + 9th), Mother (Moon + 4th), Siblings (Mars + 3rd/11th), Children (Jupiter + 5th), Spouse (Venus for males / Jupiter for females + 7th). Each entry returns karaka placement, dignity, combust/retrograde flags, and qualitative scores (health, relationship, longevity 0-100), plus current dasha activation. Use for any 'how is my [relative]?' question.

9-fold Tara from natal Moon's nakshatra at any moment: Janma (neutral), Sampat (auspicious), Vipat (avoid), Kshema (auspicious), Pratyari (avoid), Sadhaka (auspicious), Vadha (strongly avoid), Mitra (auspicious), Atimitra (strongly auspicious). Use for 'is today auspicious for X?' daily checks and as a muhurta companion. Books: KP Reader 5 muhurta canon.

Planetary war detection among the 5 tara grahas (Mercury, Mars, Venus, Jupiter, Saturn). Any pair within 1° is in war; the winner is decided by dignity, then by lower longitude. Returns active wars, winner/loser, separation arc, severity (CLOSE ≤0.5° / MODERATE ≤1°), and the loser's suppressed significations. Sun, Moon, Rahu, Ketu do not participate.

15 standard Tajik sahams as A-B+C lots: Punya, Yasas, Vidya, Vivah, Putra, Karya, Roga, Pitri, Matri, Bhratri, Rajya, Nyya, Bandhana, Krodha, Karya-Siddhi. Each returns sidereal longitude, sign, house, star lord, sub lord, formula used (day vs night chart), and a one-line description. Use for varshaphala (annual chart) work and slow-planet transit timing of life themes. Mrityu Saham is intentionally omitted per project policy (no death framing).

Six-fold planetary strength per BPHS / KP Reader 3: Sthana (positional), Dig (directional), Kala (temporal day/night), Cheshta (motional), Naisargika (natural), Drik (aspectual). Each component is normalised to 0-100; total is the average. Returns ranked planets with strongest / weakest, relative-strength bands (STRONG ≥65, MODERATE 45-64, WEAK <45), and dominant component per planet. Use to weight any planetary signification by raw strength.

[Cross-system reference tool] Saptamsa (D7) divisional chart per BPHS ch.6. Each natal sign divided into 7 parts of 4°17'08\". Used for children / progeny analysis. Returns D7 ascendant, planet placements, vargottama flags, and a focused readout of the 5th house (children house). Pairs with get_fertility_window for fertility-clinic embeds.

[Cross-system reference tool] Chaturvimsamsa / Siddhamsa (D24) divisional chart per BPHS ch.6. Each natal sign divided into 24 parts of 1°15'. Used for education / academic-success analysis. Returns D24 ascendant, planet placements, vargottama flags, and 4th house (learning) readout. Pairs with get_education_signature for ed-tech embeds.

[Cross-system reference tool] Shashtiamsa (D60) divisional chart per BPHS ch.6. Each natal sign divided into 60 parts of 0°30' (the highest-resolution division). Used for deep karma / total chart fingerprint. Highly birth-time-sensitive, also serves as a rectification stress-test. Returns D60 ascendant, placements, vargottama flags, and 1st-house (karma) readout.

Recomputes lagna and house cusps for an alternate latitude/longitude at the original birth datetime. Planets do not move (geocentric positions unchanged) but house assignments shift. Use for 'where should I move/work?' analysis, strong NRI / immigration-consultant appeal. Returns the relocated ascendant, all 12 cusps, and per-planet house-shift between natal and relocated charts.

Sign-to-body-part affliction panel. Maps each sign to its body region (Aries=head, Taurus=throat, ..., Pisces=feet) and organ system, scores affliction 0-100 from malefics in the sign + sign-lord weakness (combust/debilitated/retrograde). Returns per-sign body-part rows, highest-risk organ, and standard medical disclaimer. SUPPLEMENTARY LENS, NOT DIAGNOSTIC; never a substitute for medical evaluation. Books: KP Reader 3 ch.19-22, BPHS body-parts canon.

[Vedic kundli-match adjunct] 36-point Vedic Guna Milan: Varna(1) + Vashya(2) + Tara(3) + Yoni(4) + Graha-Maitri(5) + Gana(6) + Bhakoota(7) + Nadi(8). Returns each koota's score with description, total /36, score band (EXCELLENT/GOOD/AVERAGE/POOR), Nadi-Dosha and Bhakoot-Dosha flags. Designed for matrimonial-platform B2B embeds. NOTE: KP Reader 4 explicitly rejects Porutham; use get_compatibility_advanced for KP-rigorous compatibility (CSL-based).

[Vedic muhurta adjunct] 8 day + 8 night auspicious 1.5-hour periods (Amrit/Shubh/Labh/Char/Udveg/Rog/Kal). Each period returns lord, quality (auspicious/inauspicious), start/end UTC, and interpretation. Companion to get_panchang. Daily-utility tool with high recurring traffic.

[Vedic muhurta adjunct] 24 planetary hours per day, each ruled by one of 7 visible planets in Chaldean order (Saturn→Jupiter→Mars→Sun→Venus→Mercury→Moon). Day starts at sunrise; first hour = weekday's lord. Returns each hour's lord, quality, start/end UTC, interpretation. Pairs with Choghadiya for fine-grained timing.

[Tajik annual chart adjunct] Solar return chart cast for the moment Sun returns to its natal sidereal degree in the target year. Returns Sun-return datetime, chart lagna at that moment, Muntha sign (advances 1 sign per year of life), Muntha house from chart lagna, year lord (Varshesh), and all planet positions at sun-return. Used for annual subscription-reading products.

[Vedic alt-annual adjunct] Soli-lunar return ('true Vedic birthday'), chart cast when Sun returns to natal sidereal degree AND Moon occupies natal tithi. Per Sanjay Rath / PVR Narasimha Rao tradition. Returns TP datetime, chart lagna, match quality (EXACT/CLOSE/APPROXIMATE), and offsets.

[Jaimini adjunct] 7-karaka system ranked by sidereal degree within own sign: Atmakaraka (highest, soul) → Amatyakaraka (career) → Bhratri (siblings) → Matri (mother) → Putra (children) → Gnati (obstacles) → Darakaraka (lowest, spouse). Rahu and Ketu excluded per authentic-method convention. Used for soul-purpose / career-coaching B2B.

[Jaimini adjunct] Arudha Lagna, the Pada of the 1st house, representing public image / how the world perceives the native. Calculated by counting from lagna to lagna lord, then same count again from the lord. Returns AL sign, lord, occupants, aspecting planets, and interpretation. Foundational Jaimini concept; B2B fit for personal-branding apps.

[Jaimini adjunct] Upapada Lagna, Pada of the 12th house, used for marriage / spouse analysis in Jaimini tradition. Returns UL sign, lord, occupants, aspecting planets. Also returns all 12 Arudha padas (A1-A12) for completeness. B2B fit for matrimonial-platform deeper-layer analysis.

[Jaimini adjunct] Personal deity from the 12th house from Karakamsa (Atmakaraka in D9). Sun→Shiva, Moon→Parvati/Gauri, Mars→Kartikeya, Mercury→Vishnu, Jupiter→Narayana, Venus→Lakshmi, Saturn→Hanuman/Brahma, Rahu→Durga, Ketu→Ganesha. Returns deity, alternates, mantra, and worship guidance. B2B fit for spiritual / wellness apps.

[Vedic alt-dasha adjunct] 36-year cycle, 8 yoginis based on natal Moon's nakshatra: Mangala(1y), Pingala(2), Dhanya(3), Bhramari(4), Bhadrika(5), Ulka(6), Siddha(7), Sankata(8). Returns each yogini period with start/end dates, quality (auspicious/inauspicious), interpretation, current/past/future flags. Cross-validates Vimshottari timing.

[Vedic alt-dasha adjunct] 108-year cycle, 8 planets (no Ketu): Sun(6), Moon(15), Mars(8), Mercury(17), Saturn(10), Jupiter(19), Rahu(12), Venus(21). Best applied for births during day in Krishna Paksha. Returns each period with start/end dates, current/past/future flags. Cross-validates Vimshottari.

[Jaimini adjunct] Sign-based dasha (rashi cycles). Each sign's period = number of signs from that sign to its lord. Returns each sign-period with start/end dates and current/past/future flags. Used heavily for career and relationship timing in Jaimini schools.

[Vedic Parashari adjunct] Vasi (planet in 12th from Sun), Vesi (planet in 2nd from Sun), Ubhayachari (both 2nd and 12th occupied). Companion to lunar yogas already in get_yogas_advanced. Each yoga returns presence, strength, forming planets, description, effects.

[Vedic Parashari adjunct] Shubha Kartari (lagna flanked by benefics) + Papa Kartari (lagna flanked by malefics). Per-house verdicts; common in chart consultations. Returns each yoga's presence, strength, forming planets, effects.

[Vedic Parashari adjunct] Sign-exchange yoga in 3 classes: Maha (kendra-trikona lord exchange, strongest fortune amplifier), Khala (3rd-lord exchange, energising effort), Dainya (exchange with dusthana lord, afflicted). Returns each detected pair with classification, forming planets, and effects.

[Vedic Parashari adjunct] Structural-affliction panel: Daridra (11th lord in 6/8/12), Shakata (Moon in 6/8/12 from Jupiter), Vish (Saturn-Moon close conjunction), Guru-Chandala (Jupiter-Rahu/Ketu conjunction within 12°). Each returns presence, strength, description, effects.

[Vedic Parashari adjunct] D2 (Hora) divisional chart per BPHS ch.6. Each natal sign halved into solar/lunar Hora, wealth-acquisition ability. Returns D2 ascendant, planet placements (split by Sun's hora vs Moon's hora), vargottama flags.

[Vedic Parashari adjunct] D3 (Drekkana) divisional chart per BPHS ch.6. Each natal sign divided into 3 parts of 10° each, siblings, courage, enterprise, initiative. Returns D3 ascendant, placements, vargottama flags, 3rd house readout.

[Vedic Parashari adjunct] D4 divisional chart per BPHS ch.6. Each natal sign divided into 4 parts of 7.5°, fixed assets, real estate, vehicles, shelter. Returns D4 ascendant, placements, 4th-house readout. Pairs with get_property_decision.

[Vedic Parashari adjunct] D6 divisional chart per BPHS ch.6. Each natal sign divided into 6 parts of 5°, debts, illness, conflicts. Returns D6 ascendant, placements, 6th-house readout. Companion to get_chronic_disease_panel.

[Vedic Parashari adjunct] D8 divisional chart per BPHS ch.6. Each natal sign divided into 8 parts of 3.75°, longevity, sudden events. Returns D8 ascendant, placements, 8th-house readout. Companion to get_longevity_balarishta.

[Vedic Parashari adjunct] D12 divisional chart per BPHS ch.6. Each natal sign divided into 12 parts of 2.5°, parents, lineage, prenatal karma, ancestral patterns. Returns D12 ascendant, placements, 9th-house readout. High demand for family-themed apps.

[Vedic Parashari adjunct] D16 divisional chart per BPHS ch.6. Each natal sign divided into 16 parts of 1.875°, movable assets, vehicles, life comforts. Returns D16 ascendant, placements, 4th-house readout.

[Vedic Parashari adjunct] D20 divisional chart per BPHS ch.6. Each natal sign divided into 20 parts of 1.5°, spiritual life, sadhana, religious devotion. Returns D20 ascendant, placements, 9th-house readout. Pairs with get_ishta_devata.

[Vedic Parashari adjunct] D27 divisional chart per BPHS ch.6. Each natal sign divided into 27 parts of 1.111°, inherent personality strengths and weaknesses. Highly precise division. Returns D27 ascendant, placements, 1st-house readout.

[Vedic Parashari adjunct] D30 divisional chart per BPHS ch.6, misfortune, arishta, mental tendencies. Uses canonical Parashara mapping (odd vs even sign portions to different planet's signs). Returns D30 ascendant, placements, 6th-house readout.

[Vedic Parashari adjunct] D40 divisional chart per BPHS ch.6. Each natal sign divided into 40 parts of 0.75°, general auspiciousness, maternal lineage. Returns D40 ascendant, placements, 4th-house readout.

[Vedic Parashari adjunct] D45 divisional chart per BPHS ch.6. Each natal sign divided into 45 parts of 0.667°, character, conduct, paternal lineage. Returns D45 ascendant, placements, 1st-house readout.

[Vedic Parashari adjunct] Net house strength: Bhavadhipati (lord's Shadbala) + Drik Bala (cusp aspectual strength) + Dig Bala (directional). Each component 0-100; total averaged. Returns per-house entry with strength band (STRONG≥65, MODERATE 45-64, WEAK<45), strongest and weakest house.

[Vedic Parashari adjunct] 20-fold strength of each planet across 16 vargas (D1=3.5 weight, D2=1, D3=1, D7=0.5, D9=3, D10=0.5, ..., D60=4). Per-planet weighted score 0-20 with band (EXCELLENT 17+, VERY_GOOD 14-17, GOOD 11-14, AVERAGE 8-11, POOR <8). Used by Jaimini practitioners as the planetary 'report card'.

[KP-rule remedial] Lagna-friendly gemstone via KP rule (Reader 3 ch.48): the 1st or 11th cusp sub-lord is the candidate, MUST NOT be connected to dusthanas (6/8/12). Returns primary + secondary recommendations with stone, planet, wearing instructions; or contraindicated verdict if both candidates afflicted. B2B fit for e-commerce gemstone shops.

[Cross-system spiritual lens] Karmic-indicator panel: 12th house planets (carry-over signatures), Saturn position (debt patterns), Ketu sign (past-life skills), Rahu sign (unfinished desires), Karakamsa (soul-direction this lifetime), 12th from Karakamsa (moksha gate). Interpretive lens, not deterministic. B2B fit for spiritual / coaching apps.

Atomic pre-flight integrity check before any final verdict. Runs 'get_boundary_warnings' + 'get_combust_planets' + 'get_graha_yuddha' + 'get_vargottama_planets' in parallel server-side and emits a single confidence modifier (-30..+20) with band HIGH/MODERATE/LOW. Returns '{ flags, confidenceModifier, confidenceBand, recommendations[], summary }'. Saves 4 round-trips. Pattern E from KP expert-pattern set.

Cross-validates event timing across THREE independent dasha systems: Vimshottari (event-filtered) + Yogini (36-yr) + Jaimini Chara (sign-based). Finds calendar windows where multiple systems independently flag the same time range. Returns '{ vimshottariWindows[], yoginiCurrent, charaCurrent, convergenceWindows: [{ startDate, endDate, systemsAgreeing: 1|2|3 }], convergenceLevel: STRONG|PARTIAL|WEAK|DIVERGENT }'. Pattern B. Per K.N. Rao 'Finer Techniques of Astrological Predictions'.

Atomic spiritual / soul-purpose reading. Runs Atmakaraka identification → D9 → Karakamsa → 12th-from-Karakamsa → Ishta Devata + D20 + past-life karmic + Bhrigu Bindu in one call. Returns '{ atmakaraka, karakamsa, twelfthFromKarakamsa, ishtaDevata: { primaryDeity, mantra }, d20Spirituality, pastLifeSummary, bhriguBinduDestiny, spiritualPath }'. Pattern C. Per Sanjay Rath 'Crux of Vedic Astrology' + Jaimini Sutras.

Atomic comprehensive marriage analysis for matrimonial-platform B2B. Bundles: CSL promise verdict ('analyze_natal_promise' for Marriage) + spouse characteristics + Manglik dosha + Upapada Lagna (Jaimini) + vargottama strength multipliers + second-marriage check + DBA timing windows + pre-verdict audit. Returns '{ promiseVerdict, spouseCharacteristics, manglikDosha, upapadaLagna, vargottamaSummary, secondMarriagePromise, timingWindows[], preVerdictAudit, synthesis }'. Saves 8 round-trips per reading.

Atomic comprehensive career analysis for career-coaching B2B. Bundles: CSL promise verdict (Career) + 8-category career signature + profession description (industry/sector/employment-mode) + job-change-vs-promotion timing + lagna yoga karaka + Jaimini Amatyakaraka + pre-verdict audit. Returns '{ promiseVerdict, careerSignature, professionNature, jobChangeVsPromotion, yogaKaraka, jaiminiAmatyakaraka, preVerdictAudit, synthesis }'. Saves 7 round-trips per reading.

Atomic comprehensive matrimonial matching for matrimonial-platform B2B. Cross-validates THREE compatibility systems: 36-pt Vedic Ashta Koota (Varna+Vashya+Tara+Yoni+Graha-Maitri+Gana+Bhakoota+Nadi) + KP-rigorous 6-CSL-factor (LOVE/MARRIAGE/FINANCE/UNION/DENIAL/DASHA-SYNC) + Manglik check on both partners + Jaimini Upapada Lagna relationship classification. Returns '{ ashtaKoota, kpRigorousCompatibility, manglikCheck, upapadaLagnaRelationship, synthesis: { overallVerdict, confidenceBand, crossSystemConcordance: STRONG|PARTIAL|DIVERGENT } }'. The matrimonial flagship workflow.

Atomic daily-outlook composite for daily-content / lifestyle B2B apps. Bundles: Choghadiya (8 day + 8 night auspicious 1.5-hr periods) + Hora (24 planetary hours) + Tara Bala (9-fold from native's nakshatra) + Moon transit + next-auspicious-window list. Returns '{ weekday, sunriseUTC, sunsetUTC, currentChoghadiya, currentHora, taraBala, moonTransit, nextAuspiciousWindows[], synthesis: { overallToneToday: FAVOURABLE|MIXED|CAUTIOUS } }'. Saves 5 round-trips per daily refresh.

Atomic year-outlook composite for annual-subscription B2B products. Bundles: 12-month annual forecast + Tajik Varshaphala (solar return + Muntha) + Tithi Pravesha (soli-lunar return) + 5 key Sahams (Punya/Yasas/Karya/Karya-Siddhi/Vivah) + Yogini dasha + Ashtottari dasha + Sade Sati phases + eclipse impacts. Returns '{ targetYear, varshaphala, tithiPravesha, keySahams[], yoginiCurrent, ashtottariCurrent, sadeSatiStatus, eclipseImpacts[], synthesis: { yearTone: GROWTH|CONSOLIDATION|CAUTION|TRANSFORMATION, topMonths[] } }'. Saves 8 round-trips per annual report.

Read the KP astrometeorology signature for a single place and moment. Builds the chart for the location and time, then scores three weather channels, temperature, precipitation, and wind/storm, each with a signal, a numeric score, a descriptive band, and the chart signatures behind it. Also returns the 4th-cusp CSL verdict, the Sapta Nadi Chakra block, a plain-language summary, and a disclaimer. Inputs: latitude, longitude, utc_offset_minutes, optional ayanamsa, optional location_label, and an optional 'datetime' (ISO 8601, defaults to now). Use when: you want the weather tendency for one place at one time. The result shows the full reasoning, every band and score names the signatures it came from.

Read the four seasonal weather themes for a place across one year, derived from the cardinal ingress charts (the Sun entering Aries, Cancer, Libra, and Capricorn). Returns a 'seasons[]' array, each season carrying the full astrometeorology signature: temperature, precipitation, and wind/storm channels with signal, score, band, and signatures, plus the 4th-cusp CSL verdict, the Sapta Nadi block, a summary, and a disclaimer. Inputs: latitude, longitude, utc_offset_minutes, optional ayanamsa, optional location_label, an optional 'year' (defaults to the current year), and an optional 'frame' ('tropical' or 'sidereal') for the ingress reference. Use when: you want a year-ahead seasonal weather picture for a location. Every seasonal band shows the signatures behind it.

Read the roughly 14-day weather windows for a place across a date range, each window cast from a lunation chart (the new moon or full moon that opens it). Returns a 'windows[]' array, each window carrying the full astrometeorology signature: temperature, precipitation, and wind/storm channels with signal, score, band, and signatures, plus the 4th-cusp CSL verdict, the Sapta Nadi block, a summary, and a disclaimer. Inputs: latitude, longitude, utc_offset_minutes, optional ayanamsa, optional location_label, and optional 'start_date' and 'end_date' (ISO dates; default to a sensible range around now). Use when: you want fortnight-by-fortnight weather windows for a location over a span of weeks or months. Every window's bands show the signatures behind them.

Read the monsoon-onset signature for a place from the Ardra Pravesha chart (the chart for the Sun's entry into the Ardra nakshatra, the classical KP marker for the monsoon). Returns one astrometeorology signature under 'weather', with temperature, precipitation, and wind/storm channels each carrying signal, score, band, and signatures, plus the 4th-cusp CSL verdict, the Sapta Nadi block, a summary, and a disclaimer, alongside an 'ardraPravesha' block describing the ingress chart itself. Inputs: latitude, longitude, utc_offset_minutes, optional ayanamsa, optional location_label, and an optional 'year' (defaults to the current year). Use when: you want a monsoon-onset and rainfall read for a location and year. The bands show the signatures behind them.

S.P. Khullar's three-authority KCIL weighted verdict — produces a 0-100 KCIL score per house cusp instead of KP's binary promise/denial. Star Lord (15% weight) proposes, Sub Lord (60%) disposes, Sub-Sub Lord (25%) delivers the end result. Returns per-cusp scores with full lord-level breakdown (housesSignified, supportingHits, denialHits) and an overall score with verdict thresholds (≥70 STRONG_PROMISE, 50-69 MIXED, 30-49 WEAK, <30 DENIED). Use as a continuous-scoring alternative to analyze_natal_promise when you want a graded readout. Accepts an event name OR custom (primary_houses + house_group + denial_group).

Hariharan Four-Step Theory cross-validator. KP treats the Sub Lord as the end-result indicator; Four-Step Theory treats the STAR LORD OF THE SUB LORD as the end-result indicator. Running both side-by-side per cusp produces an agreement signal: STRONG_AGREEMENT (≥75% of cusps agree) → high confidence; PARTIAL_AGREEMENT (50-74%) → moderate; DIVERGENCE (<50%) → borderline reading requiring deeper analysis. Use as a second-opinion layer after analyze_natal_promise.

Andrew Dutta's Rule of Origin: a correctly-rectified birth chart will have the Lagna's star/sub lord connected to the 9th cusp's star/sub lord. Returns verdict DIRECT (same planet match — score 2, HIGH confidence in birth time), INDIRECT (third-planet bridge — score 1, MODERATE), or NONE (no connection — score 0, LOW; birth time likely needs rectification). Use as a fast pre-flight check on any birth chart before deeper readings.

Longitude-based harmonic aspect engine that complements the Parashari sign-aspect set. Detects aspects at 0°/30°/36°/45°/60°/72°/90°/108°/120°/135°/144°/150°/162°/180° plus the 22.5° harmonic series (22.5°/67.5°/112.5°/157.5°) with per-aspect orbs. Each detected aspect is annotated with polarity (good/bad/neutral), magnitude (major/minor), exactness, and SUB-LORD RESONANCE — when planet A's sub-lord is B, or both share a sub-lord, the aspect intensifies during the dasha of either planet. Use to surface stressful or supportive planetary tensions invisible to sign-aspect analysis.

Quantifies how close every house cusp and planet sits to a sub-sub-lord boundary (the 2,187-cell KCIL precision grid). Returns per-position arc-seconds to nearest boundary, the alternate sub-sub-lord that would apply if the position shifted across the boundary, and a CRITICAL/WARNING/STABLE flag. Includes a 0-100 twin-divergence index estimating how strongly this chart's KCIL-level predictions depend on birth-second precision. Use for birth-time precision audits, twin-chart analysis, and boundary-sensitive rectification.

Kanak Bosmia's 6-Fold Significator Matrix extends KP's L1-L4 with L5 (sub-sub-lord of cusp + its star satellites) and L6 (sub-lord of occupant + sub-lord of cusp lord). Also returns the 7-Ruling-Planet set (Lagna sign/star/sub + Moon sign/star/sub + Day Lord) instead of the canonical 5. Use when standard 4-level matrix produces too few candidates or for cross-school comparisons.

Per-planet P(event fires) ∈ [0, 1] computed from explainable feature weights: matrix level (L1=1.0, L2=0.7, L3=0.5, L4=0.3), Ruling Planet presence (+0.30), active dasha layers (+0.25 each), natal retrograde (-0.20), denial-house overlap (up to -0.25). Logistic-squashed to bounded probability. Returns ranked significators with per-feature contributions and an aggregate STRONG/MODERATE/WEAK/NEGLIGIBLE verdict. Use as a numerical sanity check on dasha-period predictions.

Sub-lord-resolved intensity timeline for Saturn's sade-sati transit (the 7.5 year period of Saturn through 12th/1st/2nd from natal Moon). Returns per-window {sub-lord, star-lord, intensity 0-100, content themes}. Saturn-in-Sub-of-Saturn = peak pressure; Saturn-in-Sub-of-Jupiter = relief; Saturn-in-Sub-of-Rahu = unconventional disruption. Use to map specific months/years of sade-sati to specific life themes.

Cross-references upcoming solar and lunar eclipses with natal cusp sub-lord boundaries. Eclipses landing within 30 arc-minutes of a cusp = CRITICAL activation of that house's significations; within 30 arcmin of a sub-lord boundary = STRONG. Activation window = eclipse date + 6 months. Use to identify specific cusps the next ~18 months will activate.

Cast a KP chart for the moment the Sun reaches sidereal 0° Aries (annual), 0° Cancer (Q2), 0° Libra (Q3), and 0° Capricorn (Q4) for a chosen location. Read 10th CSL for governance/status, 6th CSL for crisis windows, 1st CSL for public mood, 7th CSL for foreign relations. The Aries ingress is the annual baseline; the other three refine quarterly themes. LOCATION-BASED — provide latitude / longitude / utc_offset_minutes (not birth data).

For every active dasha level (MD/AD/PD) returns parallel KP and 4-Step end-result indicators: KP indicator = dasha lord's sub-lord, 4-Step indicator = dasha lord's star-lord. Also includes upcoming Antardasha periods with both indicators. Use to reason about which school's timing prevails on a given event without recomputing the dasha calendar.

Headline cross-school verdict for an event. Runs orthodox KP CSL analysis, KCIL (Khullar weighted 15/60/25), 4-Step (Hariharan star-lord-of-sub-lord), and Bosmia 6-fold (filtered through 7-RP) and returns all four normalised verdicts side-by-side with a consensus score: UNANIMOUS_PROMISE (4/4 agree), STRONG_PROMISE/DENIAL (3/4), MIXED (≥2 mixed), or SPLIT. Use as the defensible cross-school headline tool instead of any single school alone.

Computes a 12×12 cuspal interlink strength matrix. Each cell scores how strongly cusp i's {sub, star, sign} lords appear among cusp j's {occupant, owner, star-of-occupant, star-of-owner}. Weights: sub-lord match = 3, star-lord = 2, sign-lord = 1. Per-cell max = 24. Returns the matrix, top 24 strongest links, average ratio, and densest house (the strongest event-cluster center).

Computes a single weighted 0-100 divergence score between two birth charts (twins or rectification candidates). Per-cusp impact weighted by life-domain criticality (7th and 10th highest at weight 10; 8th at 9). CSL change contributes full weight, star-lord change half, sub-sub-lord change a quarter. Use to communicate \"your twin diverges X/100\" in a single headline number.