Skip to content
Lumindocs
UseBuild
Open Lumin
All tools

Chart and reference

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.

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 | lahiri | raman | true_chitraNoAyanamsa system (default: kp)
knownEventsarray<object>YesLife event that occurred.

Example call

Send the request as a standard MCP tools/call:

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:

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.