Astrology MCP Server: Connect DivineAPI to Any AI Platform

Connect DivineAPI to any AI platform. 248 astrology, numerology & horoscope tools available via the Model Context Protocol. Works with Claude, ChatGPT, Gemini, VS Code, and any MCP client.

Get Your API Keys: divineapi.com/api-keys — You will need these for every integration below.

MCP Server Endpoints

Three specialized servers covering Indian astrology, Western astrology, and horoscope & numerology services.

Server	Endpoint	Tools
Indian / Vedic Astrology	`https://mcp.divineapi.com/indian/mcp`	128
Western Astrology	`https://mcp.divineapi.com/western/mcp`	57
Horoscope, Tarot & Numerology	`https://mcp.divineapi.com/horoscope/mcp`	63

Available Tools by Server

Every tool exposed by each MCP server is listed below — 248 tools in total. Click a server to expand its full tool list. Each tool maps to a DivineAPI endpoint.

Indian / Vedic Astrology — 128 Tools (click to expand)

Tool	Description
`divine_get_panchang`	Get the complete daily Panchang for a given date and location. Returns comprehensive Vedic calendar data including tithi, nakshatra, yoga, karana, sunrise/sunset, moonrise/moonset, rahu kaal, and more.
`divine_get_tithi`	Get tithi (lunar day) details for a given date and location. Returns the current tithi, paksha (Shukla/Krishna), start/end times, and deity.
`divine_get_nakshatra`	Get nakshatra (lunar mansion) details for a given date and location. Returns the current nakshatra, its start/end time, lord, and related details.
`divine_get_karana`	Get karana details for a given date and location. Karana is half of a tithi. There are 11 karanas in Vedic astrology, each with specific qualities for timing activities.
`divine_get_surya_nakshatra`	Get Surya (Sun) Nakshatra details for a given date and location. Returns the nakshatra occupied by the Sun, useful for solar-based astrological calculations and rashi sandhi analysis.
`divine_get_yoga_panchang`	Get yoga (Sun-Moon angular relationship) for a given date and location. Returns the current yoga from the 27 Nitya Yogas, each indicating auspicious or inauspicious qualities for the day.
`divine_get_choghadiya`	Get Choghadiya (auspicious time slots) for a given date and location. Divides the day and night into multiple slots, each ruled by a different planet, indicating good/bad periods for various activities.
`divine_get_nivas_and_shool`	Get Nivas and Shool (directional inauspicious timings) for a date and location. Shool indicates inauspicious directions for travel on specific days. Nivas shows the resting place of certain deities.
`divine_get_ritu_and_anaya`	Get Ritu (season) and Anaya details for a given date and location. Returns the current Hindu season (Vasant, Grishma, Varsha, Sharad, Hemant, Shishir) and related calendar information.
`divine_get_samvat`	Get Samvat (Hindu calendar year) details for a given date and location. Returns the current Vikram Samvat, Shaka Samvat year names and numbers.
`divine_get_chandrabalam_and_tarabalam`	Get Chandrabalam and Tarabalam for a given date and location. Chandrabalam is Moon's strength for each rashi. Tarabalam is the auspiciousness based on birth nakshatra. Both important for muhurta selection.
`divine_get_other_calendars_and_epoch`	Get dates in other calendar systems and epoch values for a given date. Returns conversions to Vikram Samvat, Shaka Samvat, Kali Yuga, and Julian day numbers.
`divine_get_sun_moon`	Get sun and moon rise/set timings for a given date and location. Returns sunrise, sunset, moonrise, moonset times and related astronomical data.
`divine_get_auspicious_timings`	Get auspicious timings (shubh muhurat) for a given date and location. Returns favorable time windows for important activities like weddings, house-warming, travel, etc. (Abhijit Muhurat, Amrit Kaal, etc.).
`divine_get_inauspicious_timings`	Get inauspicious timings for a given date and location. Returns unfavorable time windows: Rahu Kaal, Yamaganda, Gulika Kaal, Dur Muhurat. Useful for avoiding inauspicious activities.
`divine_get_basic_astro_details`	Get basic astrological details for a person based on their birth data. Returns tithi, nakshatra, rashi, sun sign, moon sign, yoga, karana, varna, vashya, yoni, gana, nadi, ayanamsha, and more.
`divine_get_planetary_positions`	Get planetary positions in the birth chart (Kundli). Returns positions of all 9 Vedic planets (Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu) with sign, degree, nakshatra, and house placement.
`divine_get_horoscope_chart`	Generate a Vedic horoscope chart (Kundli diagram) as SVG and image. Supports divisional charts: D1 (Lagna/Rashi), D2 (Hora), D3 (Drekkana), D9 (Navamsha), D10 (Dashamsha), chalit, sun, moon, and more.
`divine_get_bhava_kundli`	Get Bhava Kundli (house-based chart) for a given bhava chart number (1-12). Unlike the rashi chart which shows sign placements, the Bhava chart shows exact house cusps and planetary positions within houses.
`divine_get_planet_analysis`	Get detailed analysis of one planet in the birth chart. Returns interpretation of the selected planet's placement including house lordship, aspects, conjunctions, strengths, and effects.
`divine_get_ascendant_report`	Get a detailed report based on the ascendant (Lagna) sign. Returns personality traits, physical characteristics, and life tendencies based on the rising sign at the time of birth.
`divine_get_uday_lagna`	Get Uday Lagna (rising sign) timings for a given date and location. Returns the lagna rising periods across the day with sunrise and sunset times.
`divine_get_chandramasa`	Get Chandramasa (Hindu lunar month) details for a given date and location. Returns the current Hindu lunar month name, Purnimant/Amant system, and the start/end dates of the lunar month.
`divine_get_chandrashtama`	Get Chandrashtama periods for a given month and location. Chandrashtama is when Moon transits through the 8th house from one's birth Moon sign, considered inauspicious for new ventures. Returns the month's periods per moon sign; set day to narrow to a specific date.
`divine_get_manglik_dosha`	Check for Manglik Dosha (Mangal Dosha / Kuja Dosha) in the birth chart. Important for marriage compatibility. Returns Manglik status, percentage, and cancellation factors.
`divine_get_kaal_sarpa_yoga`	Check for Kaal Sarpa Yoga in the birth chart. Occurs when all planets are hemmed between Rahu and Ketu. Returns the type of Kaal Sarpa Yoga and its effects.
`divine_get_pitra_dosha`	Check for Pitra Dosha (ancestral affliction) in the birth chart. Indicates karmic debts from ancestors affecting family harmony, progeny, and prosperity. Returns remedial measures.
`divine_get_sadhe_sati`	Check Sadhe Sati (Saturn transit) status for the person. The 7.5-year period of Saturn transiting through the 12th, 1st, and 2nd houses from Moon sign. Returns current phase and dates.
`divine_get_vimshottari_dasha`	Get Vimshottari Dasha periods for a birth chart at the requested granularity. The most widely used dasha system. Pick `dasha_type` to drill from Maha down to Deha. For Prana/Deha, also specify the parent planet(s).
`divine_get_maha_dasha_analysis`	Get textual interpretation of a Maha Dasha period (no birth data needed). Returns predictions for the named Maha Dasha covering career, health, relationships, and finances.
`divine_get_antar_dasha_analysis`	Get textual interpretation of an Antar Dasha (Maha→Antar) period. No birth data needed — this endpoint returns a generic interpretation for the named Maha + Antar combination.
`divine_get_pratyantar_dasha_analysis`	Get textual interpretation of a Pratyantar Dasha (Maha→Antar→Pratyantar) period. No birth data needed — generic interpretation for the named three-planet combination.
`divine_get_yogini_dasha`	Get Yogini Dasha periods for a birth chart. An alternative dasha system based on 8 Yoginis with a 36-year cycle. Popular for quick predictions and event timing.
`divine_get_kaal_chakra_dasha`	Get Kaal Chakra Dasha periods for a birth chart. A nakshatra-based dasha system described by Parashar. Each nakshatra pada maps to specific signs creating unique dasha sequences.
`divine_get_yogas`	Get all yogas (planetary combinations) present in the birth chart. Returns special planetary combinations indicating specific life outcomes: wealth (Dhana Yoga), fame (Raja Yoga), spiritual growth, etc.
`divine_get_nav_pancham_yoga`	Get Nav Pancham Yoga compatibility analysis between two charts. Analyzes the 5th and 9th house (trine) relationship between two partners, indicating fortune, mutual support, and harmony.
`divine_get_shadbala`	Get Shadbala (six-fold planetary strength) for a birth chart. Calculates six types of strength: Sthana Bala, Dig Bala, Kala Bala, Chesta Bala, Naisargika Bala, and Drik Bala for each planet.
`divine_get_composite_friendship`	Get composite (Panchda) friendship table for all planets. Shows natural, temporal, and composite friendship/enmity relationships between all planet pairs in the birth chart.
`divine_get_ghata_chakra`	Get Ghata Chakra (adverse combinations) for a birth chart. Returns the inauspicious day, tithi, nakshatra, yoga, karana, and lagna specific to the person's birth nakshatra.
`divine_get_sudarshana_chakra`	Get Sudarshana Chakra for a birth chart. Overlays Lagna, Moon, and Sun charts concentrically for comprehensive life prediction year by year.
`divine_get_panchak_rahita`	Check Panchak status for a given date and location. Panchak is a 5-nakshatra period (Dhanishta to Revati) considered inauspicious for certain activities like construction and travel.
`divine_get_gemstone_suggestion`	Get gemstone recommendations based on the birth chart. Returns suggested gemstones based on planetary positions, including primary gemstone, alternative stones, and wearing instructions.
`divine_get_ashtakvarga`	Get Bhinnashtakvarga (individual Ashtakvarga) tables for all planets. Returns the 8x12 benefic dots table for each planet showing strength in each sign. Used for transit prediction and sign strength analysis.
`divine_get_prasthara_chakra`	Get Prasthara Chakra (expanded Ashtakvarga) for a birth chart. Shows the detailed breakdown of benefic contributions from each planet to every sign in the Ashtakvarga system.
`divine_get_sarvashtakavarga`	Get Sarvashtakavarga (combined Ashtakvarga) for a specific chart. The sum of all individual Ashtakvarga tables, showing overall strength of each sign. Key for transit predictions.
`divine_get_sub_planet_positions`	Get sub-planet (Upagraha) positions for a birth chart. Returns positions of sub-planets like Dhuma, Vyatipata, Parivesha, Indra Chapa, and Upaketu with sign, degree, and nakshatra details.
`divine_get_sub_planet_chart`	Generate a sub-planet (Upagraha) chart as SVG and image. Returns a visual chart showing the placement of sub-planets (Dhuma, Vyatipata, Parivesha, etc.) in North or South Indian style.
`divine_get_jaimini_chara_dasha`	Get Jaimini Chara Dasha periods for a birth chart. A rashi-based dasha system where signs (not planets) rule the dasha periods. Excellent for timing events in Jaimini astrology.
`divine_get_jaimini_karakamsha_lagna`	Get Karakamsha Lagna from Jaimini astrology for a birth chart. The sign occupied by the Atmakaraka in the Navamsha chart. Reveals the soul's desire and spiritual inclinations.
`divine_get_jaimini_padas`	Get Jaimini Padas (Arudha Padas) for all houses in a birth chart. Arudha Padas show how the world perceives the native regarding each house signification (wealth, marriage, career, etc.).
`divine_get_jaimini_planetary_positions`	Get Jaimini-specific planetary positions and karakas. Returns Chara Karakas (variable significators) like Atmakaraka, Amatyakaraka, etc. based on planetary degrees.
`divine_get_kp_cuspal_sub`	Get KP Cuspal Sub Lords for all house cusps. Returns the sub lord of each house cusp, the primary factor for KP-based predictions about that house's significations.
`divine_get_kp_planetary_sub`	Get KP Planetary Sub Lords for all planets. Returns the star lord and sub lord for each planet in the KP system, essential for KP-based event prediction.
`divine_get_kp_cuspal_significator`	Get KP Planetary-Cuspal Significator Table. A comprehensive table showing which houses each planet signifies as star lord and sub lord. Core of KP prediction methodology.
`divine_get_kp_cuspal`	Get KP Cuspal chart data for a birth chart. Returns detailed cuspal positions with sign, star, and sub divisions using the KP ayanamsha and unequal house system.
`divine_get_kp_planetary_positions`	Get KP Planetary Positions for a birth chart. Returns planetary positions calculated using KP ayanamsha with sign lord, star lord, and sub lord for each planet.
`divine_get_kundli_transit_ascendant`	Get transit analysis from the Ascendant (Lagna) on a chosen transit date. Shows planetary transits on the given date analyzed from the birth Ascendant, indicating effects on different life areas. Optionally set transit time (hour/min/sec) and chart styling.
`divine_get_kundli_transit_moon`	Get transit analysis from the Moon sign on a chosen transit date. Shows planetary transits on the given date analyzed from the birth Moon sign, the most commonly used transit reference in Vedic astrology. Optionally set transit time (hour/min/sec) and chart styling.
`divine_get_grah_gochar`	Get Grah Gochar (planetary transit) data for a specific planet. Returns detailed transit information including sign changes, nakshatra transits, and effects on the native.
`divine_get_planet_combustion_transit`	Get planet combustion (Asta) transit details for a specific planet. Combustion occurs when a planet is too close to the Sun and loses strength. Returns combustion periods and their effects.
`divine_get_planet_nakshatra_transit`	Get nakshatra transit details for a specific planet. Returns when the planet enters and exits each nakshatra, useful for fine-tuning transit predictions.
`divine_get_planet_retrograde_transit`	Get retrograde transit details for a specific planet. Returns retrograde and direct motion periods for the planet, along with their effects on the native.
`divine_get_ashtakoot_milan`	Perform Ashtakoot Milan (8-point compatibility matching) for two people. The most popular matching method in North India. Evaluates 8 Gunas: Varna, Vashya, Tara, Yoni, Graha Maitri, Gana, Bhakoot, Nadi (max 36).
`divine_get_dashakoot_milan`	Perform Dashakoot Milan (10-point compatibility matching) for two people. Popular in South India. Evaluates 10 categories with max score of 36. More comprehensive than Ashtakoot Milan.
`divine_get_matching_manglik`	Check Manglik Dosha for both people in a matchmaking context. Compares Manglik status of both individuals to assess marriage compatibility when either person is Manglik.
`divine_get_matching_basic_astro`	Get basic astrological details for both persons in matchmaking. Returns rashi, nakshatra, tithi, gana, nadi, varna, etc. for both P1 and P2 side by side for comparison.
`divine_get_matching_horoscope_chart`	Generate horoscope charts for both persons in matchmaking. Returns charts for both P1 and P2 for the specified divisional chart type, enabling visual comparison of birth charts.
`divine_get_matching_vimshottari_dasha`	Get Vimshottari Dasha for both persons in matchmaking. Returns dasha periods for both P1 and P2 to compare planetary periods and assess timing compatibility.
`divine_get_matching_planetary_positions`	Get planetary positions for both persons in matchmaking. Returns side-by-side planetary positions for P1 and P2, useful for detailed compatibility analysis beyond standard matching scores.
`divine_get_festivals_by_date`	Get festivals falling on a specific date. Returns all Hindu festivals and observances for a given date and location.
`divine_get_english_calendar_festivals`	Get all Hindu festivals for a specific English calendar month. Returns festivals falling within a given month of the Gregorian calendar.
`divine_find_festival`	Find the date(s) of a specific festival in a given year. Returns the date or dates on which the named festival falls in the specified year, with location-adjusted timing and festival details.
`divine_get_festivals_by_month`	Get all Hindu festivals for a specific Hindu calendar month. Supports all 12 Hindu months: Margashirsha, Pausha, Magha, Phalguna, Chaitra, Vaishakha, Jyeshtha, Ashadha, Shravana, Bhadrapada, Ashvina, Kartika.
`divine_get_gowri_panchangam`	Get the Gowri Panchangam for a given date and location. Returns auspicious and inauspicious day and night segments plus Nalla Neram periods.
`divine_get_muhurat_marriage`	Get the Marriage Muhurat (auspicious wedding dates) for a given month and location.
`divine_get_muhurat_house_entering`	Get the Griha Pravesh (house-entering) Muhurat for a given month and location.
`divine_get_muhurat_vehicle_purchase`	Get the Vehicle Purchase Muhurat for a given month and location.
`divine_get_muhurat_property_purchase`	Get the Property Purchase Muhurat for a given month and location.
`divine_get_muhurat_business_start`	Get the Business Start Muhurat for a given month and location.
`divine_get_muhurat_foundation_laying`	Get the Foundation Laying (Bhoomi Pujan) Muhurat for a given month and location.
`divine_get_muhurat_do_ghati`	Get the Do Ghati Muhurat for a given date and location.
`divine_get_muhurat_hora`	Get the Hora (planetary hour) timings for a given date and location.
`divine_get_muhurat_jain_pachakkhan`	Get the Jain Pachakkhan timings for a given date and location.
`divine_get_malayalam_festivals`	Get major Malayalam (Kerala) festivals for a year. Returns Vishu Kani, Onam, Thrissur Pooram, Guruvayur Ekadashi, Makara Vilakku and other Kerala festivals with dates and images.
`divine_get_tamil_festivals`	Get major Tamil festivals for a year. Returns Thai Pongal, Puthandu (Tamil New Year), Karthigai Deepam, Vaikuntha Ekadashi, Arudra Darshan and other Tamil festivals with dates and images.
`divine_get_sankranti_festivals`	Get the twelve solar Sankranti festivals for a year. Returns Makar, Kumbha, Meena, Mesha and the other Sankranti transitions with dates, transition moments, and punya kala windows.
`divine_get_chandramasa_list`	Get list of Chandramasa (Hindu lunar months) for a given period. Returns the start and end dates of each Hindu lunar month for the specified year and location.
`divine_get_month_nakshatra_list`	Get daily nakshatra list for a given month. Returns the nakshatra for each day of the specified month, with start/end times and nakshatra lord details.
`divine_get_month_sunrise_sunset_list`	Get daily sunrise and sunset times for a given month. Returns sunrise and sunset times for each day of the specified month at the given location.
`divine_get_month_surya_nakshatra_list`	Get daily Surya (Sun) Nakshatra list for a given month. Returns the Sun's nakshatra position for each day of the month, useful for solar-based calendar calculations.
`divine_get_month_tithi_list`	Get daily tithi list for a given month. Returns the tithi for each day of the specified month with start/end times, paksha, and associated details.
`divine_get_lal_kitab_planetary_positions`	Get Lal Kitab planetary positions for a birth chart. Returns planet placements per the Lal Kitab system, the foundation for Lal Kitab analysis and remedies.
`divine_get_lal_kitab_horoscope_chart`	Generate the Lal Kitab horoscope chart for a birth chart. Returns the Lal Kitab style chart with planet placements as SVG and image.
`divine_get_lal_kitab_house_position`	Get Lal Kitab house positions for a birth chart. Returns which planets occupy each of the 12 houses in the Lal Kitab system.
`divine_get_lal_kitab_conjunctions`	Get Lal Kitab planetary conjunctions for a birth chart. Returns the planet combinations present in the chart and their Lal Kitab interpretation.
`divine_get_lal_kitab_teva`	Get Lal Kitab teva (chart conditions) for a birth chart. Returns which of the Lal Kitab tevas apply to the chart and what each condition means.
`divine_get_lal_kitab_planet_analysis`	Get Lal Kitab analysis of one planet in the birth chart. Returns the Lal Kitab interpretation of the selected planet's placement, including its condition and effects.
`divine_get_lal_kitab_dasha`	Get Lal Kitab dasha periods for a birth chart. Returns the Lal Kitab dasha timeline (35-year cycle) with the ruling planet for each period.
`divine_get_lal_kitab_planet_types`	Get Lal Kitab planet types for a birth chart. Classifies each planet per Lal Kitab (benefic, malefic, sleeping, exalted conditions) for the given chart.
`divine_get_lal_kitab_mahadasha_content`	Get textual Lal Kitab interpretation of a Mahadasha period (no birth data needed). Returns the Lal Kitab reading for the named Mahadasha planet.
`divine_get_lal_kitab_antardasha_content`	Get textual Lal Kitab interpretation of a Mahadasha-Antardasha combination (no birth data needed). Not every planet pair is valid; the API lists the valid antardashas on mismatch.
`divine_get_lal_kitab_debts`	Get Lal Kitab debts (rin) for a birth chart. Returns the karmic debts identified in the chart per Lal Kitab, such as self, mother, relative or unborn debts.
`divine_get_lal_kitab_house_signification`	Get the Lal Kitab signification of one house for a birth chart. Returns what the selected house (1-12) signifies per Lal Kitab and how it plays out in the given chart.
`divine_get_lal_kitab_varsha_pravesh`	Get the Lal Kitab Varsha Pravesh (annual chart entry) for a chosen year. Returns the moment the varshphal year begins for the native and the entry chart details.
`divine_get_lal_kitab_varshphal_planetary_positions`	Get Lal Kitab varshphal (annual chart) planetary positions for a chosen year. Returns the planet placements in the annual chart for the given year.
`divine_get_lal_kitab_varshphal_muntha`	Get the Lal Kitab varshphal Muntha for a chosen year. Returns the Muntha house and its interpretation for the native's annual chart.
`divine_get_lal_kitab_varshphal_chart`	Generate the Lal Kitab varshphal (annual) chart for a chosen year. Returns the annual chart as SVG and image for the given year.
`divine_get_vargottama_planets`	Get the vargottama planets for a birth chart. Returns each planet with its D1 (birth) and D9 (navamsha) sign and whether it is vargottama (the same sign in both charts), a placement considered a source of strength.
`divine_get_bhav_bala`	Get Bhava Bala (house strength) for a birth chart. Returns the numeric strength of each of the twelve houses, including the house-lord strength (bhavadhipati bala) and the directional strength (disha bala).
`divine_get_shani_ashtam_shani`	Get the Ashtama Shani analysis for a birth chart. Returns the periods when transiting Saturn occupies the eighth house from natal Saturn, with the natal Saturn placement, the ashtama sign, and age-banded predictive content.
`divine_get_bhava_analysis`	Get the house-by-house (bhava) analysis for a birth chart. For each of the twelve houses, returns the sign, house lord and its placement, the occupying planets, and the aspects received, each with interpretive content.
`divine_get_bhava_group_predictions`	Get predictions grouped by house category for a birth chart. Returns interpretations for the classical house groups: kendra (angular), trikone (trinal), trishadaya, trik (dusthana), maraka, and dhana.
`divine_get_planet_remedies`	Get remedial measures for one planet's placement in the birth chart. Requires analysis_planet (sun to ketu). Returns the recommended donation, gemstone, lifestyle practice, mantra, and the weaknesses the remedy addresses.
`divine_get_rudraksha_suggestion`	Get Rudraksha (mukhi bead) suggestions (life, lucky, and dasha beads) for a person from their birth data.
`divine_get_varshphal_varsha_pravesh`	Get the annual solar-return (Varsha Pravesh) moment for the given year.
`divine_get_varshphal_basic_astro_details`	Get basic annual-chart astro details for the given year.
`divine_get_varshphal_planetary_positions`	Get annual-chart planetary positions for the given year.
`divine_get_varshphal_horoscope_chart`	Get the annual divisional chart (D1..D60) as SVG for the given year.
`divine_get_varshphal_tajika_aspect`	Get Tajika aspects for the annual chart.
`divine_get_varshphal_muntha`	Get the Muntha (progressed ascendant) for the given year.
`divine_get_varshphal_panchadhikari`	Get the Panchadhikari (five year-lords) for the given year.
`divine_get_varshphal_tri_pataki_chakra`	Get the Tri Pataki Chakra for the annual chart.
`divine_get_varshphal_mudda_dasha`	Get the Mudda Dasha (annual dasha) for the given year.
`divine_get_varshphal_yogini_dasha`	Get the annual Yogini Dasha for the given year.
`divine_get_varshphal_patyanini_dasha`	Get the Patyanini Dasha for the given year.
`divine_get_varshphal_planetary_strengths`	Get annual-chart planetary strengths for the given year.
`divine_get_varshphal_sahams`	Get the Sahams (sensitive points) for the annual chart.
`divine_get_varshphal_yogas`	Get Tajika yogas for the annual chart.

