AgentAstrology

The Plates

28 renderer families · one specimen chart · both registers

Astrocartography — specimen plate rendered by the engine — XXIII. Astrocartography
Astrocartography — where each planet runs angular on Earth.

Wheel — specimen plate rendered by the engine — I. Wheel
The natal chart — every planet, house, and aspect on one dial.

Aspectarium — specimen plate rendered by the engine — X. Aspectarium
Every angle between every pair, tabulated.

XIII. Lunar circular calendar

The whole year's moons on one circular calendar.

Dasha timeline — specimen plate rendered by the engine — XX. Dasha timeline
Vimshottari dashas — the running periods, ruled and dated.

XXVII. Planetary clock

The planetary hours for one day and one place.

Bi-wheel — specimen plate rendered by the engine — II. Bi-wheel
Two charts on one wheel — the current sky ringed around the natal.

Tri-wheel — specimen plate rendered by the engine — III. Tri-wheel
Three charts nested — natal, partner, and the moving sky.

Square wheel — specimen plate rendered by the engine — IV. Square wheel
The natal chart in the old square manuscript form.

Heliocentric wheel — specimen plate rendered by the engine — V. Heliocentric wheel
The solar system as the Sun sees it — heliocentric longitudes.

Uranian dial — specimen plate rendered by the engine — VI. Uranian dial
The 90° Uranian dial — midpoint work at a watchmaker's precision.

Multi-chart dial — specimen plate rendered by the engine — VII. Multi-chart dial
Several charts on one 90° dial, ring by ring.

Dial midpoint tree — specimen plate rendered by the engine — VIII. Dial midpoint tree
Every midpoint striking one target, sorted into a tree.

Dial sort strip — specimen plate rendered by the engine — IX. Dial sort strip
All bodies sorted along the dial's arc — a measuring strip.

Vedic grid — specimen plate rendered by the engine — XI. Vedic grid
The North-Indian varga grid — sign placements at a glance.

XII. Monthly calendar

A month of lunations, ingresses, and stations.

Moon phase — specimen plate rendered by the engine — XIV. Moon phase
The Moon's face at one exact instant.

Graphic ephemeris — specimen plate rendered by the engine — XV. Graphic ephemeris
A year of longitudes woven into one graphic ephemeris.

Declination ephemeris — specimen plate rendered by the engine — XVI. Declination ephemeris
Declinations traced across the year — parallels made visible.

Circular ephemeris — specimen plate rendered by the engine — XVII. Circular ephemeris
The year's planetary motion bent into a single circle.

Time map — specimen plate rendered by the engine — XVIII. Time map
Slow transits mapped across years — the long weather.

Birthday timeline — specimen plate rendered by the engine — XIX. Birthday timeline
Every birthday's sky along one ruled lifeline.

Decennials (Valens) — specimen plate rendered by the engine — XXI. Decennials (Valens)
Valens' decennials — time-lord periods laid end to end.

Circumambulations — specimen plate rendered by the engine — XXII. Circumambulations
The Ascendant walking the bounds, year by measured year.

Eclipse path map — specimen plate rendered by the engine — XXIV. Eclipse path map
The next eclipse's shadow path, drawn on the map.

Local space map — specimen plate rendered by the engine — XXV. Local space map
Planet bearings from your doorstep, drawn as compass lines.

Local horizon map — specimen plate rendered by the engine — XXVI. Local horizon map
The local horizon wheel — azimuth and altitude at birth.

Planetary cycle — specimen plate rendered by the engine — XXVIII. Planetary cycle
A planet's synodic geometry — Venus' petals traced over years.

The Catalogue

29 tools · 144 methods · one MCP server

COMPUTE

Methods

astro_chart

Cast a chart at a specific moment + location. Single-chart compute primitive.

VIEW THE REFERENCE →

{
  "method": "natal",
  "birthData": {
    "year": 1990,
    "month": 1,
    "day": 1,
    "hour": 12,
    "minute": 0,
    "latitude": 51.5074,
    "longitude": -0.1278,
    "timezone": 0
  },
  "houseSystem": "placidus",
  "zodiac": "tropical"
}

astro_chart_derived

Charts derived from a natal chart via transformation techniques.

VIEW THE REFERENCE →

{
  "method": "harmonic",
  "birthData": {
    "year": 1990,
    "month": 1,
    "day": 1,
    "hour": 12,
    "minute": 0,
    "latitude": 51.5074,
    "longitude": -0.1278,
    "timezone": 0
  },
  "harmonic": 2
}

astro_aspects

Compute aspects within a chart or cross-aspects between two charts.

VIEW THE REFERENCE →

{
  "method": "within-chart",
  "birthData": {
    "year": 1990,
    "month": 1,
    "day": 1,
    "hour": 12,
    "minute": 0,
    "latitude": 51.5074,
    "longitude": -0.1278,
    "timezone": 0
  },
  "houseSystem": "placidus",
  "zodiac": "tropical"
}

astro_midpoints

Midpoint computation and Uranian planetary-picture formulas.

