Generate an interactive natal chart wheel with clickable planets, houses, and aspects. Returns an embedded visual chart explorer that lets you click any planet, house, or aspect line for instant astrological interpretation. Supports house system switching (Placidus, Whole Sign, Equal, Koch). The chart is computed using NASA JPL DE440 ephemerides for sub-arcsecond precision. Use this instead of ephemeris_chart_wheel for a richer, interactive experience in MCP Apps-capable hosts (Claude Desktop). Falls back to static SVG in other hosts.

Event handler called when the user clicks a planet in the interactive chart wheel. Provides rich contextual interpretation of the planet's placement — sign, house, aspects, dignity, and what it means for the native. This tool is called automatically by the chart UI; you do not need to call it directly.

Event handler called when the user clicks a house cusp or house number in the chart wheel. Returns the astrological meaning of that house — life area, themes, and the influence of its ruling sign and planet. This tool is called automatically by the chart UI; you do not need to call it directly.

Event handler called when the user clicks an aspect line between planets in the chart wheel. Returns the astrological interpretation of that aspect — its nature, energy, challenges, and integration advice. This tool is called automatically by the chart UI; you do not need to call it directly.

Recalculates the natal chart using a different house system. Called automatically by the chart wheel UI when the user switches house systems. Returns updated chart data including new house cusps and planet house assignments.

Start the device authorization flow to connect this MCP server to your OpenEphemeris account. Returns a verification URL and code for the user to enter in their browser. The MCP server will then automatically receive credentials and all API calls will be linked to the user's account (tier, credits, rate limits). Only needed if no OPENEPHEMERIS_API_KEY env var is set and no cached credentials exist.

Check the current authentication status of this MCP server. Shows whether the server is authenticated, which account it's linked to, the authentication method (API key, JWT, device auth), and token expiry.

Disconnect this MCP server from your OpenEphemeris account by clearing cached credentials. Does NOT revoke the API key if one is set via environment variable — only clears device-auth cached credentials.

Call any allowlisted Open Ephemeris API endpoint directly. This is the power-user escape hatch — use the typed tools (ephemeris_natal_chart, ephemeris_transits, etc.) first for common operations. Call dev_list_allowed to see all currently available endpoint paths.

AUTH: Set OPENEPHEMERIS_API_KEY in your environment. See openephemeris.com/dashboard for active plan limits.

