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
| 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 | kp_new | lahiri | raman | … | No | Ayanamsa system (default: kp) |
| knownEvents | array<object> | No | Optional 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
}
}
}