Reference
All MCP tools
Lumin exposes 49 engine-backed tools through the MCP protocol, plus a meta-tool set_birth_profile that holds birth data in conversation context.
Generated from kp-mcp/src/mcp/tools.ts on 2026-04-25.
Core analysis
4 tools
Full KP Birth Chart
get_full_chart
Get a complete KP chart with planets, houses, dasha, significators, and ruling planets. Use for general readings or when you need an overview.
Natal Promise Analysis
analyze_natal_promise
Analyzes Cuspal Sub Lords (CSL) to determine if specific life events are promised. Returns verdicts for 25 life events (marriage, career, children, travel, health, etc.). Call this first for event-related questions.
Vimshottari Dasha Periods
get_dasha_periods
Get Vimshottari dasha periods (mahadasha, antardasha, pratyantardasha). Shows current running period and upcoming periods.
Significator Matrix
get_significators
Get the KP 4-level significator matrix (L1-L4) for all 12 houses. Shows which planets activate which houses.
Event timing
5 tools
Current Ruling Planets
get_ruling_planets
Get the 5 ruling planets at the current moment for timing verification. If ruling planets overlap with event significators, the timing is confirmed.
Muhurta Timing
find_auspicious_time
Find auspicious timing (muhurta) for events like marriage, business start, travel. Scans for favorable planetary activations.
Annual Forecast
get_annual_forecast
Generate a 12-month forecast with month-by-month predictions. Shows dasha periods, activated houses, themes, and overall tone for each month.
Event Timing (v2)
find_event_timing_v2
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.
Horary Chart (v2)
get_horary_chart_v2
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.
Transit and timing
5 tools
Transit Snapshot
get_transit_analysis
Snapshot transit analysis at a single moment. For precise KP event timing (year/month/day narrowing), use get_transit_timing_hierarchy instead. This tool checks 4 transit rules at one point in time.
Moon Transit
get_moon_transit
Current Moon's sign, star lord, sub lord, and time remaining in current sub. Moon sub changes every 2-3 hours.
Sub-Lord Changes
get_sublord_changes
Find when each planet's KP sub-lord will change next. Returns hours until change for all 9 planets.
Transit Crossings
get_transit_crossings
Find all KP sublord boundary crossings for planets in a date range. Shows exact times when planets change sub-lords.
Ruling Planet Intervals
get_rp_interval
Compute ruling planets at regular time intervals (e.g., every hour for 24 hours). Use to find windows when cosmic alignment supports a specific event.
Specialized analysis
6 tools
Dosha Detection
check_doshas
Detect doshas (afflictions): Manglik Dosha, Kalsarpa Dosha, Sadhesati, Pitra Dosha, Kemadruma Dosha. Returns severity, cancellations, and remedies.
Yoga Detection
detect_yogas
Detect planetary yogas (special combinations): Raja Yoga, Dhana Yoga, Gajakesari, Budh-Aditya, Pancha Mahapurusha, Lakshmi, Saraswati, etc.
Compatibility Analysis
check_compatibility
KP-based compatibility analysis between two birth charts. Scores 7 factors including Moon compatibility, Venus-Mars attraction, Jupiter harmony, and sub-lord matching.
Career Indicators
get_profession_indicators
Career analysis: business vs employment scoring, profession indicators from 10th house CSL, and ruling planet applications.
Birth Time Rectification
rectify_birth_time
Refine birth time by testing +/-30 minutes against known life events. Requires at least 1 known event with date and relevant houses.
Daily Panchang
get_panchang
Get daily Panchang: Tithi, Nakshatra, Yoga, Karana, Rahu Kaal, sunrise/sunset. Pass the date you want Panchang for (e.g., today's date), not the person's birth date.
Chart and reference
13 tools
Planetary Positions
get_planets
Get planetary positions (sidereal longitude), retrograde status, combustion, and dignities for all 9 KP planets.
House Cusps
get_house_cusps
Get Placidus house cusp positions with sign/star/sub lords for all 12 houses.
Navamsa Chart (D9)
get_d9_chart
[Non-KP reference tool] Parashari/Vedic Navamsa (D9) chart. KP methodology uses CSL analysis (analyze_natal_promise) for marriage assessment, not Navamsa. Provided for cross-system reference only. Shows D9 ascendant, planet placements, dignity, and vargottama status.
Dasamsa Chart (D10)
get_d10_chart
[Non-KP reference tool] Parashari/Vedic Dasamsa (D10) chart. KP methodology uses 10th house CSL and significators (get_profession_indicators) for career analysis, not Dasamsa. Provided for cross-system reference only. Shows D10 placements, 10th house lord, and career indicators.
Nakshatra Details
get_nakshatra_details
Get Nakshatra pada (1-4), Navamsa signs, and planet friendship tables for all bodies.
Aspects & Strength
get_aspects_and_strength
Get planetary aspects, 5-factor house strength scores (0-100), and deep retrograde analysis.
Ashtakavarga Table
get_ashtakavarga
Get Sarvashtakavarga and Bhinnashtakavarga bindu tables. Shows strength of each planet in each sign.
Current Dasha Analysis
get_smart_current_dasha
Get the current running dasha (MD/AD/PD) annotated with house significations, active themes, and which life events are currently activated with percentage scores.
Event Dasha Periods
get_event_dasha
Find which dasha periods activate a specific life event. Returns only periods where MD+AD lords signify the required houses, ranked by coverage.
Annotated Dasha Timeline
get_annotated_dasha
Full dasha timeline annotated with house significations and event potential for each period. Shows which mahadasha activates which life events.
Full Dasha Calendar
get_antardasha_calendar
Full 120-year Vimshottari dasha calendar with all sub-periods. Use for comprehensive timeline needs.
Monthly Ephemeris
get_ephemeris
Daily sidereal positions for all 9 planets across a month. Useful for transit planning.
Birth Time Finder
find_birth_time
Find unknown birth time using KP ruling planets method. Scans all 1440 minutes of a birth date to find candidate windows matching the ruling planets at the query moment.
Methodology v2
2 tools
Fruitful Significators
get_fruitful_significators
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.
Transit Timing Hierarchy
get_transit_timing_hierarchy
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 techniques
14 tools
Advanced CSL Analysis
get_csl_advanced
Advanced CSL analysis: multi-cusp convergence (all related cusps checked independently), cuspal interlink event scoring, 6-level sublord constellation mapping (sign→star→sub→sub's sign→sub's star→sub's sub), and cusp degree sensitivity detection (boundary conditions within 10 arc-minutes). Essential for thorough promise analysis.
Advanced Retrograde Analysis
get_retrograde_advanced
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
get_dasha_advanced
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
get_transit_advanced
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 Planets
get_rp_advanced
Advanced Ruling Planet analysis: RP strength hierarchy (weighted scoring: Lagna Star Lord=5, Moon Star Lord=4, Lagna Sign Lord=3, Moon Sign Lord=2, Day Lord=1) and RP-Dasha synchronization check (verifies if predicted dasha lords appear in current RPs as FULLY, PARTIALLY, or NOT synchronized).
Advanced Horary Analysis
get_horary_advanced
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).
Medical Timing Analysis
get_medical_timing
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).
Financial Analysis
get_financial_analysis
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).
Foreign Settlement Analysis
get_foreign_settlement
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.
Advanced Marriage Analysis
get_marriage_advanced
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.
Advanced Career Analysis
get_career_advanced
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.
Legal & Litigation Analysis
get_legal_analysis
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).
Advanced Muhurta Timing
get_muhurta_advanced
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 Rectification
get_rectification_advanced
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.