{"service":"Astro Agents","tagline":"Deterministic Western + Vedic astrology API for AI agents: JPL DE440 ephemeris, no LLM, reproducible SHA-256 hashes.","engine_version":"1.0.1","start_here":"Cheapest useful call: POST /v1/western/positions or /v1/vedic/nakshatra at $0.01-0.02. Your first 3 calls are free (identify with x402 Sign-In-With-X).","why_use_this_instead_of_computing_it_yourself":["LLMs routinely get time zones, historical DST, sidereal time and ayanamsa wrong; one wrong hour moves the ascendant ~15 degrees and the Moon ~0.5 degree.","Positions come from NASA/JPL DE440 (1800-01-01..2200-01-01), the reference ephemeris other engines measure themselves against.","Deterministic: same input, same bytes. Every response carries meta.input_sha256 and meta.result_sha256 so you can cache, verify and cite results.","Every convention (ayanamsa value, house system, orbs, node type, dasha year, dosha rule) is stated in the response, never implicit."],"payment":{"protocols":["x402 (USDC on Base and Solana)","MPP (Tempo)"],"free_calls":3,"account_required":false,"how":"POST without payment -> HTTP 402 with both an x402 challenge (PAYMENT-REQUIRED header) and an MPP challenge (WWW-Authenticate: Payment). Pay with either and retry.","live_status":{"x402":{"enabled":true,"networks":["solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","eip155:8453"],"facilitators":["cdp","payai"]},"mpp":{"enabled":true,"methods":["tempo"]},"free_calls":{"enabled":true,"per_caller":3,"identity":"x402 Sign-In-With-X wallet (header SIGN-IN-WITH-X), else client IP","opt_out":"send 'X-Free-Call: skip' to be asked for payment directly"}}},"calls":[{"id":"time/resolve","method":"POST","url":"https://astro-agent.dev/v1/time/resolve","price_usd":"0.01","tier":"call","title":"Birth time resolver","summary":"Local birth time + place -> exact UT, historical UTC offset, Delta T, Local Mean Time, true solar time.","description":"The step LLMs most often get wrong. Resolves the IANA time zone from coordinates, applies the offset in force on that date (historical DST, Local Mean Time before standard time), flags ambiguous or non-existent local times instead of guessing, and returns Julian Days (UT/TT), Delta T, Local Mean Time, true (apparent) solar time and the equation of time.","mcp_tool":"resolve_birth_time","input_schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth date-time, ISO 8601: '1990-05-15T14:30' (local clock time at the place) or with an explicit offset '1990-05-15T14:30:00+02:00'. Alternative: 'date' + 'time'.","examples":["1990-05-15T14:30"]},"date":{"type":"string","description":"YYYY-MM-DD (use with 'time' instead of 'datetime')."},"time":{"type":"string","description":"HH:MM or HH:MM:SS, 24 h. Omit if unknown (computed at 12:00 with a TIME_UNKNOWN warning)."},"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Decimal degrees, north positive."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Decimal degrees, east positive."},"timezone":{"type":"string","description":"IANA zone, e.g. 'Asia/Kolkata'. Optional: resolved from the coordinates, with the historical offset (DST, Local Mean Time) of that date."},"time_basis":{"type":"string","enum":["civil","utc","lmt","true_solar"],"default":"civil","description":"What the given clock time is: civil wall-clock (default), UTC, Local Mean Time, or true (apparent) solar time."},"ambiguous_time":{"type":"string","enum":["earlier","later"],"default":"earlier","description":"Which occurrence to use when a local time happens twice (DST fall-back)."}},"required":[],"description":"Coordinates or a timezone are needed to interpret a local time."},"example_request":{"datetime":"1947-08-15T00:00","latitude":28.6139,"longitude":77.209}},{"id":"western/positions","method":"POST","url":"https://astro-agent.dev/v1/western/positions","price_usd":"0.01","tier":"call","title":"Planetary positions","summary":"Tropical (or sidereal) longitudes, latitudes, speeds and retrograde flags of Sun..Pluto, nodes, Lilith.","description":"Geocentric apparent positions from NASA/JPL DE440 for any moment 1800-2200, with sign, degree, element, modality, daily speed and retrograde status. Location is optional (only used to interpret a local time).","mcp_tool":"planet_positions","input_schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth date-time, ISO 8601: '1990-05-15T14:30' (local clock time at the place) or with an explicit offset '1990-05-15T14:30:00+02:00'. Alternative: 'date' + 'time'.","examples":["1990-05-15T14:30"]},"date":{"type":"string","description":"YYYY-MM-DD (use with 'time' instead of 'datetime')."},"time":{"type":"string","description":"HH:MM or HH:MM:SS, 24 h. Omit if unknown (computed at 12:00 with a TIME_UNKNOWN warning)."},"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Decimal degrees, north positive."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Decimal degrees, east positive."},"timezone":{"type":"string","description":"IANA zone, e.g. 'Asia/Kolkata'. Optional: resolved from the coordinates, with the historical offset (DST, Local Mean Time) of that date."},"time_basis":{"type":"string","enum":["civil","utc","lmt","true_solar"],"default":"civil","description":"What the given clock time is: civil wall-clock (default), UTC, Local Mean Time, or true (apparent) solar time."},"ambiguous_time":{"type":"string","enum":["earlier","later"],"default":"earlier","description":"Which occurrence to use when a local time happens twice (DST fall-back)."},"options":{"type":"object","properties":{"house_system":{"type":"string","enum":["alcabitius","campanus","equal","koch","meridian","morinus","placidus","porphyry","regiomontanus","topocentric","whole_sign"],"default":"placidus"},"zodiac":{"type":"string","enum":["tropical","sidereal"],"default":"tropical"},"ayanamsa":{"type":"string","enum":["fagan_bradley","krishnamurti","lahiri","raman","true_chitrapaksha","yukteshwar"],"default":"lahiri","description":"Only with zodiac=sidereal."},"points":{"description":"'all' or a list from ['sun', 'moon', 'mercury', 'venus', 'mars', 'jupiter', 'saturn', 'uranus', 'neptune', 'pluto', 'mean_node', 'true_node', 'mean_lilith']. Default: 10 planets + true node + mean Lilith.","oneOf":[{"type":"string","enum":["all"]},{"type":"array","items":{"type":"string","enum":["sun","moon","mercury","venus","mars","jupiter","saturn","uranus","neptune","pluto","mean_node","true_node","mean_lilith"]}}]},"aspects":{"description":"'all' or a list from ['conjunction', 'opposition', 'trine', 'square', 'sextile', 'quincunx', 'semisextile', 'semisquare', 'sesquiquadrate', 'quintile', 'biquintile']. Default: the 5 majors.","oneOf":[{"type":"string","enum":["all"]},{"type":"array","items":{"type":"string","enum":["conjunction","opposition","trine","square","sextile","quincunx","semisextile","semisquare","sesquiquadrate","quintile","biquintile"]}}]},"orbs":{"type":"object","additionalProperties":{"type":"number","minimum":0,"maximum":15},"description":"Override orbs per aspect, degrees."},"luminary_orb_bonus":{"type":"number","minimum":0,"maximum":5,"default":2}}}},"required":[]},"example_request":{"datetime":"2026-10-01T12:00:00Z"}},{"id":"western/aspects","method":"POST","url":"https://astro-agent.dev/v1/western/aspects","price_usd":"0.02","tier":"call","title":"Aspects","summary":"Aspects (with orb, exactness, applying/separating) for a moment, or for any longitudes you supply.","description":"Either give a moment (datetime, optional place) and get the aspects among all planets, or give 'longitudes' {name: degrees} and get the pure geometry. Orbs are explicit and overridable.","mcp_tool":"aspects","input_schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth date-time, ISO 8601: '1990-05-15T14:30' (local clock time at the place) or with an explicit offset '1990-05-15T14:30:00+02:00'. Alternative: 'date' + 'time'.","examples":["1990-05-15T14:30"]},"date":{"type":"string","description":"YYYY-MM-DD (use with 'time' instead of 'datetime')."},"time":{"type":"string","description":"HH:MM or HH:MM:SS, 24 h. Omit if unknown (computed at 12:00 with a TIME_UNKNOWN warning)."},"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Decimal degrees, north positive."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Decimal degrees, east positive."},"timezone":{"type":"string","description":"IANA zone, e.g. 'Asia/Kolkata'. Optional: resolved from the coordinates, with the historical offset (DST, Local Mean Time) of that date."},"time_basis":{"type":"string","enum":["civil","utc","lmt","true_solar"],"default":"civil","description":"What the given clock time is: civil wall-clock (default), UTC, Local Mean Time, or true (apparent) solar time."},"ambiguous_time":{"type":"string","enum":["earlier","later"],"default":"earlier","description":"Which occurrence to use when a local time happens twice (DST fall-back)."},"longitudes":{"type":"object","description":"Optional {name: degrees} or {name: {longitude, speed}}; when given, no ephemeris is used.","additionalProperties":true},"options":{"type":"object","properties":{"house_system":{"type":"string","enum":["alcabitius","campanus","equal","koch","meridian","morinus","placidus","porphyry","regiomontanus","topocentric","whole_sign"],"default":"placidus"},"zodiac":{"type":"string","enum":["tropical","sidereal"],"default":"tropical"},"ayanamsa":{"type":"string","enum":["fagan_bradley","krishnamurti","lahiri","raman","true_chitrapaksha","yukteshwar"],"default":"lahiri","description":"Only with zodiac=sidereal."},"points":{"description":"'all' or a list from ['sun', 'moon', 'mercury', 'venus', 'mars', 'jupiter', 'saturn', 'uranus', 'neptune', 'pluto', 'mean_node', 'true_node', 'mean_lilith']. Default: 10 planets + true node + mean Lilith.","oneOf":[{"type":"string","enum":["all"]},{"type":"array","items":{"type":"string","enum":["sun","moon","mercury","venus","mars","jupiter","saturn","uranus","neptune","pluto","mean_node","true_node","mean_lilith"]}}]},"aspects":{"description":"'all' or a list from ['conjunction', 'opposition', 'trine', 'square', 'sextile', 'quincunx', 'semisextile', 'semisquare', 'sesquiquadrate', 'quintile', 'biquintile']. Default: the 5 majors.","oneOf":[{"type":"string","enum":["all"]},{"type":"array","items":{"type":"string","enum":["conjunction","opposition","trine","square","sextile","quincunx","semisextile","semisquare","sesquiquadrate","quintile","biquintile"]}}]},"orbs":{"type":"object","additionalProperties":{"type":"number","minimum":0,"maximum":15},"description":"Override orbs per aspect, degrees."},"luminary_orb_bonus":{"type":"number","minimum":0,"maximum":5,"default":2}}}},"required":[]},"example_request":{"longitudes":{"sun":54.4,"moon":297.4,"saturn":295.2,"venus":12.8}}},{"id":"vedic/nakshatra","method":"POST","url":"https://astro-agent.dev/v1/vedic/nakshatra","price_usd":"0.02","tier":"call","title":"Nakshatras","summary":"Sidereal nakshatra, pada and lord of every graha; janma nakshatra with gana, yoni, nadi, varna.","description":"The 27 lunar mansions for each of the 9 grahas at a moment (Lahiri by default, 6 ayanamsas), with the birth star's attributes used in matching. Or pass 'longitude_sidereal' for a direct lookup.","mcp_tool":"nakshatras","input_schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth date-time, ISO 8601: '1990-05-15T14:30' (local clock time at the place) or with an explicit offset '1990-05-15T14:30:00+02:00'. Alternative: 'date' + 'time'.","examples":["1990-05-15T14:30"]},"date":{"type":"string","description":"YYYY-MM-DD (use with 'time' instead of 'datetime')."},"time":{"type":"string","description":"HH:MM or HH:MM:SS, 24 h. Omit if unknown (computed at 12:00 with a TIME_UNKNOWN warning)."},"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Decimal degrees, north positive."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Decimal degrees, east positive."},"timezone":{"type":"string","description":"IANA zone, e.g. 'Asia/Kolkata'. Optional: resolved from the coordinates, with the historical offset (DST, Local Mean Time) of that date."},"time_basis":{"type":"string","enum":["civil","utc","lmt","true_solar"],"default":"civil","description":"What the given clock time is: civil wall-clock (default), UTC, Local Mean Time, or true (apparent) solar time."},"ambiguous_time":{"type":"string","enum":["earlier","later"],"default":"earlier","description":"Which occurrence to use when a local time happens twice (DST fall-back)."},"longitude_sidereal":{"type":"number","description":"Optional direct lookup, degrees 0-360."},"options":{"type":"object","properties":{"ayanamsa":{"type":"string","enum":["fagan_bradley","krishnamurti","lahiri","raman","true_chitrapaksha","yukteshwar"],"default":"lahiri"},"node_type":{"type":"string","enum":["mean","true"],"default":"mean","description":"Rahu/Ketu from the mean or the true (osculating) lunar node."},"house_system":{"type":"string","enum":["whole_sign","equal","placidus","porphyry","koch"],"default":"whole_sign","description":"Bhava system; 'equal' puts the lagna degree mid-house."},"include_outer_planets":{"type":"boolean","default":false}}}},"required":[]},"example_request":{"datetime":"1990-05-15T14:30","timezone":"Asia/Kolkata"}},{"id":"vedic/panchang","method":"POST","url":"https://astro-agent.dev/v1/vedic/panchang","price_usd":"0.02","tier":"call","title":"Panchang","summary":"Tithi, vara, nakshatra, yoga, karana with the exact time each ends, plus sunrise and sunset.","description":"The Hindu almanac for any moment and place: the five limbs with their end times (to the minute), paksha, Moon and Sun rashi, sunrise/sunset, and the vara by the sunrise-to-sunrise rule.","mcp_tool":"panchang","input_schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth date-time, ISO 8601: '1990-05-15T14:30' (local clock time at the place) or with an explicit offset '1990-05-15T14:30:00+02:00'. Alternative: 'date' + 'time'.","examples":["1990-05-15T14:30"]},"date":{"type":"string","description":"YYYY-MM-DD (use with 'time' instead of 'datetime')."},"time":{"type":"string","description":"HH:MM or HH:MM:SS, 24 h. Omit if unknown (computed at 12:00 with a TIME_UNKNOWN warning)."},"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Decimal degrees, north positive."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Decimal degrees, east positive."},"timezone":{"type":"string","description":"IANA zone, e.g. 'Asia/Kolkata'. Optional: resolved from the coordinates, with the historical offset (DST, Local Mean Time) of that date."},"time_basis":{"type":"string","enum":["civil","utc","lmt","true_solar"],"default":"civil","description":"What the given clock time is: civil wall-clock (default), UTC, Local Mean Time, or true (apparent) solar time."},"ambiguous_time":{"type":"string","enum":["earlier","later"],"default":"earlier","description":"Which occurrence to use when a local time happens twice (DST fall-back)."},"options":{"type":"object","properties":{"ayanamsa":{"type":"string","enum":["fagan_bradley","krishnamurti","lahiri","raman","true_chitrapaksha","yukteshwar"],"default":"lahiri"},"node_type":{"type":"string","enum":["mean","true"],"default":"mean","description":"Rahu/Ketu from the mean or the true (osculating) lunar node."},"house_system":{"type":"string","enum":["whole_sign","equal","placidus","porphyry","koch"],"default":"whole_sign","description":"Bhava system; 'equal' puts the lagna degree mid-house."},"include_outer_planets":{"type":"boolean","default":false}}}},"required":["latitude","longitude"]},"example_request":{"datetime":"2026-10-01T06:00","latitude":25.3176,"longitude":82.9739}}],"premium":[{"id":"western/natal","method":"POST","url":"https://astro-agent.dev/v1/western/natal","price_usd":"0.06","tier":"premium","title":"Western natal chart","summary":"Complete natal chart: planets in signs and houses, ascendant, MC, 11 house systems, aspects, summary.","description":"Everything a natal reading needs, computed exactly: positions, house cusps (Placidus by default; Koch, Whole Sign, Equal, Porphyry, Regiomontanus, Campanus, Topocentric, Alcabitius, Morinus, Meridian), ascendant/MC/DSC/IC, aspects with orbs and applying/separating state, element and modality balance, chart ruler, sect and Part of Fortune.","mcp_tool":"natal_chart","input_schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth date-time, ISO 8601: '1990-05-15T14:30' (local clock time at the place) or with an explicit offset '1990-05-15T14:30:00+02:00'. Alternative: 'date' + 'time'.","examples":["1990-05-15T14:30"]},"date":{"type":"string","description":"YYYY-MM-DD (use with 'time' instead of 'datetime')."},"time":{"type":"string","description":"HH:MM or HH:MM:SS, 24 h. Omit if unknown (computed at 12:00 with a TIME_UNKNOWN warning)."},"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Decimal degrees, north positive."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Decimal degrees, east positive."},"timezone":{"type":"string","description":"IANA zone, e.g. 'Asia/Kolkata'. Optional: resolved from the coordinates, with the historical offset (DST, Local Mean Time) of that date."},"time_basis":{"type":"string","enum":["civil","utc","lmt","true_solar"],"default":"civil","description":"What the given clock time is: civil wall-clock (default), UTC, Local Mean Time, or true (apparent) solar time."},"ambiguous_time":{"type":"string","enum":["earlier","later"],"default":"earlier","description":"Which occurrence to use when a local time happens twice (DST fall-back)."},"options":{"type":"object","properties":{"house_system":{"type":"string","enum":["alcabitius","campanus","equal","koch","meridian","morinus","placidus","porphyry","regiomontanus","topocentric","whole_sign"],"default":"placidus"},"zodiac":{"type":"string","enum":["tropical","sidereal"],"default":"tropical"},"ayanamsa":{"type":"string","enum":["fagan_bradley","krishnamurti","lahiri","raman","true_chitrapaksha","yukteshwar"],"default":"lahiri","description":"Only with zodiac=sidereal."},"points":{"description":"'all' or a list from ['sun', 'moon', 'mercury', 'venus', 'mars', 'jupiter', 'saturn', 'uranus', 'neptune', 'pluto', 'mean_node', 'true_node', 'mean_lilith']. Default: 10 planets + true node + mean Lilith.","oneOf":[{"type":"string","enum":["all"]},{"type":"array","items":{"type":"string","enum":["sun","moon","mercury","venus","mars","jupiter","saturn","uranus","neptune","pluto","mean_node","true_node","mean_lilith"]}}]},"aspects":{"description":"'all' or a list from ['conjunction', 'opposition', 'trine', 'square', 'sextile', 'quincunx', 'semisextile', 'semisquare', 'sesquiquadrate', 'quintile', 'biquintile']. Default: the 5 majors.","oneOf":[{"type":"string","enum":["all"]},{"type":"array","items":{"type":"string","enum":["conjunction","opposition","trine","square","sextile","quincunx","semisextile","semisquare","sesquiquadrate","quintile","biquintile"]}}]},"orbs":{"type":"object","additionalProperties":{"type":"number","minimum":0,"maximum":15},"description":"Override orbs per aspect, degrees."},"luminary_orb_bonus":{"type":"number","minimum":0,"maximum":5,"default":2}}}},"required":["latitude","longitude"]},"example_request":{"datetime":"1990-05-15T14:30","latitude":48.8566,"longitude":2.3522}},{"id":"western/transits","method":"POST","url":"https://astro-agent.dev/v1/western/transits","price_usd":"0.08","tier":"premium","title":"Transits","summary":"Transits to a natal chart at a moment, and exact hit times over a window of up to a year.","description":"'transit': aspects from the sky at a moment to every natal point, with the natal house each transiting planet occupies. 'window': the exact UTC minute every transiting planet perfects each aspect to each natal point over up to 366 days (62 with the Moon), retrograde passes included.","mcp_tool":"transits","input_schema":{"type":"object","required":["natal"],"properties":{"natal":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth date-time, ISO 8601: '1990-05-15T14:30' (local clock time at the place) or with an explicit offset '1990-05-15T14:30:00+02:00'. Alternative: 'date' + 'time'.","examples":["1990-05-15T14:30"]},"date":{"type":"string","description":"YYYY-MM-DD (use with 'time' instead of 'datetime')."},"time":{"type":"string","description":"HH:MM or HH:MM:SS, 24 h. Omit if unknown (computed at 12:00 with a TIME_UNKNOWN warning)."},"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Decimal degrees, north positive."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Decimal degrees, east positive."},"timezone":{"type":"string","description":"IANA zone, e.g. 'Asia/Kolkata'. Optional: resolved from the coordinates, with the historical offset (DST, Local Mean Time) of that date."},"time_basis":{"type":"string","enum":["civil","utc","lmt","true_solar"],"default":"civil","description":"What the given clock time is: civil wall-clock (default), UTC, Local Mean Time, or true (apparent) solar time."},"ambiguous_time":{"type":"string","enum":["earlier","later"],"default":"earlier","description":"Which occurrence to use when a local time happens twice (DST fall-back)."}},"required":["latitude","longitude"],"description":"Birth data."},"transit":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth date-time, ISO 8601: '1990-05-15T14:30' (local clock time at the place) or with an explicit offset '1990-05-15T14:30:00+02:00'. Alternative: 'date' + 'time'.","examples":["1990-05-15T14:30"]},"timezone":{"type":"string","description":"IANA zone, e.g. 'Asia/Kolkata'. Optional: resolved from the coordinates, with the historical offset (DST, Local Mean Time) of that date."},"time_basis":{"type":"string","enum":["civil","utc","lmt","true_solar"],"default":"civil","description":"What the given clock time is: civil wall-clock (default), UTC, Local Mean Time, or true (apparent) solar time."}},"description":"The transit moment. A bare local time is read in the natal place's zone."},"window":{"type":"object","properties":{"start":{"type":"string"},"end":{"type":"string"},"include_moon":{"type":"boolean"}},"description":"UTC dates YYYY-MM-DD, at most 366 days apart."},"options":{"type":"object","properties":{"house_system":{"type":"string","enum":["alcabitius","campanus","equal","koch","meridian","morinus","placidus","porphyry","regiomontanus","topocentric","whole_sign"],"default":"placidus"},"zodiac":{"type":"string","enum":["tropical","sidereal"],"default":"tropical"},"ayanamsa":{"type":"string","enum":["fagan_bradley","krishnamurti","lahiri","raman","true_chitrapaksha","yukteshwar"],"default":"lahiri","description":"Only with zodiac=sidereal."},"points":{"description":"'all' or a list from ['sun', 'moon', 'mercury', 'venus', 'mars', 'jupiter', 'saturn', 'uranus', 'neptune', 'pluto', 'mean_node', 'true_node', 'mean_lilith']. Default: 10 planets + true node + mean Lilith.","oneOf":[{"type":"string","enum":["all"]},{"type":"array","items":{"type":"string","enum":["sun","moon","mercury","venus","mars","jupiter","saturn","uranus","neptune","pluto","mean_node","true_node","mean_lilith"]}}]},"aspects":{"description":"'all' or a list from ['conjunction', 'opposition', 'trine', 'square', 'sextile', 'quincunx', 'semisextile', 'semisquare', 'sesquiquadrate', 'quintile', 'biquintile']. Default: the 5 majors.","oneOf":[{"type":"string","enum":["all"]},{"type":"array","items":{"type":"string","enum":["conjunction","opposition","trine","square","sextile","quincunx","semisextile","semisquare","sesquiquadrate","quintile","biquintile"]}}]},"orbs":{"type":"object","additionalProperties":{"type":"number","minimum":0,"maximum":15},"description":"Override orbs per aspect, degrees."},"luminary_orb_bonus":{"type":"number","minimum":0,"maximum":5,"default":2}}}}},"example_request":{"natal":{"datetime":"1990-05-15T14:30","latitude":48.8566,"longitude":2.3522},"transit":{"datetime":"2026-10-01T12:00"},"window":{"start":"2026-10-01","end":"2026-12-31"}}},{"id":"western/synastry","method":"POST","url":"https://astro-agent.dev/v1/western/synastry","price_usd":"0.12","tier":"premium","title":"Synastry","summary":"Relationship comparison: cross-aspects, house overlays both ways, composite midpoints.","description":"Two natal charts compared: every cross-aspect with orbs, where each person's planets fall in the other's houses, harmonious/challenging counts, and composite (midpoint) positions and angles.","mcp_tool":"synastry","input_schema":{"type":"object","required":["person_a","person_b"],"properties":{"person_a":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth date-time, ISO 8601: '1990-05-15T14:30' (local clock time at the place) or with an explicit offset '1990-05-15T14:30:00+02:00'. Alternative: 'date' + 'time'.","examples":["1990-05-15T14:30"]},"date":{"type":"string","description":"YYYY-MM-DD (use with 'time' instead of 'datetime')."},"time":{"type":"string","description":"HH:MM or HH:MM:SS, 24 h. Omit if unknown (computed at 12:00 with a TIME_UNKNOWN warning)."},"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Decimal degrees, north positive."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Decimal degrees, east positive."},"timezone":{"type":"string","description":"IANA zone, e.g. 'Asia/Kolkata'. Optional: resolved from the coordinates, with the historical offset (DST, Local Mean Time) of that date."},"time_basis":{"type":"string","enum":["civil","utc","lmt","true_solar"],"default":"civil","description":"What the given clock time is: civil wall-clock (default), UTC, Local Mean Time, or true (apparent) solar time."},"ambiguous_time":{"type":"string","enum":["earlier","later"],"default":"earlier","description":"Which occurrence to use when a local time happens twice (DST fall-back)."}},"required":["latitude","longitude"]},"person_b":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth date-time, ISO 8601: '1990-05-15T14:30' (local clock time at the place) or with an explicit offset '1990-05-15T14:30:00+02:00'. Alternative: 'date' + 'time'.","examples":["1990-05-15T14:30"]},"date":{"type":"string","description":"YYYY-MM-DD (use with 'time' instead of 'datetime')."},"time":{"type":"string","description":"HH:MM or HH:MM:SS, 24 h. Omit if unknown (computed at 12:00 with a TIME_UNKNOWN warning)."},"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Decimal degrees, north positive."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Decimal degrees, east positive."},"timezone":{"type":"string","description":"IANA zone, e.g. 'Asia/Kolkata'. Optional: resolved from the coordinates, with the historical offset (DST, Local Mean Time) of that date."},"time_basis":{"type":"string","enum":["civil","utc","lmt","true_solar"],"default":"civil","description":"What the given clock time is: civil wall-clock (default), UTC, Local Mean Time, or true (apparent) solar time."},"ambiguous_time":{"type":"string","enum":["earlier","later"],"default":"earlier","description":"Which occurrence to use when a local time happens twice (DST fall-back)."}},"required":["latitude","longitude"]},"options":{"type":"object","properties":{"house_system":{"type":"string","enum":["alcabitius","campanus","equal","koch","meridian","morinus","placidus","porphyry","regiomontanus","topocentric","whole_sign"],"default":"placidus"},"zodiac":{"type":"string","enum":["tropical","sidereal"],"default":"tropical"},"ayanamsa":{"type":"string","enum":["fagan_bradley","krishnamurti","lahiri","raman","true_chitrapaksha","yukteshwar"],"default":"lahiri","description":"Only with zodiac=sidereal."},"points":{"description":"'all' or a list from ['sun', 'moon', 'mercury', 'venus', 'mars', 'jupiter', 'saturn', 'uranus', 'neptune', 'pluto', 'mean_node', 'true_node', 'mean_lilith']. Default: 10 planets + true node + mean Lilith.","oneOf":[{"type":"string","enum":["all"]},{"type":"array","items":{"type":"string","enum":["sun","moon","mercury","venus","mars","jupiter","saturn","uranus","neptune","pluto","mean_node","true_node","mean_lilith"]}}]},"aspects":{"description":"'all' or a list from ['conjunction', 'opposition', 'trine', 'square', 'sextile', 'quincunx', 'semisextile', 'semisquare', 'sesquiquadrate', 'quintile', 'biquintile']. Default: the 5 majors.","oneOf":[{"type":"string","enum":["all"]},{"type":"array","items":{"type":"string","enum":["conjunction","opposition","trine","square","sextile","quincunx","semisextile","semisquare","sesquiquadrate","quintile","biquintile"]}}]},"orbs":{"type":"object","additionalProperties":{"type":"number","minimum":0,"maximum":15},"description":"Override orbs per aspect, degrees."},"luminary_orb_bonus":{"type":"number","minimum":0,"maximum":5,"default":2}}}}},"example_request":{"person_a":{"datetime":"1990-05-15T14:30","latitude":48.8566,"longitude":2.3522},"person_b":{"datetime":"1992-08-03T09:15","latitude":45.764,"longitude":4.8357}}},{"id":"vedic/kundli","method":"POST","url":"https://astro-agent.dev/v1/vedic/kundli","price_usd":"0.15","tier":"premium","title":"Kundli (Vedic birth chart)","summary":"Sidereal D1 + D9: lagna, 9 grahas with rashi, nakshatra, pada, house, dignity, combustion, bhavas.","description":"The Jyotish birth chart: ayanamsa (Lahiri default; Raman, KP, Yukteshwar, Fagan-Bradley, True Chitrapaksha), lagna, grahas with rashi, nakshatra/pada/lord, bhava, dignity (exalted, debilitated, moolatrikona, own sign), retrograde and combustion, house table with lords and occupants, and the Navamsa (D9).","mcp_tool":"kundli","input_schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth date-time, ISO 8601: '1990-05-15T14:30' (local clock time at the place) or with an explicit offset '1990-05-15T14:30:00+02:00'. Alternative: 'date' + 'time'.","examples":["1990-05-15T14:30"]},"date":{"type":"string","description":"YYYY-MM-DD (use with 'time' instead of 'datetime')."},"time":{"type":"string","description":"HH:MM or HH:MM:SS, 24 h. Omit if unknown (computed at 12:00 with a TIME_UNKNOWN warning)."},"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Decimal degrees, north positive."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Decimal degrees, east positive."},"timezone":{"type":"string","description":"IANA zone, e.g. 'Asia/Kolkata'. Optional: resolved from the coordinates, with the historical offset (DST, Local Mean Time) of that date."},"time_basis":{"type":"string","enum":["civil","utc","lmt","true_solar"],"default":"civil","description":"What the given clock time is: civil wall-clock (default), UTC, Local Mean Time, or true (apparent) solar time."},"ambiguous_time":{"type":"string","enum":["earlier","later"],"default":"earlier","description":"Which occurrence to use when a local time happens twice (DST fall-back)."},"options":{"type":"object","properties":{"ayanamsa":{"type":"string","enum":["fagan_bradley","krishnamurti","lahiri","raman","true_chitrapaksha","yukteshwar"],"default":"lahiri"},"node_type":{"type":"string","enum":["mean","true"],"default":"mean","description":"Rahu/Ketu from the mean or the true (osculating) lunar node."},"house_system":{"type":"string","enum":["whole_sign","equal","placidus","porphyry","koch"],"default":"whole_sign","description":"Bhava system; 'equal' puts the lagna degree mid-house."},"include_outer_planets":{"type":"boolean","default":false}}}},"required":["latitude","longitude"]},"example_request":{"datetime":"1990-05-15T14:30","latitude":28.6139,"longitude":77.209}},{"id":"vedic/kundli-full","method":"POST","url":"https://astro-agent.dev/v1/vedic/kundli-full","price_usd":"0.32","tier":"premium","title":"Kundli with all 16 vargas","summary":"The kundli plus all Shodashavarga divisional charts D1..D60 (Parashara rules).","description":"Everything in /vedic/kundli plus D1, D2, D3, D4, D7, D9, D10, D12, D16, D20, D24, D27, D30, D40, D45 and D60, each with its lagna, placements and house table.","mcp_tool":"kundli_full","input_schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth date-time, ISO 8601: '1990-05-15T14:30' (local clock time at the place) or with an explicit offset '1990-05-15T14:30:00+02:00'. Alternative: 'date' + 'time'.","examples":["1990-05-15T14:30"]},"date":{"type":"string","description":"YYYY-MM-DD (use with 'time' instead of 'datetime')."},"time":{"type":"string","description":"HH:MM or HH:MM:SS, 24 h. Omit if unknown (computed at 12:00 with a TIME_UNKNOWN warning)."},"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Decimal degrees, north positive."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Decimal degrees, east positive."},"timezone":{"type":"string","description":"IANA zone, e.g. 'Asia/Kolkata'. Optional: resolved from the coordinates, with the historical offset (DST, Local Mean Time) of that date."},"time_basis":{"type":"string","enum":["civil","utc","lmt","true_solar"],"default":"civil","description":"What the given clock time is: civil wall-clock (default), UTC, Local Mean Time, or true (apparent) solar time."},"ambiguous_time":{"type":"string","enum":["earlier","later"],"default":"earlier","description":"Which occurrence to use when a local time happens twice (DST fall-back)."},"options":{"type":"object","properties":{"ayanamsa":{"type":"string","enum":["fagan_bradley","krishnamurti","lahiri","raman","true_chitrapaksha","yukteshwar"],"default":"lahiri"},"node_type":{"type":"string","enum":["mean","true"],"default":"mean","description":"Rahu/Ketu from the mean or the true (osculating) lunar node."},"house_system":{"type":"string","enum":["whole_sign","equal","placidus","porphyry","koch"],"default":"whole_sign","description":"Bhava system; 'equal' puts the lagna degree mid-house."},"include_outer_planets":{"type":"boolean","default":false}}}},"required":["latitude","longitude"]},"example_request":{"datetime":"1990-05-15T14:30","latitude":28.6139,"longitude":77.209}},{"id":"vedic/dashas","method":"POST","url":"https://astro-agent.dev/v1/vedic/dashas","price_usd":"0.10","tier":"premium","title":"Vimshottari dashas","summary":"Vimshottari maha/antar/pratyantar periods with exact dates, birth balance, and the running periods.","description":"The 120-year Vimshottari sequence from the Moon's exact nakshatra position: balance at birth, all 9 mahadashas with sub-periods down to 4 levels, and (with on_date) the periods running on a date.","mcp_tool":"vimshottari_dasha","input_schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth date-time, ISO 8601: '1990-05-15T14:30' (local clock time at the place) or with an explicit offset '1990-05-15T14:30:00+02:00'. Alternative: 'date' + 'time'.","examples":["1990-05-15T14:30"]},"date":{"type":"string","description":"YYYY-MM-DD (use with 'time' instead of 'datetime')."},"time":{"type":"string","description":"HH:MM or HH:MM:SS, 24 h. Omit if unknown (computed at 12:00 with a TIME_UNKNOWN warning)."},"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Decimal degrees, north positive."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Decimal degrees, east positive."},"timezone":{"type":"string","description":"IANA zone, e.g. 'Asia/Kolkata'. Optional: resolved from the coordinates, with the historical offset (DST, Local Mean Time) of that date."},"time_basis":{"type":"string","enum":["civil","utc","lmt","true_solar"],"default":"civil","description":"What the given clock time is: civil wall-clock (default), UTC, Local Mean Time, or true (apparent) solar time."},"ambiguous_time":{"type":"string","enum":["earlier","later"],"default":"earlier","description":"Which occurrence to use when a local time happens twice (DST fall-back)."},"on_date":{"type":"string","description":"YYYY-MM-DD (UTC): also report what is active on this date."},"options":{"type":"object","properties":{"ayanamsa":{"type":"string","enum":["fagan_bradley","krishnamurti","lahiri","raman","true_chitrapaksha","yukteshwar"],"default":"lahiri"},"node_type":{"type":"string","enum":["mean","true"],"default":"mean","description":"Rahu/Ketu from the mean or the true (osculating) lunar node."},"house_system":{"type":"string","enum":["whole_sign","equal","placidus","porphyry","koch"],"default":"whole_sign","description":"Bhava system; 'equal' puts the lagna degree mid-house."},"include_outer_planets":{"type":"boolean","default":false},"depth":{"type":"integer","minimum":1,"maximum":4,"default":2,"description":"1 mahadasha, 2 +antardasha, 3 +pratyantardasha, 4 +sookshma."},"year_length":{"type":"string","enum":["julian","gregorian","sidereal","savana"],"default":"julian","description":"Dasha year: 365.25 (default), 365.2425, 365.256363 or 360 days."}}}},"required":["latitude","longitude"]},"example_request":{"datetime":"1990-05-15T14:30","latitude":28.6139,"longitude":77.209,"on_date":"2026-10-01"}},{"id":"vedic/doshas","method":"POST","url":"https://astro-agent.dev/v1/vedic/doshas","price_usd":"0.15","tier":"premium","title":"Doshas","summary":"Manglik (Kuja), Kaal Sarp and Sade Sati / Dhaiya, each with the exact rule applied and dates.","description":"Manglik from lagna, Moon and Venus with severity and commonly cited cancellations; Kaal Sarp with type and direction (partial cases flagged); Sade Sati cycles and Dhaiya phases with start/end dates over 100 years, plus the status on a given date.","mcp_tool":"doshas","input_schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth date-time, ISO 8601: '1990-05-15T14:30' (local clock time at the place) or with an explicit offset '1990-05-15T14:30:00+02:00'. Alternative: 'date' + 'time'.","examples":["1990-05-15T14:30"]},"date":{"type":"string","description":"YYYY-MM-DD (use with 'time' instead of 'datetime')."},"time":{"type":"string","description":"HH:MM or HH:MM:SS, 24 h. Omit if unknown (computed at 12:00 with a TIME_UNKNOWN warning)."},"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Decimal degrees, north positive."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Decimal degrees, east positive."},"timezone":{"type":"string","description":"IANA zone, e.g. 'Asia/Kolkata'. Optional: resolved from the coordinates, with the historical offset (DST, Local Mean Time) of that date."},"time_basis":{"type":"string","enum":["civil","utc","lmt","true_solar"],"default":"civil","description":"What the given clock time is: civil wall-clock (default), UTC, Local Mean Time, or true (apparent) solar time."},"ambiguous_time":{"type":"string","enum":["earlier","later"],"default":"earlier","description":"Which occurrence to use when a local time happens twice (DST fall-back)."},"on_date":{"type":"string","description":"YYYY-MM-DD (UTC): also report what is active on this date."},"options":{"type":"object","properties":{"ayanamsa":{"type":"string","enum":["fagan_bradley","krishnamurti","lahiri","raman","true_chitrapaksha","yukteshwar"],"default":"lahiri"},"node_type":{"type":"string","enum":["mean","true"],"default":"mean","description":"Rahu/Ketu from the mean or the true (osculating) lunar node."},"house_system":{"type":"string","enum":["whole_sign","equal","placidus","porphyry","koch"],"default":"whole_sign","description":"Bhava system; 'equal' puts the lagna degree mid-house."},"include_outer_planets":{"type":"boolean","default":false}}}},"required":["latitude","longitude"]},"example_request":{"datetime":"1990-05-15T14:30","latitude":28.6139,"longitude":77.209,"on_date":"2026-10-01"}},{"id":"vedic/gun-milan","method":"POST","url":"https://astro-agent.dev/v1/vedic/gun-milan","price_usd":"0.25","tier":"premium","title":"Gun Milan (Ashtakoota matching)","summary":"36-point Ashtakoota marriage compatibility: all 8 kootas with reasons, doshas and Manglik check.","description":"Varna, Vashya, Tara, Yoni, Graha Maitri, Gana, Bhakoot and Nadi scored from both Moons, each with the attributes and rule behind the score, Nadi/Bhakoot dosha flags with commonly cited cancellations, and both partners' Manglik status. Boy = person_a, girl = person_b by convention.","mcp_tool":"gun_milan","input_schema":{"type":"object","required":["person_a","person_b"],"properties":{"person_a":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth date-time, ISO 8601: '1990-05-15T14:30' (local clock time at the place) or with an explicit offset '1990-05-15T14:30:00+02:00'. Alternative: 'date' + 'time'.","examples":["1990-05-15T14:30"]},"date":{"type":"string","description":"YYYY-MM-DD (use with 'time' instead of 'datetime')."},"time":{"type":"string","description":"HH:MM or HH:MM:SS, 24 h. Omit if unknown (computed at 12:00 with a TIME_UNKNOWN warning)."},"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Decimal degrees, north positive."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Decimal degrees, east positive."},"timezone":{"type":"string","description":"IANA zone, e.g. 'Asia/Kolkata'. Optional: resolved from the coordinates, with the historical offset (DST, Local Mean Time) of that date."},"time_basis":{"type":"string","enum":["civil","utc","lmt","true_solar"],"default":"civil","description":"What the given clock time is: civil wall-clock (default), UTC, Local Mean Time, or true (apparent) solar time."},"ambiguous_time":{"type":"string","enum":["earlier","later"],"default":"earlier","description":"Which occurrence to use when a local time happens twice (DST fall-back)."}},"required":["latitude","longitude"],"description":"Groom / boy (traditional convention)."},"person_b":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth date-time, ISO 8601: '1990-05-15T14:30' (local clock time at the place) or with an explicit offset '1990-05-15T14:30:00+02:00'. Alternative: 'date' + 'time'.","examples":["1990-05-15T14:30"]},"date":{"type":"string","description":"YYYY-MM-DD (use with 'time' instead of 'datetime')."},"time":{"type":"string","description":"HH:MM or HH:MM:SS, 24 h. Omit if unknown (computed at 12:00 with a TIME_UNKNOWN warning)."},"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Decimal degrees, north positive."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Decimal degrees, east positive."},"timezone":{"type":"string","description":"IANA zone, e.g. 'Asia/Kolkata'. Optional: resolved from the coordinates, with the historical offset (DST, Local Mean Time) of that date."},"time_basis":{"type":"string","enum":["civil","utc","lmt","true_solar"],"default":"civil","description":"What the given clock time is: civil wall-clock (default), UTC, Local Mean Time, or true (apparent) solar time."},"ambiguous_time":{"type":"string","enum":["earlier","later"],"default":"earlier","description":"Which occurrence to use when a local time happens twice (DST fall-back)."}},"required":["latitude","longitude"],"description":"Bride / girl."},"options":{"type":"object","properties":{"ayanamsa":{"type":"string","enum":["fagan_bradley","krishnamurti","lahiri","raman","true_chitrapaksha","yukteshwar"],"default":"lahiri"},"node_type":{"type":"string","enum":["mean","true"],"default":"mean","description":"Rahu/Ketu from the mean or the true (osculating) lunar node."},"house_system":{"type":"string","enum":["whole_sign","equal","placidus","porphyry","koch"],"default":"whole_sign","description":"Bhava system; 'equal' puts the lagna degree mid-house."},"include_outer_planets":{"type":"boolean","default":false}}}}},"example_request":{"person_a":{"datetime":"1990-05-15T14:30","latitude":28.6139,"longitude":77.209},"person_b":{"datetime":"1992-08-03T09:15","latitude":19.076,"longitude":72.8777}}},{"id":"vedic/report","method":"POST","url":"https://astro-agent.dev/v1/vedic/report","price_usd":"0.50","tier":"premium","title":"Complete Vedic report","summary":"Kundli + Vimshottari dashas + doshas + janma panchang in one call.","description":"The full Jyotish dossier for one person in a single deterministic call: everything in /vedic/kundli, /vedic/dashas (2 levels, running periods with on_date), /vedic/doshas and the panchang at birth.","mcp_tool":"vedic_report","input_schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Local birth date-time, ISO 8601: '1990-05-15T14:30' (local clock time at the place) or with an explicit offset '1990-05-15T14:30:00+02:00'. Alternative: 'date' + 'time'.","examples":["1990-05-15T14:30"]},"date":{"type":"string","description":"YYYY-MM-DD (use with 'time' instead of 'datetime')."},"time":{"type":"string","description":"HH:MM or HH:MM:SS, 24 h. Omit if unknown (computed at 12:00 with a TIME_UNKNOWN warning)."},"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Decimal degrees, north positive."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Decimal degrees, east positive."},"timezone":{"type":"string","description":"IANA zone, e.g. 'Asia/Kolkata'. Optional: resolved from the coordinates, with the historical offset (DST, Local Mean Time) of that date."},"time_basis":{"type":"string","enum":["civil","utc","lmt","true_solar"],"default":"civil","description":"What the given clock time is: civil wall-clock (default), UTC, Local Mean Time, or true (apparent) solar time."},"ambiguous_time":{"type":"string","enum":["earlier","later"],"default":"earlier","description":"Which occurrence to use when a local time happens twice (DST fall-back)."},"on_date":{"type":"string","description":"YYYY-MM-DD (UTC): also report what is active on this date."},"options":{"type":"object","properties":{"ayanamsa":{"type":"string","enum":["fagan_bradley","krishnamurti","lahiri","raman","true_chitrapaksha","yukteshwar"],"default":"lahiri"},"node_type":{"type":"string","enum":["mean","true"],"default":"mean","description":"Rahu/Ketu from the mean or the true (osculating) lunar node."},"house_system":{"type":"string","enum":["whole_sign","equal","placidus","porphyry","koch"],"default":"whole_sign","description":"Bhava system; 'equal' puts the lagna degree mid-house."},"include_outer_planets":{"type":"boolean","default":false},"depth":{"type":"integer","minimum":1,"maximum":4,"default":2,"description":"1 mahadasha, 2 +antardasha, 3 +pratyantardasha, 4 +sookshma."},"year_length":{"type":"string","enum":["julian","gregorian","sidereal","savana"],"default":"julian","description":"Dasha year: 365.25 (default), 365.2425, 365.256363 or 360 days."}}}},"required":["latitude","longitude"]},"example_request":{"datetime":"1990-05-15T14:30","latitude":28.6139,"longitude":77.209,"on_date":"2026-10-01"}}],"free_endpoints":{"GET /v1/catalog":"this document","GET /v1/health":"liveness + versions","POST /v1/verify":"recompute a result_sha256 from a response you hold"},"support":{"email":"aidatatools@proton.me","page":"https://astro-agent.dev/support","privacy":"https://astro-agent.dev/privacy","terms":"https://astro-agent.dev/terms"},"discovery":{"openapi":"https://astro-agent.dev/openapi.json","llms_txt":"https://astro-agent.dev/llms.txt","mcp":"https://astro-agent.dev/mcp","a2a_agent_card":"https://astro-agent.dev/.well-known/agent-card.json","x402":"https://astro-agent.dev/.well-known/x402"}}