Advanced techniques

Planetary Avasthas, all five families (BPHS ch. 45)

get_avasthas

Parashari, not KP. The five avastha families of Brihat Parashara Hora Shastra ch. 45, per planet, each with its verses: baladi (vv. 3-4: infant, youthful, adolescent, old, dead by six-degree bands, ascending in odd signs and reversed in even, graded one fourth / half / full / negligible / nil), jagradadi (vv. 5-6: awake, dreaming, asleep by dignity), deeptadi (vv. 7-10: nine states by dignity and relationship, every one that holds listed), lajjitadi (vv. 11-18: six states by placement, company and aspect, with v. 18's 'bhavaDestroyed' for Kshudhita and Kshobhita), and sayanadi (vv. 30-39: the twelve states by the stated formula, working shown). Every definition is at the SIGN level as the text states it: exaltation is the exaltation sign, conjunction the same sign, Drishti is graha drishti counted sign to sign, houses are whole sign; the moolatrikona ranges are ch. 3 vv. 51-54 and benefic/malefic follow ch. 34 vv. 8-10. The sayanadi SUB-STATE (Drishti/Cheshta/Vicheshta) needs the Anka value of the first syllable of the native's name, which no chart carries: pass 'name_anka' (1 to 5) to compute it, otherwise it is reported as not computable with the reason, never defaulted. The lajjitadi states read aspects, and whether Rahu and Ketu cast one is stated five ways (F175): they are computed with the nodes aspecting the 7th only (derived), and 'nodeDrishti.alternatives' lists each other reading with its class and the planets whose lajjitadi states it would change. Edition stated (Santhanam 1984). Gates no KP verdict.

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.
name_anka	unknown	No	Anka value of the first syllable of the native's personal name, per Santhanam's table (1: a ka cha da dha bha va; 2: i kha ja dha na ma sha; 3: u ga jha ta pa ya sa; 4: e gha ta tha pha ra sa; 5: o ca tha da ba la ha). Needed only for the sayanadi sub-state.

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_avasthas",
    "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.