Horoscope, Tarot & Numerology — 63 Tools (click to expand)

Tool	Description
`divine_daily_horoscope`	Get daily horoscope for a zodiac sign. Returns love, career, health, and overall predictions. For a broader outlook, also call divine_weekly_horoscope and divine_monthly_horoscope in parallel.
`divine_weekly_horoscope`	Get weekly horoscope for a zodiac sign. Returns predictions covering love, career, health, and finances for the entire week.
`divine_monthly_horoscope`	Get monthly horoscope for a zodiac sign. Returns detailed predictions for the month covering love, career, health, and financial outlook.
`divine_yearly_horoscope`	Get yearly horoscope for a zodiac sign. Returns comprehensive annual predictions covering major life themes, career, relationships, and personal growth.
`divine_chinese_horoscope`	Get Chinese zodiac horoscope for today, tomorrow, or yesterday. Returns predictions based on the Chinese zodiac animal sign including luck, love, career, and health insights.
`divine_numerology_horoscope`	Get numerology-based horoscope for a life path number and date. Returns daily numerological predictions based on the given number, including lucky colors, compatibility, and guidance.
`divine_yes_or_no_tarot`	Draw a tarot card for a yes/no question. Returns card name, image, and interpretation. Perfect for quick decision-making questions with a clear yes or no answer.
`divine_daily_tarot`	Draw a daily tarot card with interpretation and guidance. Returns a tarot card for the day with its meaning, advice, and symbolism to guide your daily decisions and awareness.
`divine_fortune_cookie`	Get a fortune cookie message with wisdom and lucky numbers. Returns a randomized fortune cookie with a wisdom message, lucky numbers, and a lesson for the day.
`divine_coffee_cup_reading`	Get a Turkish coffee cup reading with symbols and meanings. Returns an interpretation of coffee cup symbols covering past, present, and future insights in the tradition of tasseography.
`divine_career_daily_reading`	Get daily career guidance and professional insights. Returns a card-based reading focused on career, workplace dynamics, professional growth, and financial opportunities.
`divine_angel_reading`	Receive an angel card reading with divine guidance. Returns an angel card message with spiritual guidance, affirmations, and divine insights for your current life situation.
`divine_magic_reading`	Get a magical reading with mystical insights. Returns a mystical card reading with magical symbolism, enchanted guidance, and cosmic wisdom for your journey.
`divine_dream_come_true_reading`	Discover insights about manifesting your dreams. Returns a reading focused on goal achievement, dream manifestation, and the energetic alignment needed to realize your aspirations.
`divine_egyptian_prediction`	Get predictions based on ancient Egyptian divination. Returns mystical predictions drawn from ancient Egyptian wisdom, including symbolic imagery and esoteric guidance.
`divine_erotic_love_reading`	Get an intimate love and passion reading. Returns insights about romantic passion, physical attraction, and intimate connections in your love life.
`divine_ex_flame_reading`	Get insights about a past relationship. Returns a reading about an ex-partner or past flame, including lessons learned, closure guidance, and whether reconnection is advised.
`divine_flirt_love_reading`	Get playful love and flirtation insights. Returns a lighthearted reading about romantic attraction, flirtation energy, and how to navigate new romantic interests.
`divine_heartbreak_reading`	Get guidance for healing from heartbreak. Returns a compassionate reading with insights on emotional healing, self-recovery, and moving forward after a breakup or loss.
`divine_in_depth_love_reading`	Get a comprehensive love and relationship reading. Returns a detailed multi-card spread covering your love life, relationship dynamics, emotional needs, and romantic future.
`divine_know_your_friend_reading`	Get insights about a friendship. Returns a reading about friendship dynamics, trust, loyalty, and the deeper nature of a platonic relationship.
`divine_love_compatibility`	Check love compatibility between two zodiac signs. Requires the two signs (sign_1 and sign_2). Returns a compatibility reading with insights on emotional harmony, challenges, and the overall potential of the romantic pairing.
`divine_love_triangle_reading`	Get insights on a love triangle situation using tarot. Returns a reading about complicated romantic dynamics involving multiple people, with guidance on navigating the situation.
`divine_made_for_each_other`	Discover if you and your partner are made for each other. Returns a reading that evaluates soul-level compatibility, karmic connections, and whether the relationship is destined.
`divine_power_life_reading`	Get a power life reading for strength and empowerment. Returns insights about your personal power, life force energy, inner strengths, and how to harness them for success.
`divine_past_lives_connection`	Explore past life connections and karmic ties. Returns a reading about past life relationships, karmic lessons carried forward, and soul connections from previous incarnations.
`divine_past_present_future`	Get a past, present, and future three-card tarot spread. Returns a classic three-card reading with insights into what has passed, the current situation, and what lies ahead.
`divine_which_animal_are_you`	Discover your spirit animal through a divination reading. Requires full name and birth date (year 1901 to 2100). Returns your spirit animal match along with its symbolic meaning, personality traits, and spiritual guidance it offers.
`divine_wisdom_reading`	Get a wisdom reading with timeless insights and guidance. Returns a card reading focused on wisdom, life lessons, philosophical insights, and spiritual growth for your current journey.
`divine_loshu_grid`	Generate Lo Shu Grid for numerological analysis. Returns the Lo Shu magic square grid based on name and birth date, revealing personality patterns, strengths, and weaknesses through number placement in the 3x3 grid.
`divine_zodiac_planet_number`	Get zodiac sign, ruling planet, and numerological number associations. Returns the connection between your zodiac sign, its ruling planet, and the numerological numbers that influence your personality and destiny.
`divine_luck_numerology`	Get lucky numbers, colors, and days based on numerology. Returns your personal lucky numbers, favorable colors, auspicious days, and other fortune-enhancing insights derived from your name and birth date.
`divine_name_number`	Calculate your name number using Chaldean numerology. Returns the numerological value of your name, its meaning, personality traits associated with the number, and its influence on your life path.
`divine_birthday_number`	Calculate your birthday number and its significance. Returns the numerological birthday number derived from your date of birth, along with its meaning, talents, and gifts it bestows.
`divine_missing_numbers`	Find missing numbers in your numerological chart. Returns the numbers absent from your name and birth date analysis, revealing areas of challenge, karmic lessons, and qualities to develop.
`divine_driver_conductor_numbers`	Calculate driver and conductor numbers from your birth date. Returns the driver (birth day) and conductor (full birth date) numbers, explaining how they influence your personality, behavior, and destiny.
`divine_two_numbers_arrows`	Analyze two-number arrow patterns in your Lo Shu Grid. Returns the directional arrows formed by pairs of numbers in the grid, indicating specific personality traits and life tendencies.
`divine_three_numbers_arrows`	Analyze three-number arrow patterns in your Lo Shu Grid. Returns the directional arrows formed by triplets of numbers in the grid, revealing dominant personality patterns and life path indicators.
`divine_repeating_numbers`	Find repeating numbers in your numerological profile. Returns numbers that appear multiple times in your chart, indicating amplified energies, strengths, or challenges in your life.
`divine_yearly_prediction`	Get yearly numerological predictions based on your personal year number. Returns detailed predictions for the year covering career, relationships, health, and personal growth based on your numerological cycle.
`divine_numerology_gemstones`	Get recommended gemstones based on your numerological profile. Returns gemstone recommendations aligned with your numerological numbers, including their healing properties, wearing instructions, and benefits.
`divine_core_numbers`	Calculate all core numerology numbers from full name and birth date. Requires full_name and a calculation method ('general', 'chaldean', or 'pythagorean'). Returns the core numbers: Life Path, Destiny Path, Birth Day, Attitude, Pinnacles, Challenges, and more, with interpretations.
`divine_new_mobile_number`	Get a numerologically favorable new mobile number suggestion. Analyzes your name and birth date to suggest mobile numbers that are numerologically aligned with your personal vibrations.
`divine_analyze_mobile_number`	Analyze the numerological significance of a mobile number. Returns a detailed analysis of how your current mobile number aligns with your personal numerology, and its impact on your life.
`divine_flames_calculator`	Calculate FLAMES compatibility between two people. FLAMES stands for Friends, Lovers, Affectionate, Marriage, Enemies, Siblings. Returns the relationship type based on name analysis.
`divine_love_calculator`	Calculate love compatibility percentage between two people. Returns a love compatibility score with analysis based on names and genders, including relationship strengths and advice.
`divine_zodiac_gift_guru`	Get personalized gift suggestions based on zodiac sign. Requires h_day ('today', 'tomorrow', or 'yesterday') and a timezone offset (e.g., '5.5'). Returns curated gift ideas tailored to the personality traits and preferences associated with the given zodiac sign.
`divine_beauty_by_stars`	Get beauty and skincare tips based on zodiac sign. Requires h_day ('today', 'tomorrow', or 'yesterday') and a timezone offset (e.g., '5.5'). Returns personalized beauty recommendations, skincare routines, and wellness advice aligned with your zodiac sign traits.
`divine_astro_chic_picks`	Get fashion and style recommendations based on zodiac sign. Returns trendy fashion picks, style advice, and wardrobe suggestions personalized to the aesthetic preferences of your zodiac sign.
`divine_pdf_kundali_sampoorna`	Generate a comprehensive Sampoorna Kundali PDF report. Returns a complete Vedic birth chart report including planetary positions, dasha periods, yogas, doshas, and detailed life predictions. Supports optional company branding on the PDF.
`divine_pdf_kundali_ananta`	Generate an Ananta Kundali PDF report with extended analysis. Returns a detailed Vedic astrology report with extended planetary analysis, divisional charts, and in-depth dasha predictions in PDF format.
`divine_pdf_kundali_prakash`	Generate a Prakash Kundali PDF report with essential analysis. Returns a concise Vedic astrology report with key planetary positions, basic dasha analysis, and essential life predictions in PDF format.
`divine_pdf_match_making`	Generate a Vedic matchmaking (Kundali Milan) PDF report. Returns a comprehensive compatibility report for two individuals including Ashtakoota matching, Mangal Dosha analysis, and marriage compatibility score.
`divine_pdf_government_job`	Generate a government job prospects PDF report based on Vedic astrology. Returns an astrological analysis of government job potential, competitive exam success probability, and favorable periods for public sector employment.
`divine_pdf_foreign_travel`	Generate a foreign travel and settlement prospects PDF report. Returns an astrological analysis of overseas travel potential, immigration prospects, and favorable periods for foreign settlement.
`divine_pdf_vedic_5year`	Generate a 5-year Vedic yearly prediction PDF report. Returns year-by-year predictions for the next 5 years covering career, relationships, health, finances, and major life events.
`divine_pdf_vedic_10year`	Generate a 10-year Vedic yearly prediction PDF report. Returns year-by-year predictions for the next 10 years covering career, relationships, health, finances, and major life events.
`divine_pdf_vedic_15year`	Generate a 15-year Vedic yearly prediction PDF report. Returns year-by-year predictions for the next 15 years covering career, relationships, health, finances, and major life events.
`divine_pdf_natal_report`	Generate a Western astrology natal chart PDF report. Requires a report_code (e.g., 'CAREER-REPORT') and theme (e.g., '001') in addition to birth data and branding. Returns a comprehensive natal chart report based on Western astrology, including sun/moon/rising signs, planetary aspects, and house placements.
`divine_pdf_couple_report`	Generate a Western astrology couple compatibility PDF report. Returns a detailed synastry report for two people including planetary aspects, composite chart analysis, and relationship compatibility insights.
`divine_pdf_numerology_prediction`	Generate a numerology prediction PDF report. Requires full_name, gender, a report_code (e.g., 'YEARLY-PREDICTION-3-YEAR'), and branding. Returns a comprehensive numerology prediction report with life path analysis, personal year forecasts, and detailed number interpretations in PDF format.
`divine_pdf_numerology_report`	Generate a full numerology analysis PDF report. Requires full_name, gender, a report_code (e.g., 'SCHOLARLY-SPIRITS'), and branding. Returns a detailed numerology report covering all core numbers, Lo Shu Grid, name analysis, and comprehensive life path interpretations in PDF format.
`divine_pdf_reports_v2`	Generate a comprehensive PDF report using Divine API Reports V2. Supports multiple report types including vedic career, marriage, health, western natal, and numerology reports. Returns a URL to the generated PDF.

