VedaVisor Vedic Astrology MCP

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.