v0.11.0 — open source on GitHub
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
Binary runs on your laptop. Your AI prompts never leave your client — only the structured tool arguments do.
Live preview
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.
Mera lagna kya hai? Birth: 15 Jan 1990, 10:30 AM, Mumbai.
chart_ascendantAapka 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.
Setup overview
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.
Get an API key
Free 1,500 credits / month. Same dv_live_… key as direct API access.
Install the binary
Homebrew, Go install, or download a binary for Windows. ~8 MB, no deps.
Configure your client
Paste one JSON block, set LIFEASTRO_API_KEY. Same shape across all clients.
Restart & try
Quit + reopen your AI client. Ask a question. All 310 tools appear instantly.
Step 1
Get an API key
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.Step 2
Install the binary
brew tap ayanshulife/lifeastroapi-mcp \
https://github.com/ayanshulife/lifeastroapi-mcp
brew install lifeastro-mcpgo install \
github.com/ayanshulife/lifeastroapi-mcp/cmd/lifeastro-mcp@latestGrab the binary for your OS from the latest GitHub release and put it on your PATH.
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.
Step 2.5
Verify the install
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-keysThat "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.
Step 3
Configure your AI client
dv_live_… key, and restart the app. All 310 tools appear in the tool list immediately.~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"lifeastro": {
"command": "/opt/homebrew/bin/lifeastro-mcp",
"env": {
"LIFEASTRO_API_KEY": "dv_live_..."
}
}
}
}~/.cursor/mcp.json{
"mcpServers": {
"lifeastro": {
"command": "/opt/homebrew/bin/lifeastro-mcp",
"env": {
"LIFEASTRO_API_KEY": "dv_live_..."
}
}
}
}~/.codex/config.toml[mcp_servers.lifeastro]
command = "/opt/homebrew/bin/lifeastro-mcp"
env = { LIFEASTRO_API_KEY = "dv_live_..." }~/.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.
Step 4
Restart and try a question
“What's today's Rahu Kaal for Mumbai?”
panchang_rahu_kaal“Calculate my Vimshottari dasha. Birth: 12 March 1992, 6:45 AM, Pune.”
dasha_current“Compute the synastry score between these two charts: …”
western_synastry_scoreIf the AI says it doesn't have access to astrology tools, or the tools indicator is missing, see Troubleshooting below.
Tool catalog
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/abhijitGet 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/advancedGet 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-kalamGet 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/basicGet 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-muhuratGet 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/choghadiyaGet 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/durmuhurtaGet 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/gulikaGet 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-monthGet 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/horaGet 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-dinmanGet 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/karanaGet 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-tableGet 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/monthlyGet 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-moonsetGet 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/nakshatraGet 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-predictionGet 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/panchakaCheck 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-kaalGet 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-kaalGet 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/sankrantiFind 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-yogaCheck 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-sunsetGet 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/tithiGet 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/summaryGet 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/varaGet 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/varjyamGet 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/yamagandaGet 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/yogaGet 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/ascendantCompute the rising sign (lagna / ascendant) of a Vedic birth chart. Returns sign, degree, nakshatra and pada.
chart_ashtakavarga/v1/chart/ashtakvargaCompute 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/aspectsGet 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-detailsGet 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/avakhadaGet 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/bhavabalaCompute 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/combustionCheck 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/dignityGet 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_divisionalCompute 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/ghatakGet 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-yuddhaIdentify 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-occupantsList 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/housesGet 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-significatorGet 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-sublordGet 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/nakshatraGet 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/D9Compute 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/planetsCompute 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/shadbalaCompute 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/kakshaGet 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/sarvaGet 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-scoreScore 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/currentGet 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/charGet 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/majorGet 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/currentGet 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/vimshottariGet 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/currentGet 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/yoginiGet 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-syncCheck 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-yogCheck 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/longevityAssess longevity for a single person's chart — classical analysis of lagna, 8th house, and Moon sign longevity indicators.
milan_mahendra/v1/milan/mahendraCheck 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-compatCheck 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-yogCheck 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-doshaCheck 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-dirghaCheck 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-timeFind 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-balaCompute 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-praveshScore 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/naamkaranScore 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-rahitaCheck 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-siddhiCheck 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-yogaList 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-balaCompute 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/vivahScore 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/vyaparScore 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/yatraScore 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/allGet 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/lunarList 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/solarList 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-satiDetermine 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/ashtakavargaScore 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-transitCompute 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-panotiCheck 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/historyGet 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/tarabalaCompute 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/vedhaCheck 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/positionsGet 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-maasFind 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/monthGet 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/rituGet 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/solsticesGet 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/samvatsaraGet 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/monthFull 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-dateList Hindu festivals and observances falling on a specific date — Ekadashi, Pradosh, Purnima, Amavasya, major festivals, vratas, and regional observances.
festivals_vrat/v1/festivals/vratYear-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/chartCompute 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-balaCompute 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/lordGet 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-dashaCompute 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/munthaGet 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-jdGet 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/yogaGet 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/answerCast 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/arudhaCompute 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/chartCast 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-lordGet 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/significatorsGet 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/advancedCompute 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/challengesCompute 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/conductorCompute 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/destinyCompute 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/driverCompute 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/fullCompute 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-periodsCompute 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/personalityCompute 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/soulCompute 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/chartGet 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/dashaGet 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/currentGet 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-kitabList 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-outlookGet 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-phalGet 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-phalGet 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/doshasGet 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-outlookGet 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-lagnaGet 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-moonGet 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-tamilGet 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-lagnaGet 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-moonGet 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-lordGet 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-overviewGet 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/karakasGet 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/lagnaGet 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-outlookGet 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/milanGet 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-signGet 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/nakshatraGet 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-houseGet 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-signGet 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-housesGet 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-signsGet 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/profileGet 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-historyGet 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-phaseGet 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-statusGet 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-signGet 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-ashtakavargaGet 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-doubleGet 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-phalGet 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-themesGet 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-bhavishyafalGenerate 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/yogasGet 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/dailyGet 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/monthlyGet 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/weeklyGet 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-analysisGenerate 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/dailyGenerate 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/monthlyGenerate 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/weeklyGenerate 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/brihadGenerate 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/detailedGenerate 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/liteGenerate 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-doshaGenerate 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-makingGenerate 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/numerologyGenerate 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-satiGenerate 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/varshaphalGenerate 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/cardsList 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/dailyGet 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/spreadDraw 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-noGet 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/reverseReverse 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/searchSearch 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/timezoneGet 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-windowFind 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/ingressFind 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-windowFind 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/speedGet 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-spaceCompute 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-linesCompute 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-signGet 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/aspectsGet aspects in the composite (midpoint) chart for two people — shows how the relationship's combined energy is configured.
western_composite_chart/v1/western/composite/chartCompute 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/housesCompute 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/planetsCompute 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/aspectsGet aspects in the Davison relationship chart.
western_davison_chart/v1/western/davison/chartCompute 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/housesCompute 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/planetsCompute the planet placements in the Davison Relationship chart — all planet positions in the Davison chart's tropical zodiac.
western_dignities_almuten/v1/western/dignities/almutenCompute 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/boundsGet 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/faceGet 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/planetCompute 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/receptionsFind 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/triplicityGet 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/upcomingFind 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/visibilityCheck 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/firdariaCompute 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/planetsCompute 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/dailyGet 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/monthlyGet 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/weeklyGet the weekly Western horoscope for a sun sign. Uses Moon's weekly position for distinct, astrologically meaningful weekly content.
western_ingresses/v1/western/ingressesFind 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/aspectGet 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/transitGet 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/phaseGet 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/lunarCompute 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/aspectsGet the aspects formed between planets in the lunar return chart.
western_narrative_decan/v1/western/narrative/decanGet 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/firdariaGet 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/sabianGet 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/profectionGet 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/zrGet 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/yearlyGet 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/antisciaCompute 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/ascendantCompute 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-patternsDetect 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/aspectsCompute 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-plusCompute 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/centaursGet natal positions for the centaur bodies: Pholus, Nessus, Asbolus, and Chariklo.
western_natal_chart/v1/western/natal/chartCompute 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-shapeClassify 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/declinationsCompute 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/dominantGet 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-starsCompute conjunctions between natal planets and major fixed stars (Brady canon of 47 stars — Algol, Regulus, Spica, Antares, etc.) within a 1° orb.
western_natal_harmonicCompute 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-aspectsFind harmonic aspects across multiple harmonics simultaneously — quintiles (H5), septiles (H7), noviles (H9), etc.
western_natal_houses/v1/western/natal/housesCompute 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-setGet 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/lotsCompute 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/mcCompute 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-treeCompute 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/midpointsCompute 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-boundsCheck 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/paransCompute paran aspects — fixed stars crossing the 4 angles (Ascendant, MC, Descendant, IC) in parallel with natal planets.
western_natal_planets/v1/western/natal/planetsGet 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-summaryGet 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/tnosGet natal positions for trans-Neptunian objects: Eris, Sedna, Haumea, Makemake, Quaoar, Orcus, and Varuna.
western_natal_uranian_hypotheticals/v1/western/natal/uranian-hypotheticalsGet 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-setGet 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-mundaneCompute 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-zodiacalCompute 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/regiomontanusCompute Regiomontanus primary directions — uses equatorial Right Ascension arc, the simplest and fastest calculation method.
western_profections_annual/v1/western/profections/annualCompute 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/dailyCompute the daily profection drill-down — the most granular level of the profection system.
western_profections_monthly/v1/western/profections/monthlyCompute 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-natalGet secondary progressed planet aspects to natal planets — the slow symbolic evolution of the birth chart over time.
western_progressions_lunation/v1/western/progressions/lunationGet 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/planetsCompute secondary progressed planetary positions for a birth chart at a given age. Each year of life progresses one day in ephemeris time.
western_retrograde_windowFind 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-natalGet 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/planetsCompute 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/solarCompute 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/aspectsGet 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-jdGet 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/aspectsCompute 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/gridGet 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/scoreScore 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/positionsGet 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-summaryGet 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/calendarGet 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/exactFind 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-natalCompute 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/fortuneCompute 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/spiritCompute 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/ashtakootaGet 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-doshaCheck 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/totalCompute 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-doshaCheck 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/remediesGet 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-phalGet 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/yogasList 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/doshasList 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/localesList 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-axesList 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/ayanamsasList 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/endpointsList 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.
Troubleshooting
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.
Common questions
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.