Skip to content
docs
UseBuildChangelog
Open Lumin
All tools

Chart and reference

Birth Time Finder

find_birth_time

Find an UNKNOWN birth time using the KP Ruling Planets method. Scans all 1440 minutes of a birth date for candidate windows whose ascendant sign/star/sub-lords match the RPs at a query moment (typically when the querent asked the question). Optional validation against known life events. Returns '{ candidates: [{ time, ascSignLord, ascStarLord, ascSubLord, score, eventMatches }], bestCandidate }'. For *refining* an approximately-known time, use 'rectify_birth_time' instead.

Parameters

NameTypeRequiredDescription
birthDatestringYesBirth date in YYYY-MM-DD format
latitudenumberYesBirth location latitude
longitudenumberYesBirth location longitude
utcOffsetMinutesnumberYesUTC offset in minutes for birth location
queryDatetimestringNoISO datetime of the query moment (defaults to now)
queryLatitudenumberYesQuery location latitude
queryLongitudenumberYesQuery location longitude
queryUtcOffsetMinutesnumberNoUTC offset for query location
ayanamsaenum: kp | kp_new | lahiri | raman | …NoAyanamsa system (default: kp)
knownEventsarray<object>NoOptional known life events for validation

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": "find_birth_time",
    "arguments": {
      "birthDate": "...",
      "latitude": 0,
      "longitude": 0,
      "utcOffsetMinutes": 0,
      "queryLatitude": 0,
      "queryLongitude": 0
    }
  }
}