birth_chart
Use when you need the full natal chart for interpretation, comparison, or downstream transit/progression work.
Returns planets, houses, aspects, patterns, dignities, and Big Three.
`detail="compact"` drops the per-aspect details (keeps `aspects.summary`
counts) and per-pattern planet lists — saves ~15k tokens on a typical
chart, useful when you only need placements + angles.
Next step: if you need aspect-by-aspect narrative material, call with
`detail="full"`; for transits to this chart, call `current_transits` or
`transit_search` with the same birth data.
current_transits
Use when you want to know what the sky is doing to a natal chart right now (or at a specific date).
Default `mode="summary"` returns counts and the six strongest transits —
enough to answer "what's active?" in ~800 tokens. Call `mode="full"` only
when you need every active transit (≈15+ transits, ~4k tokens).
If transit_year/month/day are omitted, uses current UTC time.
transit_search
Use when you need to know which transits shape a period for a natal chart.
Returns aggregate counts by body and aspect type. Call with `mode="top"` to
also get the N strongest transits with enter/exact/leave-orb dates. Use
`mode="full"` only when you genuinely need every transit (multi-MB payloads
at ranges over a year — upstream may time out).
Next step after `mode="summary"`: pick interesting buckets from `by_body` /
`by_aspect`, then re-call with `mode="top"` for narrative material.
planetary_positions
Planetary positions for any date (defaults to now UTC).
Returns positions for Sun through Pluto plus Chiron and four major asteroids,
with longitude, sign, speed, and retrograde status.
progression_report
Secondary progressions + solar arc + progressed Moon report.
Shows how the natal chart evolves from birth to the target date.
get_sign
Return qualities, themes, shadow, crystals, and element for a zodiac sign.