Western Astrology — 57 Tools (click to expand)

Tool	Description
`divine_western_planetary_positions`	Get planetary positions in the Western natal chart. Returns positions of Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto with sign, degree, and house placement. For a complete natal reading, also call divine_western_house_cusps, divine_western_aspect_table, and divine_western_natal_insights in parallel.
`divine_western_house_cusps`	Get house cusps for the Western natal chart. Returns the degree and sign of each of the 12 house cusps based on the selected house system (Placidus, Koch, Equal, Whole Sign, etc.). Houses represent different life areas: identity, finances, communication, home, creativity, health, partnerships, transformation, philosophy, career, community, and spirituality.
`divine_western_aspect_table`	Get the aspect table for the Western natal chart. Returns all major and minor aspects (conjunctions, oppositions, trines, squares, sextiles, quincunxes, semi-sextiles, etc.) between planets. Aspects reveal how planetary energies interact, showing areas of harmony, tension, and growth in the native's life.
`divine_western_natal_wheel_chart`	Generate a visual natal wheel chart image. Returns an image URL of the natal chart wheel showing planet placements, house cusps, and zodiac signs in a traditional circular format. Customize colors and display options with optional parameters.
`divine_western_general_sign_report`	Get a general sign report for a specific planet in the natal chart. Returns an interpretive reading of the specified planet's sign placement. For example, 'sun' returns the Sun sign interpretation, 'moon' the Moon sign reading, 'venus' the Venus sign meaning for love and values, etc. Planet options: sun, moon, mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto.
`divine_western_general_house_report`	Get a general house report for a specific planet in the natal chart. Returns an interpretive reading of the specified planet's house placement. Reveals how the planet's energy manifests in a particular life area. For example, Venus in the 7th house indicates partnership-oriented love. Planet options: sun, moon, mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto.
`divine_western_moon_phases`	Get natal Moon phase information for the birth chart. Returns the Moon phase at the time of birth (New Moon, Waxing Crescent, First Quarter, Waxing Gibbous, Full Moon, Waning Gibbous, Last Quarter, Waning Crescent) and its astrological significance for personality and life purpose.
`divine_western_ascendant_report`	Get the Ascendant (Rising Sign) report for the birth chart. Returns a detailed interpretation of the Ascendant sign, which represents the persona, physical appearance, and first impressions. The Ascendant is the zodiac sign on the eastern horizon at the moment of birth and is one of the most personal points in the chart.
`divine_western_moon_phase_calendar`	Get a Moon phase calendar for a given month, year, and location. Returns a calendar of Moon phases showing New Moons, Full Moons, and quarter phases. Useful for planning activities aligned with lunar cycles, understanding emotional rhythms, and timing important decisions. Only month, year, and location are needed; birth details are not used.
`divine_western_natal_insights`	Get comprehensive natal insights and personality analysis. Returns a detailed interpretive report covering the overall chart pattern, dominant elements, modalities, key planetary placements, and synthesized personality insights. Provides a holistic view of the native's strengths, challenges, and life themes.
`divine_western_synastry_planetary_positions`	Get planetary positions for both persons in synastry analysis. Returns the positions of all planets for both individuals, showing how their charts overlay. For a complete compatibility reading, also call divine_western_synastry_aspect, divine_western_synastry_harmonious_reading, and divine_western_synastry_physical_compat in parallel.
`divine_western_synastry_house_cusps`	Get house cusps for both persons in synastry analysis. Returns the house cusps for each individual's chart, enabling comparison of how one person's planets fall into the other's houses. This reveals which life areas are activated in the relationship.
`divine_western_synastry_natal_wheel_chart`	Generate a bi-wheel synastry chart image for two persons. Returns an image URL showing both natal charts overlaid in a bi-wheel format, with one person's chart on the inner wheel and the other on the outer wheel for visual aspect analysis.
`divine_western_synastry_aspect`	Get inter-chart aspects between two persons in synastry. Returns all aspects formed between one person's planets and the other's, including conjunctions, trines, squares, oppositions, and sextiles. These cross-chart aspects are the foundation of relationship astrology, revealing attraction, friction, and compatibility.
`divine_western_synastry_harmonious_reading`	Get harmonious aspect reading for a synastry pair. Returns interpretations of all harmonious aspects (trines, sextiles, conjunctions with benefics) between the two charts. These aspects indicate natural ease, mutual support, and areas where the relationship flows effortlessly.
`divine_western_synastry_conflicting_reading`	Get conflicting aspect reading for a synastry pair. Returns interpretations of conflicting aspects (squares, oppositions) between the two charts. These aspects indicate areas of friction, disagreement, and challenge that require conscious effort and compromise to navigate successfully.
`divine_western_synastry_contrasting_reading`	Get contrasting aspect reading for a synastry pair. Returns interpretations of contrasting aspects (quincunxes, semi-sextiles) between the two charts. These aspects indicate areas where the partners have fundamentally different approaches that require adjustment, adaptation, and willingness to accept differences.
`divine_western_synastry_intense_reading`	Get intense aspect reading for a synastry pair. Returns interpretations of intense aspects (Pluto aspects, Mars-Saturn, Sun-Pluto contacts) between the two charts. These aspects indicate deep transformative dynamics, power struggles, obsession, and profound psychological influence between partners.
`divine_western_synastry_physical_compat`	Get physical compatibility analysis for a synastry pair. Returns an assessment of physical attraction and chemistry between two persons based on Mars, Venus, Ascendant, and 5th/8th house overlays. Evaluates the strength of physical magnetism and bodily harmony.
`divine_western_synastry_emotional_compat`	Get emotional compatibility analysis for a synastry pair. Returns an assessment of emotional connection and nurturing patterns between two persons based on Moon contacts, Cancer/4th house overlays, and water sign emphasis. Evaluates how partners meet each other's emotional needs and provide comfort.
`divine_western_synastry_sexual_compat`	Get sexual compatibility analysis for a synastry pair. Returns an assessment of sexual chemistry and intimate compatibility based on Mars-Venus aspects, 8th house overlays, Pluto contacts, and Scorpio emphasis. Evaluates passion, desire, and intimate harmony between partners.
`divine_western_synastry_spiritual_compat`	Get spiritual compatibility analysis for a synastry pair. Returns an assessment of spiritual connection and shared higher purpose between two persons based on Neptune contacts, 9th/12th house overlays, and Jupiter aspects. Evaluates shared beliefs, transcendent experiences, and soul-level resonance.
`divine_western_synastry_financial_compat`	Get financial compatibility analysis for a synastry pair. Returns an assessment of financial harmony and shared material values between two persons based on 2nd/8th house overlays, Venus-Jupiter aspects, and Saturn contacts. Evaluates attitudes toward money, spending habits, and potential for shared wealth building.
`divine_western_transit_basic`	Get basic transit overview for the natal chart at a specific moment. Returns the planetary transits at the given transit date/time and their aspects to natal planets. Transits show how the sky at that moment activates the birth chart, indicating periods of opportunity, challenge, and transformation in various life areas.
`divine_western_custom_transit`	Get Western transit aspects for a custom transit moment - the natal birth chart plus a separate transit date, time, and place. All ten transit fields (transit_day, transit_month, transit_year, transit_hour, transit_min, transit_sec, transit_place, transit_lat, transit_lon, transit_tzone) are required. Returns natal-to-transit planetary aspects with orbs.
`divine_western_transit_daily`	Get daily transit report for the natal chart. Returns today's transits affecting the birth chart with interpretations. For a broader view, also call divine_western_transit_weekly and divine_western_transit_monthly in parallel.
`divine_western_transit_weekly`	Get weekly transit report for the natal chart. Returns this week's transits affecting the birth chart with interpretations. Covers the major planetary movements and aspects forming during the week, highlighting key days for action, reflection, or caution.
`divine_western_transit_monthly`	Get monthly transit report for the natal chart. Returns the chosen transit_planet's transits over the given month affecting the birth chart, with aspect start/peak/end timings. Covers the planet's movements and aspects that shape the month's themes.
`divine_western_transit_house`	Get transit house overlay report for the natal chart. Returns which natal houses the transiting planets are currently moving through, indicating which life areas are currently being activated and energized by cosmic influences.
`divine_western_full_transit`	Get a comprehensive full transit report for the natal chart. Returns a complete transit analysis including all transiting planet positions, aspects to natal planets, house transits, and detailed interpretations. This is the most thorough transit report available, combining daily, weekly, and monthly perspectives.
`divine_western_planet_retrograde_transit`	Get retrograde transit information for a specific planet. Returns retrograde periods for the specified planet during the given month and year. Retrograde periods are when a planet appears to move backward, traditionally associated with delays, review, and internalization of that planet's themes.
`divine_western_planet_combustion_transit`	Get combustion transit information for a specific planet. Returns combustion periods for the specified planet during the given month and year. Combustion occurs when a planet is too close to the Sun, becoming weakened or hidden. This affects the planet's ability to express its significations clearly.
`divine_western_transit_wheel_chart`	Generate a transit wheel chart overlaying current transits on the natal chart. Returns a visual wheel chart showing natal planet positions in the inner ring and current transit positions in the outer ring.
`divine_western_transit_planetary_positions`	Get planetary positions for both natal and transit charts. Returns detailed planetary positions for both the birth chart and the transit date, showing sign, degree, house placement, and aspects.
`divine_western_planetary_ingress`	Get planetary ingress data for a specific planet. Returns sign ingress dates for the specified planet during the given month and year. An ingress occurs when a planet moves from one zodiac sign to the next, marking significant shifts in energy and themes.
`divine_western_composite_planetary_positions`	Get planetary positions for the composite chart of two persons. The composite chart is created by calculating the midpoints of each pair of planets (e.g., midpoint of both Suns, midpoint of both Moons). It represents the relationship itself as an entity, revealing the purpose, dynamics, and potential of the partnership.
`divine_western_composite_house_cusps`	Get house cusps for the composite chart of two persons. Returns the house cusps of the composite (midpoint) chart, showing which life areas the relationship emphasizes. For example, a strong composite 7th house indicates a partnership-focused relationship, while a strong 10th house suggests a public or career-oriented union.
`divine_western_composite_aspect_table`	Get the aspect table for the composite chart of two persons. Returns all aspects between planets in the composite chart. These aspects describe the internal dynamics of the relationship, showing where the partnership flows easily (trines, sextiles) and where it faces structural challenges (squares, oppositions).
`divine_western_composite_natal_wheel_chart`	Generate a visual composite chart wheel image for two persons. Returns an image URL of the composite (midpoint) chart wheel showing the relationship's planetary placements, house cusps, and zodiac signs in a traditional circular format.
`divine_western_arabic_lots`	Get Arabic Lots (Parts) for the natal chart. Returns calculated Arabic Lots including the Part of Fortune, Part of Spirit, Part of Eros, Part of Marriage, and others. Arabic Lots are sensitive points derived from three chart factors (usually Ascendant, planet, and another planet), each revealing a specific life theme.
`divine_western_asteroid_positions`	Get asteroid positions in the natal chart. Returns positions of major asteroids including Chiron (the Wounded Healer), Ceres (nurturing), Pallas Athena (wisdom and strategy), Juno (partnership and commitment), and Vesta (devotion and sacred focus). Asteroids add nuance and depth to chart interpretation.
`divine_western_fixed_stars_list`	Get the catalog of fixed star names supported by the API. Returns the full list of fixed star identifiers (e.g. 'Abhijit', 'Acrux', 'Aldebaran') that can be passed to divine_western_fixed_stars_details via its star_list parameter. This endpoint needs no input; any provided fields are ignored.
`divine_western_fixed_stars_details`	Get detailed positions and placements for specific fixed stars. Returns each requested star's zodiac position, house placement, and motion relative to the natal chart. Pass the stars to analyze in star_list; valid star names come from divine_western_fixed_stars_list.
`divine_western_planetary_midpoints`	Get planetary midpoints for the natal chart. Returns all significant midpoints between natal planets. Midpoints are the halfway points between two planets, representing a blending of their energies. When activated by transits or other planets, midpoints can trigger important events. Central to the Uranian/Hamburg school of astrology.
`divine_western_eclipse`	Get eclipse information relative to the natal chart. Returns solar and lunar eclipses and their relationship to natal planets and points. Eclipses are powerful lunations that can trigger major life events, especially when they conjoin natal planets or angles. Their effects can unfold over months.
`divine_western_declinations_parallels`	Get declinations and parallels for the natal chart. Returns planetary declinations (distance north or south of the celestial equator) and parallel/contraparallel aspects. Parallels act like conjunctions and contraparallels like oppositions, adding a hidden layer of planetary connections not visible in standard longitude-based charts.
`divine_western_aspect_patterns`	Get aspect patterns in the natal chart. Returns identified aspect patterns such as Grand Trines, T-Squares, Grand Crosses, Yods (Finger of God), Kites, Mystic Rectangles, and Stelliums. These multi-planet configurations reveal core life themes, talents, and challenges that dominate the native's experience.
`divine_western_chart_shape`	Get the overall chart shape/pattern for the natal chart. Returns the chart shape classification (Bundle, Bowl, Bucket, Locomotive, Seesaw, Splash, Splay) based on planetary distribution. The chart shape provides immediate insight into the native's approach to life, energy distribution, and focus areas.
`divine_western_other_minor_bodies`	Get positions of other minor celestial bodies in the natal chart. Returns positions of additional minor bodies such as Lilith (Black Moon), the Lunar Nodes (North and South Node), Part of Fortune, Vertex, and other sensitive points that add depth to natal chart analysis.
`divine_western_dominants`	Get dominant planets, signs, and elements in the natal chart. Returns analysis of which planets, signs, elements (Fire, Earth, Air, Water), and modalities (Cardinal, Fixed, Mutable) dominate the chart. Dominance analysis reveals the native's core temperament, preferred mode of expression, and psychological orientation.
`divine_western_planet_returns_list`	Get a list of planetary returns for the natal chart. Returns dates when transiting planets return to their natal positions. The most well-known is the Solar Return (birthday chart), but lunar returns (monthly), Mercury returns, Venus returns, Mars returns, Jupiter returns (every 12 years), and Saturn returns (every 29 years) are all significant timing techniques.
`divine_western_planet_return_details`	Get detailed planetary return chart information. Returns the full chart details for a planetary return, including planet positions, house cusps, and aspects at the exact moment the transiting planet returns to its natal degree. The return chart is used to forecast themes for the upcoming cycle.
`divine_western_progressed_lunar_events`	Get progressed lunar events for the natal chart. Returns secondary progressed Moon phases, sign ingresses, and aspects. The progressed Moon moves about one degree per month (one sign every 2.5 years), marking major emotional and developmental shifts. Progressed New Moons and Full Moons indicate pivotal life chapters.
`divine_western_planetary_arc_directions`	Get planetary arc directions for the natal chart. Returns arc directions for the chosen planet to the given target date, a predictive technique where all natal planets are advanced by the planet's progressed distance. When directed planets aspect natal positions, they indicate significant life events and turning points.
`divine_western_secondary_progressions`	Get secondary progressions for the natal chart. Returns the secondary progressed chart where each day after birth equals one year of life. Secondary progressions reveal the inner psychological evolution of the native, showing gradual shifts in identity, emotional needs, and life direction over time.
`divine_western_prenatal_list`	Get a list of prenatal eclipses and lunations for the natal chart. Returns the prenatal eclipses (solar and lunar eclipses before birth) and the prenatal lunation (last New or Full Moon before birth). These prenatal celestial events are believed to set the karmic backdrop and soul-level intentions for the incarnation.
`divine_western_prenatal_details`	Get detailed prenatal eclipse and lunation analysis for the natal chart. Returns detailed interpretation of the prenatal eclipses and lunation, including their sign, degree, aspects to natal planets, and meaning. The prenatal eclipse degree is considered a sensitive point in the chart that remains active throughout life.