VIEW THE REFERENCE →

{
  "method": "midpoints",
  "birthData": {
    "year": 1990,
    "month": 1,
    "day": 1,
    "hour": 12,
    "minute": 0,
    "latitude": 51.5074,
    "longitude": -0.1278,
    "timezone": 0
  }
}

astro_dignities

Planetary dignity assessments (essential, accidental, almuten, hyleg, receptions).

VIEW THE REFERENCE →

{
  "method": "essential",
  "birthData": {
    "year": 1990,
    "month": 1,
    "day": 1,
    "hour": 12,
    "minute": 0,
    "latitude": 51.5074,
    "longitude": -0.1278,
    "timezone": 0
  }
}

astro_chart_pattern

Qualitative chart summaries — dominance, shape, temperament, astrodynes.

VIEW THE REFERENCE →

{
  "method": "dominant",
  "birthData": {
    "year": 1990,
    "month": 1,
    "day": 1,
    "hour": 12,
    "minute": 0,
    "latitude": 51.5074,
    "longitude": -0.1278,
    "timezone": 0
  },
  "houseSystem": "placidus",
  "zodiac": "tropical"
}

astro_lots

Arabic Parts / Hellenistic Lots library. Fortune free; all others paid.

VIEW THE REFERENCE →

{
  "method": "fortune",
  "birthData": {
    "year": 1990,
    "month": 1,
    "day": 1,
    "hour": 12,
    "minute": 0,
    "latitude": 51.5074,
    "longitude": -0.1278,
    "timezone": 0
  },
  "houseSystem": "placidus"
}

astro_progressions

Symbolic time-projection techniques: secondary, solar arc, tertiary, minor, primary directions.

VIEW THE REFERENCE →

{
  "method": "secondary",
  "birthData": {
    "year": 1990,
    "month": 1,
    "day": 1,
    "hour": 12,
    "minute": 0,
    "latitude": 51.5074,
    "longitude": -0.1278,
    "timezone": 0
  },
  "targetDate": {
    "year": 2026,
    "month": 8,
    "day": 8
  }
}

astro_returns

Planetary returns — each planet's next crossing of its natal longitude.

VIEW THE REFERENCE →

{
  "method": "sun",
  "birthData": {
    "year": 1990,
    "month": 1,
    "day": 1,
    "hour": 12,
    "minute": 0,
    "latitude": 51.5074,
    "longitude": -0.1278,
    "timezone": 0
  },
  "returnYear": 2026
}

astro_timelord

Hellenistic, Persian, and Vedic time-lord systems.

VIEW THE REFERENCE →

{
  "method": "profections",
  "birthData": {
    "year": 1990,
    "month": 1,
    "day": 1,
    "hour": 12,
    "minute": 0,
    "latitude": 51.5074,
    "longitude": -0.1278,
    "timezone": 0
  }
}

astro_moment

Astrological qualities of a moment — phase, VOC, hours, mansions, eclipses.

VIEW THE REFERENCE →

{
  "method": "moon-phase",
  "year": 2026,
  "month": 8,
  "day": 8,
  "houseSystem": "placidus",
  "zodiac": "tropical"
}

SEARCH

Methods

astro_find_events

Date-range scans for astrological events — aspects, ingresses, eclipses, stations, etc.

VIEW THE REFERENCE →

{
  "method": "moon-events",
  "dateRange": {
    "from": {
      "year": 2026,
      "month": 1,
      "day": 1
    },
    "to": {
      "year": 2026,
      "month": 12,
      "day": 31
    }
  }
}

astro_find_electional

Electional astrology — score date ranges against a criteria DSL.

VIEW THE REFERENCE →

{
  "method": "criteria",
  "dateRange": {
    "from": {
      "year": 2026,
      "month": 1,
      "day": 1
    },
    "to": {
      "year": 2026,
      "month": 12,
      "day": 31
    }
  },
  "criteria": [
    {
      "kind": "planet-in-sign",
      "planet": "Sun",
      "signs": [
        "Aries"
      ]
    }
  ]
}

astro_search_charts
Celebrity chart database lookup + filter search (Astrodatabank-grade).
VIEW THE REFERENCE →
```
{
  "method": "lookup",
  "name": "London"
}
```

RENDER

Methods

astro_render_wheel

Zodiac wheel renders — single, bi-, tri-, quadri-, or heliocentric wheel.

VIEW THE REFERENCE →

{
  "method": "single",
  "birthData": {
    "year": 1990,
    "month": 1,
    "day": 1,
    "hour": 12,
    "minute": 0,
    "latitude": 51.5074,
    "longitude": -0.1278,
    "timezone": 0
  },
  "houseSystem": "placidus"
}

astro_render_dial

Cosmobiology dials — single, multi-chart, midpoint tree, sort strip.

VIEW THE REFERENCE →

{
  "method": "single",
  "birthData": {
    "year": 1990,
    "month": 1,
    "day": 1,
    "hour": 12,
    "minute": 0,
    "latitude": 51.5074,
    "longitude": -0.1278,
    "timezone": 0
  }
}

