Astro Agents - deterministic Western + Vedic astrology

Local birth time + place -> exact UT, historical UTC offset, Delta T, Local Mean Time, true solar time. 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. Deterministic (JPL DE440, no LLM); every result carries meta.result_sha256. Price $0.01 per call via REST POST https://astro-agent.dev/v1/time/resolve (x402 or MPP); your first 3 calls are free here.

{
  "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."
}

Tropical (or sidereal) longitudes, latitudes, speeds and retrograde flags of Sun..Pluto, nodes, Lilith. 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). Deterministic (JPL DE440, no LLM); every result carries meta.result_sha256. Price $0.01 per call via REST POST https://astro-agent.dev/v1/western/positions (x402 or MPP); your first 3 calls are free here.

{
  "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": []
}

Aspects (with orb, exactness, applying/separating) for a moment, or for any longitudes you supply. 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. Deterministic (JPL DE440, no LLM); every result carries meta.result_sha256. Price $0.02 per call via REST POST https://astro-agent.dev/v1/western/aspects (x402 or MPP); your first 3 calls are free here.

{
  "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": []
}

Complete natal chart: planets in signs and houses, ascendant, MC, 11 house systems, aspects, summary. 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. Deterministic (JPL DE440, no LLM); every result carries meta.result_sha256. Price $0.06 per call via REST POST https://astro-agent.dev/v1/western/natal (x402 or MPP); your first 3 calls are free here.

{
  "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"
  ]
}

Transits to a natal chart at a moment, and exact hit times over a window of up to a year. '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. Deterministic (JPL DE440, no LLM); every result carries meta.result_sha256. Price $0.08 per call via REST POST https://astro-agent.dev/v1/western/transits (x402 or MPP); your first 3 calls are free here.

{
  "type": "object",
  "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
        }
      }
    }
  },
  "required": [
    "natal"
  ]
}

Relationship comparison: cross-aspects, house overlays both ways, composite midpoints. 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. Deterministic (JPL DE440, no LLM); every result carries meta.result_sha256. Price $0.12 per call via REST POST https://astro-agent.dev/v1/western/synastry (x402 or MPP); your first 3 calls are free here.

{
  "type": "object",
  "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
        }
      }
    }
  },
  "required": [
    "person_a",
    "person_b"
  ]
}

Sidereal nakshatra, pada and lord of every graha; janma nakshatra with gana, yoni, nadi, varna. 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. Deterministic (JPL DE440, no LLM); every result carries meta.result_sha256. Price $0.02 per call via REST POST https://astro-agent.dev/v1/vedic/nakshatra (x402 or MPP); your first 3 calls are free here.

{
  "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": []
}

Tithi, vara, nakshatra, yoga, karana with the exact time each ends, plus sunrise and sunset. 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. Deterministic (JPL DE440, no LLM); every result carries meta.result_sha256. Price $0.02 per call via REST POST https://astro-agent.dev/v1/vedic/panchang (x402 or MPP); your first 3 calls are free here.

{
  "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"
  ]
}

Sidereal D1 + D9: lagna, 9 grahas with rashi, nakshatra, pada, house, dignity, combustion, bhavas. 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). Deterministic (JPL DE440, no LLM); every result carries meta.result_sha256. Price $0.15 per call via REST POST https://astro-agent.dev/v1/vedic/kundli (x402 or MPP); your first 3 calls are free here.

{
  "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"
  ]
}

The kundli plus all Shodashavarga divisional charts D1..D60 (Parashara rules). 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. Deterministic (JPL DE440, no LLM); every result carries meta.result_sha256. Price $0.32 per call via REST POST https://astro-agent.dev/v1/vedic/kundli-full (x402 or MPP); your first 3 calls are free here.

{
  "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"
  ]
}

Vimshottari maha/antar/pratyantar periods with exact dates, birth balance, and the running periods. 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. Deterministic (JPL DE440, no LLM); every result carries meta.result_sha256. Price $0.10 per call via REST POST https://astro-agent.dev/v1/vedic/dashas (x402 or MPP); your first 3 calls are free here.

{
  "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"
  ]
}

Manglik (Kuja), Kaal Sarp and Sade Sati / Dhaiya, each with the exact rule applied and dates. 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. Deterministic (JPL DE440, no LLM); every result carries meta.result_sha256. Price $0.15 per call via REST POST https://astro-agent.dev/v1/vedic/doshas (x402 or MPP); your first 3 calls are free here.

{
  "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"
  ]
}

36-point Ashtakoota marriage compatibility: all 8 kootas with reasons, doshas and Manglik check. 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. Deterministic (JPL DE440, no LLM); every result carries meta.result_sha256. Price $0.25 per call via REST POST https://astro-agent.dev/v1/vedic/gun-milan (x402 or MPP); your first 3 calls are free here.

{
  "type": "object",
  "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
        }
      }
    }
  },
  "required": [
    "person_a",
    "person_b"
  ]
}

Kundli + Vimshottari dashas + doshas + janma panchang in one call. 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. Deterministic (JPL DE440, no LLM); every result carries meta.result_sha256. Price $0.50 per call via REST POST https://astro-agent.dev/v1/vedic/report (x402 or MPP); your first 3 calls are free here.

{
  "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"
  ]
}

Free. Lists every astrology endpoint with price, input schema and an example request. Call this first to pick the right tool.

{
  "type": "object",
  "properties": {}
}

Free. Recomputes the SHA-256 of a 'result' object returned by any tool and compares it with the result_sha256 you hold, proving the result was not altered.

{
  "type": "object",
  "properties": {
    "result": {
      "type": "object"
    },
    "result_sha256": {
      "type": "string"
    }
  },
  "required": [
    "result"
  ]
}