All tools
Advanced techniques
Tara Bala (9-fold from Janma Nakshatra)
get_tara_bala
9-fold Tara from natal Moon's nakshatra at any moment: Janma (neutral), Sampat (auspicious), Vipat (avoid), Kshema (auspicious), Pratyari (avoid), Sadhaka (auspicious), Vadha (strongly avoid), Mitra (auspicious), Atimitra (strongly auspicious). Use for 'is today auspicious for X?' daily checks and as a muhurta companion. Books: KP Reader 5 muhurta canon.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| birth_datetime | string | Yes | Birth date and time in ISO 8601 format (e.g., "1990-05-15T14:30:00"). |
| latitude | number | Yes | Birth location latitude. Range: -90 to 90. |
| longitude | number | Yes | Birth location longitude. Range: -180 to 180. |
| utc_offset_minutes | number | Yes | UTC offset in minutes (e.g., 330 for IST, -300 for EST). |
| ayanamsa | enum: kp | kp_new | lahiri | raman | true_chitra | khullar | No | Ayanamsa system. Defaults to kp. |
| query_date | string | No | ISO date to evaluate (default: now). |
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": "get_tara_bala",
"arguments": {
"birth_datetime": "1992-08-14T04:32:00",
"latitude": 6.927,
"longitude": 79.861,
"utc_offset_minutes": 330,
"ayanamsa": "kp"
}
}
}Birth data
This tool requires birth data on every call. The MCP server is stateless, so calling set_birth_profile first validates the data and returns the reading plan, but it does not store anything. Repeat the same five fields here.