Setup Guide

Select your platform below for copy-paste-ready configuration.

VS Code (Copilot, Cline, Continue)

Add to .vscode/mcp.json:

{
  "servers": {
    "divineapi-indian-astrology": {
      "type": "http",
      "url": "https://mcp.divineapi.com/indian/mcp",
      "headers": {
        "X-Divine-Api-Key": "your_api_key_here",
        "X-Divine-Auth-Token": "your_auth_token_here"
      }
    }
  }
}

Note: Replace indian with western or horoscope for other servers. Works with GitHub Copilot (VS Code 1.102+), Cline, Continue, Roo Code. Reload VS Code after saving.

Claude Code

Run in terminal:

claude mcp add divineapi-indian '{"type":"http","url":"https://mcp.divineapi.com/indian/mcp","headers":{"X-Divine-Api-Key":"your_api_key_here","X-Divine-Auth-Token":"your_auth_token_here"}}'

Add --scope user to make it available across all projects. Run claude mcp list to verify.

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "divineapi-indian-astrology": {
      "url": "https://mcp.divineapi.com/indian/mcp",
      "headers": {
        "X-Divine-Api-Key": "your_api_key_here",
        "X-Divine-Auth-Token": "your_auth_token_here"
      }
    }
  }
}

Config location:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Restart Claude Desktop after saving.

