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
| 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:
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-finderThe engine is a private internal service. All public access flows through the MCP server, which handles auth, rate limiting, and response compaction.