Sahadeva

Router / planner. Give it the user's natural-language question and optional context flags and it returns a deterministic, ordered call plan — the primary tool, why, the arguments it needs, alternatives and relevant resource URIs — so you know exactly what to call BEFORE calling it. Read-only, makes no astrological claim. Call this first when unsure which of the many tools fits.

Searches Sahadeva's deterministic local catalogue and geographic index. It never invokes another AI model. If no result exists, the MCP host should resolve the place with its own capabilities and pass coordinates to the chart tool.

EXPERT FULL-MATRIX TOOL — prefer consult_jyotishya (normal questions) or get_compact_chart_evidence (compact facts). Use this only when the user explicitly requests full technical matrices. Calculates a complete South Indian chart from a known catalogue place or explicit latitude, longitude, and IANA timezone supplied by the MCP host. Bare place names auto-resolve to the curated best-effort match

Family view for 2–6 linked people (for example wife, husband, children, parents). For each person: current mahadasha and antardasha with dates, upcoming period changes, Sade Sati / Ashtama Shani status, and the windows when two or more members are under Saturn pressure together. Use it when a question involves the whole family. It reports dated overlaps only and never treats one chart as the cause

Resolves both birth places, calculates both charts, and returns separate auditable North Indian 36-point Ashtakoota and South Indian ten-Porutham breakdowns plus Mangal/Kuja Dosha evidence. Traditional research preview; never a relationship verdict.

Gender-neutral Nakshatra compatibility between any two people for a chosen bond — business partner, friend, sibling, colleague, mentor/student, roommate or general. Resolves both places, calculates both charts, and returns per-factor Tara, Graha Maitri, Gana, Yoni, Bhakoot and Moon-element evidence weighted for that relationship, plus a 0-100 harmony index. Traditional research preview; never a ve

Returns the five limbs plus Rahu Kaal, Yamaganda, Gulika, Bhadra status, Abhijit and Brahma Muhurta, day/night Choghadiya, 24 Horas, solar-day context, festival flags, and optional Tara/Chandra Bala from a natal chart.

Ranks candidate windows over a bounded date range using activity Panchanga fitness, prohibited-period avoidance, optional Tara/Chandra Bala, instant Lagna structure, and activity-karaka condition. Returns every pass/fail reason and draft source key.

EXPERT electional search: finds ascendant-sign windows across 1 day (up to 3 with an API key) and scores each elected Lagna structurally (lord strength and dignity, benefic/malefic placement, Moon condition, activity-karaka state, prohibited-period overlap). Ineligible windows stay visible with fail reasons; draft rules, never a guarantee.

Calculates Mangal/Kuja, Kaal Sarpa enclosure, Kemadruma, and conservative Pitru-related structural candidates with raw/effective severity and explicit cancellation or mitigation evidence.

Returns deterministic Nakshatra star, sub, and sub-sub lords, ruling planets, and transparent significator evidence. Explicitly reports KP ayanamsa and Placidus cusps as unavailable until independently validated.

Returns seven- and eight-Chara-Karaka conventions, all Arudha Padas including Arudha Lagna and Upapada, Karakamsha, and Jaimini Rashi Drishti matrices without silently mixing conventions.

Solves the exact tropical solar-return instant for a target year and returns the sidereal annual chart, Muntha, Tajika aspect candidates, and transparent boundaries for pending Varshesha, Saham, and Mudda-Dasha rules.

Projects placements and sign-based Graha Drishti under Lahiri, Krishnamurti, Raman, or Fagan/Bradley, reports boundary changes, and preserves per-convention validation status. Non-Lahiri full derived systems are not silently recomputed.

Detects structural afflictions and supportive Yogas, weights their activation through Vimshottari Maha/Antardashas over a date range, and returns ranked neutral themes with reasons, citation state, uncalibrated confidence, and mandatory safety limits.

PRIMARY TOOL FOR EVERY NORMAL USER QUESTION AND FIRST READING. Always runs a complete person-first screen covering identity, education, employment, business, money, love, marriage, health routines, family/property, children and spirituality, plus strengths, Doshas/cancellations and safe practical support. It then gives extra Varga and timing depth to the exact question, checks contradictions and r

Runs the shared deterministic judgment pipeline for career, education, property, relationships, or spirituality. Returns supporting and opposing evidence, relevant Varga confirmation, current Dasha activation, uncertainty, matched reviewed citations, unresolved source keys, and explicit abstention boundaries. The web app uses the same judgment engine.

Reviewer/developer tool. Validates the typed rule DSL and replays a proposed rule, including exceptions and harm/review publication gates, against a deterministic chart. It does not approve or publish the rule.

Lists or deterministically replays a local book-rule fixture, comparing expected matches, exceptions and source locators. Passing validates software consistency only; examples remain unpublishable until independent scan adjudication and review.

