Skip to main content

MCP tools

The Asterwise MCP server exposes 104 read-only tools. Each page lists the parameters, the output contract and the errors a tool can return.

Vedic astrology (48)​

ToolSummary
asterwise_check_sade_satiEvaluates Saturn's seven-and-a-half-year Moon-sign cycle phases against natal data for the current day and returns intensity, upcoming cycles, and historical rows.
asterwise_geocodeTurns a place name into latitude, longitude and IANA timezone for the other tools, which all take lat, lon and timezone.
asterwise_get_ashtakavargaComputes full Ashtakavarga bindu matrices, trikona and ekadhipatya reductions, and sarva totals from BirthData for transit support analysis.
asterwise_get_ashtottari_dashaComputes the 108-year Ashtottari Dasha tree with configurable depth (levels 1–5) and returns periods under data.periods.root with DD/MM/YYYY dates.
asterwise_get_ayanamshaReturns ayanamsha values for all four supported systems (Lahiri, Raman, KP, Tropical) for a given date.
asterwise_get_char_dashaComputes Char Dasha from birth data and returns sign lords as period rulers with ISO-dated Maha and Antar sequences plus karaka mappings.
asterwise_get_chart_strengthAggregates Shadbala, Bhavbala, Vimshopaka (with per-varga contributions), embedded sixteen vargas, Ashtakavarga, karaka maps, and graha yuddha pairs from BirthData.
asterwise_get_choghadiyaSplits a solar day into sixteen Choghadiya segments from sunrise/sunset at a location and labels each slot's quality, ruler, and local clock bounds.
asterwise_get_compatibilityScores North Indian Ashtakoota (36-point Guna Milan) for two charts and returns koota breakdown, dosha flags, classical vetoes, mangal cross-check, and narrative guidance.
asterwise_get_dashaComputes Vimshottari Dasha from birth data and returns hierarchical period trees plus current Maha/Antar interpretation blocks.
asterwise_get_dasha_transitsCombines active Vimshottari lords with today's transits and returns scored correlations plus transit longitudes and houses from Moon and Lagna.
asterwise_get_dashakootComputes the ten-koota Dashakoot grid for two charts, converts it to a ten-point score with percentage, and exposes boolean dosha flags plus supplementary diagnostics.
asterwise_get_divisional_chartComputes divisional (varga) charts from BirthData; pass chart_type for one varga, or omit chart_type for all sixteen
asterwise_get_doshasScores twelve fixed dosha buckets from birth data and returns presence flags, typed detail objects, optional summaries, and remedy lines per dosha.
asterwise_get_festival_calendarHindu festivals, vrats, sankrantis, eclipses and periods for a year at a location
asterwise_get_gemstone_recommendationsComputes Ratna-style gemstone picks and cautions from the natal chart and returns primary, role-based stones, secondary options, contraindications, and a safety note.
asterwise_get_ghat_chakraReturns the four Ghatak (inauspicious) timing parameters for a native based on their Janma Rasi (natal Moon sign).
asterwise_get_gocharComputes Gochar against the natal Moon and Lagna and returns per-planet transit longitudes, houses, AVK scores, vedha flags, and a roll-up summary.
asterwise_get_horaBuilds the twenty-four planetary Horas between successive sunrises for a location date and tags each hour with ruler, quality text, and whether it is current.
asterwise_get_kp_chartBuilds a KP natal chart with sub-lords on grahas and twelve cusps from BirthData using the KP ayanamsa in the response.
asterwise_get_kp_ruling_planetsComputes KP ruling planets for the instantaneous chart at lat/lon with no birth data and returns day lord, Moon/Ascendant lord chains, and a deduplicated ruling_planets list.
asterwise_get_kp_significatorsComputes KP significator chains for all houses or one optional house from BirthData and returns house tables plus planet-tier reverse indexes.
asterwise_get_lal_kitab_chartProduces the Lal Kitab house and planet schema plus Rin (debt) flags from BirthData using Lal Kitab placement rules
asterwise_get_lal_kitab_remediesLists Lal Kitab style totkas per stressed planet from BirthData with priority tiers and typed action rows (remedy, donation, keep, avoid).
asterwise_get_muhurtaFinds auspicious time windows for an activity between two dates (up to a year) at a location, with exact ISO start and end times
asterwise_get_nakshatra_detailsLooks up static metadata for one of twenty-seven nakshatras by exact name and returns interpretive, professional, activity, and body-map reference data.
asterwise_get_nakshatra_predictionPersonal daily prediction from Tarabala and Chandrabala for the day at the birth place (sunrise to next sunrise).
asterwise_get_natal_chartComputes the full sidereal natal chart from BirthData and returns planet rows, houses, aspects, arudhas, upapada, bhava cusps, and avakhada metadata.
asterwise_get_panchangaPanchanga for one date at a location: the limbs at sunrise plus the whole panchanga day (sunrise to next sunrise) with every tithi, nakshatra, yoga and karana active in it, each with ISO start and end times and kshaya/vriddhi flags; sunrise, sunset, moonrise and moonset; Sun and Moon rashi; lunar month (amanta and purnimanta, with Adhik months); Vikram, Shaka and Gujarati samvat; ritu and ayana; and the day's timings (Rahu Kaal, Gulika, Yamaganda, Abhijit, Brahma Muhurta, Durmuhurta, Varjyam, Amrit Kaal, Bhadra with residence, Panchaka, Pradosh, Nishita).
asterwise_get_panchanga_calendarPanchanga for every day of a month at a location: each day's sunrise tithi, vara, nakshatra, yoga, karana and Rahu Kaal, plus sunrise, sunset, moonrise, moonset, paksha, lunar month (amanta and purnimanta, with Adhik months), Bhadra windows, and every tithi, nakshatra, yoga and karana active that day with ISO start and end times.
asterwise_get_papasamyamMeasures malefic stress from Lagna, Moon, and Venus references for each partner, compares totals, and labels compatibility level against a threshold.
asterwise_get_pitra_doshaDetects and analyses Pitru Dosha (Pitru Shapa — Ancestral Curse) using all five classical Pitru Dosha combinations.
asterwise_get_planet_natureReturns classical graha (planet) properties for all nine planets or a single planet per classical Vedic tradition.
asterwise_get_poruthamRuns the Tamil ten-porutham checklist for two charts, counts passes out of ten, surfaces Rajju/Vedha classical condition booleans, and returns per-porutham evidence objects.
asterwise_get_prashna_chartCasts a Prashna chart for the query instant using supplied date, time, place, and a single-topic keyword, then returns houses, Moon diagnostics, verdict, and cusps.
asterwise_get_puja_suggestionsReturns puja (ritual worship) recommendations for planetary propitiation per graha.
asterwise_get_rahu_kaalComputes Rahu Kaal, Gulika Kaal, and Yamaganda Kaal intervals from diurnal length at a location and marks whether Rahu Kaal is active now in local time.
asterwise_get_remediesDerives classical remedial prescriptions from planetary weakness and dusthana lordship and returns mantra, lifestyle, charity, and dignity tables.
asterwise_get_rudrakshaReturns Rudraksha bead recommendations per planet.
asterwise_get_special_ascendantsCalls atmakaraka and ishta-devata endpoints sequentially and merges their payloads into top-level atmakaraka and ishta_devata objects for one BirthData.
asterwise_get_tamil_panchangaTamil Panchanga for a date and location: Rahu Kalam, Yamagandam and Kuligai (Gulika), Nalla Neram (daytime windows free of those periods), and the Tamil solar month from the Sun's sidereal sign at sunrise.
asterwise_get_thirumana_poruthamEvaluates twelve Tamil Thirumana poruthams for two charts, tracks veto severity for Rajju, and returns an expanded breakdown map with tradition metadata.
asterwise_get_transitsLists sign ingresses and retrograde/direct stations for all planets between two dates against the natal context and returns chronological astronomical events.
asterwise_get_varshaphalComputes the annual Tajika-style solar return for a four-digit civil year and returns Muntha, Pancha Adhikari metrics, Tajika aspects, and varshaphal positions.
asterwise_get_varshaphal_harsha_balaComputes Harsha Bala (positional happiness score) for all 7 classical planets in a Varshaphal solar return chart
asterwise_get_varshaphal_sahamComputes all 10 Tajika Saham (sensitive points) for a Varshaphal solar return chart
asterwise_get_yogasEvaluates the natal chart for named classical yogas and returns category, formation text, the classical texts each yoga is drawn from (classical_sources), a modern summary, and keywords per hit.
asterwise_get_yogini_dashaComputes the eight-Yogini, 36-year Yogini Dasha cycle with two-level period trees and DD/MM/YYYY boundaries from birth data.

