Skip to content
docs
UseBuildChangelog
Open Lumin
All tools

Advanced techniques

Lost Article: Where It Is (KP horary)

get_lost_article_location

From the horary chart the question_number fixes, three coordinates of one place: the direction, from the sign of a planet in a kendra (the 1st first, then 4th, 7th, 10th) or else the lagna sign (KP Reader 6 pages 51 and 64); the distance class, from the house of the sub lord of the first 7th-house significator (page 237: kendra same place, 3rd near, 9th far, 12th abroad, otherwise moderate); and the spot on the premises, from the lagna's drekkana (page 64, Sloka 2: gate, middle, rear). Returns '{ horaryAscendant, queryType, questionNumber, direction: { direction, sourceRule, indicatorPlanet, indicatorSign, rationale }, distance: { distanceClass, seventhSignificator, seventhSigInSubOf, seventhSigSubLordHouse, rationale }, inHouseLocation: { drekkana, location, rationale }, bookCitations, disclaimer }'. 'horaryAscendant', 'queryType' and 'questionNumber' echo the cast it read. The same fields 'get_lost_or_missing' returns as 'direction', 'distance' and 'inHouseLocation'. An aid to a search, not an investigative fact. The chart is cast at the moment and place the question is judged: send 'judgement_datetime' (the local wall clock there), 'judgement_latitude', 'judgement_longitude', and 'judgement_utc_offset_minutes' or 'judgement_time_zone'. This tool needs no birth data. The result echoes 'horaryMoment' ('instant', 'local', 'place', 'source', 'utcOffsetSource') and 'deprecatedInput', which names any old field name the call used and the field to send instead.

Parameters

NameTypeRequiredDescription
ayanamsaenum: kp | kp_new | lahiri | raman | true_chitra | khullarNoAyanamsa system. Defaults to kp.
birth_datetimestringNoDeprecated, use judgement_datetime. For this one release, a call with no judgement_* field is cast at this date and time and the place below, and the result's deprecatedInput says so.
latitudenumberNoDeprecated, use judgement_latitude.
longitudenumberNoDeprecated, use judgement_longitude.
utc_offset_minutesnumberNoDeprecated, use judgement_utc_offset_minutes or judgement_time_zone.
time_zonestringNoDeprecated, use judgement_time_zone.
judgement_datetimestringNoThe moment the question is judged, as the local wall clock at the place of judgement, ISO 8601 with no zone suffix (e.g. 2026-10-20T10:30:00). Send it on every call; the result's horaryMoment echoes it.
judgement_latitudenumberNoLatitude of the place where the question is judged, north positive.
judgement_longitudenumberNoLongitude of the place where the question is judged, east positive.
judgement_utc_offset_minutesnumberNoUTC offset in force at the place of judgement at that moment, in minutes east of UTC (e.g. 330 for India, -240 for New York in summer). Prefer judgement_time_zone, which works it out; if both are given they must agree.
judgement_time_zonestringNoIANA time zone of the place of judgement (e.g. "Asia/Colombo", "America/New_York"). The offset in force there at judgement_datetime is read from the tz database, daylight saving and past changes included.
question_numbernumberYesQuerent's KP question number (1-249)
query_typeenum: theft | lost | missing_personNoType of horary query

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_lost_article_location",
    "arguments": {
      "judgement_datetime": "2026-10-20T10:30:00",
      "judgement_latitude": 6.927,
      "judgement_longitude": 79.861,
      "judgement_time_zone": "Asia/Colombo",
      "question_number": 0
    }
  }
}