MCP tools

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

Tool	Summary
asterwise_check_mobile_number	Digit-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_sade_sati	Evaluates 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_check_vehicle_number	Strips 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_draw_tarot_cards	Draws N unique random cards from the 78-card deck using cryptographic randomness (Python secrets.SystemRandom)
asterwise_get_angel_number	Lookup the meaning of a specific angel number by its sequence
asterwise_get_angel_number_personal	Computes a personal angel number from a birth date using the Pythagorean Life Path as the base
asterwise_get_angel_number_today	Returns today's angel number computed from the current date
asterwise_get_ashtakavarga	Computes full Ashtakavarga bindu matrices, trikona and ekadhipatya reductions, and sarva totals from BirthData for transit support analysis.
asterwise_get_ashtottari_dasha	Computes 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_ayanamsha	Returns ayanamsha values for all four supported systems (Lahiri, Raman, KP, Tropical) for a given date.
asterwise_get_balance_number	Calculates the Balance number from the first letter of each name part, using Pythagorean values
asterwise_get_biorhythm	Computes physical (23-day), emotional (28-day), and intellectual (33-day) biorhythm cycles for a birth date.
asterwise_get_business_name_analysis	Reduces 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_numerology	Reduces 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_char_dasha	Computes 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_strength	Aggregates Shadbala, Bhavbala, Vimshopaka (with per-varga contributions), embedded sixteen vargas, Ashtakavarga, karaka maps, and graha yuddha pairs from BirthData.
asterwise_get_choghadiya	Splits 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_compatibility	Scores 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_crystal	Lookup a specific crystal by slug or name (case-insensitive)
asterwise_get_crystal_by_planet	Returns all crystals associated with a specific Vedic planet
asterwise_get_crystal_recommendations	Recommends crystals based on zodiac sign, chakra, or intention keyword
asterwise_get_crystal_recommendations_natal	Recommends crystals from a Vedic natal chart using house lordship rules for gem selection
asterwise_get_crystals	Returns all 50 crystals in the database sorted alphabetically
asterwise_get_dasha	Computes Vimshottari Dasha from birth data and returns hierarchical period trees plus current Maha/Antar interpretation blocks.
asterwise_get_dasha_transits	Combines active Vimshottari lords with today's transits and returns scored correlations plus transit longitudes and houses from Moon and Lagna.
asterwise_get_dashakoot	Computes 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_chart	Computes divisional (varga) chart positions from BirthData; pass chart_type for one varga, or omit chart_type for all sixteen.
asterwise_get_doshas	Scores twelve fixed dosha buckets from birth data and returns presence flags, typed detail objects, optional summaries, and remedy lines per dosha.
asterwise_get_dream_symbol	Lookup a specific dream symbol by slug or name (case-insensitive)
asterwise_get_dream_symbols	Returns dream symbols from the database with dual-tradition interpretation: Jungian/Western psychological analysis and traditional Vedic dream-symbol meaning
asterwise_get_expression_number	Calculates the Expression (Destiny) number from the full name using Pythagorean letter values
asterwise_get_festival_calendar	Computes all major Hindu festival dates for a given year and location
asterwise_get_gemstone_recommendations	Computes 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_chakra	Returns the four Ghatak (inauspicious) timing parameters for a native based on their Janma Rasi (natal Moon sign).
asterwise_get_gochar	Computes 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_hora	Builds 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_horoscope	Fetches an AI-synthesised Moon-sign horoscope for a chosen horizon and returns structured guidance fields plus metadata about the model and period.
asterwise_get_karmic_lessons	Identifies karmic lessons by scanning all letter values in the full name and finding which digits 1–9 are absent
asterwise_get_kp_chart	Builds 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_planets	Computes 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_significators	Computes 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_chart	Produces the Lal Kitab house and planet schema plus Rin (debt) flags from BirthData using Lal Kitab placement rules
asterwise_get_lal_kitab_remedies	Lists Lal Kitab style totkas per stressed planet from BirthData with priority tiers and typed action rows (remedy, donation, keep, avoid).
asterwise_get_lo_shu_grid	Derives 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_numbers	Fetches 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_number	Calculates the Maturity number as the sum of Life Path and Expression numbers, reduced to a single digit or master number
asterwise_get_muhurta	Searches a date span for top-scoring muhurta windows for a named activity using Panchanga, Choghadiya, and classical siddhi flags at a location.
asterwise_get_nakshatra_details	Looks 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_prediction	Returns a personalised daily prediction using Tarabala and Chandrabala.
asterwise_get_name_correction	Scores 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_natal_chart	Computes the full sidereal natal chart from BirthData and returns planet rows, houses, aspects, arudhas, upapada, bhava cusps, and avakhada metadata.
asterwise_get_number_meaning	Returns dictionary-style numerology copy for a single integer, including interpretation, keywords, and stubbed extended fields.
asterwise_get_numerology_compatibility	Compares 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_profile	Builds a Pythagorean numerology profile from a legal name and birth date and returns core numbers, cycles, lucky digits, and summary copy.
asterwise_get_panchanga	Computes Panchanga elements for one calendar date at a geographic location and returns tithi, vara, nakshatra, yoga, karana, and end times in UTC.
asterwise_get_panchanga_calendar	Returns one row per civil day for a calendar month at a location with condensed tithi, vara, nakshatra, yoga, karana, and rahu_kaal columns.
asterwise_get_papasamyam	Measures malefic stress from Lagna, Moon, and Venus references for each partner, compares totals, and labels compatibility level against a threshold.
asterwise_get_personal_cycles	Returns the Personal Year, Personal Month, and Personal Day numbers for a given birth date and optional target date
asterwise_get_personal_year	Looks 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_number	Calculates the Personality number from consonants in the full name
asterwise_get_pitra_dosha	Detects and analyses Pitru Dosha (Pitru Shapa — Ancestral Curse) using all five classical Pitru Dosha combinations.
asterwise_get_planet_nature	Returns classical graha (planet) properties for all nine planets or a single planet per classical Vedic tradition.
asterwise_get_porutham	Runs 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_chart	Casts 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_suggestions	Returns puja (ritual worship) recommendations for planetary propitiation per graha.
asterwise_get_rahu_kaal	Computes 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_remedies	Derives classical remedial prescriptions from planetary weakness and dusthana lordship and returns mantra, lifestyle, charity, and dignity tables.
asterwise_get_rudraksha	Returns Rudraksha bead recommendations per planet.
asterwise_get_soul_urge_number	Calculates the Soul Urge (Heart's Desire) number from vowels in the full name
asterwise_get_special_ascendants	Calls atmakaraka and ishta-devata endpoints sequentially and merges their payloads into top-level atmakaraka and ishta_devata objects for one BirthData.
asterwise_get_tamil_panchanga	Returns Tamil-specific Panchanga for a date and location: all four inauspicious periods (Rahu Kalam, Yamagandam, Kuligai, Emagandam), Nalla Neram (auspicious daytime windows between inauspicious periods), and the Tamil solar month name based on the Sun's sidereal sign at sunrise.
asterwise_get_tarot_card	Returns full structured data for a single card identified by its slug ID
asterwise_get_tarot_card_of_the_day	Returns a deterministic daily tarot card seeded by SHA-256 hash of the date string
asterwise_get_tarot_cards	Returns the complete 78-card Rider-Waite-Smith deck with full metadata
asterwise_get_tarot_celtic_cross	Ten-card Celtic Cross spread — traditional ten-position tarot layout
asterwise_get_tarot_major_arcana	Returns all 22 Major Arcana cards (The Fool through The World) as a structured array
asterwise_get_tarot_suit	Returns all 14 cards in a given Minor Arcana suit as a structured array.
asterwise_get_tarot_three_card_spread	Past / Present / Future spread
asterwise_get_tarot_yes_no	Draws one card and returns a yes, no, or maybe answer with confidence level
asterwise_get_thirumana_porutham	Evaluates twelve Tamil Thirumana poruthams for two charts, tracks veto severity for Rajju, and returns an expanded breakdown map with tradition metadata.
asterwise_get_transits	Lists sign ingresses and retrograde/direct stations for all planets between two dates against the natal context and returns chronological astronomical events.
asterwise_get_varshaphal	Computes 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_bala	Computes Harsha Bala (positional happiness score) for all 7 classical planets in a Varshaphal solar return chart
asterwise_get_varshaphal_saham	Computes all 10 Tajika Saham (sensitive points) for a Varshaphal solar return chart
asterwise_get_western_aspects	Calculates all active aspects between a supplied set of planetary longitudes
asterwise_get_western_compatibility	Overall compatibility score (0–100) between two natal charts
asterwise_get_western_composite	Midpoint composite chart for two people
asterwise_get_western_horoscope	Fetches 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_return	Next lunar return chart after a given date
asterwise_get_western_moon_calendar	Returns lunar phase data for every day in a calendar month as a structured array
asterwise_get_western_moon_phase	Calculates the tropical lunar phase for any date using Swiss Ephemeris
asterwise_get_western_natal	Calculate a complete Western natal chart using the tropical zodiac and Swiss Ephemeris
asterwise_get_western_planetary_return	Next return chart for any planet after a given date
asterwise_get_western_secondary_progressions	Secondary progressed chart using the day-for-a-year method
asterwise_get_western_solar_arc	Solar Arc Directions for a target date
asterwise_get_western_solar_return	Solar return chart for a given year
asterwise_get_western_synastry	Aspect grid between two natal charts using the tropical zodiac
asterwise_get_western_transits_daily	Current sky positions vs natal chart for a single day
asterwise_get_western_transits_monthly	30-day transit window vs natal chart
asterwise_get_western_transits_weekly	7-day transit window vs natal chart
asterwise_get_western_zodiac_compatibility	Sign-to-sign compatibility without birth data
asterwise_get_yogas	Evaluates the natal chart for named classical yogas and returns category, formation text, classical results, modern summaries, and keywords per hit.
asterwise_get_yogini_dasha	Computes the eight-Yogini, 36-year Yogini Dasha cycle with two-level period trees and DD/MM/YYYY boundaries from birth data.