ChatGPT (Custom Connector)

In ChatGPT open Settings, go to Apps & Connectors, then Advanced settings, and enable Developer mode. Click Create and fill in:

Name: Divine API - Indian Astrology
Server URL: https://mcp.divineapi.com/indian/mcp
Authentication: OAuth

Accept the custom-connector notice and click Create, then Sign in: ChatGPT redirects you to the Divine API login page, where you enter your API key and auth token. Replace indian with western or horoscope for the other servers.

Note: connecting and listing tools works on any ChatGPT plan; executing tools inside a chat requires a paid plan (an OpenAI platform limitation).

Claude Messages API

import Anthropic from "@anthropic-ai/sdk";

const anthropic = new Anthropic();

const response = await anthropic.beta.messages.create({
  model: "claude-sonnet-4-20250514",
  max_tokens: 1024,
  mcp_servers: [{
    type: "url",
    url: "https://mcp.divineapi.com/indian/mcp",
    name: "divineapi-indian-astrology",
    authorization_token: "your_api_key_here:your_auth_token_here"
  }],
  tools: [{ type: "mcp_toolset", mcp_server_name: "divineapi-indian-astrology" }],
  messages: [{ role: "user", content: "Your prompt here" }]
}, {
  headers: { "anthropic-beta": "mcp-client-2025-11-20" }
});

