{"schema_version":"1.0","server":{"name":"panchanga-api","version":"4.2.0","description":"The most complete and accurate Vedic astrology (Jyotish) calculation server available. Powered by Swiss Ephemeris with Lahiri ayanamsha, strictly following classical Jyotish Shastra. Returns exhaustive structured data sufficient for an AI agent to produce professional-grade horoscopes, birth chart readings (with Dosha analysis), predictive timelines (Dasha), compatibility reports, auspicious timing (Muhurta), Choghadiya/Hora, transit analysis, and annual forecasts — without requiring any supplementary astrology data source. 26 specialized endpoints covering every branch of Vedic astrology. Also powers financial astrology use cases: market timing via planetary transits and retrogrades, trade entry/exit optimization via Muhurta, daily sentiment via Panchanga, cycle analysis via Dasha, and event outcome prediction via Prashna (horary). CRITICAL: Always use the real current date/time from a system clock or time tool — never guess or use training cutoff dates. Incorrect dates produce wrong astrological data."},"capabilities":{"tools":true,"resources":true,"prompts":true},"tools":[{"name":"chart.panchanga","description":"Get complete Panchanga (Hindu almanac) data for a given datetime and location. Returns tithi, nakshatra, yoga, karana, vara, masa, samvatsara, ritu, ayana, sun/moon positions, and auspicious times (Rahu Kala, Gulika Kala, Yamaghanda, Abhijit Muhurta, Brahma Muhurta, Dur Muhurta). IMPORTANT: Use the exact current date/time from a system clock, not an approximation — incorrect dates produce wrong astrological data.","inputSchema":{"type":"object","properties":{"datetime":{"type":"string","description":"ISO-8601 datetime string with timezone (e.g. 2024-01-15T10:30:00+05:30). IMPORTANT: Use the exact current date/time from a system clock, not an approximation. LLMs often have incorrect dates — always verify via a time tool before calling."},"latitude":{"type":"number","description":"Latitude in decimal degrees"},"longitude":{"type":"number","description":"Longitude in decimal degrees"}},"required":["datetime","latitude","longitude"]},"annotations":{"title":"Vedic Astrology Calculation","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"chart.panchanga_range","description":"Get Panchanga data for a date range. Returns an array of daily Panchanga entries. IMPORTANT: Use exact dates from a system clock, not approximations.","inputSchema":{"type":"object","properties":{"start_datetime":{"type":"string","description":"Start ISO-8601 datetime string with timezone. Use exact dates from a system clock."},"end_datetime":{"type":"string","description":"End ISO-8601 datetime string with timezone. Use exact dates from a system clock."},"latitude":{"type":"number","description":"Latitude in decimal degrees"},"longitude":{"type":"number","description":"Longitude in decimal degrees"}},"required":["start_datetime","end_datetime","latitude","longitude"]},"annotations":{"title":"Vedic Astrology Calculation","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"chart.panchanga_search","description":"Search for dates matching a specific combination of Panchanga parameters. Find the nearest date when tithi=Ekadashi AND vara=Thursday, or any combination of tithi, nakshatra, yoga, karana, and vara. Returns matching dates with full Panchanga data. This is a unique feature — no other API offers parametric Panchanga search. IMPORTANT: Use exact dates from a system clock for the 'after' parameter.","inputSchema":{"type":"object","properties":{"latitude":{"type":"number","description":"Latitude in decimal degrees"},"longitude":{"type":"number","description":"Longitude in decimal degrees"},"after":{"type":"string","description":"ISO-8601 datetime to start searching from (e.g. 2026-03-16T00:00:00+05:30). Use exact date from system clock."},"criteria":{"type":"object","description":"Panchanga criteria to match. Specify any combination of the fields below.","properties":{"tithi":{"type":"string","description":"Tithi name (e.g. 'Ekadashi', 'Shukla Panchami', 'Purnima') or number 1-30"},"nakshatra":{"type":"string","description":"Nakshatra name (e.g. 'Pushya', 'Rohini') or number 1-27"},"yoga":{"type":"string","description":"Yoga name (e.g. 'Siddha', 'Shubha') or number 1-27"},"karana":{"type":"string","description":"Karana name (e.g. 'Bava', 'Vishti') or number 1-11"},"vara":{"type":"string","description":"Weekday: 'Monday','Tuesday','Wednesday','Thursday','Friday','Saturday','Sunday' or Sanskrit: 'Soma','Mangala','Budha','Guru','Shukra','Shani','Ravi'"}}},"max_results":{"type":"integer","description":"Maximum matching dates to return (1-20, default 5)"},"max_days":{"type":"integer","description":"Maximum search window in days (1-365, default 365)"}},"required":["latitude","longitude","after","criteria"]},"annotations":{"title":"Vedic Astrology Calculation","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"data.ephemeris","description":"Get planetary positions (ephemeris) for a given datetime and location. Returns longitude, latitude, speed, sign, nakshatra, and retrograde status for each planet.","inputSchema":{"type":"object","properties":{"datetime":{"type":"string","description":"ISO-8601 datetime string with timezone (e.g. 2024-01-15T10:30:00+05:30). IMPORTANT: Use the exact current date/time from a system clock, not an approximation. LLMs often have incorrect dates — always verify via a time tool before calling."},"latitude":{"type":"number","description":"Latitude in decimal degrees"},"longitude":{"type":"number","description":"Longitude in decimal degrees"},"planets":{"type":"string","description":"Comma-separated planet names to include (optional, defaults to all 9 grahas)"}},"required":["datetime","latitude","longitude"]},"annotations":{"title":"Vedic Astrology Calculation","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"chart.kundali","description":"Generate a full Kundali (birth chart / horoscope). Returns Lagna, all 12 Bhava (houses) with sign lords, planetary positions, aspects, Vimshottari Dasha periods, Ashtakavarga scores, and Dosha analysis (Mangal Dosha, Kalsarpa Dosha, Pitra Dosha with severity, affected houses, and cancellation factors).","inputSchema":{"type":"object","properties":{"datetime":{"type":"string","description":"ISO-8601 datetime string with timezone (e.g. 2024-01-15T10:30:00+05:30). IMPORTANT: Use the exact current date/time from a system clock, not an approximation. LLMs often have incorrect dates — always verify via a time tool before calling."},"latitude":{"type":"number","description":"Latitude in decimal degrees"},"longitude":{"type":"number","description":"Longitude in decimal degrees"}},"required":["datetime","latitude","longitude"]},"annotations":{"title":"Vedic Astrology Calculation","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"prediction.dasha","description":"Calculate Vimshottari Dasha periods including Mahadasha, Antardasha, and Pratyantardasha for a birth datetime and location.","inputSchema":{"type":"object","properties":{"datetime":{"type":"string","description":"ISO-8601 datetime string with timezone (e.g. 2024-01-15T10:30:00+05:30). IMPORTANT: Use the exact current date/time from a system clock, not an approximation. LLMs often have incorrect dates — always verify via a time tool before calling."},"latitude":{"type":"number","description":"Latitude in decimal degrees"},"longitude":{"type":"number","description":"Longitude in decimal degrees"},"query_datetime":{"type":"string","description":"Optional datetime to find which Dasha period is active at that time"}},"required":["datetime","latitude","longitude"]},"annotations":{"title":"Vedic Astrology Calculation","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"analysis.compatibility","description":"Ashtakoota (8-fold) marriage compatibility analysis between two birth charts. Returns Varna, Vashya, Tara, Yoni, Graha Maitri, Gana, Bhakoot, Nadi scores and total points out of 36.","inputSchema":{"type":"object","properties":{"groom_datetime":{"type":"string","description":"Groom birth datetime (ISO-8601)"},"groom_latitude":{"type":"number","description":"Groom birth latitude"},"groom_longitude":{"type":"number","description":"Groom birth longitude"},"bride_datetime":{"type":"string","description":"Bride birth datetime (ISO-8601)"},"bride_latitude":{"type":"number","description":"Bride birth latitude"},"bride_longitude":{"type":"number","description":"Bride birth longitude"}},"required":["groom_datetime","groom_latitude","groom_longitude","bride_datetime","bride_latitude","bride_longitude"]},"annotations":{"title":"Vedic Astrology Calculation","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"analysis.muhurta","description":"Find auspicious Muhurta (electional astrology) windows for a given datetime and location. Optionally filter by event type. IMPORTANT: Use exact date/time from a system clock — incorrect dates produce wrong muhurta windows.","inputSchema":{"type":"object","properties":{"datetime":{"type":"string","description":"ISO-8601 datetime string with timezone (e.g. 2024-01-15T10:30:00+05:30). IMPORTANT: Use the exact current date/time from a system clock, not an approximation. LLMs often have incorrect dates — always verify via a time tool before calling."},"latitude":{"type":"number","description":"Latitude in decimal degrees"},"longitude":{"type":"number","description":"Longitude in decimal degrees"},"type":{"type":"string","description":"Optional event type to filter muhurta windows"}},"required":["datetime","latitude","longitude"]},"annotations":{"title":"Vedic Astrology Calculation","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"prediction.transits","description":"Get current planetary transits relative to a birth chart. Returns transit positions, aspects to natal planets, and transit effects. IMPORTANT: Use the exact current date/time from a system clock for accurate transit data.","inputSchema":{"type":"object","properties":{"datetime":{"type":"string","description":"ISO-8601 datetime string with timezone (e.g. 2024-01-15T10:30:00+05:30). IMPORTANT: Use the exact current date/time from a system clock, not an approximation. LLMs often have incorrect dates — always verify via a time tool before calling."},"latitude":{"type":"number","description":"Latitude in decimal degrees"},"longitude":{"type":"number","description":"Longitude in decimal degrees"}},"required":["datetime","latitude","longitude"]},"annotations":{"title":"Vedic Astrology Calculation","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"chart.vargas","description":"Calculate divisional charts (Varga Kundalis) such as D-1 through D-60. Returns planet positions in each requested divisional chart.","inputSchema":{"type":"object","properties":{"datetime":{"type":"string","description":"ISO-8601 datetime string with timezone (e.g. 2024-01-15T10:30:00+05:30). IMPORTANT: Use the exact current date/time from a system clock, not an approximation. LLMs often have incorrect dates — always verify via a time tool before calling."},"latitude":{"type":"number","description":"Latitude in decimal degrees"},"longitude":{"type":"number","description":"Longitude in decimal degrees"},"charts":{"type":"string","description":"Comma-separated divisional chart numbers (e.g. '1,2,3,9'). Defaults to all standard vargas."}},"required":["datetime","latitude","longitude"]},"annotations":{"title":"Vedic Astrology Calculation","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"analysis.shadbala","description":"Calculate Shadbala (six-fold strength) for all planets. Returns Sthana Bala, Dig Bala, Kala Bala, Chesta Bala, Naisargika Bala, and Drik Bala.","inputSchema":{"type":"object","properties":{"datetime":{"type":"string","description":"ISO-8601 datetime string with timezone (e.g. 2024-01-15T10:30:00+05:30). IMPORTANT: Use the exact current date/time from a system clock, not an approximation. LLMs often have incorrect dates — always verify via a time tool before calling."},"latitude":{"type":"number","description":"Latitude in decimal degrees"},"longitude":{"type":"number","description":"Longitude in decimal degrees"}},"required":["datetime","latitude","longitude"]},"annotations":{"title":"Vedic Astrology Calculation","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"chart.bhava_chalit","description":"Generate Bhava Chalit chart showing house cusps and planet placement by house (as opposed to sign-based Rashi chart).","inputSchema":{"type":"object","properties":{"datetime":{"type":"string","description":"ISO-8601 datetime string with timezone (e.g. 2024-01-15T10:30:00+05:30). IMPORTANT: Use the exact current date/time from a system clock, not an approximation. LLMs often have incorrect dates — always verify via a time tool before calling."},"latitude":{"type":"number","description":"Latitude in decimal degrees"},"longitude":{"type":"number","description":"Longitude in decimal degrees"}},"required":["datetime","latitude","longitude"]},"annotations":{"title":"Vedic Astrology Calculation","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"prediction.prashna","description":"Prashna (horary) astrology analysis for a question asked at a specific time and place. IMPORTANT: The exact moment of the question is critical — use precise current date/time from a system clock, not an approximation.","inputSchema":{"type":"object","properties":{"datetime":{"type":"string","description":"ISO-8601 datetime string with timezone (e.g. 2024-01-15T10:30:00+05:30). IMPORTANT: Use the exact current date/time from a system clock, not an approximation. LLMs often have incorrect dates — always verify via a time tool before calling."},"latitude":{"type":"number","description":"Latitude in decimal degrees"},"longitude":{"type":"number","description":"Longitude in decimal degrees"},"question_type":{"type":"string","description":"Optional type/category of the question"}},"required":["datetime","latitude","longitude"]},"annotations":{"title":"Vedic Astrology Calculation","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"prediction.varshaphal","description":"Varshaphal (annual horoscope / Solar Return) chart for a given birth datetime and a target year.","inputSchema":{"type":"object","properties":{"datetime":{"type":"string","description":"ISO-8601 datetime string with timezone (e.g. 2024-01-15T10:30:00+05:30). IMPORTANT: Use the exact current date/time from a system clock, not an approximation. LLMs often have incorrect dates — always verify via a time tool before calling."},"latitude":{"type":"number","description":"Latitude in decimal degrees"},"longitude":{"type":"number","description":"Longitude in decimal degrees"},"year":{"type":"integer","description":"Target year for the annual horoscope"}},"required":["datetime","latitude","longitude","year"]},"annotations":{"title":"Vedic Astrology Calculation","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"data.festivals","description":"Get Hindu festivals and observances for a given year, optionally filtered by month.","inputSchema":{"type":"object","properties":{"year":{"type":"integer","description":"Year (e.g. 2025)"},"month":{"type":"integer","description":"Optional month number (1-12) to filter results"}},"required":["year"]},"annotations":{"title":"Vedic Astrology Calculation","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"data.festivals_month","description":"Get Hindu festivals and observances for a specific year and month.","inputSchema":{"type":"object","properties":{"year":{"type":"integer","description":"Year (e.g. 2025)"},"month":{"type":"integer","description":"Month number (1-12)"}},"required":["year","month"]},"annotations":{"title":"Vedic Astrology Calculation","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"analysis.kp_system","description":"Calculate KP (Krishnamurti Paddhati) chart. Returns planet positions with star lord, sub lord, sub-sub lord, Placidus house cusps with KP divisions, and house significators following the KP four-level hierarchy. KP system divides each nakshatra into 9 unequal sub-parts based on Vimshottari Dasha proportions for precise prediction.","inputSchema":{"type":"object","properties":{"datetime":{"type":"string","description":"ISO-8601 datetime string with timezone (e.g. 2024-01-15T10:30:00+05:30). IMPORTANT: Use the exact current date/time from a system clock, not an approximation. LLMs often have incorrect dates — always verify via a time tool before calling."},"latitude":{"type":"number","description":"Latitude in decimal degrees"},"longitude":{"type":"number","description":"Longitude in decimal degrees"}},"required":["datetime","latitude","longitude"]},"annotations":{"title":"Vedic Astrology Calculation","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"analysis.kp_sublord_changes","description":"Track when a planet's KP sub-lord changes over a time range. Uses adaptive step sizes and binary search for exact crossing moments. Returns each change event with datetime, longitude, from/to sub-lord and star-lord. Useful for KP timing predictions.","inputSchema":{"type":"object","properties":{"planet":{"type":"string","description":"Planet name (e.g. 'jupiter', 'moon', 'saturn')"},"start":{"type":"string","description":"Start datetime (ISO-8601 with timezone)"},"end":{"type":"string","description":"End datetime (ISO-8601 with timezone)"},"latitude":{"type":"number","description":"Latitude in decimal degrees"},"longitude":{"type":"number","description":"Longitude in decimal degrees"}},"required":["planet","start","end","latitude","longitude"]},"annotations":{"title":"Vedic Astrology Calculation","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"analysis.kp_ingress","description":"Find exact times when a planet enters a new rashi (sign). Steps through the time range detecting sign boundary crossings and uses binary search for precise timing. Useful for tracking major planetary transits.","inputSchema":{"type":"object","properties":{"planet":{"type":"string","description":"Planet name (e.g. 'saturn', 'jupiter', 'sun')"},"start":{"type":"string","description":"Start datetime (ISO-8601 with timezone)"},"end":{"type":"string","description":"End datetime (ISO-8601 with timezone)"},"latitude":{"type":"number","description":"Latitude in decimal degrees"},"longitude":{"type":"number","description":"Longitude in decimal degrees"}},"required":["planet","start","end","latitude","longitude"]},"annotations":{"title":"Vedic Astrology Calculation","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"analysis.kp_planets_intervals","description":"Get all planet positions with full KP hierarchy (sign, star lord, sub lord) at regular time intervals. Useful for ephemeris tables and tracking planetary movement patterns.","inputSchema":{"type":"object","properties":{"start":{"type":"string","description":"Start datetime (ISO-8601 with timezone)"},"end":{"type":"string","description":"End datetime (ISO-8601 with timezone)"},"interval_hours":{"type":"number","description":"Hours between each snapshot (e.g. 2 for every 2 hours)"},"latitude":{"type":"number","description":"Latitude in decimal degrees"},"longitude":{"type":"number","description":"Longitude in decimal degrees"}},"required":["start","end","interval_hours","latitude","longitude"]},"annotations":{"title":"Vedic Astrology Calculation","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"data.choghadiya","description":"Calculate Choghadiya (hourly muhurta divisions) and Hora (planetary hours) for a given datetime and location. Choghadiya divides day and night into 8 auspicious/inauspicious periods each. Hora assigns a planetary ruler to each hour from sunrise following the Chaldean order. IMPORTANT: Use the exact current date/time from a system clock.","inputSchema":{"type":"object","properties":{"datetime":{"type":"string","description":"ISO-8601 datetime string with timezone (e.g. 2024-01-15T10:30:00+05:30). IMPORTANT: Use the exact current date/time from a system clock, not an approximation. LLMs often have incorrect dates — always verify via a time tool before calling."},"latitude":{"type":"number","description":"Latitude in decimal degrees"},"longitude":{"type":"number","description":"Longitude in decimal degrees"}},"required":["datetime","latitude","longitude"]},"annotations":{"title":"Vedic Astrology Calculation","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"analysis.pancha_pakshi","description":"Calculate Pancha Pakshi (Five Birds System) — ancient Tamil timing system based on 5 birds: Vulture (Earth), Owl (Water), Crow (Fire), Cock (Air), Peacock (Ether). Returns current active bird and activity, day/night period breakdown with sub-activities. Optionally provide birth_nakshatra (1-27) and is_shukla_paksha for personalized birth bird analysis and best timing. IMPORTANT: Use exact date/time from a system clock.","inputSchema":{"type":"object","properties":{"datetime":{"type":"string","description":"ISO-8601 datetime string with timezone (e.g. 2024-01-15T10:30:00+05:30). IMPORTANT: Use the exact current date/time from a system clock, not an approximation. LLMs often have incorrect dates — always verify via a time tool before calling."},"latitude":{"type":"number","description":"Latitude in decimal degrees"},"longitude":{"type":"number","description":"Longitude in decimal degrees"},"birth_nakshatra":{"type":"integer","description":"Birth nakshatra number (1-27) for personalized birth bird analysis. Optional."},"is_shukla_paksha":{"type":"boolean","description":"True for Shukla (waxing moon) paksha, False for Krishna (waning). Used with birth_nakshatra. Optional, defaults to True."}},"required":["datetime","latitude","longitude"]},"annotations":{"title":"Vedic Astrology Calculation","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"data.vrata","description":"Get Vrata (religious observance) calendar for a given year. Returns Ekadashi dates, Sankranti, Navaratri, Pradosh Vrat, Chaturthi, Purnima, Amavasya, and other important fasting/observance days with astronomical basis and recommended rituals.","inputSchema":{"type":"object","properties":{"year":{"type":"integer","description":"Year (e.g. 2026)"}},"required":["year"]},"annotations":{"title":"Vedic Astrology Calculation","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"data.vrata_month","description":"Get Vrata (religious observance) calendar for a specific year and month. Returns Ekadashi, Sankranti, Pradosh Vrat, Chaturthi, Purnima, Amavasya, and other fasting/observance days for the given month.","inputSchema":{"type":"object","properties":{"year":{"type":"integer","description":"Year (e.g. 2026)"},"month":{"type":"integer","description":"Month number (1-12)"}},"required":["year","month"]},"annotations":{"title":"Vedic Astrology Calculation","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"analysis.remedies","description":"Get planetary remedies based on a birth chart. Returns personalized recommendations including mantras, gemstones, fasting days, charity suggestions, and ritual prescriptions for afflicted or weak planets. Analyzes planetary strengths, afflictions, and Dasha periods to prioritize remedies.","inputSchema":{"type":"object","properties":{"datetime":{"type":"string","description":"ISO-8601 datetime string with timezone (e.g. 2024-01-15T10:30:00+05:30). IMPORTANT: Use the exact current date/time from a system clock, not an approximation. LLMs often have incorrect dates — always verify via a time tool before calling."},"latitude":{"type":"number","description":"Latitude in decimal degrees"},"longitude":{"type":"number","description":"Longitude in decimal degrees"}},"required":["datetime","latitude","longitude"]},"annotations":{"title":"Vedic Astrology Calculation","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"analysis.aspects","description":"Calculate planetary aspects (Graha Drishti and Rashi Drishti). Returns Parashari house-based aspects with strength percentages (25/50/75/100%), Jaimini sign-based Rashi Drishti, and mutual aspect detection. Special aspects: Mars (4th/8th at 100%), Jupiter (5th/9th at 100%), Saturn (3rd/10th at 100%). IMPORTANT: Use exact date/time from a system clock.","inputSchema":{"type":"object","properties":{"datetime":{"type":"string","description":"ISO-8601 datetime string with timezone (e.g. 2024-01-15T10:30:00+05:30). IMPORTANT: Use the exact current date/time from a system clock, not an approximation. LLMs often have incorrect dates — always verify via a time tool before calling."},"latitude":{"type":"number","description":"Latitude in decimal degrees"},"longitude":{"type":"number","description":"Longitude in decimal degrees"}},"required":["datetime","latitude","longitude"]},"annotations":{"title":"Vedic Astrology Calculation","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"data.upagrahas","description":"Calculate all 11 Upagrahas (sub-planets). Sun-based (5): Dhuma, Vyatipata, Parivesha, Indrachapa, Upaketu — derived from Sun longitude. Time-based (6): Gulika, Mandi, Kaala, Mrityu, Ardhaprahara, Yamaghantaka — derived from sunrise and weekday. Each returns longitude, sign, and nakshatra. IMPORTANT: Use exact date/time from a system clock.","inputSchema":{"type":"object","properties":{"datetime":{"type":"string","description":"ISO-8601 datetime string with timezone (e.g. 2024-01-15T10:30:00+05:30). IMPORTANT: Use the exact current date/time from a system clock, not an approximation. LLMs often have incorrect dates — always verify via a time tool before calling."},"latitude":{"type":"number","description":"Latitude in decimal degrees"},"longitude":{"type":"number","description":"Longitude in decimal degrees"}},"required":["datetime","latitude","longitude"]},"annotations":{"title":"Vedic Astrology Calculation","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"prediction.monthly_transits","description":"Get all planetary sign changes (ingress) and retrograde start/end events during a month. Tracks all 9 Vedic planets for sign changes, and Mercury/Venus/Mars/Jupiter/Saturn for retrograde direction changes. Binary-searches for exact event times. IMPORTANT: Use exact year/month values.","inputSchema":{"type":"object","properties":{"year":{"type":"integer","description":"Year (e.g. 2026)"},"month":{"type":"integer","description":"Month (1-12)"},"latitude":{"type":"number","description":"Latitude in decimal degrees"},"longitude":{"type":"number","description":"Longitude in decimal degrees"}},"required":["year","month","latitude","longitude"]},"annotations":{"title":"Vedic Astrology Calculation","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"analysis.monthly_aspects","description":"Get major aspect formations between planets during a month. Detects conjunction (0 deg), sextile (60 deg), square (90 deg), trine (120 deg), and opposition (180 deg) for all planet pairs excluding Moon. Returns exact times and orb values.","inputSchema":{"type":"object","properties":{"year":{"type":"integer","description":"Year (e.g. 2026)"},"month":{"type":"integer","description":"Month (1-12)"},"latitude":{"type":"number","description":"Latitude in decimal degrees"},"longitude":{"type":"number","description":"Longitude in decimal degrees"}},"required":["year","month","latitude","longitude"]},"annotations":{"title":"Vedic Astrology Calculation","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"analysis.lunar_aspects","description":"Get Moon's aspects to all planets over a given number of days. Moon moves ~13 deg/day forming frequent aspects. Returns aspect type, exact time, orb, and Moon's sign at each aspect. IMPORTANT: Use exact date/time from a system clock.","inputSchema":{"type":"object","properties":{"datetime":{"type":"string","description":"ISO-8601 datetime string with timezone (e.g. 2024-01-15T10:30:00+05:30). IMPORTANT: Use the exact current date/time from a system clock, not an approximation. LLMs often have incorrect dates — always verify via a time tool before calling."},"latitude":{"type":"number","description":"Latitude in decimal degrees"},"longitude":{"type":"number","description":"Longitude in decimal degrees"},"days":{"type":"integer","description":"Number of days to scan (1-31, default 7)"}},"required":["datetime","latitude","longitude"]},"annotations":{"title":"Vedic Astrology Calculation","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"account.webhook_subscribe","description":"Subscribe to astrological event notifications via webhook. Your URL receives a POST when the event occurs. Costs 1 credit per subscription, deliveries are free. Supported events: ekadashi (11th tithi), purnima (full moon), amavasya (new moon), sankranti (sun entering new sign), saturn_sign_change, jupiter_sign_change, mercury_retrograde_start, mercury_retrograde_end, eclipse_solar, eclipse_lunar. Webhook payload includes event type, event data, and subscriber location if provided. Verify authenticity via X-Webhook-Signature header (HMAC-SHA256 of body using subscription_id as key).","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"HTTPS URL to receive webhook POST notifications"},"events":{"type":"array","items":{"type":"string"},"description":"Event types to subscribe to (e.g. ['ekadashi', 'purnima'])"},"latitude":{"type":"number","description":"Optional latitude for location-specific event data"},"longitude":{"type":"number","description":"Optional longitude for location-specific event data"}},"required":["url","events"]},"annotations":{"title":"Account Registration","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"account.register","description":"Register for an API key to access PanchangaAPI. Two registration flows: (1) Email: call with {\"email\": \"user@example.com\"} — returns pending status + account_id + polling info. Email arrives with HTML button (for humans) and 6-digit PIN (for agents). Human path: clicks button -> sees HTML page with api_key and message 'Send this key to your AI agent'. Agent with email access: reads PIN -> POST /verify {\"email\": \"...\", \"code\": \"123456\"} -> gets api_key. Agent without email access: polls GET /register/status/{account_id} every 5s for up to 5min -> gets api_key when user clicks button. (2) Telegram: call with {\"telegram_id\": 123456789} — returns pending status + verify_url + polling info. Agent sends verify_url to user via Telegram. User clicks -> @womanspirit_en_bot verifies -> api_key in chat. Agent polls GET /register/status/{account_id} every 5s to get api_key. Alternatively POST /verify {\"telegram_id\": 123, \"code\": \"1234\"} to verify via API. Admin receives Telegram notification on every registration and verification.","inputSchema":{"type":"object","properties":{"email":{"type":"string","description":"Email address for email-based registration and verification"},"name":{"type":"string","description":"Optional display name"},"telegram_id":{"type":"integer","description":"Telegram user ID for Telegram-based registration and verification"}},"required":[]},"annotations":{"title":"Account Registration","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}}],"authentication":{"schemes":[{"type":"apiKey","in":"header","name":"X-API-Key","description":"Free API key — register via POST /register. Free tier: 2 requests/day. Top up with NOWPayments crypto or Telegram Stars for higher usage."},{"type":"telegram_stars","description":"Telegram Stars payment via @womanspirit_en_bot. Fallback when user has no USDC wallet. Agent sends user a deep link: https://t.me/womanspirit_en_bot?start=pay_{api_key}_{stars} — user pays with Telegram Stars, credits are added instantly. 1 Star ≈ 0.5 credits (1 credit = $0.03 = 1 API call)."}],"registration":{"url":"/register","method":"POST","flows":{"email":{"body":"{\"email\": \"user@example.com\"}","result":"Returns status=pending + account_id + polling info. Email sent with HTML button (humans) and 6-digit PIN (agents).","human_path":"Human clicks the 'Verify Account' button in the email. GET /verify?token=<token> returns an HTML page showing the api_key with the message 'Send this key to your AI agent'. Agent then polls GET /register/status/{account_id} to retrieve the api_key.","agent_with_email":"Agent with email access reads the email, extracts the 6-digit PIN, then calls POST /verify {\"email\": \"...\", \"code\": \"123456\"} to activate and receive api_key. Alternatively, extract the token from the button link and GET /verify?token=<token>.","agent_without_email":"Agent without email access polls GET /register/status/{account_id} every 5 seconds for up to 5 minutes. When the user clicks the button in the email, the polling endpoint returns status=verified with the api_key.","verify_button":"GET /verify?token=<token_from_email> -- returns HTML page for humans, JSON for API clients","verify_api":"POST /verify {\"email\": \"user@example.com\", \"code\": \"123456\"} -- for AI agents using the PIN","verify_result":"Returns api_key"},"telegram":{"body":"{\"telegram_id\": 123456789}","result":"Returns status=pending + account_id + verify_url (Telegram deep link) + polling info.","verify_url_format":"https://t.me/womanspirit_en_bot?start=verify_{account_id}_{code}","verify_api":"POST /verify {\"telegram_id\": 123456789, \"code\": \"1234\"}","agent_flow":"1) POST /register with telegram_id. 2) Agent sends the returned verify_url to the user via Telegram. 3) User clicks the link -> @womanspirit_en_bot verifies automatically -> api_key sent in chat. 4) Agent polls GET /register/status/{account_id} every 5 seconds to get the api_key. 5) Alternatively, if agent received the code via bot, POST /verify with telegram_id and code to get api_key."}},"polling":{"url":"/register/status/{account_id}","method":"GET","interval_seconds":5,"timeout_seconds":300,"description":"Poll this endpoint after email or Telegram registration. Returns {status: 'pending'} while waiting, then {status: 'verified', api_key: '...'} once the user completes verification."},"topup":{"crypto":"https://api.moon-bot.cc/checkout/{api_key}/{credits} — 350+ coins via NOWPayments. Packages: 100/$3, 500/$15, 1000/$30, 5000/$150.","telegram_stars":"https://t.me/womanspirit_en_bot?start=pay_{api_key}_{stars} — 1 Star ≈ 0.5 credits. Agent sends deep link to user via Telegram."},"admin_notifications":"Admin receives Telegram notification on every registration and verification."}},"pricing":{"free_tier":"2 requests/day (with a registered API key)","per_credit_usd":0.03,"bulk_1000_usd":30.0,"payment_methods":["telegram_stars","nowpayments_crypto"],"note":"One Panchanga call gives you everything for a daily reading. One Kundali call gives you a complete birth chart."}}