Skip to content
Lumindocs
UseBuildChangelog
Open Lumin
All tools

Advanced techniques

Relocation Chart (Astrocartography Lens)

get_relocation_chart

Recomputes lagna and house cusps for an alternate latitude/longitude at the original birth datetime. Planets do not move (geocentric positions unchanged) but house assignments shift. Use for 'where should I move/work?' analysis, strong NRI / immigration-consultant appeal. Returns the relocated ascendant, all 12 cusps, and per-planet house-shift between natal and relocated charts.

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 | lahiri | raman | true_chitraNoAyanamsa system. Defaults to kp.
relocated_latitudenumberYesLatitude of the alternate location.
relocated_longitudenumberYesLongitude of the alternate location.

Example call

Send the request as a standard MCP tools/call:

http
POST https://mcp.lumin.guru/mcp
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_relocation_chart",
    "arguments": {
      "birth_datetime": "1992-08-14T04:32:00",
      "latitude": 6.927,
      "longitude": 79.861,
      "utc_offset_minutes": 330,
      "ayanamsa": "kp",
      "relocated_latitude": 0,
      "relocated_longitude": 0
    }
  }
}

Engine endpoint

This tool delegates to the kp-engine endpoint:

http
POST /v1/kp/relocation

The engine is a private internal service. All public access flows through the MCP server, which handles auth, rate limiting, and response compaction.

Birth data

This tool requires birth data. If you have already called set_birth_profile in the same conversation, the MCP server injects those fields automatically and you can omit them from the call.