Skip to content
docs
UseBuildChangelog
Open Lumin
All tools

Advanced techniques

Advanced Muhurta Timing

get_muhurta_advanced

KP auspicious moment triangulation (T40), the older three-condition test kept alongside the four-layer election. Walks exact Moon sub and Ascendant sub boundaries for windows where (1) the Lagna sub lord signifies the event houses, and additionally reports whether the Ascendant's sign, star AND sub lords all agree, (2) the Moon's star lord is a fruitful significator, (3) the Day Lord is a fruitful significator. 3 of 3 is fully auspicious, 2 of 3 workable. Returns moments with 'datetime', 'datetimeEnd', 'durationMinutes', 'lagnaFullAgreement', and a 'scanSummary' carrying 'momentsFound' versus 'momentsReturned'. For a full election prefer 'find_election_window', which applies the dasha layer and carries provenance for the house group.

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.
eventstringNoEvent to find muhurta for. Default Marriage.
scan_startstringNoScan start date, ISO 8601. Default now.
scan_daysnumberNoDays to scan. Default 7, maximum 30.
event_latitudenumberNoLatitude of where the event happens. Defaults to the birth latitude.
event_longitudenumberNoLongitude of where the event happens. Defaults to the birth longitude.
event_utc_offset_minutesnumberNoUTC offset at the event location, in minutes. Defaults to the birth offset.

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_muhurta_advanced",
    "arguments": {
      "birth_datetime": "1992-08-14T04:32:00",
      "latitude": 6.927,
      "longitude": 79.861,
      "utc_offset_minutes": 330,
      "ayanamsa": "kp"
    }
  }
}

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.