Advanced techniques
Shadbala (6-Fold Planetary Strength)
get_shadbala
Six-fold planetary strength per BPHS / KP Reader 3: Sthana (positional), Dig (directional), Kala (temporal day/night), Cheshta (motional), Naisargika (natural), Drik (aspectual). Each component is normalised to 0-100; total is the average. Returns ranked planets with strongest / weakest, relative-strength bands (STRONG ≥65, MODERATE 45-64, WEAK <45), and dominant component per planet. Use to weight any planetary signification by raw strength.
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 | lahiri | raman | true_chitra | No | Ayanamsa system. Defaults to kp. |
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": "get_shadbala",
"arguments": {
"birth_datetime": "1992-08-14T04:32:00",
"latitude": 6.927,
"longitude": 79.861,
"utc_offset_minutes": 330,
"ayanamsa": "kp"
}
}
}Engine endpoint
This tool delegates to the kp-engine endpoint:
POST /v1/kp/shadbalaThe engine is a private internal service. All public access flows through the MCP server, which handles auth, rate limiting, and response compaction.
Birth data
This tool requires birth data. If you have already called set_birth_profile in the same conversation, the MCP server injects those fields automatically and you can omit them from the call.