Compares Lahiri with selected alternative ayanamsa projections for one topic, identifies changed Lagna, topic lord, karaka, sign, house and Nakshatra anchors, and marks when a Lahiri judgment must not be reused. Alternative full derived charts remain explicitly unvalidated.

Returns the selected house, lord condition, occupants, functional lordship, relevant relationship edges, supporting and opposing evidence, unresolved source keys and sensitive-house restrictions.

Refines the question, checks birth-time fitness, collects dated life history for rectification, records consent, and returns the session plan. Run this before chart judgment for a new person.

Builds one reviewable claim from a topic judgment: active dasha window, observable outcome, falsifier, and review date. Resolve it later with record_consultation_outcome.

Returns dispositors, chains, conjunctions, exchanges, Graha Drishti, compound relationships and Lagna-specific functional lordships as distinct edge types.

Returns calculated Vara, Tithi class, Nakshatra lord, Yoga, Karana, Paksha Bala, boundary warnings and unresolved lineage-specific source keys. This is distinct from daily Panchanga.

Converts verified natal placements to Lal Kitab fixed houses and returns source locators for all nine planet-house sections. Prediction prose, annual-chart emulation and remedies remain withheld until atomic extraction, scan verification and lineage review.

Returns all source families, locators, coverage counts, lexical risk signals and graduated disclosure policy without republishing source body text.

Matches the chart's nine fixed-house placements to remedy blocks extracted from the complete 778-page corpus. Returns provenance, classifications and safety flags, but withholds OCR instruction text until each condition graph is scan-verified and independently approved.

Calculates a topic-aware Lal Kitab natal prediction and remedy plan from fixed houses, conjunction friendship/enmity, dormancy, eclipse conditions and birth-period context. It reasons from calculated chart facts without searching the corpus at runtime and returns a complete explanation trace; annual timing is not implied.

Returns whole-book extraction counts, source hash, catalog hash and publication policy without returning copyrighted remedy text.

Builds an optional practice protocol from the evidence ledger and user preferences. It can return no-remedy-needed, never emits unreviewed gemstones, costly rituals or initiation-only mantras, and does not claim causality.

Calculates Iṣṭa, Dharma, Pālana, Guru and Kula Devatā anchors from an explicit lineage preset: occupants, Rashi Drishti, then sign lord with visible tie-breaks. Unsupported lineages are withheld rather than silently mixed. It never prescribes initiation-only mantra or claims one uniquely correct deity.

Combines the topic evidence ledger, belief/cost/burden preferences, Iṣṭa and guiding Devatā calculation, Muhurta-as-remedy routing, optional charity and low-risk conduct. Every candidate exposes its source and publication gate. It withholds unreviewed gemstones, initiation-only mantras, fasting and costly rituals.

Research-preview remedy repertoire. Works out each graha's functional nature and afflictions, then returns conduct, optional charity, dosha candidates and Dasha-based timing. Mantras and gemstones require explicit opt-in and remain unreviewed traditional material. Lal Kitab remedies stay withheld until house-specific extraction, scan verification and independent review. No topic required.

Analyze natal, Dasha and transit activation together

Calculate a separated planetary strength profile

Calculate Bhinnashtakavarga and Sarvashtakavarga

Analyze one divisional chart

Analyze Yoga formation, strength and opposition

Calculate a declared Dasha system

Inspect Badhaka structure without supernatural claims

Analyze Arudha and Upapada structures

Audit reading prose against calculated placements and safety rules

Returns book-section locators and rule-review status without treating discovered prose as executable doctrine.

Compares engine, ruleset, input and conclusion status changes.

Evidence-linked analyze nakshatra profile without deterministic outcome claims.

Evidence-linked analyze marriage structure without deterministic outcome claims.

Evidence-linked analyze career structure without deterministic outcome claims.

Evidence-linked analyze education structure without deterministic outcome claims.

Evidence-linked analyze property and vehicle without deterministic outcome claims.

Evidence-linked analyze finance structure without deterministic outcome claims.

Evidence-linked analyze spiritual path without deterministic outcome claims.

Evidence-linked build claim evidence ledger without deterministic outcome claims.

Ranks a maximum seven-day range using Panchanga, prohibited intervals, Tara Bala and Chandra Bala. Medical procedures are unsupported.

Produces descriptive calibration from recorded claim outcomes; it never presents the result as scientific validation.

EXPERT FULL-REPORT TOOL — prefer consult_jyotishya (brief dossier + profileRef) for normal questions; use get_full_life_report_section for one section at a time. Builds a complete South Indian astrology report covering all major life areas, domain-specific timing outlooks, measured strengths, Vargas, structural Yogas, current Dasha and upcoming Antardashas. Timing activation identifies an area, ne

