explore_transit_timeline
Generate an interactive transit timeline of upcoming transits to your natal points, grouped by month with exact dates, aspects, and retrograde markers. Click any transit for a focused interpretation.
Instructions
Generate an interactive Transit Timeline — a vertical, date-ordered list of upcoming transit hits (transiting planets forming a chosen aspect to natal chart positions) over a date range.
Returns a visual timeline with: • Exact crossing dates grouped by month • Transiting planet glyph, the natal point it contacts, and the aspect • Zodiac position of each crossing and retrograde markers • Click any transit for a focused interpretation
ASPECT ANGLES: 0 = conjunction/return (default), 180 = opposition, 90 = square, 120 = trine, 60 = sextile. EFFICIENCY: specify transiting_planets and natal_points to keep compute fast. DEFAULT natal_points: sun, moon, mercury, venus, mars, jupiter, saturn. SEARCH RANGE LIMITS: Explorer/PayG → 1 year; Pro → 5 years; Startup → 10 years.
CREDIT COST: 6 credits per call (natal chart + predictive transit search).
Use this for a rich, interactive transit-forecast experience in MCP Apps-capable hosts (Claude Desktop). Falls back to a text summary in other hosts.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end_date | Yes | End of the transit search window. ISO 8601 date or zoned datetime; a naive clock time is rejected. Date-only resolves to 12:00 UTC. | |
| start_date | Yes | Start of the transit search window. ISO 8601 date or zoned datetime; a naive clock time is rejected. Date-only resolves to 12:00 UTC. | |
| aspect_angle | No | Aspect angle in degrees. 0 = conjunction/return (default), 180 = opposition, 90 = square, 120 = trine, 60 = sextile. | |
| natal_points | No | Natal point IDs to target, e.g. ['sun','moon','asc','mc','saturn']. Omit for the 7 classical bodies. | |
| natal_datetime | Yes | ISO 8601 datetime; zone required — a `Z`/±HH:MM suffix or the `timezone` argument. Date-only resolves to 12:00 UTC. Full rule: server `instructions`. | |
| natal_latitude | Yes | Latitude of birth location in decimal degrees. Resolve from a place name with location_search; never recall coordinates from memory. | |
| natal_timezone | No | IANA timezone for the natal birth location (e.g. `America/Chicago`); required when the datetime is naive. | |
| natal_longitude | Yes | Longitude of birth location in decimal degrees. | |
| transiting_planets | No | Transiting planet IDs to search, e.g. ['saturn','jupiter','uranus','pluto','chiron']. Omit to search all outer planets. |