astro_render_aspectarium

Aspect grid visualization — standard, orb-weighted intensity, or two-chart synastry grid.

VIEW THE REFERENCE →

{
  "method": "standard",
  "birthData": {
    "year": 1990,
    "month": 1,
    "day": 1,
    "hour": 12,
    "minute": 0,
    "latitude": 51.5074,
    "longitude": -0.1278,
    "timezone": 0
  }
}

astro_render_map

Geographic chart renders — astrocartography, local space, eclipse paths, horizon.

VIEW THE REFERENCE →

{
  "method": "astrocartography",
  "birthData": {
    "year": 1990,
    "month": 1,
    "day": 1,
    "hour": 12,
    "minute": 0,
    "latitude": 51.5074,
    "longitude": -0.1278,
    "timezone": 0
  }
}

astro_render_ephemeris
Ephemeris renders — table (Free⌃ text / Paid SVG), circular, graphic-with-overlay, declination-axis graphic.
VIEW THE REFERENCE →
```
{
  "method": "table",
  "year": 2026,
  "month": 8
}
```
astro_render_calendar
Astrological calendar renders — monthly grid or circular lunar phase.
VIEW THE REFERENCE →
```
{
  "method": "monthly-astro",
  "year": 2026,
  "month": 8
}
```

astro_render_vedic_grid

Vedic divisional chart grid renders — D1..D60, North or South Indian layout.

VIEW THE REFERENCE →

{
  "method": "grid",
  "birthData": {
    "year": 1990,
    "month": 1,
    "day": 1,
    "hour": 12,
    "minute": 0,
    "latitude": 51.5074,
    "longitude": -0.1278,
    "timezone": 0
  },
  "vargas": [
    "D1"
  ],
  "layout": "north-indian"
}

astro_render_timeline

Time-aligned visualizations — birthday, dasha, decennials, circumambulations, time-map.

VIEW THE REFERENCE →

{
  "method": "birthday",
  "birthData": {
    "year": 1990,
    "month": 1,
    "day": 1,
    "hour": 12,
    "minute": 0,
    "latitude": 51.5074,
    "longitude": -0.1278,
    "timezone": 0
  },
  "dateRange": {
    "from": {
      "year": 2026,
      "month": 1,
      "day": 1
    },
    "to": {
      "year": 2026,
      "month": 12,
      "day": 31
    }
  }
}

astro_render_planetary_cycle

Mercury / Venus / Mars synodic cycle renders (petals, synodic, promethean).

VIEW THE REFERENCE →

{
  "method": "cycle",
  "planet": "mercury",
  "layout": "synodic",
  "dateRange": {
    "from": {
      "year": 2026,
      "month": 1,
      "day": 1
    },
    "to": {
      "year": 2026,
      "month": 12,
      "day": 31
    }
  }
}

astro_render_planetary_clock
Planetary clock face — rise, set, culminate for a date + location.
VIEW THE REFERENCE →
```
{
  "method": "clock",
  "date": {
    "year": 2026,
    "month": 8,
    "day": 8
  },
  "latitude": 51.5074,
  "longitude": -0.1278
}
```
astro_render_moon_phase_illustration
Standalone moon-phase illustration (Free⌃ default palette).
VIEW THE REFERENCE →
```
{
  "method": "illustration",
  "date": {
    "year": 2026,
    "month": 8,
    "day": 8
  }
}
```

UTILITY

Methods

astro_geocode
Place-name → coordinates + timezone. basic Free; atlas Paid (historical TZ + DST).
VIEW THE REFERENCE →
```
{
  "method": "basic",
  "query": "London"
}
```
astro_date_convert
Calendar and timezone conversions — julian-gregorian, timezone, easter-date.
VIEW THE REFERENCE →
```
{
  "method": "julian-gregorian",
  "date": {
    "year": 2026,
    "month": 8,
    "day": 8
  },
  "calendar": "julian"
}
```
astro_cultural_attribute
Cultural attributes from birthdate — numerology, Chinese zodiac, Celtic tree.
VIEW THE REFERENCE →
```
{
  "method": "numerology",
  "date": {
    "year": 1990,
    "month": 1,
    "day": 1
  }
}
```
astro_lookup
Reference lookup — Sabian symbols (Paid), astrology-term encyclopedia (Free).
VIEW THE REFERENCE →
```
{
  "method": "astrology-term",
  "term": "aspect"
}
```

Call The Api

curl -X POST https://api.agentastrology.com/v1/tools/astro_chart \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"natal","birthData":{"year":1990,"month":1,"day":1,"hour":12,"minute":0,"latitude":51.5074,"longitude":-0.1278,"timezone":0}}'

200 OK

{
  "summary": {
    "houseSystem": "Placidus system",
    "zodiac": "Tropical"
  },
  "planets": [
    { "id": "Sun", "longitude": 280.814, ... }
  ],
  ...
}

VIEW FULL REFERENCE →

Built For Agents

Pricing

Free during beta. Every key gets full access to all 29 tools.

Give your AI agents real astrology.