LifeAstroAPILifeAstroAPI

Astrology, inside your AI assistant.

Install lifeastro-mcp on your laptop. Your AI assistant instantly gains 310 tools — panchang, kundli, dasha, match-making, muhurta, eclipses, synastry, progressions.

Works with Claude Desktop, Cursor, Continue.dev, Codex CLI — any MCP-aware client. Each tool call uses one credit from your dv_live_… key. No MCP surcharge, no separate "MCP key".

MIT licensed · statically-linked Go binary · ~8 MB

How it connectsstdio + HTTPS
AI Client
Claude · Cursor · Codex
stdio
lifeastro-mcp
310 tools · v0.11.0
HTTPS · Bearer dv_live_…
api.lifeastroapi.com
311 endpoints · <1 ms compute

Binary runs on your laptop. Your AI prompts never leave your client — only the structured tool arguments do.

310
AI tools
4
AI clients supported
5
Platforms
8 MB
Binary size

Just ask in plain language.

Once installed and configured, your AI assistant answers astrology questions naturally — no curl, no code, no docs. The AI picks the right tool from your question.

Claude Desktop · lifeastro-mcp connected
You

Mera lagna kya hai? Birth: 15 Jan 1990, 10:30 AM, Mumbai.

Claude
tool call →chart_ascendant

Aapka lagna Capricorn (Makara) hai, 12°34′ par. Lagna lord Saturn 10th house mein sthit hai, Karma bhav par — career mein steady upward arc ka indication. Saturn ka 10th-house placement aapko discipline aur long-term focus deta hai.

Four steps. Five minutes.

lifeastro-mcp is a small Go binary (~8 MB) that runs as a subprocess of your AI client. Your client talks to it over stdio (local IPC); the binary talks to api.lifeastroapi.com over HTTPS using your key. Nothing else.

1

Get an API key

Free 1,500 credits / month. Same dv_live_… key as direct API access.

2

Install the binary

Homebrew, Go install, or download a binary for Windows. ~8 MB, no deps.

3

Configure your client

Paste one JSON block, set LIFEASTRO_API_KEY. Same shape across all clients.

4

Restart &amp; try

Quit + reopen your AI client. Ask a question. All 310 tools appear instantly.

Get an API key

Sign up at lifeastroapi.com/signup — it's free and takes 30 seconds. Create a key in the dashboard (it looks like dv_live_<hex>). The free plan gives you 1,500 credits / month and 500 credits / day — plenty to try every MCP tool. The same key works for direct API calls, JSON reports, and the MCP binary.

Install the binary

Three options depending on your platform. The source is public on GitHub under MIT — the Go module works today; Homebrew and signed binaries are attached to each GitHub release.
macOS & Linux — recommended
Homebrew
brew tap ayanshulife/lifeastroapi-mcp \
  https://github.com/ayanshulife/lifeastroapi-mcp
brew install lifeastro-mcp
If you have Go 1.25+ installed
Go install
go install \
  github.com/ayanshulife/lifeastroapi-mcp/cmd/lifeastro-mcp@latest
Windows / no package manager
Download binary

Grab the binary for your OS from the latest GitHub release and put it on your PATH.

GitHub releases

Supported platforms: darwin/arm64 (Apple Silicon), darwin/amd64 (Intel Mac), linux/amd64, linux/arm64, windows/amd64. Source (MIT) is at github.com/ayanshulife/lifeastroapi-mcp.

macOS Gatekeeper note: if you download the binary directly (not via Homebrew), macOS will block the first launch with "cannot verify developer". Open System Settings → Privacy & Security and click Open Anyway, or run xattr -d com.apple.quarantine /path/to/lifeastro-mcp in a terminal. Homebrew installs don't hit this because brew vouches for the binary.

Verify the install

Before wiring up your AI client, confirm the binary is on your PATH and exits cleanly with the expected error message. Run this in a terminal:
$ which lifeastro-mcp
/opt/homebrew/bin/lifeastro-mcp     # or wherever your install put it

$ lifeastro-mcp
lifeastro-mcp: LIFEASTRO_API_KEY env var is required.
Add it to your MCP client config:
  "env": { "LIFEASTRO_API_KEY": "dv_live_..." }
Get a key at https://lifeastroapi.com/dashboard/api-keys

That "LIFEASTRO_API_KEY env var is required" message is the expected output — it means the binary loaded correctly and fail-fast auth is working. If you see command not found instead, the binary isn't on your PATH; use brew --prefix lifeastro-mcp (Homebrew) or check your $GOBIN / ~/go/bin (go install) and add it to PATH.

Configure your AI client

Paste this block into your AI client's MCP config file, replace the API key placeholder with your dv_live_… key, and restart the app. All 310 tools appear in the tool list immediately.
Claude Desktop
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "lifeastro": {
      "command": "/opt/homebrew/bin/lifeastro-mcp",
      "env": {
        "LIFEASTRO_API_KEY": "dv_live_..."
      }
    }
  }
}
Cursor
File: ~/.cursor/mcp.json
{
  "mcpServers": {
    "lifeastro": {
      "command": "/opt/homebrew/bin/lifeastro-mcp",
      "env": {
        "LIFEASTRO_API_KEY": "dv_live_..."
      }
    }
  }
}
OpenAI Codex CLI
File: ~/.codex/config.toml
[mcp_servers.lifeastro]
command = "/opt/homebrew/bin/lifeastro-mcp"
env = { LIFEASTRO_API_KEY = "dv_live_..." }
Continue.dev
File: ~/.continue/config.json
{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "/opt/homebrew/bin/lifeastro-mcp",
          "env": {
            "LIFEASTRO_API_KEY": "dv_live_..."
          }
        }
      }
    ]
  }
}

Windsurf and other MCP-aware clients use the same command + env shape — just change the config file location. Binary path hints: /opt/homebrew/bin/lifeastro-mcp (Homebrew on Apple Silicon), /usr/local/bin/lifeastro-mcp (Homebrew on Intel Mac), ~/go/bin/lifeastro-mcp (Go install). Always confirm with which lifeastro-mcp.

Restart and try a question