EXPERT FULL-REPORT ALIAS — prefer consult_jyotishya for normal questions. One-call alias for the complete evidence-linked life report. Returns enriched placements, strengths, Vargas, synthesis, current Dasha, and a configurable future transit-and-Dasha horizon for narration clients.

Returns one bounded section of the full report for MCP clients with limited context windows.

EXPERT FULL-MATRIX TOOL — prefer consult_jyotishya or get_compact_chart_evidence for normal questions. Deterministically calculates sidereal placements, all 16 Parashari vargas, Panchanga, Vimshottari timing, layered evidence and uncertainty from explicit birth data. Placement sign is a zero-based 0-11 index and signName is the display-safe name.

Returns the calculation boundary, accuracy status, interpretive safety contract and production validation requirements.

Calculates deterministic transit placements for an explicit instant and maps them to whole-sign houses from a supplied natal Lagna.

Resolves a verified catalogue place and its IANA timezone before calculating sidereal transits, avoiding manual coordinate and offset entry.

Finds sign-boundary crossings for Sun through Saturn and the lunar nodes over an explicit future interval.

Samples the declared birth-time interval and reports Lagna, Moon-pada and Navamsa-Lagna boundary changes. This is not rectification.

Returns counts of sources, passages, approved rules and active reviewers. Draft material is never represented as expert knowledge.

Reports independent readiness gates for calculations, executable rules, worked examples, practitioner review and outcome calibration. It explicitly reports Lal Kitab as source-only until a dedicated reviewed engine exists.

Checks engine certification, timezone provenance, conventions and important sign/Nakshatra/Pada boundary distances before interpretation. It does not claim an external ephemeris recomputation.

Returns implemented rule claims and their passage, rule, reviewer, contradiction, and publication state. Unlinked or draft claims are never represented as citations.

Returns passage-level citations only when the linked rule satisfies the two-reviewer publication gate and has no blocking review. Unresolved keys are returned separately.

Returns the frozen blind-validation protocol, cohort-size gates, anti-leakage rules, and the honest current calibration state. It never treats a known single case as validation.

Returns the active Mahadasha, Antardasha and Pratyantardasha with exact boundaries for one ISO date. Optimized for AI clients that do not need the full 120-year timeline.

Returns a stable, compact, deterministic evidence object for narration agents. It omits bulky timelines and contribution matrices while retaining calculation version, confidence, placements, focus, and safety boundaries.

For one date, returns active Vimshottari periods plus Saturn, Jupiter and node transit houses from natal Moon and Lagna. Sade Sati and Dhaiya are labelled structural periods, not guaranteed outcomes.

Returns exact Saturn, Jupiter, Rahu and Ketu sidereal sign periods, Saturn Sade Sati/Dhaiya structural ranges, and Vimshottari intersections over a selected future interval.

Finds overlaps between Jupiter transiting the natal seventh sign and Venus or seventh-lord Vimshottari periods. Returns planning windows, never a guaranteed marriage prediction.

Returns separate North Indian Ashtakoota and South Indian ten-Porutham compatibility, Kuja evidence, compact summaries for both charts, and structural marriage-planning windows for each person in one call.

Renders a deterministic South Indian chart as inline SVG, including retrograde, combustion, and dignity flags.

Generates the full reading context as a server-side PDF and returns a hosted URL valid for 30 days.

Casts a server-time horary chart, checks chart fitness, and returns an auditable structural judgment plus outcome-confirmation hook.

Closes the Prashna feedback loop using the private confirmation token returned by calculate_prashna. The token is hashed at rest and is distinct from the consultation ID.

Returns Vimsopaka and Ishta/Kashta evidence, topic-specific cross-Varga synthesis, special Lagnas, expanded Yoga candidates and additional-Dasha status.

Applies natal promise as a hard gate and returns uncalibrated, auditable timing windows with learnable factor weights.

Scores candidate birth times against life events and validates with a held-out event. Never claims an exact recovered minute.

Returns only publication-gated rules and rights-safe source metadata. Drafts and open contradictions are excluded.

Searches passage metadata and returns text only when display rights permit it. Results never become executable rules automatically.

Compares explicitly supplied tradition ledgers while preserving separate methods, evidence, contradictions and readiness states.

Applies calculation, approved-rule, opposition, calibration and harm gates and returns publish, caution or claim-level abstain, plus narration instructions. Sensitive topics remain answerable with bounded reflections and practical suggestions.

Stores one atomic claim and a consent-scoped outcome for descriptive validation without training on narration.

Reports coverage and validation gates without converting descriptive counts into scientific or predictive validity.

Reviewer-only mutation recording convention version, scan verification, sensitive class, remedy burden and decision.