Skip to content
Lumindocs
UseBuild
Open Lumin

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

Event timing

5 tools

Transit and timing

5 tools

Specialized analysis

6 tools

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

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.