Fully quit and reopen your AI client (in Claude Desktop: ⌘Q, then reopen — a simple window close doesn't reload MCP servers). You should see a tools indicator at the bottom of the chat window. Try one of these prompts:
Try this

“What's today's Rahu Kaal for Mumbai?”

Should call panchang_rahu_kaal
Try this

“Calculate my Vimshottari dasha. Birth: 12 March 1992, 6:45 AM, Pune.”

Should call dasha_current
Try this

“Compute the synastry score between these two charts: …”

Should call western_synastry_score

If the AI says it doesn't have access to astrology tools, or the tools indicator is missing, see Troubleshooting below.

310 tools in v0.11.0.

All calculation endpoints of the 311-endpoint REST API are exposed as tools, grouped by domain below; two informational endpoints (the API version and the narrative reference index) are excluded. A few tools are convenience variants of one endpoint, such as the separate Vimshottari dasha levels, which is why the totals are 310 and 311.

Panchang (29)

panchang_abhijit/v1/panchang/abhijit

Get the Abhijit muhurta window for a date and location — the auspicious 48-minute period around solar noon, considered one of the most powerful muhurtas for new beginnings (except Wednesdays when it is weak). Returns start and end timestamps.

panchang_advanced/v1/panchang/advanced

Get the complete advanced panchang — everything in basic plus: all muhurta windows (Rahu Kaal, Yamaganda, Gulika, Abhijit, Brahma Muhurat, Durmuhurta), Varjyam, Amrit Kalam, full 16-slot Choghadiya (day + night), Hindu month with Amanta/Purnimanta, Vikram Samvat + Samvatsara name, Ritu (season), Ayana, Sun/Moon sign, Disha Shool, Nak Shool, Moon Nivas, active Panchang Yogas (Amrit Siddhi etc.), and same-day element transitions (next tithi if it changes today). Best single call for muhurta apps.

panchang_amrit_kalam/v1/panchang/amrit-kalam

Get the Amrit Kalam window for a date and location — an auspicious 1h36m period within the current nakshatra, considered especially beneficial for starting important activities and medical treatments. The counterpart to Varjyam within the same nakshatra. Returns start/end timestamps.

panchang_basic/v1/panchang/basic

Get the complete basic panchang for any date and location in one call: tithi (with deity, type, end-time), nakshatra (with ruling planet, deity, gana, end-time), yoga (with auspiciousness), karana (2 slots with deity and special note), vara (weekday + lord), sunrise, sunset, moonrise, moonset. Replaces 7 separate atomic calls.

panchang_brahma_muhurat/v1/panchang/brahma-muhurat

Get the Brahma Muhurat window — the 96-minute span before sunrise considered most auspicious for sadhana, study, and meditation. Returns start/end timestamps.

panchang_choghadiya/v1/panchang/choghadiya

Get the day's Choghadiya muhurta windows — Amrit, Shubh, Labh (auspicious) and Rog, Kaal, Udveg (inauspicious). Returns 8 day-time + 8 night-time windows with start/end.

panchang_durmuhurta/v1/panchang/durmuhurta

Get the Durmuhurta windows for a date and location — two inauspicious 48-minute periods in the day determined by the weekday (different for each vara). Starting anything important during Durmuhurta is avoided. Returns start/end timestamps for all Durmuhurta windows of the day.

panchang_gulika/v1/panchang/gulika

Get the Gulika Kaal muhurta window for a date and location — a daily inauspicious period associated with Saturn's son Gulika (Mandi). Considered inauspicious for starting new ventures. Returns start and end timestamps.

panchang_hindu_month/v1/panchang/hindu-month

Get the current Hindu lunar month details for a date — returns Purnimanta and Amanta month name (Chaitra/Vaishakha/…), paksha (Shukla/Krishna), Vikram Samvat, Shaka Samvat, and whether it is an Adhik (intercalary) month.

panchang_hora/v1/panchang/hora

Get the planetary hora (planet-hour) schedule for a date — each hour ruled by Sun/Moon/Mars/Mercury/Jupiter/Venus/Saturn in the classical sequence.

panchang_hora_dinman/v1/panchang/hora-dinman

Get the Dinman (day length) and Ratriман (night length) for a date — the exact duration of daytime from sunrise to sunset and nighttime from sunset to next sunrise, in ghatis (1 ghati = 24 minutes). Used in muhurta calculations.

panchang_karana/v1/panchang/karana

Get the panchang karana for a date and location — one of the 11 karanas (half-tithis): Bava, Balava, Kaulava, Taitila, Gara, Vanija, Vishti (Bhadra), Shakuni, Chatushpada, Naga, Kimstughna. Vishti/Bhadra karana is inauspicious for starting activities.

panchang_lagna_table/v1/panchang/lagna-table

Get the lagna (ascendant sign) table for a day — shows when each of the 12 zodiac signs rises on the eastern horizon with precise start/end times. Each lagna lasts roughly 1.5–2.5 hours. Used for muhurta selection (choosing an auspicious rising sign for an event).

panchang_monthly/v1/panchang/monthly

Get a full month panchang calendar — one entry per day with vara, tithi, nakshatra, yoga, sunrise, sunset; with include=sheet also the tithi/nakshatra/moon-sign end-times, moonrise/moonset, Hindu month, Vikram samvat and every festival of each day — a complete printable Hindu calendar page.

panchang_moonrise_moonset/v1/panchang/moonrise-moonset

Get the moonrise and moonset times for a date and location — returns timestamps for when the Moon rises and sets, its current phase, and nakshatra.

panchang_nakshatra/v1/panchang/nakshatra

Get the Moon's nakshatra (lunar mansion) for a date and location — returns the current nakshatra name, pada, ruling planet, start/end timestamps, and the next nakshatra.

panchang_nakshatra_prediction/v1/panchang/nakshatra-prediction

Get a personalised daily prediction based on Tara Bala — the position of today's Moon nakshatra relative to your birth nakshatra. Returns: today's Moon nakshatra, tara type (Janma/Sampat/Vipat/Kshema/Pratyak/Sadhana/Vadha/Mitra/Param-Mitra), auspiciousness score, and specific guidance for health, work, relationships, finance, and travel.

panchang_panchaka/v1/panchang/panchaka

Check if the current time is in Panchaka — the inauspicious period when the Moon transits Aquarius or Pisces (creates obstacles for travel, construction, funerals, and starting new activities). Returns whether Panchaka is active, which of the 5 types it is (Roga/Mrityu/Agni/Raja/Chora), and the end time.

panchang_pradosh_kaal/v1/panchang/pradosh-kaal

Get the Pradosh Kaal window for a date and location — the auspicious 1.5-hour twilight period after sunset especially sacred to Lord Shiva. Falls on Trayodashi tithi (13th lunar day). Returns the window timestamps and whether it is Pradosh Vrat day.

panchang_rahu_kaal/v1/panchang/rahu-kaal

Get today's Rahu Kaal window — the inauspicious 90-minute span avoided for new ventures. Returns start/end timestamps in the observer's timezone.

panchang_sankranti/v1/panchang/sankranti

Find the next solar Sankranti (the Sun's entry into a sidereal sign) on or after a date — returns the sign entered, the exact local and UTC moment, and flags for Makar Sankranti and Mesha Sankranti (solar new year). Defaults to today; call again with a later date to walk through the year.

panchang_siddha_yoga/v1/panchang/siddha-yoga

Check if the current date has Siddha Yoga — an auspicious panchang yoga formed by specific vara+nakshatra combinations (e.g. Sunday+Hasta, Monday+Mrigashira, Saturday+Rohini, etc.). Siddha Yoga is highly auspicious for starting new ventures and ceremonies. Returns whether it is active and which vara-nakshatra pair created it.

panchang_sunrise_sunset/v1/panchang/sunrise-sunset

Get the precise sunrise and sunset times for a date and location — returns solar event timestamps, duration of daylight, and the nakshatra/tithi at sunrise.

panchang_tithi/v1/panchang/tithi

Get the lunar day (tithi) for a date and location — Krishna/Shukla paksha, tithi name (Pratipada/Dwitiya/.../Amavasya/Purnima), and end-of-tithi timestamp.

panchang_today/v1/panchang/summary

Get the Hindu daily panchang for a location: tithi (lunar day), vara (weekday), nakshatra (lunar mansion), yoga, karana, sunrise/sunset, and Rahu Kaal / Yamaganda / Gulika muhurat windows.

panchang_vara/v1/panchang/vara

Get the Hindu vara (weekday) details for a date — returns the vara name (Ravivara/Somavara/…), its ruling planet, the vara's general auspiciousness for different activities, and the vara lord's strength.

panchang_varjyam/v1/panchang/varjyam

Get the Varjyam window for a date and location — a daily inauspicious 1h36m period within a nakshatra determined by the Moon's position; all activities including travel, medical procedures, and ceremonies are avoided. Returns start/end timestamps.

panchang_yamaganda/v1/panchang/yamaganda

Get the Yamaganda muhurta window for a date and location — a daily inauspicious 90-minute period (varies by weekday) ruled by Yama; activities started during Yamaganda are considered ill-starred. Returns start and end timestamps.

panchang_yoga/v1/panchang/yoga

Get the panchang yoga for a date — one of the 27 yogas (Vishkumbha through Vaidhriti) determined by the combined longitude of Sun and Moon. Some yogas are auspicious (Siddha, Shubha, Amrita) and others inauspicious (Vishkumbha, Atiganda, Vyaghata).

Birth Chart — Vedic (21)

chart_ascendant/v1/chart/ascendant

Compute the rising sign (lagna / ascendant) of a Vedic birth chart. Returns sign, degree, nakshatra and pada.

chart_ashtakavarga/v1/chart/ashtakvarga

Compute the Sarvashtakavarga — the 12-sign benefic-point grid built from each graha's individual Ashtakavarga (BAV). Used for transit timing and house strength analysis.

chart_aspects/v1/chart/aspects

Get all Vedic graha drishti (planetary aspects) on a birth chart — full + special aspects of Mars/Jupiter/Saturn/Rahu/Ketu, plus the 7th-house aspect of every planet.

chart_astro_details/v1/chart/astro-details

Get the complete birth chart snapshot in one call: Avakhada Chakra (Varna, Vashya, Yoni, Gana, Nadi, Paya, Tatva), Ascendant (sign, nakshatra, pada), all 9 planet positions (sign, house, nakshatra, retrograde), Sun sign, Moon sign, and complete birth panchang (tithi with deity + type, nakshatra with lord + deity, yoga, vara). Replaces 4–5 separate calls.

chart_avakhada/v1/chart/avakhada

Get the Avakhada Chakra — the traditional 8-element birth identity card: varna, vashya, yoni, gana, nadi, paya, and tatva. Used in Vedic naming, marriage matching, and personality analysis.

chart_bhavabala/v1/chart/bhavabala

Compute Bhava Bala — the six-component strength of each of the 12 houses: Bhavadhipati Bala (lord strength), Bhava Digbala, Bhava Drishti Bala, and more. Identifies which houses are strong/weak in the chart.

chart_combustion/v1/chart/combustion

Check which planets are combust (too close to the Sun) in a birth chart — returns each planet's angular distance from Sun, whether it is combust by classical limits, and combust severity.

chart_dignity/v1/chart/dignity

Get classical dignity status of all 9 grahas in a birth chart — exalted, debilitated, mool trikona, own sign, friend's house, neutral, enemy's, or great enemy's.

chart_divisional

Compute any divisional chart (varga) from D1 to D60 — for marriage (D9), career (D10), children (D7), wealth (D2), parents (D12), misfortunes (D30), and the rest of the classical 16. Returns divisional lagna and each planet's divisional sign + house. Use 'chart_navamsa' for the dedicated D9 entry point if a separate marriage tool is needed; this is the general-purpose varga endpoint.

chart_ghatak/v1/chart/ghatak

Get the Ghatak Chakra (inauspicious indicators) for a birth chart — identifies the inauspicious weekday, tithi, nakshatra, lagna, and month specific to this chart's Moon sign. These are the conditions most harmful to the native and should be avoided for muhurta.

chart_graha_yuddha/v1/chart/graha-yuddha

Identify Graha Yuddha (planetary war) in a birth chart — occurs when two visible planets are within 1° of each other. Returns the warring pair, winner (the planet with higher ecliptic latitude), loser, and degrees of separation.

chart_house_occupants/v1/chart/house-occupants

List all planets occupying each of the 12 houses in a birth chart — a house-indexed view of the chart (vs planet-indexed from chart_planets).

chart_houses/v1/chart/houses

Get the 12 house cusps of a Vedic birth chart — sign on each house, lord, and degrees. Whole-sign houses by default.

chart_kp_house_significator/v1/chart/kp-house-significator

Get KP (Krishnamurti Paddhati) house significators for a given cusp — lists planets that significate the house through occupancy, lordship, and sub-lord chain. Used in KP astrology for event timing and prediction.

chart_kp_sublord/v1/chart/kp-sublord

Get the KP sublord of a planet — the sub-lord of the nakshatra sub-division the planet occupies (KP star lord → sub lord → sub-sub lord chain). Central to KP timing.

chart_nakshatra/v1/chart/nakshatra

Get the birth (Janma) nakshatra and pada — the lunar mansion the Moon was in at birth, used for naming, muhurta, and Vimshottari dasha. Returns nakshatra name (English + Devanagari), pada (1-4), and ruling planet.

chart_navamsa/v1/chart/divisional/D9

Compute the Navamsa (D9) divisional chart, used in Vedic astrology for marriage, dharma, and the inner spouse. Returns Navamsa lagna and each planet's Navamsa sign + house.

chart_planets/v1/chart/planets

Compute the placement of all 9 grahas (Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu) in a Vedic birth chart: sign, degree, nakshatra, house, retrograde flag. Use whenever someone asks 'where is my Saturn', 'what's my Moon sign', or wants the full birth chart.

chart_shadbala/v1/chart/shadbala

Compute Shadbala — the six-fold strength of each graha (sthana / dig / kala / chesta / naisargika / drik bala) plus the total. Identifies the strongest and weakest planets in the chart.

chart_shadbala_component/v1/chart/shadbala/

Get a specific Shadbala component for all planets — one of the 6 strength types: sthana bala (positional), dig bala (directional), kala bala (temporal), cheshta bala (motional/retrogression), naisargika bala (natural), drik bala (aspectual). Use when you need to understand why a planet is strong or weak in a specific dimension.

chart_single_planet/v1/chart/planet/

Get the detailed placement of a single planet in a Vedic birth chart — sign, degree, nakshatra, pada, house, speed, retrograde flag, dignity, and aspects received. More concise than chart_planets when you only need one graha.

Ashtakavarga (4)

ashtakavarga_bhinna/v1/ashtakavarga/bhinna/

Get the Bhinna (individual planet) Ashtakavarga table for one planet — the 12-sign grid showing how many of the 8 reference points (7 planets + lagna) contribute benefic points to each sign for that planet's transit. Max 8 per sign.

ashtakavarga_kaksha/v1/ashtakavarga/kaksha

Get Kaksha (sub-division) level Ashtakavarga analysis — divides each sign into 8 equal 3°45′ segments, each ruled by a graha. Used for precise transit timing within a sign.

ashtakavarga_sarva/v1/ashtakavarga/sarva

Get the Sarvashtakavarga table — the combined 12-sign benefic-point grid from all 9 grahas. Each sign shows total benefic points (max 56). High-scoring signs indicate strong houses for transit timing.

ashtakavarga_transit_score/v1/ashtakavarga/transit-score

Score current (or a given date's) planetary transits against a natal chart using Ashtakavarga benefic points. Returns a score per transiting planet indicating how favourable the transit is for that natal chart.

Dasha Systems (14)

dasha_char_antardashas/v1/dasha/char/

Drill into one Char Dasha (Jaimini) mahadasha sign and list its antardasha sub-periods with dates.

dasha_char_current/v1/dasha/char/current

Get the currently running Char Dasha (Jaimini) period stack for a birth chart — the active mahadasha sign and antardasha sign with their date windows.

dasha_char_full/v1/dasha/char

Get the full Char Dasha (Jaimini sign-based dasha) schedule for a birth chart — every mahadasha sign period with start/end dates across the full cycle.

dasha_char_major/v1/dasha/char/major

Get the Char Dasha (Jaimini) mahadasha-level periods only — one row per sign period with start/end dates. Lighter than dasha_char_full.

dasha_char_pratyantardashas/v1/dasha/char/

Drill into a specific Char Dasha (Jaimini) mahadasha + antardasha pair and list the next-level sub-periods with dates.

dasha_current/v1/dasha/vimshottari/current

Get the currently running 5-level Vimshottari Mahadasha / Antardasha / Pratyantardasha / Sookshma / Prana stack for a birth chart.

dasha_vimshottari_antardasha/v1/dasha/vimshottari/

Get all Pratyantardasha sub-sub-periods within a specific Vimshottari Mahadasha + Antardasha combination.

dasha_vimshottari_full/v1/dasha/vimshottari

Get the full 120-year Vimshottari Mahadasha sequence anchored at birth — all 9 lords, with start/end dates and durations.

dasha_vimshottari_mahadasha/v1/dasha/vimshottari/

Get all Antardasha sub-periods within a specific Vimshottari Mahadasha — returns the 9 antardasha periods (with start/end dates) nested under the requested mahadasha lord. Use when you want 'all antardasha periods inside my Saturn mahadasha', 'sub-periods in Jupiter dasha', 'when does Rahu-Sun antardasha start in my Rahu mahadasha'.

dasha_vimshottari_pratyantardasha/v1/dasha/vimshottari/

Get all Sookshma sub-sub-sub-periods within a specific 3-level Vimshottari combination (Maha + Antar + Pratyantar).

dasha_vimshottari_sookshma/v1/dasha/vimshottari/

Get all Prana (5th level) sub-sub-sub-sub-periods within a specific 4-level Vimshottari combination. The finest dasha granularity — each Prana period spans a few days.

dasha_yogini_by_name/v1/dasha/yogini/

Get the Yogini Dasha sub-periods for a specific Yogini lord — when does a particular Yogini period (Mangala, Pingala, Dhanya, Bhramari, Bhadrika, Ulka, Siddha, or Sankata) run and what are its sub-periods.

dasha_yogini_current/v1/dasha/yogini/current

Get the currently-running Yogini Mahadasha — the 8-period (36-year cycle) secondary system used alongside Vimshottari for cross-validation. Returns the active Yogini lord with start/end.

dasha_yogini_full/v1/dasha/yogini

Get the full Yogini Dasha sequence for a birth chart — all 8 Yogini lords (Mangala, Pingala, Dhanya, Bhramari, Bhadrika, Ulka, Siddha, Sankata) with start/end dates across 36 years.

Matchmaking (Milan) (9)

milan_ashtakoota_single/v1/milan/ashtakoota/

Get the score and detailed explanation for a single Ashtakoota koota — one of: varna, vashya, tara, yoni, graha_maitri, gana, bhakoot, or nadi. Returns the score for that koota with the classical reasoning.

milan_dasha_sync/v1/milan/dasha-sync

Check Dasha synchrony between two partners — are they running compatible mahadasha lords at the same time? Good dasha synchrony indicates the couple will flourish together during major life events.

milan_dhan_yog/v1/milan/dhan-yog

Check Dhan Yog (wealth yoga) for a single person's chart — assesses 2nd/11th house lord strength and Jupiter placement for prosperity.

milan_longevity/v1/milan/longevity

Assess longevity for a single person's chart — classical analysis of lagna, 8th house, and Moon sign longevity indicators.

milan_mahendra/v1/milan/mahendra

Check Mahendra Koota — the 4th additional compatibility factor beyond Ashtakoota. Counts from bride's nakshatra to groom's in multiples of 4, 13, 22 etc. A positive result indicates the groom will protect and provide for the bride.

milan_navamsa_compat/v1/milan/navamsa-compat

Check Navamsa compatibility — compares the D9 (Navamsa) chart placements of both partners for deeper marriage harmony beyond the D1 chart. Assesses 7th house navamsa lord synergy and mutual aspect in the navamsa.

milan_santan_yog/v1/milan/santan-yog

Check Santan Yog for a single person's chart — assesses 5th house lord and Jupiter placement to indicate prospects for children.

milan_shani_dosha/v1/milan/shani-dosha

Check Shani Dosha for a single person's chart — Saturn in 1st, 4th, 7th, 10th, or 12th house from lagna. Returns dosha presence, which house, and cancellation rules.

milan_stree_dirgha/v1/milan/stree-dirgha

Check Stree Dirgha — the distance from bride's nakshatra to groom's must be more than 9 nakshatras for a beneficial match (indicates the groom will lead a longer, more prosperous life than the bride expected).

Muhurta (11)

muhurta_best_time/v1/muhurta/best-time

Find the highest-scoring muhurta window across a date range using a balanced scoring of tithi, nakshatra, vara, choghadiya, and Rahu Kaal exclusion. General-purpose 'when is the best time' query when no specific ceremony type applies.

muhurta_chandra_bala/v1/muhurta/chandra-bala

Compute Chandra Bala — the Moon's strength relative to a person's natal Moon sign on a given date. Score 1–6 based on the Moon's position (1st=Janma, 2nd=Sampat, etc.). Used for personal muhurta selection.

muhurta_graha_pravesh/v1/muhurta/graha-pravesh

Score how auspicious a specific date (and optional time) is for a housewarming (griha pravesh) at a location — returns a 0-100 score, a grade, and the factor breakdown. Evaluates ONE date per call; to search a range use muhurta_best_time.

muhurta_naamkaran/v1/muhurta/naamkaran

Score how auspicious a specific date (and optional time) is for a baby's naming ceremony (naamkaran), given the child's birth date — returns a 0-100 score, a grade, days since birth, and the factor breakdown. Evaluates ONE date per call; to search a range use muhurta_best_time.

muhurta_panchaka_rahita/v1/muhurta/panchaka-rahita

Check whether a specific date (and optional time) is free of Panchaka dosha (panchaka rahita) — the classical test applied before any important undertaking. Evaluates ONE date per call.

muhurta_sarvartha_siddhi/v1/muhurta/sarvartha-siddhi

Check whether Sarvartha Siddhi Yoga (the weekday-nakshatra combination considered auspicious for all purposes) is present on a specific date. Evaluates ONE date per call.

muhurta_shubha_yoga/v1/muhurta/shubha-yoga

List the auspicious yogas (Amrit Siddhi, Ravi Pushya, Guru Pushya, Dwipushkar, Tripushkar and similar) present on a specific date. Evaluates ONE date per call.

muhurta_tara_bala/v1/muhurta/tara-bala

Compute Tara Bala score for a given date relative to a person's birth nakshatra — rates the day's Moon nakshatra as Janma/Sampat/Vipat/Kshema/Pratyak/Sadhana/Vadha/Mitra/Param-Mitra. Used for personalized muhurta selection.

muhurta_vivah/v1/muhurta/vivah

Score how auspicious a specific date (and optional time) is for a wedding (vivah) at a location — returns a 0-100 score, a grade, and the factor-by-factor breakdown (tithi, vara, nakshatra, Sun sign, Guru/Shukra strength, Rahu Kaal). Evaluates ONE date per call; to search a date range for the best wedding dates use muhurta_best_time with purpose=vivah.

muhurta_vyapar/v1/muhurta/vyapar

Score how auspicious a specific date (and optional time) is for starting a business or opening a shop (vyapar) at a location — returns a 0-100 score, a grade, and the factor breakdown. Evaluates ONE date per call; to search a range use muhurta_best_time.

muhurta_yatra/v1/muhurta/yatra

Score how auspicious a specific date (and optional time) is for starting a journey (yatra) from a location — returns a 0-100 score, a grade, and the factor breakdown including disha shool. Evaluates ONE date per call.

Transits, Sade Sati & Eclipses (11)

eclipses_all/v1/eclipses/all

Get all eclipses (solar and lunar) in a date range — type, peak time, nakshatra; with lat/lon also the local contact times (sparsha, madhya, moksha), visibility at that place and the sutak kaal, exactly as a printed panchang shows for a grahan.

eclipses_lunar/v1/eclipses/lunar

List lunar eclipses in a date range — returns peak time (UT), magnitude, type (total / partial / penumbral), and visibility. Optional lat/lon filters to eclipses visible from that location.

eclipses_solar/v1/eclipses/solar

List solar eclipses in a date range — returns peak time (UT), magnitude, type (total / annular / partial / hybrid), and visibility path. Optional lat/lon filters to eclipses visible from that location.

sade_sati/v1/transit/sade-sati

Determine whether a person is currently in Saturn's Sade Sati (the 7.5-year transit through the 12th, 1st, and 2nd house from natal Moon) and list past + upcoming Sade Sati windows.

transit_ashtakavarga/v1/transit/ashtakavarga

Score current planetary transits against a natal chart using Ashtakavarga — shows which houses transiting planets are moving through and how many benefic points those signs have in the natal chart. High-point transits are favourable; low-point are challenging.

transit_double_transit/v1/transit/double-transit

Compute Double Transit (Jupiter-Saturn-Rahu joint transit) analysis — the classical technique where an event manifests only when Jupiter AND Saturn both transit houses connected to a natal significator simultaneously. Used for timing major life events (marriage, career change, relocation).

transit_small_panoti/v1/transit/small-panoti

Check whether a person is currently in Small Panoti (Ashtama Shani) — the 2.5-year Saturn transit through the 8th house from natal Moon, considered challenging. Returns status, start/end dates, and intensity.

transit_small_panoti_history/v1/transit/small-panoti/history

Get the complete history and future windows of Small Panoti (Ashtama Shani) for a natal chart — all past and upcoming 2.5-year periods when Saturn transits the 8th house from natal Moon.

transit_tarabala/v1/transit/tarabala

Compute Tara Bala for today's transiting Moon relative to a natal chart — rates the day as Janma/Sampat/Vipat/Kshema/Pratyak/Sadhana/Vadha/Mitra/Param-Mitra tara. Used to personalize daily muhurta.

transit_vedha/v1/transit/vedha

Check Vedha (transit obstruction) for a natal chart — certain house transits are blocked (vedha'd) by another planet transiting a specific opposing house simultaneously. Returns which transits are obstructed by Vedha right now.

transits_now/v1/transit/positions

Get the current sidereal positions of all 9 grahas — the live sky positions used to evaluate current transits, gochar effects, and dasha-transit interplay. Returns each planet's sign, degree, nakshatra, and retrograde flag at the requested moment.

Hindu Calendar & Festivals (6)

calendar_adhik_maas/v1/calendar/adhik-maas

Find the Adhik Maas (intercalary/leap month) in a given year — the extra lunar month inserted to sync the Hindu lunar calendar with the solar year. Returns the month name, start date, and end date. Adhik Maas occurs roughly every 2.5–3 years.

calendar_month/v1/calendar/month

Get the Hindu lunar-calendar details for a Gregorian date — the Hindu month (Chaitra, Vaishakha, …) in both Amanta and Purnimanta reckoning, paksha (Shukla/Krishna), tithi number within the month, adhik/kshaya flags, Vikram and Shaka Samvat years, ritu and ayana. One date per call; defaults to today.

calendar_ritu/v1/calendar/ritu

Get the current Hindu Ritu (season) for a date — one of 6 seasons: Vasanta (spring), Grishma (summer), Varsha (monsoon), Sharad (autumn), Hemanta (pre-winter), Shishira (winter). Each Ritu spans 2 solar months.

calendar_solstices/v1/calendar/solstices

Get the equinoxes and solstices of a year — exact moment in local time, which ayana begins (tropical Dakshinayana in June, tropical Uttarayana in December, with the note that the panchang's Uttarayana is Makara Sankranti), and sunrise/sunset/day length at a location.

calendar_samvatsara/v1/calendar/samvatsara

Get the Samvatsara (Jupiter-cycle year name) in effect on a date — the 60-year cycle used in Hindu astrology (Prabhava, Vibhava, Shukla, … Akshaya), with the Vikram and Shaka Samvat years. Defaults to today.

festivals_month/v1/festivals/month

Full Hindu festival calendar for a month at a location — every Ekadashi (smarta/Vaishnava), Pradosh, Sankashti, Purnima, Amavasya, Sankranti, major and regional festivals, jayantis and eclipses, with location-correct dates (verified entry for entry against printed panchang calendars of 14 cities).

festivals_on_date/v1/festivals/on-date

List Hindu festivals and observances falling on a specific date — Ekadashi, Pradosh, Purnima, Amavasya, major festivals, vratas, and regional observances.

festivals_vrat/v1/festivals/vrat

Year-wise Vrat & Upavas lists — every Ekadashi (smarta + Vaishnava, with parana), Pradosh, Sankashti, Purnima, Amavasya, Shraddha (16 Pitru Paksha tithis), Janmashtami (Smarta/ISKCON), Masik Shivaratri, Durgashtami, Kalashtami, Skanda Shashthi, Karthigai, Satyanarayana Puja, Sankranti or eclipse of a year at a location.

Varshaphal (Annual) (7)

varshaphal_chart/v1/varshaphal/chart

Compute the Varshaphal (annual solar-return) chart for a given year — Varsha Lagna, muntha placement, and the year-ruler (Varsha Lord). Foundation for any annual prediction.

varshaphal_harsha_bala/v1/varshaphal/harsha-bala

Compute Tajika Harsha Bala (planetary strength) for the annual solar-return chart. Returns five components per planet: Stana Bala (positional), Uchcha Bala (exaltation proximity), Ooja-Yugma Bala (gender), Kendradi Bala (angular/succedent/cadent), and Drekkana Bala (decanate). Higher total = stronger planet in the annual chart.

varshaphal_lord/v1/varshaphal/lord

Get the Varsha Lord (year ruler) for an annual chart — the planet that rules the Varshaphal year based on the Tajika system. The Varsha Lord strongly influences the themes of the solar-return year.

varshaphal_mudda_dasha/v1/varshaphal/mudda-dasha

Compute the Varshaphal Mudda Dasha (annual dasha) periods for the solar-return year. The 9 planets each rule a fixed number of days (Sun=11, Moon=24, Mars=6, Mercury=34, Jupiter=48, Venus=20, Saturn=19, Rahu=12, Ketu=6); the sequence starts from the Varsha Lord. Returns 18 periods covering the full year (2 cycles of 180 days each).

varshaphal_muntha/v1/varshaphal/muntha

Get Muntha placement for a Varshaphal year — Muntha moves one sign per year from birth lagna and its house position in the annual chart is a key indicator of the year's themes. Muntha in 1st/5th/9th/10th is favourable; 6th/8th/12th is challenging.

varshaphal_solar_return_jd/v1/varshaphal/solar-return-jd

Get the precise Julian Day (JD) and calendar datetime of the solar return for a given year — the exact moment the Sun returns to its natal longitude. This is the true astrological birthday and the foundation of all Varshaphal calculations.

varshaphal_yoga/v1/varshaphal/yoga

Get Tajika Yogas in the Varshaphal annual chart — Ikkaval, Induvara, Ithasala, Ishrafa, Nakta, Yamaya, Manau, Khallasara, Duphali-Kuttha, and other Tajika aspect-based yogas that indicate the tone of the solar-return year.

Prashna (Horary) (5)

prashna_answer/v1/prashna/answer

Cast a Prashna (horary) chart for the moment a question is asked and compute the classical yes/no/uncertain verdict for it. You must map the question to the house that signifies its subject (e.g. 10 for a job, 7 for marriage, 2 for money, 4 for property). Defaults to the current moment.

prashna_arudha/v1/prashna/arudha

Compute the Arudha Lagna of a Prashna chart — the perceived image/manifestation of the question's subject. Used in KP and Jaimini Prashna for nuanced prediction beyond the basic yes/no.

prashna_chart/v1/prashna/chart

Cast the full Prashna (horary) chart for the moment a question is asked — returns lagna, all planet placements, houses, and panchang at the moment of the question. Use when you need the complete chart data for detailed horary analysis, not just the yes/no answer.

prashna_lagna_lord/v1/prashna/lagna-lord

Get the lagna lord analysis for a Prashna chart — where the lagna lord is placed, its strength, and what it indicates about the querent's situation and chances of success.

prashna_significators/v1/prashna/significators

Get the KP significators for a Prashna chart — lists planets significating the houses relevant to the question (e.g. houses 2, 6, 10, 11 for job questions). Used for KP horary timing and prediction.

Numerology (9)

numerology_advanced/v1/numerology/advanced

Compute the advanced Vedic numerology profile from a name (and optionally DOB): Maturity Number (life purpose emerging after 40), Karmic Lessons (missing digits = undeveloped qualities), Sub-conscious Self (9 minus karmic lessons), Hidden Passion (dominant talent), and Balance Number (crisis response quality).

numerology_challenges/v1/numerology/challenges

Compute the four Vedic Challenge Numbers from a birth date — the life obstacles and developmental lessons to be mastered in different life stages (CH1 early life, CH2 middle life, CH3 major challenge, CH4 later life).

numerology_conductor/v1/numerology/conductor

Compute the Bhagyank / Conductor number — derived from the full date of birth (DD+MM+YYYY reduced to a single digit). The Conductor governs destiny, life path, and fortune.

numerology_destiny/v1/numerology/destiny

Compute the Destiny number — derived from all letters of the full name (vowels + consonants). Represents life purpose, talents, and the path you are meant to fulfil.

numerology_driver/v1/numerology/driver

Compute the Mulank / Driver number — the single-digit number derived from the day of birth (1–31, reduced to 1–9, preserving 11/22/33). The Driver represents personality, instinct, and primary nature.

numerology_full/v1/numerology/full

Compute the 5 core Vedic numerology numbers — Driver (Mulank, from DOB day), Conductor (Bhagyank, from full DOB), Soul (Soul-Urge, from name vowels), Personality (from name consonants), and Destiny (from full name). Master numbers 11/22/33 are preserved (not reduced). Returns lucky factors per number.

numerology_personal_periods/v1/numerology/personal-periods

Compute the Personal Year, Personal Month, and Personal Day numbers for any date — the time-transiting layer of Vedic numerology that shows the numerological climate for a specific period. Each number comes with lucky factors (planet, day, color, gemstone).

numerology_personality/v1/numerology/personality

Compute the Personality number — derived from the consonants of the full name. Represents the outer personality, how others perceive you, and the mask you present to the world.

numerology_soul/v1/numerology/soul

Compute the Soul Urge number — derived from the vowels of the full name. Reveals inner motivation, deepest desires, and what truly drives a person at soul level.

Lal Kitab (3)

lalkitab_chart/v1/lalkitab/chart

Get the Lal Kitab chart for a birth — planets mapped into Lal Kitab's fixed Aries-based houses, with per-planet house placements used by Lal Kitab remedies.

lalkitab_dasha/v1/lalkitab/dasha

Get the full 35-year Lal Kitab dasha schedule for a birth — the planet-ruled periods unique to the Lal Kitab system with start/end dates.

lalkitab_dasha_current/v1/lalkitab/dasha/current

Get the currently active Lal Kitab dasha planet and period window for a birth chart.

Remedies (9)

remedy_by_rule_id/v1/vedic/remedies/

Get the remedy associated with a specific astrological rule ID — returns the complete remedy package (mantras, poojas, vratas, gemstone, yantra, color, number) for a rule that has a remedy attached. Use when you have a specific rule ID and want its remedy.

remedy_daan_by_id/v1/vedic/remedies/daan/

Get the full details of a specific daan (charity/donation) remedy by ID — what to donate, to whom, on which day/nakshatra, and the planetary affliction it addresses.

remedy_lalkitab_for_placement/v1/vedic/remedies/lal-kitab/

Get the Lal Kitab remedies for a specific planet-in-house placement (e.g. Saturn in house 8) — the exact upay Lal Kitab prescribes for that placement. Combine with lalkitab_chart to find placements first.

remedy_lalkitab_list/v1/vedic/remedies/lal-kitab

List Lal Kitab remedies — the simple, household-item upay (remedies) Lal Kitab is famous for, optionally filtered by planet.

remedy_mantra_by_id/v1/vedic/remedies/mantra/

Get the full details of a specific mantra remedy by ID — Sanskrit text, transliteration, meaning, recitation count, timing (day/nakshatra), and deity.

remedy_pooja_by_id/v1/vedic/remedies/pooja/

Get the full details of a specific pooja (ritual worship) remedy by ID — puja name, deity, procedure summary, recommended day/nakshatra, materials needed, and expected benefit.

remedy_rudraksha_by_id/v1/vedic/remedies/rudraksha/

Get the full details of a specific rudraksha remedy by ID — mukhi count, ruling planet, wearing procedure, day and mantra for energization.

remedy_vrat_by_id/v1/vedic/remedies/vrat/

Get the full details of a specific vrat (fasting/observance) remedy by ID — vrat name, deity, day of observance, procedure, food restrictions, duration, and expected benefit.

remedy_yantra_by_id/v1/vedic/remedies/yantra/

Get the full details of a specific yantra remedy by ID — the yantra's purpose, installation procedure, direction, day, and associated mantra.

Narrative Interpretations (10+ languages) (36)

narrative_career_outlook/v1/vedic/narrative/career-outlook

Get a multi-paragraph career and profession narrative for a Vedic birth chart — analyses the 10th house lord, planets in the 10th, D10 chart, and dashas to describe career strengths, suitable professions, and current period's impact on work.

narrative_dasha_phal/v1/vedic/narrative/dasha-phal

Get the Dasha Phal (period interpretation) narrative for the currently running Vimshottari Mahadasha + Antardasha combination — a human-readable explanation of what this dasha pair typically brings and how it interacts with the natal chart.

narrative_dasha_tree_phal/v1/vedic/narrative/dasha-tree-phal

Get narrative interpretations for a specific dasha combination — pass mahadasha lord (and optionally antardasha lord) to get the meaning of that specific period for the natal chart. Useful for asking about a future dasha period.

narrative_divisional/v1/vedic/narrative/divisional/

Get a narrative interpretation of a specific divisional (varga) chart — a written analysis of the lagna, key planet placements, and the life area governed by that divisional chart (e.g. D10 for career, D7 for children, D9 for marriage).

narrative_dosha_by_id/v1/vedic/narrative/dosha/

Get a narrative interpretation of a specific dosha in a birth chart — whether it is present, its severity, classical cancellation conditions that apply, its effects on the native's life, and remedial suggestions.

narrative_doshas/v1/vedic/narrative/doshas

Get the Doshas narrative for a birth chart — comprehensive analysis of all major afflictions (Mangal Dosha, Kaal Sarp Dosha, Pitru Dosha, Shrapit Dosha, Guru Chandal Yoga, Grahan Yoga) with presence, severity, cancellations, and remedial guidance.

narrative_finance_outlook/v1/vedic/narrative/finance-outlook

Get a finance and wealth narrative for a Vedic birth chart — analyses the 2nd and 11th house lords, Jupiter, Venus, and wealth yogas to describe financial strengths, challenges, and periods of prosperity.

narrative_horoscope_daily_by_lagna/v1/vedic/narrative/horoscope/daily-by-lagna

Get a personalised daily horoscope narrative computed from the rising sign (lagna) of a birth chart — more precise than generic Moon-sign horoscopes since it uses the exact birth data.

narrative_horoscope_daily_by_moon/v1/vedic/narrative/horoscope/daily-by-moon

Get a personalised daily horoscope narrative computed from the natal Moon sign with full transit context — richer than a generic rashifal because it uses the birth chart's Moon degree and current transit aspects.

narrative_horoscope_daily_tamil/v1/vedic/narrative/horoscope/daily-tamil

Get a daily horoscope in Tamil astrology style — uses the Tamil rashi system and traditional Tamil Panchangam for the day's reading.

narrative_horoscope_weekly_by_lagna/v1/vedic/narrative/horoscope/weekly-by-lagna

Get a personalised weekly horoscope narrative computed from the birth chart's rising sign (lagna) — personalised 7-day outlook with major transit themes.

narrative_horoscope_weekly_by_moon/v1/vedic/narrative/horoscope/weekly-by-moon

Get a personalised weekly horoscope narrative computed from the natal Moon sign — personalised weekly reading using the birth chart's Moon degree.

narrative_house_lord/v1/vedic/narrative/house-lord

Get a narrative interpretation of a specific house lord's placement — where the lord of house N is placed in the chart and what it means for the areas of life that house governs.

narrative_house_lords_overview/v1/vedic/narrative/house-lords-overview

Get a comprehensive narrative overview of all 12 house lords' placements in a birth chart — a full bhavesh analysis summarising how each house lord's position shapes the chart.

narrative_karakas/v1/vedic/narrative/karakas

Get the Jaimini Chara Karakas for a birth chart — the 8 karaka planets (Atmakaraka, Amatyakaraka, Bhratrukaraka, Matrukaraka, Putrakaraka, Gnatikaraka, Darakaraka, Dara/Swamsha) determined by planet degrees, with interpretation.

narrative_lagna/v1/vedic/narrative/lagna

Get a narrative interpretation of the birth chart's lagna (ascendant) — describes the physical appearance, personality, health tendencies, and life approach associated with the rising sign, including first-house planets' influence.

narrative_marriage_outlook/v1/vedic/narrative/marriage-outlook

Get a marriage and relationship narrative for a Vedic birth chart — analyses the 7th house lord, Venus, navamsa, and marriage-timing dashas to describe relationship characteristics, likely spouse traits, and timing of marriage.

narrative_milan/v1/vedic/narrative/milan

Get a narrative compatibility analysis for a couple — goes beyond the numeric Ashtakoota score with a written interpretation of compatibility across all factors (guna milan, mangal dosha, dashas, navamsa).

narrative_moon_sign/v1/vedic/narrative/moon-sign

Get a narrative interpretation of the natal Moon sign (Chandra Rashi) — covers emotional nature, mental tendencies, mother relationship, and instinctive responses associated with the Moon's sign placement.

narrative_nakshatra/v1/vedic/narrative/nakshatra

Get a narrative interpretation of the birth nakshatra (Janma Nakshatra) — covers personality, strengths, weaknesses, compatible nakshatras, ruling deity, symbol, and life path themes of the nakshatra the Moon occupied at birth.

narrative_planet_in_house/v1/vedic/narrative/planet-in-house

Get a narrative interpretation of a specific planet's house placement in a Vedic birth chart — describes what that planet's position in that house means for the native's life areas, including classical significations and any classical yoga formation.

narrative_planet_in_sign/v1/vedic/narrative/planet-in-sign

Get a narrative interpretation of a specific planet's sign placement — describes how the planet expresses itself in that rashi, classical dignity/debility implications, and characteristic traits.

narrative_planets_in_houses/v1/vedic/narrative/planets-in-houses

Get narrative interpretations for ALL planets' house placements in a birth chart in a single call — the full house-placement reading for every graha. Use when you want a comprehensive house-placement analysis rather than one planet at a time.

narrative_planets_in_signs/v1/vedic/narrative/planets-in-signs

Get narrative interpretations for ALL planets' sign placements in a birth chart in a single call — the full sign-placement reading for every graha.

narrative_profile/v1/vedic/narrative/profile

Get a holistic birth chart profile narrative — an executive summary of the entire chart covering lagna, Moon sign, key planetary strengths/weaknesses, dominant yogas, current dasha, and life-theme highlights in a single comprehensive reading.

narrative_sade_sati_history/v1/vedic/narrative/sade-sati-history

Get a narrative of all past and future Sade Sati periods for a birth chart — written descriptions of each 7.5-year Saturn transit cycle with dates, life themes expected, and which phase (rising/peak/setting) the person experienced.

narrative_sade_sati_phase/v1/vedic/narrative/sade-sati-phase

Get a narrative interpretation of the current Sade Sati phase (rising, peak, or setting) — what the current phase typically brings and remedies. Only meaningful when the person is actually in Sade Sati.

narrative_sade_sati_status/v1/vedic/narrative/sade-sati-status

Get the current Sade Sati status with narrative context — whether the person is in Sade Sati, which phase, start/end dates, and a written description of the current transit's meaning for their Moon sign.

narrative_sun_sign/v1/vedic/narrative/sun-sign

Get a narrative interpretation of the natal Sun sign (Surya Rashi) — covers ego, identity, father, authority, vitality, and the life-purpose themes associated with the Sun's sidereal sign placement.

narrative_transit_ashtakavarga/v1/vedic/narrative/transit-ashtakavarga

Get a narrative interpretation of the Ashtakavarga transit scores for a birth chart — written analysis of how current planetary transits score against the natal chart's benefic-point grid, with guidance on which transits are favourable or challenging.

narrative_transit_double/v1/vedic/narrative/transit-double

Get a narrative of the Double Transit analysis — written explanation of which life events the current Jupiter-Saturn joint transit is activating in the chart, and when the confluence is strongest.

narrative_transit_phal/v1/vedic/narrative/transit-phal

Get the Transit Phal (gochar results) narrative — a written analysis of all current major planetary transits over the natal chart, their house positions from Moon, and the classical effects expected from each transit.

narrative_varshaphal_themes/v1/vedic/narrative/varshaphal-themes

Get a narrative of the key themes for the current Varshaphal (solar-return) year — written analysis of the annual chart's varsha lord, muntha, annual lagna, and tajika yogas as a prediction for the year's major themes.

narrative_yearly_bhavishyafal/v1/vedic/narrative/yearly-bhavishyafal

Generate a personalised yearly horoscope (Bhavishyafal) for any year using LifeAstroAPI's 6000+ authored Vedic rules. Returns up to 14 sections: Varshaphal themes (Muntha + Varsha Lord), active Vimshottari dasha at solar return, Sade Sati phase (if applicable), slow-mover transit narratives (Jupiter, Saturn, Rahu/Ketu, Mars), and life-area outlooks (marriage, career, finance). All anchored to the solar return JD — the true astrological new year. Far richer than generic sun-sign yearly horoscopes.

narrative_yoga_by_id/v1/vedic/narrative/yoga/

Get a narrative interpretation of a specific yoga in a birth chart — detailed explanation of what the yoga means, how strongly it is formed in this chart, its classical effects, and what the native can expect from it. Use meta_vedic_yogas to find yoga IDs.

narrative_yogas/v1/vedic/narrative/yogas

Get a narrative of all major Vedic yogas present in a birth chart — Raja Yoga, Dhana Yoga, Parivartana Yoga, Kemadruma Yoga, Neecha Bhanga, Panchamahapurusha, and others — with presence, strength, and what each yoga means for the native.

Horoscopes & Reports (15)

horoscope_daily/v1/horoscope/daily

Get the daily horoscope for a Vedic Moon sign (rashi) — covers career, relationships, health, finance themes for the day plus daily lucky factors (color, number, direction).

horoscope_monthly/v1/horoscope/monthly

Get the monthly horoscope for a Vedic Moon sign (rashi). Returns the full-month outlook with sankranti shifts, mahadasha-transit interplay, weekly themes, and a recommended monthly focus.

horoscope_weekly/v1/horoscope/weekly

Get the weekly horoscope for a Vedic Moon sign (rashi). Returns the 7-day outlook with major planetary themes, week-spanning transits, and a focus recommendation.

report_dasha_analysis/v1/reports/dasha-analysis

Generate a comprehensive Dasha Analysis report — the full Vimshottari dasha timeline with narrative interpretation for each Mahadasha period, key life events timing, and dasha-transit correlations.

report_horoscope_daily/v1/reports/horoscope/daily

Generate a detailed daily horoscope report for a Moon sign — structured report with separate sections for career, love, finance, health, and daily guidance. More comprehensive than the quick daily reading.

report_horoscope_monthly/v1/reports/horoscope/monthly

Generate a detailed monthly horoscope report for a Moon sign — structured report covering the month's major transit themes, weekly breakdown, and guidance for career, relationships, and finance for the full month.

report_horoscope_weekly/v1/reports/horoscope/weekly

Generate a detailed weekly horoscope report for a Moon sign — structured report covering the week's planetary movement, day-by-day highlights, and focus areas.

report_kundli_brihad/v1/reports/kundli/brihad

Generate the Brihad (comprehensive) Kundli report — the most detailed birth chart report covering chart analysis, all divisional charts (D1–D60), planetary strengths (Shadbala), ashtakavarga, all dashas, yogas, doshas, remedies, and lifetime predictions.

report_kundli_detailed/v1/reports/kundli/detailed

Generate a Detailed Kundli report — comprehensive birth chart report with D1/D9/D10 charts, planetary strengths, major yogas, doshas, Vimshottari dasha timeline, and predictions by life area. Less exhaustive than Brihad but complete for most purposes.

report_kundli_lite/v1/reports/kundli/lite

Generate a Lite Kundli report — a concise birth chart summary with lagna, Moon sign, nakshatra, key planets, current dasha, and a brief personality reading. Ideal for a quick reference or introductory reading.

report_mangal_dosha/v1/reports/mangal-dosha

Generate a comprehensive Mangal Dosha report — full analysis of Mangal Dosha presence, sub-rules, all cancellation conditions checked, severity, impact on marriage, and detailed remedies with specific mantras, pujas, and gemstone guidance.

report_match_making/v1/reports/match-making

Generate a comprehensive Match Making (Kundli Milan) report for a couple — full Ashtakoota analysis with all 8 kootas scored, Mangal Dosha compatibility, Dasha synchrony, Navamsa compatibility, and an overall written recommendation.

report_numerology/v1/reports/numerology

Generate a comprehensive Numerology report — calculates all key numbers (Driver/Mulank, Conductor/Bhagyank, Name number, Soul Urge, Personality, Destiny) from name and date of birth, with complete interpretation of each number's meaning and their combined influence.

report_sade_sati/v1/reports/sade-sati

Generate a comprehensive Sade Sati report — covers current Sade Sati status, all past and upcoming cycles from birth to age 90, phase-by-phase narrative for the current or next cycle, and detailed remedies (mantras, donations, Shani puja guidance).

report_varshaphal/v1/reports/varshaphal

Generate a comprehensive Varshaphal (Solar Return) annual report — full annual chart with varsha lord, muntha, annual lagna, Tajika yogas, Mudda dasha timeline, and predictions for all 12 life areas for the current solar-return year.

Tarot (5)

tarot_card/v1/tarot/card/

Get the complete details for a single tarot card by ID — name, suit, element, archetype, upright and reversed meanings, keywords, and yes/no tendency.

tarot_cards/v1/tarot/cards

List tarot cards from the 78-card Rider-Waite deck with upright/reversed meanings, keywords, and yes/no tendency. Filter by suit or search by keyword.

tarot_daily/v1/tarot/daily

Get the card of the day — a deterministic daily tarot card that is the same for everyone on a given date. Includes the card's upright or reversed meaning as a daily message.

tarot_spread/v1/tarot/spread

Draw a tarot spread with a chosen layout and optional topic focus. Single card for a focused message; three-card for past/present/future; Celtic Cross for a full 10-card reading. Results are reproducible with a seed.

tarot_yes_no/v1/tarot/yes-no

Get a yes/no tarot answer — draws one card, returns yes/no/maybe based on the card's natural tendency modified by orientation, with reasoning.

Planet Moments & Geo (8)

geo_place/v1/geo/place/

Get full details for a specific place by its geo ID — resolves a place ID returned by geo_search into complete details (name, state, country, lat, lon, elevation, IANA timezone, population). Use when you have a place ID from a previous search and need to resolve its full data.

geo_reverse/v1/geo/reverse

Reverse geocoding — find the nearest city/place name for a given latitude and longitude. Returns place name, state, district, country code, and IANA timezone. Free (0 credits). Use this when you have GPS coordinates and need the city name or timezone.

geo_search/v1/geo/search

Search for a city or place by name — returns matching locations with latitude, longitude, state/province, country, and IANA timezone. Use when the user mentions a city name and you need coordinates for chart or panchang computations.

geo_timezone/v1/geo/timezone

Get the IANA timezone for a latitude/longitude — returns timezone name (e.g. Asia/Kolkata), UTC offset, and current DST status. Use before calling any chart/panchang endpoint when you only have coordinates without an explicit timezone.

planet_combustion_window/v1/planet-moments/combustion-window

Find the next combustion window of a planet on or after a date — when the planet is too close to the Sun (within classical combust limits) and loses strength. Defaults to searching from today.

planet_ingress/v1/planet-moments/ingress

Find a planet's sign ingresses (sankranti / sign changes) in a date range — exact moment the planet crosses from one sidereal sign to the next.

planet_retrograde_window/v1/planet-moments/retrograde-window

Find a planet's retrograde windows in a date range — start station (retrograde turn), end station (direct turn), and the sign each station occurs in. Mercury / Venus / Mars / Jupiter / Saturn retrogrades are most asked about.

planet_speed/v1/planet-moments/speed

Get the current speed and motion state of a planet — degrees per day, whether it is direct/retrograde/stationary, and its speed relative to mean motion.

Western Astrology (92)

western_astrocartography_local_space/v1/western/astrocartography/local-space

Compute Local Space astrocartography — the directions from an observer's location in which each natal planet rises, sets, culminates, or anti-culminates. Used to find beneficial directions for travel, relocation, or orienting a home.

western_astrocartography_planet_lines/v1/western/astrocartography/planet-lines

Compute Astrocartography (ACG) planet lines for a natal moment — traces the geographic lines where each planet rises (ASC), sets (DSC), culminates (MC), or is at nadir (IC) at birth. Returns polylines in lat/lon for mapping.

western_compatibility_sun_sign/v1/western/compatibility/sun-sign

Get the Western sun-sign compatibility between two zodiac signs — score 0–100, band (excellent/good/fair/challenging), aspect basis (trine/sextile/square etc.), element interaction, strengths, and challenges. No birth data needed.

western_composite_aspects/v1/western/composite/aspects

Get aspects in the composite (midpoint) chart for two people — shows how the relationship's combined energy is configured.

western_composite_chart/v1/western/composite/chart

Compute the composite chart (midpoint method) for two people — the relationship chart showing the energies of the union itself, not either individual. Returns composite planetary positions and house cusps.

western_composite_houses/v1/western/composite/houses

Compute the house cusps of the Composite chart for two people — the midpoint chart combining both natal charts to represent the relationship itself. Returns the composite Ascendant, Midheaven, and all 12 house cusps.

western_composite_planets/v1/western/composite/planets

Compute the planet placements in the Composite chart for two people — midpoint positions for all planets in the relationship chart. Returns sign, degree, house, and aspect pattern in the composite.

western_davison_aspects/v1/western/davison/aspects

Get aspects in the Davison relationship chart.

western_davison_chart/v1/western/davison/chart

Compute the Davison relationship chart — an alternative to the composite chart that uses the midpoint of the two birth times rather than midpoint longitudes. Returns planets + houses for the Davison chart.

western_davison_houses/v1/western/davison/houses

Compute the house cusps of the Davison Relationship chart — the chart for the midpoint in time and space between two people's births (an actual chart for a real moment, unlike the composite). Returns Davison Ascendant and house cusps.

western_davison_planets/v1/western/davison/planets

Compute the planet placements in the Davison Relationship chart — all planet positions in the Davison chart's tropical zodiac.

western_dignities_almuten/v1/western/dignities/almuten

Compute the Almuten Figuris — the planet with the highest combined essential dignity score at the Ascendant degree. The 'ruler of the chart' in classical astrology.

western_dignities_bounds/v1/western/dignities/bounds

Get the bound (term) ruler for a zodiac degree and the full sign breakdown — shows which planet rules each of the five bounds within a sign. Egyptian or Ptolemaic tables.

western_dignities_face/v1/western/dignities/face

Get the face (decan) ruler for a zodiac degree using the Chaldean order — shows which of the 36 faces the degree falls in and its planetary ruler.

western_dignities_planet/v1/western/dignities/planet

Compute all essential dignities for a planet in a natal chart — domicile, exaltation, detriment, fall, triplicity lord, bound lord, and face lord. Returns an Almuten score.

western_dignities_receptions/v1/western/dignities/receptions

Find the mutual receptions in a Western birth chart — pairs of the seven classical planets that sit in each other's dignities (domicile, exaltation, triplicity, term or face) and so support one another. Computed from the natal planet positions, so it makes two API requests (natal planets, then receptions).

western_dignities_triplicity/v1/western/dignities/triplicity

Get the triplicity (element) ruler for a zodiac degree — shows which planet rules by fire/earth/air/water triplicity, with day and night rulers.

western_eclipses_upcoming/v1/western/eclipses/upcoming

Find upcoming solar and lunar eclipses from today forward (default 12 months ahead). Returns eclipse type, UTC peak time, and whether it is total, partial, annular, or penumbral.

western_eclipses_visibility/v1/western/eclipses/visibility

Check whether upcoming eclipses are visible from a specific location — returns visibility type (total, partial, annular, not visible) and times of contact.

western_firdaria/v1/western/firdaria

Compute Firdaria planetary periods — the Medieval/Persian 75-year planetary time-lord cycle. Each planet rules a period proportional to its Chaldean years. Returns the current major and minor Firdaria lords.

western_heliocentric_planets/v1/western/heliocentric/planets

Compute heliocentric (Sun-centred) planetary positions — where the planets actually are in the solar system as seen from the Sun, not Earth. Returns Earth's position too.

western_horoscope_daily/v1/western/horoscope/daily

Get the daily Western horoscope for a sun sign. Uses Moon transit position for perpetual coverage — every date has a unique, astrologically grounded reading.

western_horoscope_monthly/v1/western/horoscope/monthly

Get the monthly Western horoscope for a sun sign. June–December 2026 has authored content; other months use the annual solar theme.

western_horoscope_weekly/v1/western/horoscope/weekly

Get the weekly Western horoscope for a sun sign. Uses Moon's weekly position for distinct, astrologically meaningful weekly content.

western_ingresses/v1/western/ingresses

Find all planetary sign-change ingresses in a date range — when each planet enters a new tropical zodiac sign, including retrograde re-entries.

western_interpretation_aspect/v1/western/interpretation/aspect

Get a narrative interpretation for a specific natal or synastry aspect (e.g. Sun square Mars). Returns headline, body text, and caveats.

western_interpretation_transit/v1/western/interpretation/transit

Get a narrative interpretation for a transiting planet aspecting a natal planet (e.g. Saturn transiting square natal Sun). Returns themes, timing advice, and caveats.

western_lunar_phase/v1/western/lunar/phase

Get the natal Moon phase at birth — phase angle, illumination percentage, 8-named phase (new moon through waning crescent), and age in days since last new moon.

western_lunar_return/v1/western/returns/lunar

Compute the Lunar Return chart — the chart for the exact moment the transiting Moon returns to its natal degree (~every 27.3 days). Returns planets + houses for that return moment.

western_lunar_return_aspects/v1/western/returns/lunar/aspects

Get the aspects formed between planets in the lunar return chart.

western_narrative_decan/v1/western/narrative/decan

Get the authored narrative for a zodiac decan (10° division of a sign). Each sign has 3 decans ruled by different planets.

western_narrative_firdaria/v1/western/narrative/timelord/firdaria

Get the Firdaria time-lord narrative for a given planet — the Hellenistic planetary period system (similar to Vimshottari but Ptolemaic). Pass the current Firdaria lord (e.g. 'Saturn') to get a narrative of what that period brings.

western_narrative_fixed_star/v1/western/narrative/fixed-star/

Get the authored narrative interpretation for a named fixed star in a natal chart.

western_narrative_sabian/v1/western/narrative/sabian

Get the authored Sabian symbol and interpretation for a specific zodiac degree (1–360, where 1 = Aries 1° and 360 = Pisces 30°).

western_narrative_timelord_profection/v1/western/narrative/timelord/profection

Get the authored narrative for the annual profection house — a description of the life themes activated in this profection year. Use after western_profections_annual to get the interpretation.

western_narrative_timelord_zr/v1/western/narrative/timelord/zr

Get the authored narrative for a Zodiacal Releasing planetary lord — describes the life-period themes when a given planet is lord in the ZR system.

western_narrative_yearly/v1/western/narrative/yearly

Get the annual solar-return theme for a sun sign — a deep interpretive essay on the year's archetypal themes for that sign. Available for all 12 signs in English, Hindi, and Marathi.

western_natal_antiscia/v1/western/natal/antiscia

Compute natal antiscia (solstice points) and contra-antiscia — mirror positions across the Cancer/Capricorn and Aries/Libra axes. Antiscia contacts between planets indicate hidden connections.

western_natal_ascendant/v1/western/natal/ascendant

Compute the Western (tropical) natal Ascendant — rising sign, degree, and Midheaven in the tropical zodiac. Distinct from the Vedic sidereal ascendant (typically ~23° earlier).

western_natal_aspect_patterns/v1/western/natal/aspect-patterns

Detect classical multi-planet aspect patterns in a natal chart — Grand Trine, T-Square, Grand Cross, Yod (Finger of God), Kite, Mystic Rectangle, Stellium, Grand Sextile.

western_natal_aspects/v1/western/natal/aspects

Compute all natal aspects in a Western tropical birth chart — conjunctions, oppositions, trines, squares, sextiles, and minor aspects. Returns orbs and partile flags.

western_natal_asteroid/v1/western/natal/asteroid/

Get the position of a specific asteroid in a Western birth chart by its MPC catalog number — sign, degree, house, retrograde flag. Supports all numbered asteroids in the Swiss Ephemeris database.

western_natal_big_four_asteroids/v1/western/natal/asteroids/big-four-plus

Compute natal positions of the four major asteroids — Ceres, Pallas, Juno, Vesta — plus Chiron (Wounded Healer). Returns sign, degree, and house for each.

western_natal_centaurs/v1/western/natal/centaurs

Get natal positions for the centaur bodies: Pholus, Nessus, Asbolus, and Chariklo.

western_natal_chart/v1/western/natal/chart

Compute a Western (tropical) natal chart — all planets with sign + degree, ascendant, MC, 12 houses (Placidus / Koch / Whole Sign), and aspect grid. Distinct from the Vedic 'chart_planets' — uses tropical zodiac, not sidereal.

western_natal_chart_shape/v1/western/natal/chart-shape

Classify the natal chart into one of the seven Jones planetary distribution patterns: Splash, Bundle, Locomotive, Bowl, Bucket, See-Saw, or Splay.

western_natal_declinations/v1/western/natal/declinations

Compute natal planetary declinations — the celestial latitude north or south of the equator. Identifies parallel aspects (same declination = same-sign energy) and contra-parallel aspects (opposite declination = opposition energy), plus out-of-bounds planets beyond ±23.4°.

western_natal_dominant/v1/western/natal/dominant

Get the chart dominance profile — dominant element (fire/earth/air/water), dominant modality (cardinal/fixed/mutable), most aspected planet, Lilly dignity ranking of traditional planets, and hemisphere balance.

western_natal_fixed_star/v1/western/natal/fixed-stars/

Check if a specific fixed star is conjunct any natal planet or angle in a Western birth chart — returns the star's tropical longitude, which natal point it aspects (if any), orb in degrees, and classical interpretation.

western_natal_fixed_stars/v1/western/natal/fixed-stars

Compute conjunctions between natal planets and major fixed stars (Brady canon of 47 stars — Algol, Regulus, Spica, Antares, etc.) within a 1° orb.

western_natal_harmonic

Compute the Nth harmonic chart (all planetary positions multiplied by N modulo 360°). Harmonics reveal hidden aspect patterns: H4 = squares, H5 = quintiles, H7 = septiles.

western_natal_harmonic_aspects/v1/western/natal/harmonic-aspects

Find harmonic aspects across multiple harmonics simultaneously — quintiles (H5), septiles (H7), noviles (H9), etc.

western_natal_houses/v1/western/natal/houses

Compute Western tropical house cusps for a birth chart. Returns all 12 house cusp degrees plus Ascendant and MC in the chosen house system (default Placidus).

western_natal_lilith_set/v1/western/natal/lilith-set

Get all Lilith positions: Mean Black Moon Lilith, True Black Moon Lilith, Osculating (Interpolated) Lilith, and asteroid 1181 Lilith.

western_natal_lot/v1/western/natal/lot/

Compute a specific Arabic Lot (Part) in a Western birth chart — Lot of Fortune, Spirit, Eros, Necessity, Courage, Victory, Nemesis, or Basis. Returns the lot's zodiac position, sign, house, and brief interpretation.

western_natal_lots/v1/western/natal/lots

Compute all 12 Hellenistic Arabic Parts (Lots) for a Western tropical natal chart — Fortune, Spirit, Eros, Necessity, Courage, Victory, and more. Returns each lot's degree, sign, and house.

western_natal_mc/v1/western/natal/mc

Compute the Midheaven (Medium Coeli, MC) and its tropical sign for a Western birth chart — the career and public reputation point, along with its aspects to natal planets.

western_natal_midpoint_tree/v1/western/natal/midpoint-tree

Compute the Ebertin-style 90° dial midpoint tree — identifies all activated midpoints (planet on the midpoint of two others within orb). Returns a tree structure with Ebertin keyword weights.

western_natal_midpoints/v1/western/natal/midpoints

Compute all planet-pair midpoints in a Western natal chart and identify which planets activate each midpoint within orb. Essential for cosmobiology / Ebertin analysis.

western_natal_out_of_bounds/v1/western/natal/out-of-bounds

Check which planets are Out of Bounds (OOB) in a Western natal chart — planets with declination beyond ±23°26′ (the Sun's maximum), considered to operate outside normal rules and with heightened, unconventional energy.

western_natal_parans/v1/western/natal/parans

Compute paran aspects — fixed stars crossing the 4 angles (Ascendant, MC, Descendant, IC) in paral­lel with natal planets.

western_natal_planets/v1/western/natal/planets

Get all planet placements in the Western (tropical) birth chart — sign, degree, house, retrograde flag, and speed for all 10 planets (Sun through Pluto) plus Chiron. Distinct from Vedic chart_planets which uses sidereal zodiac.

western_natal_single_planet/v1/western/natal/planet/

Get detailed data for a single planet in a Western (tropical) birth chart — sign, degree, house, speed, retrograde flag, dignity, aspects to other planets, and declination.

western_natal_summary/v1/western/narrative/natal-summary

Get a composed narrative summary of a Western natal chart — authored prose covering Ascendant, Sun, Moon placements and key aspect highlights.

western_natal_tnos/v1/western/natal/tnos

Get natal positions for trans-Neptunian objects: Eris, Sedna, Haumea, Makemake, Quaoar, Orcus, and Varuna.

western_natal_uranian_hypotheticals/v1/western/natal/uranian-hypotheticals

Get positions for the eight Uranian/Hamburg school hypothetical planets: Cupido, Hades, Zeus, Kronos, Apollon, Admetos, Vulkanus, and Poseidon.

western_natal_vertex_set/v1/western/natal/vertex-set

Get the Vertex, Anti-Vertex, and East Point for a natal chart. The Vertex is an electrically charged destiny point; contacts to it from transits or synastry indicate fated encounters.

western_primary_directions_placidus_mundane/v1/western/primary-directions/placidus-mundane

Compute Placidus mundane primary directions — the promissor moves through the Placidus mundane house framework. An alternative calculation method to zodiacal directions.

western_primary_directions_placidus_zodiacal/v1/western/primary-directions/placidus-zodiacal

Compute Placidus zodiacal primary directions — the oldest predictive technique in Western astrology (1° ≈ 1 year). Returns all direction events sorted chronologically: which natal planets are being directed and what they aspect.

western_primary_directions_regiomontanus/v1/western/primary-directions/regiomontanus

Compute Regiomontanus primary directions — uses equatorial Right Ascension arc, the simplest and fastest calculation method.

western_profections_annual/v1/western/profections/annual

Compute Annual Profections — the Hellenistic annual time-lord technique where the Ascendant advances one sign per year, activating that sign's ruler as the year's lord. Returns the profected sign, lord, and activated house.

western_profections_daily/v1/western/profections/daily

Compute the daily profection drill-down — the most granular level of the profection system.

western_profections_monthly/v1/western/profections/monthly

Compute the monthly profection sub-period — which house and lord are activated this month within the annual profection cycle.

western_progressions_aspects_to_natal/v1/western/progressions/aspects-to-natal

Get secondary progressed planet aspects to natal planets — the slow symbolic evolution of the birth chart over time.

western_progressions_lunation/v1/western/progressions/lunation

Get the progressed Moon phase — shows what stage of the 29-year progressed lunation cycle you are in (new moon, crescent, first quarter, gibbous, full moon, disseminating, last quarter, balsamic).

western_progressions_planets/v1/western/progressions/planets

Compute secondary progressed planetary positions for a birth chart at a given age. Each year of life progresses one day in ephemeris time.

western_retrograde_window

Find all retrograde station dates (station retrograde → station direct) for a planet within a date range. Returns exact station moments and the sign during the retrograde peak.

western_solar_arc_aspects_to_natal/v1/western/solar-arc/aspects-to-natal

Get solar arc directed planet aspects to natal planets — a predictive technique where all planets advance at the rate of the Sun (~1°/year).

western_solar_arc_planets/v1/western/solar-arc/planets

Compute Solar Arc directed planetary positions — each planet advances by the Sun's progressed arc (~1°/year). Returns directed positions for all planets.

western_solar_return/v1/western/returns/solar

Compute the Solar Return chart for a given year — the chart for the exact moment the Sun returns to its natal degree. Returns all planets + ascendant for the solar return year.

western_solar_return_aspects/v1/western/returns/solar/aspects

Get the aspects formed between planets in the solar return chart — shows which planets are strongly configured in the return year.

western_solar_return_exact_jd/v1/western/returns/solar/exact-jd

Get the exact Julian Day (JD) and calendar datetime of the Western (tropical) solar return for a given year — the precise moment the Sun returns to its natal tropical longitude. Foundation for accurate solar-return chart casting.

western_synastry_aspects/v1/western/synastry/aspects

Compute the cross-chart aspects between two natal charts (synastry). Returns all significant inter-chart aspects with orbs — essential for relationship compatibility analysis.

western_synastry_grid/v1/western/synastry/grid

Get the full N×M synastry aspect grid between two natal charts — every planet in chart A aspecting every planet in chart B.

western_synastry_score/v1/western/synastry/score

Score the compatibility between two natal charts (Western synastry). Returns a numeric score and breakdown by aspect quality and house overlays.

western_transit_positions/v1/western/transits/positions

Get current (or any-date) tropical planetary positions for transit analysis — all planets with sign, degree, speed, and retrograde status.

western_transit_summary/v1/western/narrative/transit-summary

Get a composed narrative summary of current transits to a natal chart — authored prose for the most exact active transits at the given moment.

western_transits_calendar/v1/western/transits/calendar

Get a day-by-day calendar of transiting planet aspects to a natal chart over a date range (up to 30 days). Each day shows all active transit-to-natal aspects computed at noon UTC.

western_transits_exact/v1/western/transits/exact

Find the exact moment a transiting planet will aspect a natal planet — useful for precise transit timing. Returns the Julian Day and UTC time of the exact aspect.

western_transits_to_natal/v1/western/transits/to-natal

Compute all current transiting planet aspects to natal planets — the real-time influences on a birth chart. Returns each transit planet's aspect to each natal planet with orb and applying/separating status.

western_zodiacal_releasing/v1/western/zodiacal-releasing/fortune

Compute Zodiacal Releasing from the Lot of Fortune — the Hellenistic predictive technique assigning planetary periods by releasing from a lot sign through the zodiac. Returns current Level 1 and Level 2 time-lord periods.

western_zodiacal_releasing_spirit/v1/western/zodiacal-releasing/spirit

Compute Zodiacal Releasing from the Lot of Spirit — indicates career and achievement periods. Complement to western_zodiacal_releasing (Fortune).

Meta & Discovery (6)

ashtakoota_breakdown/v1/milan/ashtakoota

Get the full Ashtakoota match-making table — all 8 kootas (varna, vashya, tara, yoni, graha-maitri, gana, bhakoot, nadi) individually with each koota's score, max, reasoning, and any dosha flags.

mangal_dosha/v1/milan/mangal-dosha

Check whether a birth chart has Mangal Dosha (Manglik condition) — Mars in a position that classically affects marriage. Returns presence flag, sub-rule (BPHS strict / modern North / from Moon), cancellation status, and severity.

match_making_score/v1/milan/ashtakoota/total

Compute the Ashtakoota (Guna Milan) compatibility score between a bride and groom — the traditional 36-point Vedic match-making system covering varna, vashya, tara, yoni, graha-maitri, gana, bhakoot, and nadi koota. Returns total score and per-koota breakdown.

nadi_dosha/v1/milan/nadi-dosha

Check Nadi Dosha — the 8-point koota in Ashtakoota matching that fails when both partners share the same Nadi (Adi/Madhya/Antya). Returns presence + cancellation rules + remedy notes.

vedic_remedies/v1/vedic/remedies

Get Vedic astrological remedies for a birth chart — personalised remedies based on weak planets, doshas, and challenging dashas. Returns mantras (with count/timing), gemstone recommendations, vratas, poojas, yantras, lucky colors, and lucky numbers.

vivah_phal/v1/milan/vivah-phal

Get Vivah Phal — marriage-outcome assessment for a single person's chart: longevity of the union, bhakoot/gana indicators, and qualitative outlook derived from lagna, Mars, Jupiter, and 7th lord positions.

Catalogs & Glossary (8)

chart_ashtakvarga_planet/v1/chart/ashtakvarga/{planet}

Get one planet's Bhinnashtakavarga row from the chart endpoint — the benefic points (bindus) that planet holds in each of the 12 signs, with its total. A compact single-planet alternative to the full ashtakavarga table.

narrative_reference/v1/vedic/narrative/reference/{family}

Read the authored Vedic astrology glossary for one concept family — explanatory text that defines a concept (what a yoga or dosha is, how a technique works) rather than interpreting one person's chart. No birth data needed.

meta_vedic_yogas/v1/meta/vedic/yogas

List every yoga the API can detect and narrate, with its ID, a one-line definition, the life domains it touches and the planets involved. Free (0 credits). Call this to find the ID that narrative_yoga_by_id needs, or to answer 'which yogas do you support'.

meta_vedic_doshas/v1/meta/vedic/doshas

List every dosha the API can detect and narrate (Mangal, Kaal Sarp and its sub-types, Pitru and others), with its ID, the life domains it touches and the planets involved. Free (0 credits). Call this to find the ID that narrative_dosha_by_id needs.

meta_vedic_locales/v1/meta/vedic/locales

List the languages the narrative endpoints can answer in, with how much of the interpretation corpus each one covers. Free (0 credits). Use before passing a lang/locale to a narrative tool, or to answer 'which languages are supported'.

meta_vedic_narrative_axes/v1/meta/vedic/narrative-axes

List the axes along which narrative text can be varied (such as locale and regional pack). Free (0 credits). Rarely needed directly — use it to discover which variation parameters the narrative tools understand.

meta_ayanamsas/v1/meta/ayanamsas

List the ayanamsa systems the API supports (Lahiri, Raman, Krishnamurti/KP, Fagan-Bradley and others) with each one's value in degrees on a date, and which is the default. Free (0 credits).

meta_endpoints/v1/meta/endpoints

List every API route with its credit cost and group. Free (0 credits). Use to answer 'how many credits does X cost', 'what will this request cost me', or to estimate the cost of a plan before running several tools.

When things don't click.

Most setup issues fall into one of these four buckets. If none match, the GitHub repo's troubleshooting section has the latest list, or file an issue.

Tools don't appear in Claude Desktop

Check the Claude Desktop logs at ~/Library/Logs/Claude/mcp*.log. Two most common causes: (1) "command not found" — the path in command is wrong; run `which lifeastro-mcp` and paste the absolute path. (2) "LIFEASTRO_API_KEY env var is required" — the env block is missing or has a typo.

Tool call returns API 401: Unauthorized

Your API key is invalid, revoked, or expired. Generate a new one in the dashboard and replace it in the config block.

Tool call returns API 429

You've hit your plan's rate limit (13 RPM on free plan) or daily cap (500 credits / day on free plan). Either upgrade your plan or wait for the next reset window (free tier resets at midnight UTC).

Tool call returns context deadline exceeded

The upstream API took longer than 15 seconds — usually a transient network blip. Retry once. If it persists, check api.lifeastroapi.com/healthz or contact support.

Frequently asked.

Do I need an OpenAI / Anthropic API key?

No. The MCP binary only forwards structured tool calls — your AI client (Claude Desktop, Cursor, Codex CLI, etc.) already handles the LLM side. We don't run any AI inference.

Does this cost extra credits?

No. Every tool call is one HTTPS request to api.lifeastroapi.com using your existing dv_live_… key — same credit cost as a direct curl call. There is no MCP surcharge.

Where does the binary run?

On your laptop. Your AI client spawns lifeastro-mcp as a child process and talks to it over stdio. The binary itself only makes outbound HTTPS calls to api.lifeastroapi.com — nothing else. Source is open on GitHub for full auditability.

Can I use my free-trial key?

Yes. The free plan's 1,500 credits / month and 500 credits / day apply across all sources — direct API, MCP binary, JSON report endpoints. Plenty to evaluate every tool. The 13 RPM rate limit also applies, but MCP usage is bursty (one tool call per AI turn) so you'll rarely hit it.

What about ChatGPT / web-based AI clients?

ChatGPT's MCP support is still in limited beta as of mid-2026, and it needs a remote HTTP MCP endpoint (not a local binary). We're planning a hosted endpoint at mcp.lifeastroapi.com as a follow-up — until then, Claude Desktop / Cursor / Codex CLI cover the audience that has solid MCP support today.

What if my AI assistant calls the wrong tool?

Every tool exposes a JSON schema; the MCP client validates each call against the schema before sending. If the AI picks a tool whose data shape doesn't match the user's intent, it sees the upstream response and corrects on the next turn.

Is my data sent to you?

Only the tool call arguments needed for the calculation (date, time, place, etc.) — same as a direct API call. We don't see your AI prompts, your conversation history, or anything else from your AI client. Calls are logged for billing only; payloads are not stored.

Can I read or fork the source?

Yes — lifeastro-mcp is MIT licensed and lives at https://github.com/ayanshulife/lifeastroapi-mcp. You can read every line, fork it, modify it, ship your own build. We rebuild it from source on every release with GitHub Actions; the published checksums let you verify the binary you downloaded matches the tag.

Ready to set this up?

Sign up for 1,500 free credits / month, install lifeastro-mcp, paste the config block — you're done in 5 minutes. Source is on GitHub if you want to audit first.