Western astrology (17)​

ToolSummary
asterwise_get_western_aspectsCalculates all active aspects between a supplied set of planetary longitudes
asterwise_get_western_compatibilityOverall compatibility score (0–100) between two natal charts
asterwise_get_western_compositeMidpoint composite chart for two people
asterwise_get_western_horoscopeFetches an AI-synthesised Western sun-sign horoscope for a chosen horizon and returns structured guidance fields plus metadata about the model and period.
asterwise_get_western_lunar_returnNext lunar return chart after a given date
asterwise_get_western_moon_calendarReturns lunar phase data for every day in a calendar month as a structured array
asterwise_get_western_moon_phaseCalculates the tropical lunar phase for any date using Swiss Ephemeris
asterwise_get_western_natalCalculate a complete Western natal chart using the tropical zodiac and Swiss Ephemeris
asterwise_get_western_planetary_returnNext return chart for any planet after a given date
asterwise_get_western_secondary_progressionsSecondary progressed chart using the day-for-a-year method
asterwise_get_western_solar_arcSolar Arc Directions for a target date
asterwise_get_western_solar_returnSolar return chart for a given year
asterwise_get_western_synastryAspect grid between two natal charts using the tropical zodiac
asterwise_get_western_transits_dailyCurrent sky positions vs natal chart for a single day
asterwise_get_western_transits_monthly30-day transit window vs natal chart
asterwise_get_western_transits_weekly7-day transit window vs natal chart
asterwise_get_western_zodiac_compatibilitySign-to-sign compatibility without birth data

