Skip to content
docs
UseBuildChangelog
Open Lumin
All tools

Advanced techniques

Foreign Job and Posting (KP, distinct from foreign settlement)

get_foreign_job_verdict

Working abroad, which get_foreign_settlement structurally cannot answer: its three stages are 3/12, 9/12 and 4/12 with no 6th or 10th house anywhere, so it reads settlement and never employment. KP Reader 3 p.330 states it plainly, stay in a foreign country is judged from the 12th, for further studies the 9th, and for a job 6 and 10 also. Promise gate, R3 p.327: the 12th CSL must signify 3, 9 or 12, and the event runs in the conjoined periods of those significators. The 6th-house term is what separates a posting from a settlement (Part 3 p.061 and R6 p.311, both independently: a 12th CSL signifying 3/9/12 AND a strong significator of the 6th gives a foreign assignment). R3 p.334's one-minute denial applies when the 12th CSL falls in the 8th bhava, the 12th from the 9th, which denies overseas entirely. 'mode' splits PAID_ABROAD, OWN_BUSINESS_ABROAD (the 6th against the 7th abroad, Part 1 pp.132-134), PROBATION (9 + 12) and PROMOTION_POSTING (11 with 6 or 10, R6 p.332), STUDY_ONLY and bare travel, each with the candidates that lost so the caller can see the margin. Also returns the abroad income gate on 2/6/11 and a permanent-residence read on 1/3/9/10/12 (Part 1 p.215). Not immigration, visa or relocation advice: verify every requirement with the relevant authority.

Parameters

NameTypeRequiredDescription
birth_datetimestringYesBirth date and time in ISO 8601 format (e.g., "1990-05-15T14:30:00").
latitudenumberYesBirth location latitude. Range: -90 to 90.
longitudenumberYesBirth location longitude. Range: -180 to 180.
utc_offset_minutesnumberYesUTC offset in minutes (e.g., 330 for IST, -300 for EST).
ayanamsaenum: kp | kp_new | lahiri | raman | true_chitra | khullarNoAyanamsa system. Defaults to kp.
horizon_yearsnumberNoYears ahead to scan (default 12, clamped 1-30)

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