Skip to content
docs
UseBuildChangelog
Open Lumin
All tools

Advanced techniques

Horary Validation Panel

get_horary_validation_panel

Horary validation panel (renamed from get_horary_advanced on 2026-10-08), on TWO charts: the natal chart from the birth data, and a horary chart cast at the moment of the question ('judgement_datetime', default now, at the birth place unless 'judgement_latitude'/'judgement_longitude' are given, with 'judgement_utc_offset_minutes' or 'judgement_time_zone') with the Ascendant FIXED by the number at the commencement of its sub and the other cusps from the latitude of judgement (KP Reader 6). Returns '{ numberIntuition, crossValidation, summary, horaryAscendant, horaryMoment, deprecatedInput, rulingPlanetsVariants, methodSeams }'; 'deprecatedInput' names any old field name the call used and the field to send instead. 'numberIntuition' checks whether that sub lord signifies the query houses (self-confirmatory vs weakly chosen); 'crossValidation' compares fruitful significators between the two charts (divergence suggests checking the birth time). 'horaryAscendant' and 'horaryMoment' let the cast be checked. The two are different claims, one about the question and one about the birth chart, and each has its own tool (get_horary_number_intuition, get_horary_natal_crosscheck), named in 'methodSeams'; both blocks still ship here. Both thresholds (0.67 for the number, 0.75 / 0.5 / 0.25 for convergence) are unsourced Lumin conventions and say so in 'scoreProvenance'. Also returns 'rulingPlanetsVariants' (F185): [KP] KSK's ruling planets from the Ascendant rising at the moment of judgement (Reader 6 canon p.211), the set this tool reads, beside [KP-extended] Prabhakar c.2006's from the number's sign and star lords, reported only; the same block 'get_horary_ruling_planets_variants' returns given the same judgement_datetime.

Parameters

NameTypeRequiredDescription
birth_datetimestringYesBirth date and time in ISO 8601 format (e.g., "1990-05-15T14:30:00").
latitudenumberYesBirth location latitude. Range: -90 to 90.
longitudenumberYesBirth location longitude. Range: -180 to 180.
utc_offset_minutesnumberYesUTC offset in minutes (e.g., 330 for IST, -300 for EST).
ayanamsaenum: kp | kp_new | lahiri | raman | true_chitra | khullarNoAyanamsa system. Defaults to kp.
target_numbernumberYesKP horary question number
judgement_datetimestringNoThe moment the question is judged, as the local wall clock at the place of judgement, ISO 8601 with no zone suffix (e.g. 2026-10-20T10:30:00). Defaults to now, and the result's horaryMoment says so.
judgement_latitudenumberNoLatitude of the place where the question is judged, north positive.
judgement_longitudenumberNoLongitude of the place where the question is judged, east positive.
judgement_utc_offset_minutesnumberNoUTC offset in force at the place of judgement at that moment, in minutes east of UTC (e.g. 330 for India, -240 for New York in summer). Prefer judgement_time_zone, which works it out; if both are given they must agree.
judgement_time_zonestringNoIANA time zone of the place of judgement (e.g. "Asia/Colombo", "America/New_York"). The offset in force there at judgement_datetime is read from the tz database, daylight saving and past changes included.
query_datetimestringNoDeprecated, use judgement_datetime.
query_latitudenumberNoDeprecated, use judgement_latitude.
query_longitudenumberNoDeprecated, use judgement_longitude.
query_utc_offset_minutesnumberNoDeprecated, use judgement_utc_offset_minutes or judgement_time_zone.
query_eventstringYesThe event or question being queried. Use a short keyword or phrase (e.g., 'Marriage', 'Job offer', 'Foreign travel', 'Health recovery', 'Property purchase', 'Exam result').

Example call

Send the request as a standard MCP tools/call:

http
POST https://mcp.lumin.guru/mcp
Authorization: Bearer mcp_yourkey...
Accept: application/json, text/event-stream
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_horary_validation_panel",
    "arguments": {
      "birth_datetime": "1992-08-14T04:32:00",
      "latitude": 6.927,
      "longitude": 79.861,
      "utc_offset_minutes": 330,
      "ayanamsa": "kp",
      "target_number": 137,
      "query_event": "..."
    }
  }
}

Birth data

This tool requires birth data on every call. The MCP server is stateless, so calling set_birth_profile first validates the data and returns the reading plan, but it does not store anything. Repeat the same five fields here.