CREDIT COSTS: • Standard chart math (natal, progressed, bazi, vedic, iching): 1 credit • Human Design: 2 credits • Visualization rendering (chart-wheel, bi-wheel, charts/*): 2 credits • Comparative math (synastry, composite, overlay): 3 credits • Predictive ops (transits/search, returns): 5 credits • Predictive transit-chart: 1 credit • ACG / astrocartography: 10 credits (acg/hits: 15 credits) • Calendar endpoints: 10 credits • Catalog / metadata / health endpoints: 0 credits • Compute surcharge: requests > 30s add 1 credit per 30s (predictive, acg, calendar, electional) • format=llm (token-optimized output): available on all tiers

COMMON CALLS: POST /ephemeris/natal-chart — Full natal chart (body: {subject: {name: 'Name', birth_datetime: {iso: '1990-04-15T14:30:00-05:00'}, birth_location: {latitude: {decimal: 40.0}, longitude: {decimal: -70.0}, timezone: {}}}}) POST /ephemeris/natal/batch — Up to 50 natal charts in one request POST /ephemeris/relocation — Relocated chart (same natal, new location) POST /predictive/transits/search — Transit event search over a date range POST /predictive/returns/solar — Solar return chart POST /predictive/returns/lunar — Lunar return chart POST /comparative/synastry — Two-person synastry chart POST /comparative/composite — Composite (midpoint) chart POST /human-design/chart — Full HD chart (body: {birth_datetime_utc: '1990-04-15T19:30:00Z'}) — lat/lon optional POST /time/julian-day — Convert date to JD (body: {year: 1987, month: 7, day: 15, hour: 14, minute: 1}) GET /ephemeris/moon/phase — Current/queried moon phase GET /ephemeris/moon/void-of-course — Next void-of-course period GET /ephemeris/agro/daily — Biodynamic farming day quality GET /ephemeris/agro/calendar — Multi-day biodynamic calendar GET /ephemeris/agro/void-of-course — Biodynamic VoC periods GET /eclipse/next-visible — Next eclipse visible from a location (query: lat, lon, type=solar|lunar) GET /eclipse/solar/global — Next global solar eclipse (query: date=YYYY-MM-DD) GET /eclipse/solar/local — Local solar eclipse (query: lat, lon) GET /tidal/forcing — Gravitational tidal forcing index POST /acg/power-lines — Astrocartography power lines (lat/lon GeoJSON) POST /acg/hits — ACG power at a specific location GET /calendar/astrology/moon-phases — Moon phase calendar for a date range GET /location/autocomplete — Geocode a place name (query: q=City Name) POST /timezone/lookup — Resolve timezone + UTC offset for a location POST /chinese/bazi — Chinese Ba Zi (Four Pillars) chart (body: {year, month, day, hour}) GET /chinese/zodiac — Chinese zodiac year element/animal POST /vedic/chart — Vedic (Jyotish) natal chart (body: {datetime_utc, latitude, longitude}) GET /catalogs/bodies — List all supported celestial bodies

BINARY RESPONSES: • Binary/image endpoints return {content_type, content_length, encoding, data_base64} so callers can decode bytes deterministically.

ECLIPSE NOTE: Eclipse endpoints accept format=llm via the query param like other endpoints.

format=llm NOTE: Add query: {format: 'llm'} to natal/synastry/composite/HD endpoints for compact columnar output optimized for LLM token budgets (availability depends on your current plan).

List all API operations (method + path) that this MCP instance is authorized to call. Returns endpoint entries grouped by method, plus the active deny rules. Use this to discover what's available before calling dev_call, or to verify an endpoint path. Typed shortcut tools (ephemeris_natal_chart, ephemeris_transits, etc.) cover the most common operations — check those first before reaching for dev_call.

Calculate a full natal (birth) chart for a person. Returns planetary positions, house cusps, aspects, and chart patterns. Use format='llm' for a compact, token-efficient output ideal for interpretation (available on all tiers). The result includes all major planets, Chiron and major asteroids like Ceres, angles (ASC/MC/DSC/IC), essential dignities, retrograde status, house system data, and major aspect grid. Asteroids are automatically included.

CREDIT COST: 1 credit per call.

EXAMPLE: Calculate the natal chart for someone born April 15, 1990 at 2:30 PM in Chicago: datetime='1990-04-15T14:30:00', latitude=41.8781, longitude=-87.6298

Search for astrological transit events affecting a natal chart over a date range. Returns a list of exact transit moments — when transiting planets form specified aspects to natal planet positions. Ideal for generating horoscope timelines, event forecasting, or finding optimal timing windows.

HOW IT WORKS: This tool first calculates the natal chart to extract your actual planetary ecliptic longitudes, then searches for transiting planets crossing those exact degrees.

ASPECT ANGLES: Use aspect_angle to search for specific aspects to natal positions: 0 = conjunction/return (default), 180 = opposition, 90 = square, 120 = trine. Example: Saturn Return → transiting_planets=['saturn'], natal_points=['saturn'], aspect_angle=0 Example: Uranus Opposition → transiting_planets=['uranus'], natal_points=['uranus'], aspect_angle=180 Example: Chiron Return → transiting_planets=['chiron'], natal_points=['chiron'], aspect_angle=0

SUPPORTED BODIES: Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, Chiron, Pholus, Ceres, Pallas, Juno, Vesta, MeanNode.

CREDIT COST: 6 credits per call (1 for natal + 5 for transit search). Requests exceeding 30 seconds incur 1 additional credit per 30s of compute time.

SEARCH RANGE LIMITS: Explorer tier is limited to 1-year windows; Developer to 5 years. Ranges exceeding the limit are silently clamped.

EXAMPLE: Find all Saturn transits to the natal Sun/Moon for the next 6 months: natal_datetime='1990-04-15T14:30:00', natal_latitude=41.8781, natal_longitude=-87.6298, start_date='2026-01-01', end_date='2026-06-30', transiting_planets=['saturn']

Get the Moon's current phase angle, illumination, and void-of-course status AT a specific point in time. Returns phase name (New, Waxing Crescent, First Quarter, etc.), exact angle, illumination %, and next void-of-course period.

⚠️ THIS TOOL ANSWERS: 'What phase is the moon in right now (or at a given datetime)?' ❌ THIS TOOL DOES NOT ANSWER: 'When is the next new moon / full moon?' → For upcoming phase DATES use ephemeris_next_lunar_phase instead.

CREDIT COST: 1 credit per call.

If no datetime is provided, returns the current (live) moon phase.

EXAMPLE: Get moon phase for a specific date/time: datetime='2026-03-20T12:00:00Z'

EXAMPLE: Get the current moon phase right now: (call with no arguments)

Find the next occurrence of a specific Moon phase after a given date. Returns the exact UTC datetime, zodiac sign, and degree.

✅ USE THIS TOOL FOR: 'When is the next new moon?', 'When is the next full moon?', 'What date is the next quarter moon?', or any question about UPCOMING phase dates.

CREDIT COST: 1 credit per call.

EXAMPLE: Find the next new moon: phase='new_moon'

EXAMPLE: Find the next full moon after a specific date: phase='full_moon', after_date='2026-06-01'

EXAMPLE: Find the next 3 full moons: phase='full_moon', count=3

Find the next solar or lunar eclipse. Returns the eclipse type, date/time of maximum, magnitude, and duration of totality (if any).

📍 LOCATION OPTIONAL: • WITH latitude+longitude → returns local contact times and visibility for that specific location. • WITHOUT latitude+longitude → returns the next global eclipse of that type (no location needed).

USE THIS TOOL FOR: 'When is the next solar eclipse?', 'When is the next total lunar eclipse?', 'Will there be an eclipse visible from Tokyo?'

CREDIT COST: 1 credit per call.

EXAMPLE: Next solar eclipse globally (no location needed): eclipse_type='solar'

EXAMPLE: Next solar eclipse visible from New York: eclipse_type='solar', latitude=40.7128, longitude=-74.006

EXAMPLE: Next lunar eclipse from London: eclipse_type='lunar', latitude=51.5074, longitude=-0.1278

Calculate a full Human Design I Ching hexagram chart from birth data. Returns the person's Type (Generator, Manifesting Generator, Projector, Manifestor, Reflector), Strategy, Authority, Profile (e.g. 1/3, 2/4), defined and undefined Centers, activated Gates and Channels, Incarnation Cross, and both Personality (conscious) and Design (unconscious) planetary positions.

CREDIT COST: 2 credits per call.

Human Design uses two calculation moments: the birth time (Personality) and ~88° of Sun motion before birth (~3 months prior, the Design calculation). The API handles this automatically.

IMPORTANT: The datetime should be in UTC. If you have local birth time, convert to UTC first.

EXAMPLE: Get the Human Design chart for someone born April 15, 1990 at 7:30 PM UTC: datetime='1990-04-15T19:30:00Z', latitude=41.8781, longitude=-87.6298

Calculate a synastry chart comparing two people's natal charts. Returns inter-aspects (planetary connections between the two charts), composite points, and relationship indicators. Use this for compatibility analysis, relationship timing, or partnership insights.

CREDIT COST: 3 credits per call.

EXAMPLE: Compare two people's charts: person_a_datetime='1990-04-15T14:30:00', person_a_latitude=41.8781, person_a_longitude=-87.6298, person_b_datetime='1988-09-22T08:15:00', person_b_latitude=34.0522, person_b_longitude=-118.2437

Calculate a relocation chart — the same natal planetary positions re-cast for a different geographic location. Used to understand how living in a different city shifts house placements and angles, without changing the planetary longitudes in the chart.

CREDIT COST: 1 credit per call.

EXAMPLE: How does moving from Chicago to London change someone's chart? natal_datetime='1990-04-15T14:30:00', natal_latitude=41.8781, natal_longitude=-87.6298, relocation_latitude=51.5074, relocation_longitude=-0.1278

Find optimal planetary timing windows (electional astrology). Scans a date range to find the best times for an event based on essential dignity, aspect quality, sect, and void-of-course moon penalties. Evaluates every hour and clusters the best continuous windows.

CREDIT COST: 5 credits per call (heavy calculation).

EXAMPLE: Find the best time to launch a business in early March 2026. start_date='2026-03-01', end_date='2026-03-10', latitude=40.7128, longitude=-74.0060, avoid_voc=true, lunar_phase='waxing'

Analyze the astrological quality of a specific moment: planet positions, aspects, void of course status, lunar phase, day ruler, and an overall electional score (0-100). Perfect for evaluating whether 'right now' or a specific date/time is good for action.

CREDIT COST: 2 credits per call.

EXAMPLE: Analyze March 21, 2026 at noon: date='2026-03-21T12:00:00'

Find all upcoming retrograde and direct stations for planets in a date range. Returns exact station times, longitudes, and signs.

USE THIS TOOL FOR: 'When does Mercury go retrograde?', 'Is Venus retrograde this year?', 'What planets station this month?', 'When does Mars go direct?'

All required fields have smart defaults (searches the next 90 days from today).

CREDIT COST: 3 credits per call.

EXAMPLE: Mercury and Venus stations in the next 3 months (all defaults): (no args required, will auto-scan next 90 days for all inner planets)

EXAMPLE: Outer planet stations in 2026: start_date='2026-01-01', end_date='2026-12-31', planets='jupiter,saturn,uranus,neptune,pluto'

Find all active aspects between planets at a specific moment. Returns aspect type, orb, quality score, and whether it's applying or separating. Great for checking the 'weather' of a given day.

CREDIT COST: 2 credits per call.

EXAMPLE: What aspects are active on March 21, 2026? date='2026-03-21T12:00:00'

Calculate a Vedic (Jyotish) natal chart with sidereal positions. Returns planet placements in rashis (sidereal signs), nakshatras with pada, navamsa placements, and bhavas (houses). Uses Whole Sign houses, sidereal zodiac with configurable ayanamsa.

CREDIT COST: 1 credit per call.

SUPPORTED AYANAMSA: lahiri (default), fagan_bradley, krishnamurti, raman, yukteshwar

EXAMPLE: Vedic chart for someone born Jan 15, 1990 at 8:30 AM UTC in Mumbai: datetime='1990-01-15T08:30:00Z', latitude=19.076, longitude=72.8777

Calculate a Chinese Ba Zi (Four Pillars of Destiny) chart. Returns the Year, Month, Day, and Hour pillars, each containing a Heavenly Stem and Earthly Branch pair. Also includes the Day Master element, Wu Xing element breakdown, and basic interpretation context.

CREDIT COST: 1 credit per call.

You can provide either a datetime string (which will be decomposed automatically) or explicit year/month/day/hour values.

EXAMPLE: Ba Zi for someone born July 15, 1987 at 2:00 PM: year=1987, month=7, day=15, hour=14

Generate a classic astrological Chart Wheel image (SVG) for a person/event. This draws a standard circular chart wheel with planets, aspects, and house cusps. The tool returns a native SVG image that Claude displays inline in the conversation — no external tools needed.

CREDIT COST: 2 credits per call.

EXAMPLE: Generate a natal chart wheel for someone born April 15, 1990 in Chicago: datetime='1990-04-15T14:30:00', latitude=41.8781, longitude=-87.6298

Generate a Bi-Wheel (Synastry/Transit) image (SVG) comparing two charts. Draws Subject A's planets on the inside wheel and Subject B's on the outside wheel. Returns a native SVG that Claude displays inline in the conversation.

CREDIT COST: 2 credits per call.

EXAMPLE: Compare someone born April 15, 1990 (A) to someone born June 10, 1992 (B): datetime_a='...', latitude_a=..., longitude_a=..., datetime_b='...', latitude_b=..., longitude_b=...

Calculate the exact Solar Return date/time — when the Sun returns to its natal ecliptic longitude (happens once per year near the birthday). Returns the Solar Return chart for the year ahead.

CREDIT COST: 5 credits per call.

TARGET DATE: Provide target_datetime near the desired birthday year. If omitted, defaults to the current year's solar return.

EXAMPLE: Solar return for someone born 1985-06-21 (current year): birth_datetime='1985-06-21T14:00:00Z'

EXAMPLE: Solar return for 2027 specifically: birth_datetime='1985-06-21T14:00:00Z', target_datetime='2027-01-01T00:00:00Z'

Calculate the exact Lunar Return date/time — when the Moon returns to its natal ecliptic longitude (~every 27.3 days). Used to cast the monthly Lunar Return chart.

CREDIT COST: 5 credits per call.

TARGET DATE: Provide target_datetime near the month you want. If omitted, defaults to the next upcoming lunar return from today.

EXAMPLE: Next lunar return after today for someone born 1990-04-15: birth_datetime='1990-04-15T14:30:00Z'

EXAMPLE: Lunar return nearest March 2026: birth_datetime='1990-04-15T14:30:00Z', target_datetime='2026-03-15T00:00:00Z'

Calculate a planetary return — when any planet returns to its natal longitude. Useful for Jupiter returns (~12 years), Saturn returns (~29 years), Chiron returns (~50 years), Uranus returns (~84 years), etc.

CREDIT COST: 5 credits per call.

EXAMPLE: Saturn return for birth 1990-04-15 near year 2019: body='saturn', birth_datetime='1990-04-15T14:30:00Z', target_datetime='2019-01-01T00:00:00Z' EXAMPLE: Chiron return for birth 1975-03-10 near age 50: body='chiron', birth_datetime='1975-03-10T08:00:00Z', target_datetime='2025-01-01T00:00:00Z'

Calculate a Secondary Progressed (or Solar Arc / Tertiary) chart. Advances the natal chart symbolically — 1 day = 1 year (secondary), or using solar arc motion. Returns progressed planet positions, house cusps, aspects, and retrograde status.

CREDIT COST: 1 credit per call.

EXAMPLE: Secondary progressions for someone born 1985-06-21, progressed to 2026-01-01: birth_datetime='1985-06-21T14:00:00', birth_latitude=51.5, birth_longitude=-0.12, target_datetime='2026-01-01', method='secondary'

Get the precise ecliptic longitude, latitude, distance, speed, and retrograde status for a single planet/body at a given date and time. Planet IDs: 0=Sun, 1=Moon, 2=Mercury, 3=Venus, 4=Mars, 5=Jupiter, 6=Saturn, 7=Uranus, 8=Neptune, 9=Pluto, 10=North Node, 11=South Node, 12=Lilith, 15=Chiron, 17=Ceres, 18=Pallas, 19=Juno, 20=Vesta.

CREDIT COST: 1 credit per call.

EXAMPLE: Where is Mars on 2026-03-20 at noon UTC? planet_id=4, datetime='2026-03-20T12:00:00Z'

Calculate house cusps and angles (ASC, MC, DSC, IC) for a given date, time, and location using one or more house systems.

House system codes: P=Placidus, K=Koch, O=Porphyry, R=Regiomontanus, C=Campanus, E=Equal, W=Whole Sign.

CREDIT COST: 1 credit per call.

EXAMPLE: Placidus houses for London at 2026-03-20 noon UTC: datetime='2026-03-20T12:00:00Z', latitude=51.5074, longitude=-0.1278, house_systems=['P']

Calculate a composite chart from two or more natal charts. The composite uses midpoints of each planet pair to derive a single relationship chart.

CREDIT COST: 3 credits per call.

EXAMPLE: Composite for two people: person_a_datetime='1990-04-15T14:30:00', person_a_latitude=41.88, person_a_longitude=-87.63, person_b_datetime='1988-09-22T08:15:00', person_b_latitude=34.05, person_b_longitude=-118.24

Calculate a midpoint composite chart — an alternative composite method using the midpoints of matching planet positions.

CREDIT COST: 3 credits per call.

Calculate an overlay chart — place one person's planets in another person's houses. Shows how person A's energies impact person B's life areas and vice versa.

CREDIT COST: 3 credits per call.

Calculate active transits to a natal chart — shows which current planets are aspecting natal positions. Essential for predictive astrology.

CREDIT COST: 3 credits per call.

EXAMPLE: Current transits to someone born 1990-04-15: natal_datetime='1990-04-15T14:30:00', natal_latitude=41.88, natal_longitude=-87.63

Calculate a Human Design composite chart for two people. Merges both bodygraphs to show shared channels, authority dynamics, and relationship type.

CREDIT COST: 4 credits per call.

EXAMPLE: person_a_datetime='1990-04-15T14:30:00Z', person_b_datetime='1988-09-22T08:15:00Z'

Calculate a Human Design Penta (group) chart for 3-5 people. Shows functional attributes, leadership dynamics, channels, redundancies, and a group stability score.

CREDIT COST: 6 credits per call.

EXAMPLE (3 people): group_name='Team Alpha', members=[ {id: 'alice', name: 'Alice', datetime: '1990-04-15T14:30:00Z'}, {id: 'bob', name: 'Bob', datetime: '1988-09-22T08:15:00Z'}, {id: 'carol', name: 'Carol', datetime: '1995-01-10T11:00:00Z'} ]

Generate a Human Design Bodygraph image (SVG) from a birth datetime (UTC). Renders the full bodygraph circuit board showing all 9 centers, 36 channels, and 64 gates with Personality (conscious) and Design (unconscious) activations color-coded. Defined centers are filled with their HD doctrine color; open/undefined centers remain muted. Returns a native SVG that Claude displays inline. Use format='png' to opt into raster output (requires server-side rasterizer).

CREDIT COST: 2 credits per call.

EXAMPLE: Generate a bodygraph for someone born April 15, 1990 at 19:30 UTC: datetime='1990-04-15T19:30:00Z'

Calculate a Human Design planetary return chart — full HD chart (type, strategy, authority, gates, channels) at the moment a planet returns to its natal position. Supports all HD-relevant planets.

CREDIT COST: 2 credits per call.

Key returns in Human Design: • Saturn Return (~29y, ~59y) — maturation/authority activation • Chiron Return (~50y) — wound-to-teaching integration • Jupiter Return (~12y) — expansion cycles • Mars Return (~2y) — energy/drive reset • Lunar Return (~27.3d) — emotional/body cycle

EXAMPLE: Saturn return chart for birth 1990-04-15: planet='saturn', datetime='1990-04-15T19:30:00Z', return_year=2020

Calculate a Human Design opposition chart — the HD chart at the moment a planet opposes its natal position (180°).

Key oppositions in Human Design: • Uranus Opposition (~age 42) — midlife awakening/individuation • Saturn Opposition (~age 14-15, ~44) — structural tension • Jupiter Opposition (~age 6, ~18, ~30) — expansion challenges

CREDIT COST: 2 credits per call.

EXAMPLE: Uranus opposition for birth 1983-07-15: planet='uranus', datetime='1983-07-15T12:00:00Z', target_year=2025

Calculate natal charts for multiple subjects in a single request. Supports up to 100 subjects. Returns enhanced natal chart data for each.

CREDIT COST: 1 credit per subject.

EXAMPLE: Two people batch: subjects: [ { name: 'Alice', datetime: '1990-04-15T14:30:00', latitude: 41.88, longitude: -87.63 }, { name: 'Bob', datetime: '1988-09-22T08:15:00', latitude: 34.05, longitude: -118.24 } ]

Calculate essential dignities (domicile, exaltation, detriment, fall, peregrine) for all planets at a given date/time. Essential for traditional astrology.

CREDIT COST: 1 credit per call.

Get retrograde/direct status and speed for all planets at a given date/time. Returns is_retrograde flag, longitude speed, and station proximity for every planet.

CREDIT COST: 1 credit per call.

Optionally pass planet_id (0-9) to query a single planet.

Calculate midpoints between all planet pairs for a given date/time and location. Returns midpoint longitude, the two planets involved, and any planet at the midpoint.

CREDIT COST: 1 credit per call.

Calculate positions of fixed stars and conjunctions to natal planets. Returns star longitude, magnitude, and any planets within orb.

CREDIT COST: 1 credit per call.

Calculate Arabic Parts / Hermetic Lots (Lot of Fortune, Spirit, etc.) for a given chart.

CREDIT COST: 1 credit per call.

Calculate chart angles and sensitive points (ASC, MC, DSC, IC, Vertex, East Point, etc.) for a given date/time and location.

CREDIT COST: 1 credit per call.

Check the aspect between two ecliptic longitudes. Returns the angular separation and any aspects within orb (conjunction, sextile, square, trine, opposition, etc.).

CREDIT COST: 1 credit per call.

EXAMPLE: Check aspect between 15° Aries and 75° Gemini: longitude_1=15, longitude_2=75

Get Venus Star Points — the Sun-Venus conjunction events nearest to a birth date. Shows the quality of each conjunction (cazimi, combust, under beams) with zodiac details.

CREDIT COST: 2 credits per call.

EXAMPLE: Venus star points for someone born 1990-04-15: datetime='1990-04-15T14:30:00', latitude=41.88, longitude=-87.63

Find all Sun-Venus conjunctions in a date range. Returns each conjunction with its exact timestamp, zodiac position, orb, visibility (morning/evening star), and dignity.

CREDIT COST: 2 credits per call.

EXAMPLE: Find Venus conjunctions in 2026: start_date='2026-01-01', end_date='2026-12-31'

Compute the 8-year Venus Star pattern — the pentagram of 5 Venus-Sun conjunctions that trace a near-perfect star over 8 years (the Venus synodic cycle). Returns the 5 vertices with their zodiac positions.

CREDIT COST: 2 credits per call.

EXAMPLE: 8-year star starting from 2020: date='2020-01-01'

Get the current Venus phase — morning star, evening star, or combust. Returns Venus longitude, Sun longitude, elongation, retrograde/cazimi status.

CREDIT COST: 1 credit per call.

EXAMPLE: Venus phase right now (omit date): (no args required)

EXAMPLE: Venus phase on a specific date: date='2026-03-20'

Find Venus greatest elongation events (when Venus is farthest from the Sun in the sky). Returns east (evening star) and west (morning star) elongation peaks.

CREDIT COST: 2 credits per call.

Find Venus retrograde and direct stations in a date range. Returns the exact moment Venus appears to stop and reverse direction.

CREDIT COST: 2 credits per call.

EXAMPLE: Venus stations in 2026: start_date='2026-01-01', end_date='2026-12-31'

Calculate Astrocartography power lines (MC, IC, AC/ASC, DC/DSC) for a natal chart. Returns GeoJSON LineStrings tracing each planetary angle line around the globe. These are the latitudinal lines where a planet was rising (AC), setting (DC), culminating (MC), or anti-culminating (IC) at birth.

❌ NOT FOR: 'Is [city] good for me?' or 'What planets affect me in Tokyo?' → For a specific city/location analysis, use acg_hits instead (faster and more relevant). ✅ USE FOR: Getting the full global GeoJSON line geometry for map rendering or bulk geographic analysis.

CREDIT COST: 10 credits per call.

EXAMPLE: Saturn and Jupiter power lines for a chart born 1990-04-15 in Chicago: birth_datetime='1990-04-15T14:30:00', birth_latitude=41.8781, birth_longitude=-87.6298, bodies=['Saturn', 'Jupiter']

Find all Astrocartography lines (power lines + aspect lines) passing near a specific location. Returns features sorted by distance, making it easy to interpret planetary influences at a place.

✅ USE THIS TOOL FOR: 'Is [city] good for me?', 'What planets affect me in Tokyo?', 'What ACG lines run through Paris for my chart?', 'Which cities are under my Jupiter line?' ❌ NOT FOR: Full global map geometry → use acg_power_lines for that instead.

CREDIT COST: 15 credits per call.

EXAMPLE: All ACG lines within 3° of Paris for a chart born 1990-04-15 in Chicago: birth_datetime='1990-04-15T14:30:00', birth_latitude=41.8781, birth_longitude=-87.6298, query_latitude=48.8566, query_longitude=2.3522, radius_deg=3