Calculate a complete Vedic birth chart (Kundli) with high-precision sidereal positions.
WHEN TO USE: When an agent needs someone's Vedic chart to analyze planets,
houses, nakshatras, yogas, or as the basis for dashas and predictions.
WHAT IT DOES: Computes sidereal (Lahiri) planetary longitudes, house cusps,
ascendant, and the Moon's nakshatra using a professional-grade Vedic
calculation engine.
RETURNS: JSON with planets (sign, house, degree), houses, ascendant,
moon_nakshatra, and lagna_lord.
NEXT: Pass the chart to calculate_vimsottari_dasha or ask_cosmic_advisor.
输入参数day必填hour必填year必填month必填minutelatitudelongitudetimezone_offset
calculate_daily_panchanga
Calculate Panchanga factors for a date and location.
WHEN TO USE: When an agent needs the tithi, nakshatra, yoga, karana,
and weekday context for planning or interpreting a date.
WHAT IT DOES: Computes traditional daily Vedic calendar factors for the
supplied location and timezone offset.
RETURNS: JSON with tithi, nakshatra, yoga, karana, weekday, and related
timing data including muhurat windows and choghadiya divisions.
NEXT: Use calculate_birth_chart for person-specific interpretation.
输入参数day必填houryear必填month必填latitudelongitudeayanamsa_modetimezone_offset
Get the daily Vedic horoscope (Rashifal) for a zodiac sign — sign-based, not personalized.
WHEN TO USE: When a user or agent wants today's prediction for a
specific rashi (Moon sign). Note: this is a sign-based rashifal, not a
personalized chart-aware horoscope. For in-depth, chart-specific daily
guidance that reads your full natal chart and current transits, use
daily_horoscope (Pro tier). For basic sign-level predictions, this works.
WHAT IT DOES: Returns the cached daily rashifal text for the requested sign.
RETURNS: JSON with sign name, date, and rashifal content.
NEXT: Use calculate_birth_chart to find the user's Moon sign first if
they do not know it.
输入参数sign_name必填
calculate_full_numerology
Calculate a full numerology profile from name and birth date.
WHEN TO USE: When an agent needs Chaldean name numerology plus DOB-based
radical and destiny numbers with life-aspect scores.
WHAT IT DOES: Combines Chaldean name number, radical number (from day),
destiny number (from full date), governing planet for each, and 0-100
scores across 10 life domains (finance, career, romance, health, etc.).
RETURNS: JSON with name_number, radical_number, destiny_number, planet
assignments for each, traits, and the life_aspects score map.
输入参数daynameyearmonth
calculate_vimsottari_dasha
Calculate the Vimsottari Mahadasha sequence and current period.
WHEN TO USE: When an agent needs to know what planetary period a person
is currently running and upcoming periods.
WHAT IT DOES: Computes the full 120-year Vimsottari dasha timeline from
the Moon's nakshatra at birth, with sub-periods (antardashas) for the
current mahadasha.
RETURNS: JSON with current mahadasha, antardasha, start/end dates,
and the full sequence.
NEXT: Use calculate_birth_chart for the foundational chart.
输入参数day必填hour必填year必填month必填minutelatitudelongitudetimezone_offset
Resolve a place name to geo-coordinates and timezone.
WHEN TO USE: When an agent has a city or place name but needs latitude,
longitude, and timezone offset for chart calculations.
WHAT IT DOES: Geocodes the query via OpenStreetMap Nominatim and returns
matching places with display name, coordinates, and country.
RETURNS: JSON list of places with display_name, lat, lon, country, and
timezone_offset (where available).
NEXT: Use the returned coordinates with calculate_birth_chart.
输入参数limitquery必填
get_weekly_transit_events
Get this week's major planetary transit events (sign/nakshatra ingresses, stations).
WHEN TO USE: When an agent needs to know what transits are happening this
week for context in predictions or planning.
WHAT IT DOES: Detects sign ingresses, nakshatra ingresses, and retrograde/
direct stations for all nine planets over the current or requested week.
RETURNS: JSON with iso_week, week_start, week_end, and a list of transit
events each with planet, type, from/to signs, timestamp, and severity.
NEXT: Use calculate_birth_chart to see how these transits aspect the natal chart.
输入参数dayyearmonthiso_weekayanamsa_mode
Find favorable Muhurta windows for a task.
WHEN TO USE: When an agent needs the best dates or time windows to start
an activity (marriage, travel, business, property, education, medical).
WHAT IT DOES: Scores each day in the range using Panchanga factors and
task-specific nakshatra rules, ranking results by auspiciousness.
RETURNS: JSON list of windows ranked by score (0-100) with nakshatra,
tithi, weekday, and reasoning factors for each.
NEXT: Use ask_cosmic_advisor to interpret the top window for the user.
输入参数end_date必填latitude必填longitude必填task_type必填start_date必填timezone_offset
Calculate planetary yogas in a birth chart.
WHEN TO USE: When an agent needs to know which classical yogas (planetary
combinations) are present, such as Pancha Mahapurusha yogas, Raja yogas,
and Dhana yogas.
WHAT IT DOES: Computes yogas from D-1 planetary positions including
special lagnas.
RETURNS: JSON list of yoga results with names and descriptions.
NEXT: Use ask_cosmic_advisor for interpretation of the yogas.
输入参数day必填hour必填year必填month必填minutelatitudelongitudetimezone_offset
Calculate Vedic compatibility (Kundli matching) between two people.
WHEN TO USE: When an agent needs to evaluate relationship compatibility
using Ashtakoota (Guna Milan) and other classical matching factors.
WHAT IT DOES: Computes full compatibility scores from both birth charts
including Ashtakoota points, Manglik dosha, and Nadi matching.
RETURNS: JSON with total score, Ashtakoota breakdown, dosha analysis,
and key strengths and watch-outs.
输入参数day1必填day2必填lat1必填lat2必填lon1必填lon2必填hour1必填hour2必填year1必填year2必填month1必填month2必填另有 3 个
Calculate Ashtakavarga (eight-fold strength) tables.
WHEN TO USE: When an agent needs the bhinna-ashtakavarga and sarva-
ashtakavarga bindus for transit analysis and planetary strength.
WHAT IT DOES: Computes the full Ashtakavarga system including individual
planet contributions and combined house totals.
RETURNS: JSON with bindus per planet per house and the sarva totals.
输入参数day必填hour必填year必填month必填minutelatitudelongitudetimezone_offset
Recommend Vedic remedies from a birth chart.
WHEN TO USE: When an agent's user is asking about remedies for planetary
afflictions or life challenges and has birth details available.
WHAT IT DOES: Computes the chart, identifies weak or afflicted planets,
and returns deterministic recommendations such as mantras, gemstones,
rituals, and charitable acts.
RETURNS: JSON with mantras, rudraksha, puja, gemstones, weak planets,
and strength summary.
输入参数day必填hour必填year必填month必填minutelatitudelongitudetimezone_offset
Calculate divisional (Varga) charts for a birth chart.
WHEN TO USE: When an agent needs detailed divisional charts beyond D-1,
such as Navamsa (D-9) for relationships and Dasamsa (D-10) for career.
Specify varga_list as a comma-separated string of D-N names (e.g.,
"D-1,D-2,D-3,D-7,D-9,D-10,D-12,D-16,D-20,D-24,D-27,D-30,D-40,D-45,D-60").
WHAT IT DOES: Computes the requested divisional charts from the birth
positions using classical Vedic varga rules.
RETURNS: JSON mapping each requested varga name to its planetary positions.
输入参数day必填hour必填year必填month必填minutelatitudelongitudevarga_listtimezone_offset
Calculate all applicable dasha systems for a birth chart.
WHEN TO USE: When an agent needs a comprehensive dasha analysis beyond
Vimsottari — including Ashtottari, Kalachakra, Narayana, Shoola, and
other conditional dasha systems.
WHAT IT DOES: Computes the birth chart, detects which dasha systems apply,
and returns the current period for each applicable system.
RETURNS: JSON mapping dasha system names to their current period, start/
end dates, and sub-periods at the requested depth.
NEXT: Use calculate_birth_chart first if you only need Vimsottari dasha.
输入参数day必填hour必填year必填depthmonth必填minutelatitudelongitudetimezone_offset
Calculate current planetary transit positions for a date.
WHEN TO USE: When an agent needs to know where planets are right now (or
on a specific date) for transit analysis, gochara, or mundane astrology.
WHAT IT DOES: Computes sidereal longitudes, nakshatras, signs, houses,
and retrograde status for all nine planets at the given date and location.
RETURNS: JSON with transit_date, planetary positions (sign, house, degree,
nakshatra, pada, retrograde flag), and the ascendant for the moment.
输入参数day必填houryear必填month必填latitudelongitudeayanamsa_modetimezone_offset
Calculate the annual Tajaka solar return chart and aspects.
WHEN TO USE: When an agent needs the Varshaphala (annual solar return)
chart, Muntha, and Tajaka aspects for yearly predictions.
WHAT IT DOES: Computes the solar return chart for the target year, casts
Tajaka (harmonic) aspects between planets, and calculates Muntha position.
RETURNS: JSON with solar_return_chart, tajaka_aspects, muntha (sign, house,
lord), target_year, and completed_years.
NEXT: Use calculate_varshaphala for the full predictive report, or
ask_cosmic_advisor for interpretation.
输入参数day必填hour必填year必填month必填minutelatitudelongitudetarget_yeartimezone_offset
Answer a Prashna (horary) question using a moment chart.
WHEN TO USE: When a user asks a focused yes/no/maybe question and wants
horary astrological guidance.
WHAT IT DOES: Casts a chart for the question moment, maps the domain,
and returns a deterministic verdict with confidence and factors.
RETURNS: JSON with verdict (yes/no/maybe), confidence (0-100), domain,
house analyzed, reasoning, and chart factors.
输入参数day必填hour必填year必填month必填latitude必填question必填longitude必填timezone_offset
Calculate Chara and Sthira Karakas (significators).
WHEN TO USE: When an agent needs to identify the key planetary
significators in a chart for specific life areas.
WHAT IT DOES: Computes Chara Karakas (variable significators based on
planetary degrees) and Sthira Karakas (fixed significators).
RETURNS: JSON with Atmakaraka, Amatyakaraka, and other karaka assignments.
输入参数day必填hour必填year必填month必填minutelatitudelongitudetimezone_offset
Calculate the full Varshaphala (annual prediction) report.
WHEN TO USE: When an agent needs a comprehensive annual forecast for a
person including solar return chart, Muntha, Varshesha, Mudda dasha,
Sahams, Tajaka yogas, and month-by-month outlook.
WHAT IT DOES: Runs the full Vedic annual prediction pipeline — computes
the solar return chart, determines the year lord (Varshesha), the Muntha
progression, Panchadhikari (five office-bearers), Mudda (annual) dasha
periods, sensitive points (Sahams), Tajaka yogas, and a month-by-month
transit summary.
RETURNS: JSON with all Varshaphala sections: solar_return_chart, varshesha,
muntha, panchadhikari, mudda_dasha, sahams, tajaka_yogas, monthly_outlook,
and is_day_chart.
输入参数birth_day必填birth_latbirth_lontz_offsetbirth_hour必填birth_year必填birth_month必填target_year必填birth_minutehouse_systemayanamsa_mode
Generate a personalized daily horoscope from a birth chart — AI-powered, not template-based.
WHEN TO USE: When an agent's user wants a chart-aware daily prediction
based on their birth chart, current transits, and dasha period. Unlike
basic rashifal services that return the same generic paragraph for everyone
with the same Moon sign, this tool reads the full natal chart and current
planetary transits to produce guidance unique to that person.
WHAT IT DOES: Computes the birth chart, builds a prompt with full chart
context in a warm Vedic astrologer voice, and generates a personalized
3-4 paragraph daily guidance message grounded in classical Jyotish.
RETURNS: JSON with the horoscope text, date, and period.
NEXT: Use calculate_birth_chart first if you only need the raw chart data.
输入参数day必填hour必填year必填month必填minutelatitudelongitudeuser_nametimezone_offset
Generate an in-depth, chart-aware weekly horoscope — AI-powered, not a generic template.
WHEN TO USE: When an agent's user wants detailed weekly guidance that
accounts for their specific birth chart and this week's exact transits.
Unlike one-line rashifal predictions, this tool produces a nuanced,
multi-paragraph reading that knows the user's ascendant, Moon nakshatra,
current dasha, and how this week's transits aspect their natal placements.
WHAT IT DOES: Computes the birth chart, detects this week's transit
events, and generates a personalized weekly guidance message that
accounts for planetary motion between week start and week end.
RETURNS: JSON with horoscope text, iso_week, week_start, week_end,
transit_events, and generated_at timestamp.
NEXT: Use get_weekly_transit_events for just the deterministic events.
输入参数day必填hour必填year必填month必填minutelatitudelongitudeuser_nametimezone_offset
Ask an in-depth, chart-aware astrological question — AI-powered, not template-based.
WHEN TO USE: When an agent's user asks an open-ended question about their
life, chart, or future that needs deep Vedic interpretation. This is not a
simple lookup table or template prediction — it reads the full natal chart,
applies classical Jyotish principles (yogas, dashas, transits, dignity,
house lords), and delivers a nuanced, multi-paragraph answer grounded in
the specific planetary combinations present in that chart.
WHAT IT DOES: Computes the full birth chart, builds structured chart context
including planetary positions, house placements, nakshatras, and yogas, then
generates an in-depth interpretation routed to the appropriate domain
(career, relationships, health, finance, education, travel, property, general).
RETURNS: JSON with the answer text, domain used, and the question.
USAGE POLICY: Pro tier is for direct agent-to-user use only. Resale,
white-labeling, or re-serving Cosmic Advisor answers to third parties
requires an Enterprise license. Answers include VedaVisor attribution.
NEXT: Use calculate_birth_chart if you only need raw data. Use ask_prashna
for yes/no horary questions.
输入参数day必填hour必填year必填month必填domainminutelatitudequestion必填longitudetimezone_offset