Astro Agents

{
  "name": "Astro Agents",
  "description": "Deterministic Western + Vedic astrology API for AI agents: JPL DE440 ephemeris, no LLM, reproducible SHA-256 hashes. Each skill id is also a REST route (POST https://astro-agent.dev/v1/<skill id>). Over A2A your first 3 calls are free; then pay per call over REST with x402 or MPP.",
  "version": "1.0.1",
  "provider": {
    "organization": "aidatatools",
    "url": "https://github.com/aidatatools-dev"
  },
  "documentationUrl": "https://astro-agent.dev/llms-full.txt",
  "supportedInterfaces": [
    {
      "url": "https://astro-agent.dev/a2a",
      "protocolBinding": "JSONRPC",
      "protocolVersion": "1.0"
    }
  ],
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "extendedAgentCard": false
  },
  "defaultInputModes": [
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "skills": [
    {
      "id": "time/resolve",
      "name": "Birth time resolver",
      "description": "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. $0.01 per call over REST.",
      "tags": [
        "time zone",
        "true solar time",
        "local mean time",
        "julian day",
        "delta t",
        "astrology",
        "deterministic"
      ],
      "examples": [
        "{\"skill\": \"time/resolve\", \"input\": {\"datetime\": \"1947-08-15T00:00\", \"latitude\": 28.6139, \"longitude\": 77.209}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "western/positions",
      "name": "Planetary positions",
      "description": "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). $0.01 per call over REST.",
      "tags": [
        "ephemeris",
        "planet positions",
        "retrograde",
        "zodiac",
        "astrology",
        "deterministic"
      ],
      "examples": [
        "{\"skill\": \"western/positions\", \"input\": {\"datetime\": \"2026-10-01T12:00:00Z\"}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "western/aspects",
      "name": "Aspects",
      "description": "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. $0.02 per call over REST.",
      "tags": [
        "aspects",
        "orbs",
        "applying",
        "separating",
        "astrology",
        "deterministic"
      ],
      "examples": [
        "{\"skill\": \"western/aspects\", \"input\": {\"longitudes\": {\"sun\": 54.4, \"moon\": 297.4, \"saturn\": 295.2, \"venus\": 12.8}}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "western/natal",
      "name": "Western natal chart",
      "description": "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. $0.06 per call over REST.",
      "tags": [
        "natal chart",
        "birth chart",
        "houses",
        "ascendant",
        "horoscope",
        "astrology",
        "deterministic"
      ],
      "examples": [
        "{\"skill\": \"western/natal\", \"input\": {\"datetime\": \"1990-05-15T14:30\", \"latitude\": 48.8566, \"longitude\": 2.3522}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "western/transits",
      "name": "Transits",
      "description": "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. $0.08 per call over REST.",
      "tags": [
        "transits",
        "forecast",
        "exact aspect dates",
        "retrograde",
        "astrology",
        "deterministic"
      ],
      "examples": [
        "{\"skill\": \"western/transits\", \"input\": {\"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\"}}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "western/synastry",
      "name": "Synastry",
      "description": "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. $0.12 per call over REST.",
      "tags": [
        "synastry",
        "compatibility",
        "relationship",
        "composite",
        "astrology",
        "deterministic"
      ],
      "examples": [
        "{\"skill\": \"western/synastry\", \"input\": {\"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}}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "vedic/nakshatra",
      "name": "Nakshatras",
      "description": "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. $0.02 per call over REST.",
      "tags": [
        "nakshatra",
        "janma nakshatra",
        "birth star",
        "jyotish",
        "vedic",
        "astrology",
        "deterministic"
      ],
      "examples": [
        "{\"skill\": \"vedic/nakshatra\", \"input\": {\"datetime\": \"1990-05-15T14:30\", \"timezone\": \"Asia/Kolkata\"}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "vedic/panchang",
      "name": "Panchang",
      "description": "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. $0.02 per call over REST.",
      "tags": [
        "panchang",
        "tithi",
        "muhurta",
        "hindu calendar",
        "sunrise",
        "astrology",
        "deterministic"
      ],
      "examples": [
        "{\"skill\": \"vedic/panchang\", \"input\": {\"datetime\": \"2026-10-01T06:00\", \"latitude\": 25.3176, \"longitude\": 82.9739}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "vedic/kundli",
      "name": "Kundli (Vedic birth chart)",
      "description": "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). $0.15 per call over REST.",
      "tags": [
        "kundli",
        "kundali",
        "janam kundli",
        "vedic chart",
        "jyotish",
        "navamsa",
        "astrology",
        "deterministic"
      ],
      "examples": [
        "{\"skill\": \"vedic/kundli\", \"input\": {\"datetime\": \"1990-05-15T14:30\", \"latitude\": 28.6139, \"longitude\": 77.209}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "vedic/kundli-full",
      "name": "Kundli with all 16 vargas",
      "description": "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. $0.32 per call over REST.",
      "tags": [
        "divisional charts",
        "vargas",
        "shodashavarga",
        "D9",
        "D10",
        "D60",
        "astrology",
        "deterministic"
      ],
      "examples": [
        "{\"skill\": \"vedic/kundli-full\", \"input\": {\"datetime\": \"1990-05-15T14:30\", \"latitude\": 28.6139, \"longitude\": 77.209}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "vedic/dashas",
      "name": "Vimshottari dashas",
      "description": "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. $0.10 per call over REST.",
      "tags": [
        "dasha",
        "vimshottari",
        "mahadasha",
        "antardasha",
        "astrology",
        "deterministic"
      ],
      "examples": [
        "{\"skill\": \"vedic/dashas\", \"input\": {\"datetime\": \"1990-05-15T14:30\", \"latitude\": 28.6139, \"longitude\": 77.209, \"on_date\": \"2026-10-01\"}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "vedic/doshas",
      "name": "Doshas",
      "description": "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. $0.15 per call over REST.",
      "tags": [
        "manglik",
        "mangal dosha",
        "kaal sarp",
        "sade sati",
        "dosha",
        "astrology",
        "deterministic"
      ],
      "examples": [
        "{\"skill\": \"vedic/doshas\", \"input\": {\"datetime\": \"1990-05-15T14:30\", \"latitude\": 28.6139, \"longitude\": 77.209, \"on_date\": \"2026-10-01\"}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "vedic/gun-milan",
      "name": "Gun Milan (Ashtakoota matching)",
      "description": "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. $0.25 per call over REST.",
      "tags": [
        "gun milan",
        "kundli matching",
        "ashtakoota",
        "marriage compatibility",
        "guna",
        "astrology",
        "deterministic"
      ],
      "examples": [
        "{\"skill\": \"vedic/gun-milan\", \"input\": {\"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}}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "vedic/report",
      "name": "Complete Vedic report",
      "description": "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. $0.50 per call over REST.",
      "tags": [
        "vedic report",
        "jyotish report",
        "kundli report",
        "astrology",
        "deterministic"
      ],
      "examples": [
        "{\"skill\": \"vedic/report\", \"input\": {\"datetime\": \"1990-05-15T14:30\", \"latitude\": 28.6139, \"longitude\": 77.209, \"on_date\": \"2026-10-01\"}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    }
  ]
}