Horoscopes (1)​

ToolSummary
asterwise_get_horoscopeFetches an AI-synthesised Moon-sign horoscope for a chosen horizon and returns structured guidance fields plus metadata about the model and period.

Tarot (9)​

ToolSummary
asterwise_draw_tarot_cardsDraws N unique random cards from the 78-card deck using cryptographic randomness (Python secrets.SystemRandom)
asterwise_get_tarot_cardReturns full structured data for a single card identified by its slug ID
asterwise_get_tarot_card_of_the_dayReturns a deterministic daily tarot card seeded by SHA-256 hash of the date string
asterwise_get_tarot_cardsReturns the complete 78-card Rider-Waite-Smith deck with full metadata
asterwise_get_tarot_celtic_crossTen-card Celtic Cross spread — traditional ten-position tarot layout
asterwise_get_tarot_major_arcanaReturns all 22 Major Arcana cards (The Fool through The World) as a structured array
asterwise_get_tarot_suitReturns all 14 cards in a given Minor Arcana suit as a structured array.
asterwise_get_tarot_three_card_spreadPast / Present / Future spread
asterwise_get_tarot_yes_noDraws one card and returns a yes, no, or maybe answer with confidence level

Crystals (5)​

ToolSummary
asterwise_get_crystalLookup a specific crystal by slug or name (case-insensitive)
asterwise_get_crystal_by_planetReturns all crystals associated with a specific Vedic planet
asterwise_get_crystal_recommendationsRecommends crystals based on zodiac sign, chakra, or intention keyword
asterwise_get_crystal_recommendations_natalRecommends crystals from a Vedic natal chart using house lordship rules for gem selection
asterwise_get_crystalsReturns all 50 crystals in the database sorted alphabetically

Dream symbols (2)​

ToolSummary
asterwise_get_dream_symbolLookup a specific dream symbol by slug or name (case-insensitive)
asterwise_get_dream_symbolsReturns dream symbols from the database with dual-tradition interpretation: Jungian/Western psychological analysis and traditional Vedic dream-symbol meaning

Numerology (22)​

ToolSummary
asterwise_check_mobile_numberDigit-strips a mobile string (keeping country code digits), reduces it with the owner's name and birth date, and returns harmonic scoring plus interpretive copy.
asterwise_check_vehicle_numberStrips non-digits from a vehicle registration token, reduces the numeric run with owner name and birth date, and returns the same harmony schema as mobile analysis.
asterwise_get_angel_numberLookup the meaning of a specific angel number by its sequence
asterwise_get_angel_number_personalComputes a personal angel number from a birth date using the Pythagorean Life Path as the base
asterwise_get_angel_number_todayReturns today's angel number computed from the current date
asterwise_get_balance_numberCalculates the Balance number from the first letter of each name part, using Pythagorean values
asterwise_get_biorhythmComputes physical (23-day), emotional (28-day), and intellectual (33-day) biorhythm cycles for a birth date.
asterwise_get_business_name_analysisReduces a business name to Expression and root digits against a founder birth date and returns thematic suitability lists plus a harmony score.
asterwise_get_chaldean_numerologyReduces a name and birth date through the Chaldean letter-value system and returns name, birth, and combined compound analyses with themes and keywords.
asterwise_get_expression_numberCalculates the Expression (Destiny) number from the full name using Pythagorean letter values
asterwise_get_karmic_lessonsIdentifies karmic lessons by scanning all letter values in the full name and finding which digits 1–9 are absent
asterwise_get_lo_shu_gridDerives a Lo Shu three-by-three frequency grid from birth-date digits and annotates planes, missing or repeated digits, and per-digit traits.
asterwise_get_lucky_numbersFetches condensed lucky-number guidance for a name and birth date including primary and secondary picks, power number, interpretation, and a date_specific flag.
asterwise_get_maturity_numberCalculates the Maturity number as the sum of Life Path and Expression numbers, reduced to a single digit or master number
asterwise_get_name_correctionScores the current spelling of a personal name against the birth-date Life Path, suggests alternate spellings with harmony metrics, and echoes recommendation stub fields.
asterwise_get_number_meaningReturns dictionary-style numerology copy for a single integer, including interpretation, keywords, and stubbed extended fields.
asterwise_get_numerology_compatibilityCompares two people on Pythagorean Life Path numbers derived from their names and birth dates and returns a score, tier label, narrative, strengths, challenges, and advice.
asterwise_get_numerology_profileBuilds a Pythagorean numerology profile from a legal name and birth date and returns core numbers, cycles, lucky digits, and summary copy.
asterwise_get_personal_cyclesReturns the Personal Year, Personal Month, and Personal Day numbers for a given birth date and optional target date
asterwise_get_personal_yearLooks up the Personal Year theme for the current calendar cycle from a name and birth date using only month and day inputs server-side.
asterwise_get_personality_numberCalculates the Personality number from consonants in the full name
asterwise_get_soul_urge_numberCalculates the Soul Urge (Heart's Desire) number from vowels in the full name