Pass both credentials joined by a colon as authorization_token (format: api_key:auth_token). No OAuth required.

OpenAI Agents SDK

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp

async def main():
    async with MCPServerStreamableHttp(
        name="DivineAPI",
        params={
            "url": "https://mcp.divineapi.com/indian/mcp",
            "headers": {
                "X-Divine-Api-Key": "your_api_key_here",
                "X-Divine-Auth-Token": "your_auth_token_here"
            }
        }
    ) as server:
        agent = Agent(
            name="Astrologer",
            instructions="Use DivineAPI tools to answer questions",
            mcp_servers=[server]
        )
        result = await Runner.run(agent, "Get today's horoscope for Aries")
        print(result.final_output)

asyncio.run(main())

Gemini / Python MCP Client

import asyncio
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

async def main():
    async with streamablehttp_client(
        "https://mcp.divineapi.com/indian/mcp",
        headers={
            "X-Divine-Api-Key": "your_api_key_here",
            "X-Divine-Auth-Token": "your_auth_token_here"
        }
    ) as (read_stream, write_stream, _):
        async with ClientSession(read_stream, write_stream) as session:
            await session.initialize()
            tools = await session.list_tools()
            print(f"Available tools: {[t.name for t in tools.tools]}")

asyncio.run(main())

Custom MCP Client (TypeScript)

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';

