Advanced techniques

Ishta Devata, Personal Deity [Jaimini]

get_ishta_devata

[Jaimini adjunct] Personal deity from the 12th house from Karakamsa (Atmakaraka in D9), read in the order the sources give: a planet in it; failing that, planets aspecting it by rashi drishti; failing that, its lord (Rath; A22). Several planets at a step are all returned as 'candidates', ranked by Rath's ladder (exalted, own sign, then highest longitude), with 'significatorStep' and 'rankingRule' saying how. The Karakamsa read in the rasi chart ships as 'karakamsaInRasi', and the eight-karaka Atmakaraka's reading as 'byOtherScheme' when it differs. Deity mapping (tradition): Sun→Shiva, Moon→Parvati/Gauri, Mars→Kartikeya, Mercury→Vishnu, Jupiter→Narayana, Venus→Lakshmi, Saturn→Hanuman/Brahma, Rahu→Durga, Ketu→Ganesha. The 'mantra' string is unsourced and labelled so in 'sources.mantra'. B2B fit for spiritual / wellness apps.

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.

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