Transit and timing

Transit Crossings

get_transit_crossings

All KP sub-lord boundary crossings for the requested planets within a date window (max 366 days). Uses 1-hour coarse scan + binary-search refinement to minute precision. Returns '{ crossings: [{ planet, crossingTimeUTC, fromKP, toKP, fromSubLord, toSubLord, isNakshatraChange, isSignChange }], totalCrossings, planetsSearched, pagination, pageNote }'. **Paged.** A year-long scan of all 9 planets runs to hundreds of crossings, so they come back a page at a time; read 'pageNote' and call again with 'page' incremented until it says it is the last page. Narrowing 'planets' or the date window is usually better than paging through everything.

Parameters

Example call

Send the request as a standard MCP tools/call:

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_transit_crossings",
    "arguments": {
      "startDatetime": "...",
      "endDatetime": "..."
    }
  }
}