const client = new Client({ name: 'my-app', version: '1.0.0' });
const transport = new StreamableHTTPClientTransport(
  new URL('https://mcp.divineapi.com/indian/mcp'),
  { requestInit: { headers: {
    'X-Divine-Api-Key': 'your_api_key_here',
    'X-Divine-Auth-Token': 'your_auth_token_here'
  }}}
);
await client.connect(transport);
const tools = await client.listTools();
console.log(tools);

How It Works

The Model Context Protocol connects AI assistants to DivineAPI in four steps.

Step	Description
1. Discovery	Your AI client connects to the MCP endpoint and discovers all available astrology tools — their names, parameters, and descriptions.
2. User Prompt	You ask a question in natural language: "What's today's Panchang for Delhi?" or "Generate my natal chart."
3. Tool Execution	The AI selects the right tool(s), sends the request to DivineAPI via MCP, and receives structured astrological data.
4. Response	The AI formats the raw data into a clear, natural-language response — complete with interpretations and insights.

Authentication

Three ways to authenticate with DivineAPI MCP servers. All use your credentials from divineapi.com/api-keys.

Header-Based Auth (Recommended)

Pass your API key and auth token as HTTP headers with every request. Works with VS Code, Claude Code, Claude Desktop, OpenAI, Gemini, and custom clients.

