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

Name	Type	Required	Description
birthDate	string	Yes	Birth date in YYYY-MM-DD format
latitude	number	Yes	Birth location latitude
longitude	number	Yes	Birth location longitude
utcOffsetMinutes	number	Yes	UTC offset in minutes for birth location
queryDatetime	string	No	ISO datetime of the query moment (defaults to now)
queryLatitude	number	Yes	Query location latitude
queryLongitude	number	Yes	Query location longitude
queryUtcOffsetMinutes	number	No	UTC offset for query location
ayanamsa	enum: kp \| lahiri \| raman \| true_chitra \| …	No	Ayanamsa system (default: kp)
knownEvents	array<object>	Yes	Life event that occurred.

Example call

Send the request as a standard MCP tools/call:

http

POST https://mcp.lumin.guru/mcp
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,
      "knownEvents": []
    }
  }
}

Engine endpoint

This tool delegates to the kp-engine endpoint:

http

POST /v1/kp/birth-time-finder

The engine is a private internal service. All public access flows through the MCP server, which handles auth, rate limiting, and response compaction.