Advanced techniques

Argala, intervention from planets (BPHS ch. 31, the Parashari form)

get_argala

Parashari, not KP, and the BPHS form only: whether Jaimini judges a matter BY argala is Q032's question and is not answered here. From Brihat Parashara Hora Shastra ch. 31 vv. 2-18: planets in the 2nd, 4th, 11th (and 5th) from a reference cause argala, planets in the 12th, 10th, 3rd (and 9th) obstruct it, counted from the reference per Santhanam's note; argala prevails when the causing planets outnumber the obstructors; the grade is one planet limited, two medium, more than two excellent; three or more malefics in the 3rd are vipreet argala, 'harmless and very favourable'. The reference is the lagna by default, or any bhava ('reference_house', whole sign from the lagna) or planet ('reference_planet'). Two lines the text leaves open are REPORTED BOTH WAYS rather than picked: the v. 10 quarter rule (obstruction only when the two planets sit in matching quarters, 1st with 4th, 2nd with 3rd, which much software ignores) gives the primary 'verdict', with 'verdictByHouseAlone' beside it; and the ambiguous node reversal ('counted accordingly in a reverse manner') is applied in the common reading with 'withoutNodeReversal' beside it. What is NOT applied is named: the strength branch ('if the Argala causing Grah is stronger'), because no sourced Parashari strength exists in the engine (F047), so equal counts are returned as undecided; and the dasha timing. Subha, papa or mixed argala by ch. 34 vv. 8-10. Edition stated (Santhanam 1984; ch. 32 in Sharma). 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.
reference_house	unknown	No	The bhava to count argala from, whole sign from the lagna. Default 1, the lagna. Not with reference_planet.
reference_planet	unknown	No	A planet to count argala from, using its sign as the reference. Not with reference_house.

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