Find the Next Transit
next_transitSearch the sky, past or future, for when a gate is entered or an open center activated (Pro).
The only tool that answers "when" about gates: get_transits and get_person_transits read one moment and cannot see past it, so the Rave New Year comes from here.
Two searches, exactly one per call:
A gate:
gate, optionallylineandbody. Its next entry, a row per body.A center:
personanddefines. When a planet next completes one of their hanging gates into it, and which channel.
A return — Saturn, Solar, nodal, the Uranus opposition, the Kiron return — is get_cycles, not this.
Next, every, and a sweep. Without until a row is that body's FIRST
arrival and the walk runs decades. With until it is every arrival inside at
most a year — "in 2026", "how often this year". A sweep of past years is the
first shape: a call per gate, no body, chained from searched_until. Every
date is searched in the ephemeris; none follows from an age, a calendar or an
earlier row.
An empty answer means nothing arrives before searched_until, not that it
never does. A body already in the gate has not arrived in it; what is true now
is get_person_transits.
Times come back already in timezone, with the zone named.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "next_transit"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | No | One of the thirteen bodies — 'Sun', 'Moon', 'North Node' — to narrow either search to that body. | |
| gate | No | A gate, 1 to 64. The Rave New Year is the Sun entering gate 41. | |
| line | No | One of that gate's six lines, to narrow a `gate` search. Only with `gate`. | |
| after | No | Where the search starts: ISO 8601 local date-time ('2026-09-17T09:00') or date ('2026-09-17'), on the user's own clock — no offset, no time zone. Leave it out for now. A past date is valid and is how a historical question is answered; anything outside 1781 to 2053 is refused in words that name the range. | |
| until | No | Where a period ends, same clock as `after`; a bare date ('2026-12-31') covers the whole of that day. Turns the answer from each body's next arrival into every arrival in the window, with `counts` per body. At most a year after `after`. Leave it out for 'when next'. | |
| person | No | A saved person's full name exactly as saved, or 'me' for the account holder, with `defines`. Their birth time has to be exact. | |
| defines | No | The open center to search for the sky activating, with `person`. | |
| timezone | No | The user's IANA time zone, e.g. 'Europe/Amsterdam' — where they are NOW, not where they were born. Every time in the answer is printed in it, and a bare `after` or `until` is read on it. Pass it whenever you know the user's local time; you usually do, and we have no other way to find out. Left out, we fall back to the time zone of their birth place, which is wrong for anyone who has moved. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||