X-Divine-Api-Key: your_api_key
X-Divine-Auth-Token: your_auth_token

Single Token (platforms with one credential field)

Some platforms can send only one token and no custom headers (for example the Claude Messages API MCP connector). Join your two credentials with a colon and pass them as the token:

Authorization: Bearer your_api_key:your_auth_token

OAuth 2.0 (Claude.ai)

For Claude.ai web connectors, OAuth is used automatically. Just enter the MCP URL in Settings → Connectors, and you'll be redirected to a login page to enter your credentials.

// Claude.ai Settings → Connectors
URL: https://mcp.divineapi.com/indian/mcp
// No Client ID needed — just click Add

What is MCP?

The Model Context Protocol is an open standard that lets AI assistants connect to external tools and data sources. Think of it as a universal adapter — instead of building separate plugins for every AI platform, one MCP server works everywhere.

DivineAPI's MCP servers expose 248 astrology, numerology, and horoscope tools that any AI assistant can discover and call. Your users ask questions in plain language, and the AI handles the rest.

Available Servers

Server	Endpoint URL	Tools
Indian / Vedic Astrology	`https://mcp.divineapi.com/indian/mcp`	128 tools
Western Astrology	`https://mcp.divineapi.com/western/mcp`	57 tools
Horoscope, Tarot & Numerology	`https://mcp.divineapi.com/horoscope/mcp`	63 tools