{"service":"Astro Agents","tagline":"Research-grade astronomical data & computation API — NASA/JPL DE440 ephemerides for any date, past, present or future, reproducible and SHA-256 verifiable.","description":"Astro Agents — a research-grade, verifiable astronomical data and computation API for developers, researchers and astronomy, calendar, observation and data applications. Ephemerides from the real NASA/JPL DE440: planetary positions (geocentric & heliocentric, ecliptic & equatorial: right ascension and declination), speeds and retrograde motion, Moon phase and illumination, angular separations between bodies (aspects, declination parallels), longitude time series, and a to-the-minute celestial event calendar (solar and lunar eclipses, stations, ingresses, lunations, out-of-bounds), 1800-2200. Any date — past, present or future — reproducible: no LLM, historical time zones resolved for you, every result SHA-256 hashed and checkable, accuracy benchmarked against NASA/JPL Horizons. Pay per call over REST or natively in MCP with x402 (USDC on Base or Solana) or MPP: zero setup, no account; or with prepaid credits or a monthly plan. Data only — no predictions, never a signal or forecast.","astronomy":{"pillars":[{"name":"NASA/JPL DE440","detail":"The reference planetary ephemeris, read through Skyfield: apparent geocentric positions, true equinox of date, IAU 2006/2000A."},{"name":"Any date: past, present, future","detail":"Every date from 1800 to 2200, events to the minute; historical time zones and daylight saving resolved from the coordinates. The same request always returns the same bytes."},{"name":"SHA-256 on every result","detail":"meta.input_sha256 and meta.result_sha256 on every response; POST /v1/verify (free) recomputes them, so a result can be cached, cited and checked."},{"name":"Benchmarked against Horizons","detail":"Positions compared with NASA/JPL Horizons over 1800-2200, method and every value published at /benchmark.md."}],"routes":[{"route":"POST /v1/western/positions","title":"Planetary positions for any date (ephemeris)","mcp_tool":"planet_positions","price_usd":"0.01"},{"route":"POST /v1/western/sky","title":"Sky today: retrogrades, Moon phase, next events","mcp_tool":"sky_today","price_usd":"0.01"},{"route":"POST /v1/astronomy/rise-set","title":"Rise, set and twilight times for a place","mcp_tool":"rise_set_times","price_usd":"0.01"},{"route":"POST /v1/astronomy/altaz","title":"Altitude and azimuth of every body from a place","mcp_tool":"altitude_azimuth","price_usd":"0.01"},{"route":"POST /v1/astronomy/visibility","title":"Observation windows for a night","mcp_tool":"observation_windows","price_usd":"0.02"},{"route":"POST /v1/astronomy/moon","title":"Moon phase, illumination, distance and next phases","mcp_tool":"moon_details","price_usd":"0.01"},{"route":"POST /v1/astronomy/day","title":"Astronomical summary of the day for a place","mcp_tool":"day_summary","price_usd":"0.02"},{"route":"POST /v1/astronomy/seasons","title":"Equinoxes, solstices, perihelion and day length over a year","mcp_tool":"seasons","price_usd":"0.01"},{"route":"POST /v1/astronomy/time","title":"Julian day, sidereal time, Delta T and time scales","mcp_tool":"time_scales","price_usd":"0.01"},{"route":"POST /v1/astronomy/convert","title":"Coordinate conversion between sky frames","mcp_tool":"convert_coordinates","price_usd":"0.01"},{"route":"POST /v1/astronomy/phenomena","title":"Planetary phenomena: oppositions, conjunctions, elongations","mcp_tool":"planetary_phenomena","price_usd":"0.10"},{"route":"POST /v1/astronomy/eclipse-local","title":"Local circumstances of solar and lunar eclipses","mcp_tool":"local_eclipse","price_usd":"0.10"},{"route":"POST /v1/astronomy/solunar","title":"Solunar periods: lunar transits, moonrise and moonset","mcp_tool":"solunar_periods","price_usd":"0.01"},{"route":"POST /v1/western/aspects","title":"Angles between bodies (aspects, parallels)","mcp_tool":"aspects","price_usd":"0.02"},{"route":"POST /v1/finance/events","title":"Celestial event calendar (eclipses, stations, ingresses)","mcp_tool":"astro_event_calendar","price_usd":"0.25"},{"route":"POST /v1/finance/planetary-lines","title":"Planetary longitude series (geocentric + heliocentric)","mcp_tool":"planetary_lines","price_usd":"0.20"},{"route":"POST /v1/finance/analogues","title":"Sky similarity search (matching skies)","mcp_tool":"sky_analogues","price_usd":"0.25"},{"route":"POST /v1/time/resolve","title":"Local time resolver (historical time zones)","mcp_tool":"resolve_birth_time","price_usd":"0.01"}],"data_only":"Astronomical data only: no predictions, never a signal or forecast."},"engine_version":"1.9.0","whats_new":{"version":"1.9.0","date":"2026-11-05","items":[{"what":"Celestial event calendar","route":"POST /v1/finance/events","mcp_tool":"astro_event_calendar","price_usd":"0.25","summary":"Solar and lunar eclipses, retrograde/direct stations, sign ingresses, lunations, angular aspects, declination parallels and out-of-bounds crossings between two dates, 1800-2200, each to the UTC minute with a unix timestamp and a stable key."},{"what":"Heliocentric and equatorial positions","route":"POST /v1/western/positions","mcp_tool":"planet_positions","price_usd":"0.01","summary":"options.perspective = heliocentric, options.coordinates = equatorial (right ascension, declination, out-of-bounds). Defaults unchanged."},{"what":"Declination parallels","route":"POST /v1/western/aspects","mcp_tool":"aspects","price_usd":"0.02","summary":"options.declination: parallels and contra-parallels with orb and applying/separating."},{"what":"Planetary longitude series","route":"POST /v1/finance/planetary-lines","mcp_tool":"planetary_lines","price_usd":"0.20","summary":"Geocentric and heliocentric planet longitudes in one call, snapshot or series (1h..1w, up to 1,000 samples), with speeds, retrograde flags and declinations."},{"what":"Sky similarity search (matching skies)","route":"POST /v1/finance/analogues","mcp_tool":"sky_analogues","price_usd":"0.25","summary":"The past or future dates whose planetary positions best match a reference sky (a moment, 'now' or your own positions), ranked by a stated circular angular distance over longitudes, aspects, declinations and retrograde flags; the metric is in every response. Data only."},{"what":"Sky now","route":"POST /v1/western/sky","mcp_tool":"sky_today","price_usd":"0.01","summary":"Positions, retrogrades and the Moon's phase and illumination now, and the exact times of the next ingresses, stations, lunations and aspects."},{"what":"Accuracy verified against NASA/JPL Horizons","route":"GET /v1/benchmark","price_usd":"0","summary":"12,400 comparisons, 1800-2199: positions 0.0005\" mean / 0.024\" max (ICRF); longitude as served 0.048\" mean over 1962-2026.","details":"https://astro-agent.dev/benchmark.md"}]},"start_here":"Cheapest useful call: POST /v1/western/positions (planetary positions for any date) or /v1/western/sky (positions, Moon phase, next events) at $0.01. Each client gets 1 free call on the $0.01-0.02 routes (REST, MCP or A2A), within a daily budget shared by all callers; every other route is always paid.","why_use_this_instead_of_computing_it_yourself":["LLMs routinely get time zones, historical DST, sidereal time and Delta T wrong; one wrong hour moves 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 (frame, equinox, perspective, orbs, zodiac) is stated in the response, never implicit."],"payment":{"protocols":["x402 (USDC on Base and Solana)","MPP (Tempo: OUSD or USDC.e)"],"free_calls":{"per_client":1,"rest_routes":["time/resolve","western/positions","astronomy/rise-set","astronomy/altaz","astronomy/visibility","astronomy/moon","astronomy/day","astronomy/seasons","astronomy/time","astronomy/convert","astronomy/solunar","western/sky","western/aspects"],"mcp_a2a":"the same $0.01-0.02 tools only; every other tool is always paid","limits":"identified by IP; daily budget shared by all callers","shared_platforms":"users of Claude's MCP connectors share one pool that refills every hour (see /v1/health)"},"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"],"currencies":["0x20c0000000000000000000006a37DA5C996874BE","0x20C000000000000000000000b9537d11c60E8b50"]},"free_calls":{"enabled":true,"per_caller":1,"rest_routes":["time/resolve","western/positions","astronomy/rise-set","astronomy/altaz","astronomy/visibility","astronomy/moon","astronomy/day","astronomy/seasons","astronomy/time","astronomy/convert","astronomy/solunar","western/sky","western/aspects"],"mcp_a2a":"the same cheap tools only; every premium and finance tool is always paid","daily_cap_all_callers":300,"identity":"client IP, as set by the hosting platform (never a request header)","shared_platform_pools":{"platforms":["anthropic"],"per_hour":12,"per_day":60,"why":"users of these platforms reach us from shared IPs, so they share a pool that refills every hour instead of 1 per IP for life"},"opt_out":"send 'X-Free-Call: skip' to be asked for payment directly"}}},"finance":{"tagline":"Planetary time series and celestial events as data: geocentric and heliocentric positions, declination, longitude series and a to-the-minute event calendar, reproducible to the byte.","why":"Provable and replayable: every result is SHA-256 hashed, so the same request returns the same bytes.","tags":["astronomy","ephemeris","nasa-jpl","celestial-events","data"],"data_not_signals":"Exact astronomical data only; no signal, forecast or advice.","routes":[{"route":"POST /v1/finance/planetary-lines","mcp_tool":"planetary_lines","price_usd":"0.20"},{"route":"POST /v1/finance/events","mcp_tool":"astro_event_calendar","price_usd":"0.25"},{"route":"POST /v1/finance/analogues","mcp_tool":"sky_analogues","price_usd":"0.25"},{"route":"POST /v1/western/positions","mcp_tool":"planet_positions","price_usd":"0.01"},{"route":"POST /v1/western/aspects","mcp_tool":"aspects","price_usd":"0.02"},{"route":"POST /v1/western/sky","mcp_tool":"sky_today","price_usd":"0.01"}],"for_bots":{"series":"finance/planetary-lines with start/end/interval: pandas.DataFrame(result['series']) gives one column per line, indexed by 'timestamp' (unix seconds, UTC).","events":"finance/events: each event has exact_utc, timestamp (unix seconds) and a stable key; page a long range year by year and de-duplicate on key.","analogues":"finance/analogues: pandas.DataFrame(result['matches']) gives one row per matching date (date_utc, timestamp, score in degrees, positions, retrograde flags, per-feature distances); the metric is in result.settings.metric. reference {birth: {datetime, latitude, longitude}} compares the sky at a local date-time and place to past/future dates — data only.","replay":"Store meta.input_sha256 and meta.result_sha256 with your data; the same request returns the same bytes, and POST /v1/verify recomputes the hash.","frameworks":"pandas or any time-series store: merge the events or series on a unix timestamp (timestamp) to join them with other data."}},"calls":[{"id":"time/resolve","method":"POST","url":"https://astro-agent.dev/v1/time/resolve","price_usd":"0.01","tier":"call","title":"Local time resolver (historical time zones)","summary":"Local 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 civil 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 for any date (ephemeris)","summary":"Planetary positions for any date and time (ephemeris): tropical or sidereal longitude, latitude, speed and retrograde flag of the Sun, Moon, Mercury..Pluto, nodes and 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). Options: perspective 'heliocentric' (seen from the Sun) and coordinates 'equatorial' (right ascension, declination, out-of-bounds).","mcp_tool":"planet_positions","input_schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Local civil 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","description":"Optional calculation settings; every default is the common Western convention.","properties":{"house_system":{"type":"string","enum":["alcabitius","campanus","equal","koch","meridian","morinus","placidus","porphyry","regiomontanus","topocentric","whole_sign"],"default":"placidus","description":"House system for cusps and planet houses, e.g. 'placidus' (default) or 'whole_sign'."},"zodiac":{"type":"string","enum":["tropical","sidereal"],"default":"tropical","description":"'tropical' (Western, default) or 'sidereal' (pair it with 'ayanamsa')."},"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,"description":"Extra orb in degrees for aspects involving the Sun or the Moon. Example: 2."},"perspective":{"type":"string","enum":["geocentric","heliocentric"],"default":"geocentric","description":"'geocentric' (default) or 'heliocentric' (geometric, seen from the Sun: Earth instead of Sun and Moon, no lunar points)."},"coordinates":{"type":"string","enum":["ecliptic","equatorial"],"default":"ecliptic","description":"'ecliptic' (default: longitude/latitude) or 'equatorial': also each point's right ascension, declination, their daily speeds and an out-of-bounds flag."}}}},"required":[]},"example_request":{"datetime":"2026-10-01T12:00:00Z"}},{"id":"astronomy/rise-set","method":"POST","url":"https://astro-agent.dev/v1/astronomy/rise-set","price_usd":"0.01","tier":"call","title":"Rise, set and twilight times for a place","summary":"Rise, transit and set of the Sun, Moon and planets for a place and local day, with civil, nautical and astronomical twilight, day length, golden hour and blue hour.","description":"For sky, weather, photography and outdoor apps: for one local calendar day at a place (time zone and DST resolved from the coordinates), each body's rise and set (with azimuth) and upper transit (with altitude), or 'always_up' / 'always_down' when it neither rises nor sets (polar day and night); for the Sun, dawn and dusk at -6, -12 and -18 degrees, solar noon, day length, and the golden hour (Sun between -4 and +6 degrees) and blue hour (-6 to -4) intervals. Times in UTC to the second, local time with its offset, and unix timestamps; every convention (refraction, limb, horizon) is in result.settings.","mcp_tool":"rise_set_times","input_schema":{"type":"object","required":["date","latitude","longitude"],"properties":{"date":{"type":"string","description":"The local calendar day at the place, YYYY-MM-DD (1800-01-02..2199-12-30), midnight to midnight in its time zone."},"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Decimal degrees, north positive."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Decimal degrees, east positive."},"elevation_m":{"type":"number","minimum":-500,"maximum":9000,"default":0,"description":"Height above the WGS84 ellipsoid, metres (no terrain or horizon dip is modelled)."},"timezone":{"type":"string","description":"IANA zone for local times, e.g. 'Europe/Paris'. Optional: resolved from the coordinates (with its historical DST rules)."},"bodies":{"type":"array","items":{"type":"string","enum":["sun","moon","mercury","venus","mars","jupiter","saturn","uranus","neptune","pluto"]},"description":"Bodies to time. Default: all ten (Sun, Moon, Mercury..Pluto). The Sun's twilight block is always returned."}}},"example_request":{"date":"2026-06-21","latitude":48.8566,"longitude":2.3522}},{"id":"astronomy/altaz","method":"POST","url":"https://astro-agent.dev/v1/astronomy/altaz","price_usd":"0.01","tier":"call","title":"Altitude and azimuth of every body from a place","summary":"Where the Sun, Moon and planets are in the sky from a place at a moment: altitude, azimuth, compass point, topocentric right ascension and declination, distance, elongation, illumination and magnitude.","description":"For sky maps, telescope pointing, AR and observation apps: each body's apparent altitude and azimuth (with refraction, or airless), whether it is above the horizon, its topocentric right ascension and declination, distance (and the Moon's in km), angular distance from the Sun, illuminated fraction and visual magnitude (planets), plus the sky state (day, civil / nautical / astronomical twilight, night). Matches NASA/JPL Horizons to under a second of arc.","mcp_tool":"altitude_azimuth","input_schema":{"type":"object","required":["datetime","latitude","longitude"],"properties":{"datetime":{"type":"string","description":"The moment: UTC ('2026-06-21T21:00:00Z'), with an explicit offset, or local civil time at the place ('2026-06-21T23:00', time zone resolved from the coordinates)."},"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Decimal degrees, north positive."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Decimal degrees, east positive."},"elevation_m":{"type":"number","minimum":-500,"maximum":9000,"default":0,"description":"Height above the WGS84 ellipsoid, metres (no terrain or horizon dip is modelled)."},"timezone":{"type":"string","description":"IANA zone for local times, e.g. 'Europe/Paris'. Optional: resolved from the coordinates (with its historical DST rules)."},"bodies":{"type":"array","items":{"type":"string","enum":["sun","moon","mercury","venus","mars","jupiter","saturn","uranus","neptune","pluto"]},"description":"Bodies to locate. Default: all ten."},"options":{"type":"object","properties":{"refraction":{"type":"boolean","default":true,"description":"Apply atmospheric refraction to the altitude (true) or give the geometric, airless altitude (false)."},"temperature_c":{"type":"number","default":10,"description":"Air temperature for refraction, deg C."},"pressure_hpa":{"type":["number","string"],"default":"standard","description":"Air pressure for refraction, hPa, or 'standard' (from the elevation)."}},"description":"Refraction settings."}}},"example_request":{"datetime":"2026-06-21T23:00","latitude":48.8566,"longitude":2.3522}},{"id":"astronomy/visibility","method":"POST","url":"https://astro-agent.dev/v1/astronomy/visibility","price_usd":"0.02","tier":"call","title":"Observation windows for a night","summary":"When each planet and the Moon can be observed from a place during a night: windows above a minimum altitude while the sky is dark, with the best time, altitude, azimuth and magnitude.","description":"For observation planning: over the night that starts on 'date' (local noon to noon), the intervals when each body stands at least min_altitude_deg above the horizon while the Sun is at or below sun_altitude_max_deg (default -6: after civil dusk), each with start, end, duration and the best moment (highest altitude) with its azimuth and visual magnitude; plus the dark interval itself.","mcp_tool":"observation_windows","input_schema":{"type":"object","required":["date","latitude","longitude"],"properties":{"date":{"type":"string","description":"The evening that starts the observing night, YYYY-MM-DD: the night runs from local noon on that date to local noon the next day."},"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Decimal degrees, north positive."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Decimal degrees, east positive."},"elevation_m":{"type":"number","minimum":-500,"maximum":9000,"default":0,"description":"Height above the WGS84 ellipsoid, metres (no terrain or horizon dip is modelled)."},"timezone":{"type":"string","description":"IANA zone for local times, e.g. 'Europe/Paris'. Optional: resolved from the coordinates (with its historical DST rules)."},"bodies":{"type":"array","items":{"type":"string","enum":["moon","mercury","venus","mars","jupiter","saturn","uranus","neptune","pluto"]},"description":"Bodies to plan. Default: the Moon and Mercury..Neptune."},"options":{"type":"object","properties":{"min_altitude_deg":{"type":"number","minimum":-5,"maximum":89,"default":10,"description":"Lowest useful altitude of the body above the horizon, degrees."},"sun_altitude_max_deg":{"type":"number","minimum":-18,"maximum":0,"default":-6,"description":"The sky counts as dark when the Sun is at or below this altitude: -6 civil, -12 nautical, -18 astronomical."}},"description":"What counts as observable."}}},"example_request":{"date":"2026-06-21","latitude":48.8566,"longitude":2.3522}},{"id":"astronomy/moon","method":"POST","url":"https://astro-agent.dev/v1/astronomy/moon","price_usd":"0.01","tier":"call","title":"Moon phase, illumination, distance and next phases","summary":"The Moon at a moment: phase name and angle, illuminated fraction, age, lunation number, distance and apparent size, the next new, first quarter, full and last quarter Moons, and the next perigee and apogee.","description":"For calendar, weather, photography and tide apps: phase (8 names), phase angle, illuminated fraction, waxing or waning, age in days since the new Moon, Brown lunation number, centre-to-centre distance in km and Earth radii, angular diameter, ecliptic position, the previous new Moon, the next four principal phases and the next perigee and apogee with their distances, to the second. With latitude/longitude: the Moon's altitude and azimuth there and that local day's moonrise, transit and moonset. Perigee and apogee match NASA/JPL Horizons to the minute.","mcp_tool":"moon_details","input_schema":{"type":"object","properties":{"datetime":{"type":"string","description":"The moment: UTC, an explicit offset, or local civil time at the place given by latitude/longitude. Default: now (UTC, to the minute)."},"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Optional: add the Moon's altitude and azimuth from this place and that local day's moonrise, transit and moonset."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Optional, with latitude."},"elevation_m":{"type":"number","minimum":-500,"maximum":9000,"default":0,"description":"Height above the WGS84 ellipsoid, metres (no terrain or horizon dip is modelled)."},"timezone":{"type":"string","description":"IANA zone for local times, e.g. 'Europe/Paris'. Optional: resolved from the coordinates (with its historical DST rules)."}}},"example_request":{"datetime":"2026-01-03T12:00:00Z","latitude":48.8566,"longitude":2.3522}},{"id":"astronomy/day","method":"POST","url":"https://astro-agent.dev/v1/astronomy/day","price_usd":"0.02","tier":"call","title":"Astronomical summary of the day for a place","summary":"One call for a day at a place: sunrise, sunset, twilight, day length, golden and blue hour; the Moon's phase, illumination, rise and set; the planets observable that night; the next lunations, planetary stations and eclipse.","description":"The daily sky block of a weather, calendar or outdoor app, in one request: the Sun (rise, solar noon, set, civil / nautical / astronomical dawn and dusk, day length, golden and blue hour), the Moon (phase, illuminated fraction, age, distance, moonrise, transit, moonset, the next principal phase), the planets observable that night (window, best time, altitude, azimuth, magnitude; brightest first), the lunations and planetary stations of the next 7 days, and the next solar or lunar eclipse anywhere on Earth. Local times with offset, UTC and unix timestamps; each block follows the conventions of its own route.","mcp_tool":"day_summary","input_schema":{"type":"object","required":["date","latitude","longitude"],"properties":{"date":{"type":"string","description":"The local calendar day at the place, YYYY-MM-DD (1800-01-02..2199-12-30)."},"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Decimal degrees, north positive."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Decimal degrees, east positive."},"elevation_m":{"type":"number","minimum":-500,"maximum":9000,"default":0,"description":"Height above the WGS84 ellipsoid, metres (no terrain or horizon dip is modelled)."},"timezone":{"type":"string","description":"IANA zone for local times, e.g. 'Europe/Paris'. Optional: resolved from the coordinates (with its historical DST rules)."}}},"example_request":{"date":"2026-08-10","latitude":48.8566,"longitude":2.3522}},{"id":"astronomy/seasons","method":"POST","url":"https://astro-agent.dev/v1/astronomy/seasons","price_usd":"0.01","tier":"call","title":"Equinoxes, solstices, perihelion and day length over a year","summary":"The year's equinoxes and solstices and Earth's perihelion and aphelion to the second; optionally the Sun day by day: sunrise, sunset, day length, solar noon, declination and equation of time.","description":"For calendars, almanacs, education and solar apps: the March and September equinoxes and the June and December solstices (UTC, and local with a place), Earth's perihelion and aphelion with their distances, and with daily=true a row per day: solar noon, the Sun's apparent declination, the equation of time and, for a place, sunrise, sunset and day length, plus the longest and shortest days. Matches the published 2026 times to the minute.","mcp_tool":"seasons","input_schema":{"type":"object","required":["year"],"properties":{"year":{"type":"integer","minimum":1800,"maximum":2199,"description":"Calendar year."},"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Optional: local times, and with daily=true the day-by-day sunrise, sunset and day length at this place."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Optional, with latitude."},"elevation_m":{"type":"number","minimum":-500,"maximum":9000,"default":0,"description":"Height above the WGS84 ellipsoid, metres (no terrain or horizon dip is modelled)."},"timezone":{"type":"string","description":"IANA zone for local times, e.g. 'Europe/Paris'. Optional: resolved from the coordinates (with its historical DST rules)."},"daily":{"type":"boolean","default":false,"description":"Add one row per day: solar noon, the Sun's declination, the equation of time and, with a place, sunrise, sunset and day length."}}},"example_request":{"year":2026,"latitude":48.8566,"longitude":2.3522}},{"id":"astronomy/time","method":"POST","url":"https://astro-agent.dev/v1/astronomy/time","price_usd":"0.01","tier":"call","title":"Julian day, sidereal time, Delta T and time scales","summary":"One moment in every astronomical time scale: UTC, unix time, Julian day (UTC, UT1, TT, TDB), MJD, Julian centuries, Delta T, TAI-UTC, UT1-UTC, Greenwich and local mean and apparent sidereal time.","description":"For telescope control, data reduction and education: the Julian day in UTC, UT1, TT and TDB, the modified Julian day, Julian centuries since J2000 (TT), Delta T (TT - UT1), TAI - UTC and UT1 - UTC, Greenwich mean and apparent sidereal time and, with a longitude, the local ones; plus day of year and ISO week.","mcp_tool":"time_scales","input_schema":{"type":"object","required":["datetime"],"properties":{"datetime":{"type":"string","description":"The moment: UTC ('2026-06-21T12:00:00Z'), with an explicit offset, or local civil time with latitude/longitude."},"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Optional: resolve a local time, and give the local sidereal time."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Optional, with latitude."},"timezone":{"type":"string","description":"IANA zone for local times, e.g. 'Europe/Paris'. Optional: resolved from the coordinates (with its historical DST rules)."}}},"example_request":{"datetime":"2026-06-21T12:00:00Z","latitude":48.8566,"longitude":2.3522}},{"id":"astronomy/convert","method":"POST","url":"https://astro-agent.dev/v1/astronomy/convert","price_usd":"0.01","tier":"call","title":"Coordinate conversion between sky frames","summary":"Convert one direction on the sky between equatorial (J2000 and of date), ecliptic (J2000 and of date), galactic and, with a moment and a place, horizontal coordinates.","description":"For catalogues, planetarium and telescope software: give a direction in one frame and get it in all the others: equatorial J2000 (ICRS) and of date, ecliptic J2000 and of date, galactic, and horizontal (altitude, azimuth) when a datetime and a place are given. Geometric frame rotations of a direction (no aberration or refraction is added: use astronomy/altaz for where a body appears).","mcp_tool":"convert_coordinates","input_schema":{"type":"object","required":["frame","coordinates"],"properties":{"frame":{"type":"string","enum":["equatorial_j2000","equatorial_of_date","ecliptic_j2000","ecliptic_of_date","galactic","horizontal"],"description":"The frame of the input coordinates."},"coordinates":{"type":"object","properties":{"ra_hours":{"type":"number","description":"Equatorial frames: right ascension, hours 0-24."},"dec":{"type":"number","description":"Equatorial frames: declination, degrees."},"longitude":{"type":"number","description":"Ecliptic and galactic frames: longitude, degrees 0-360."},"latitude":{"type":"number","description":"Ecliptic and galactic frames: latitude, degrees."},"altitude":{"type":"number","description":"Horizontal frame: altitude, degrees."},"azimuth":{"type":"number","description":"Horizontal frame: azimuth from north, degrees 0-360."}},"description":"The direction, with the two fields of its frame."},"datetime":{"type":"string","description":"Needed for the of-date and horizontal frames (UTC, offset, or local time with latitude/longitude)."},"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Observer latitude, for the horizontal frame."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Observer longitude, for the horizontal frame."}}},"example_request":{"frame":"equatorial_j2000","coordinates":{"ra_hours":6.75247703,"dec":-16.71611582},"datetime":"2026-06-21T21:00:00Z","latitude":48.8566,"longitude":2.3522}},{"id":"astronomy/solunar","method":"POST","url":"https://astro-agent.dev/v1/astronomy/solunar","price_usd":"0.01","tier":"call","title":"Solunar periods: lunar transits, moonrise and moonset","summary":"The day's solunar periods for a place: major periods centred on the Moon's upper and lower meridian transits, minor periods centred on moonrise and moonset, with the Moon's phase.","description":"For fishing, hunting and outdoor apps that use the solunar timing convention: for one local day at a place, each major period (centred on the Moon's upper transit overhead and lower transit underfoot, 2 h by default) and minor period (centred on moonrise and moonset, 1 h by default) with its start, centre and end in local time, the Moon's altitude at its transits and its phase. The events are exact (astronomy/rise-set conventions); the windows are the convention's, adjustable. No rating attached.","mcp_tool":"solunar_periods","input_schema":{"type":"object","required":["date","latitude","longitude"],"properties":{"date":{"type":"string","description":"The local calendar day at the place, YYYY-MM-DD (1800-01-02..2199-12-30)."},"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Decimal degrees, north positive."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Decimal degrees, east positive."},"elevation_m":{"type":"number","minimum":-500,"maximum":9000,"default":0,"description":"Height above the WGS84 ellipsoid, metres (no terrain or horizon dip is modelled)."},"timezone":{"type":"string","description":"IANA zone for local times, e.g. 'Europe/Paris'. Optional: resolved from the coordinates (with its historical DST rules)."},"options":{"type":"object","properties":{"major_minutes":{"type":"integer","minimum":10,"maximum":360,"default":120,"description":"Length of a major period, centred on a lunar transit."},"minor_minutes":{"type":"integer","minimum":10,"maximum":360,"default":60,"description":"Length of a minor period, centred on moonrise or moonset."}},"description":"Window lengths."}}},"example_request":{"date":"2026-06-21","latitude":48.8566,"longitude":2.3522}},{"id":"western/sky","method":"POST","url":"https://astro-agent.dev/v1/western/sky","price_usd":"0.01","tier":"call","title":"Sky today: retrogrades, Moon phase, next events","summary":"The sky today (no location needed): planet positions, retrogrades and Moon phase now, plus the exact UTC times of the next ingresses, stations (Mercury retrograde), new and full moons and aspects.","description":"For agents and apps that follow the sky itself (calendars, daily content, alerts): positions with retrograde flags and the Moon's phase and illumination at a moment (default: now, UTC), then every sign ingress, retrograde/direct station, lunation (new, quarter, full) and major aspect between the planets over the next 1-90 days, each to the minute. Tropical or sidereal. Pass 'datetime' for a reproducible call.","mcp_tool":"sky_today","input_schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Local civil 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)."},"days":{"type":"integer","minimum":1,"maximum":90,"default":30,"description":"How many days ahead to list events. Example: 30."},"options":{"type":"object","description":"Optional zodiac settings.","properties":{"zodiac":{"type":"string","enum":["tropical","sidereal"],"default":"tropical","description":"'tropical' (default) or 'sidereal' (pair it with 'ayanamsa')."},"ayanamsa":{"type":"string","enum":["fagan_bradley","krishnamurti","lahiri","raman","true_chitrapaksha","yukteshwar"],"default":"lahiri","description":"Only with zodiac=sidereal."}}}},"required":[],"description":"All optional: the moment (default now, UTC). A local time needs a timezone or coordinates."},"example_request":{"datetime":"2026-10-01T00:00Z","days":30}},{"id":"western/aspects","method":"POST","url":"https://astro-agent.dev/v1/western/aspects","price_usd":"0.02","tier":"call","title":"Angles between bodies (aspects, parallels)","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. With options.declination: declinations and the parallels / contra-parallels too.","mcp_tool":"aspects","input_schema":{"type":"object","properties":{"datetime":{"type":"string","description":"Local civil 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, declination?, declination_speed?}}; when given, no ephemeris is used.","additionalProperties":true},"options":{"type":"object","description":"Optional calculation settings; every default is the common Western convention.","properties":{"house_system":{"type":"string","enum":["alcabitius","campanus","equal","koch","meridian","morinus","placidus","porphyry","regiomontanus","topocentric","whole_sign"],"default":"placidus","description":"House system for cusps and planet houses, e.g. 'placidus' (default) or 'whole_sign'."},"zodiac":{"type":"string","enum":["tropical","sidereal"],"default":"tropical","description":"'tropical' (Western, default) or 'sidereal' (pair it with 'ayanamsa')."},"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,"description":"Extra orb in degrees for aspects involving the Sun or the Moon. Example: 2."},"declination":{"type":"boolean","default":false,"description":"Also return the declinations and the parallels / contra-parallels between points."},"declination_orb":{"type":"number","minimum":0,"maximum":3,"default":1,"description":"Orb for parallels and contra-parallels, degrees. Example: 1."}}}},"required":[]},"example_request":{"longitudes":{"sun":54.4,"moon":297.4,"saturn":295.2,"venus":12.8}}}],"premium":[{"id":"astronomy/phenomena","method":"POST","url":"https://astro-agent.dev/v1/astronomy/phenomena","price_usd":"0.10","tier":"premium","title":"Planetary phenomena: oppositions, conjunctions, elongations","summary":"Every conjunction with the Sun (inferior / superior for Mercury and Venus), opposition, greatest elongation, conjunction between two planets, perihelion and aphelion between two dates, to the second.","description":"For almanacs, observing guides and astronomy newsletters: between two dates (up to 366 days, 1800-2199), each planet's conjunctions with the Sun, oppositions (with the Earth distance), greatest elongations east or west (with the angle), conjunctions between planets (with their angular separation and distance from the Sun), and perihelion and aphelion (heliocentric distance), each with a stable key. Matches the published 2026 dates.","mcp_tool":"planetary_phenomena","input_schema":{"type":"object","required":["start","end"],"properties":{"start":{"type":"string","description":"First UTC date, YYYY-MM-DD (1800-01-08..2199-12-30)."},"end":{"type":"string","description":"Last UTC date, YYYY-MM-DD, at most 366 days after start."},"bodies":{"type":"array","items":{"type":"string","enum":["mercury","venus","mars","jupiter","saturn","uranus","neptune"]},"description":"Planets to follow. Default: Mercury..Neptune."},"include":{"type":"array","items":{"type":"string","enum":["conjunction","opposition","greatest_elongation","planet_conjunction","perihelion","aphelion"]},"description":"Phenomena to return. Default: all."}}},"example_request":{"start":"2026-01-01","end":"2026-12-31","include":["opposition","greatest_elongation"]}},{"id":"astronomy/eclipse-local","method":"POST","url":"https://astro-agent.dev/v1/astronomy/eclipse-local","price_usd":"0.10","tier":"premium","title":"Local circumstances of solar and lunar eclipses","summary":"For a place: every solar and lunar eclipse between two dates with its local circumstances: whether and how it is seen, contact times, magnitude, obscuration, duration and the Sun's or Moon's altitude.","description":"For eclipse chasers, planetariums, schools and travel apps: solar eclipses from the place's own viewpoint (local type: total, annular, partial or none; contacts C1, C2, maximum, C3, C4 with the Sun's altitude and azimuth; magnitude, obscuration, duration, duration of totality or annularity) and lunar eclipses (penumbral and umbral contacts P1, U1, U2, maximum, U3, U4, P4 with the Moon's altitude, umbral and penumbral magnitude, durations), each marked visible when the body is above the horizon. Matches NASA's predictions to a few seconds (2024-04-08 at Dallas, 2025-03-14 lunar eclipse).","mcp_tool":"local_eclipse","input_schema":{"type":"object","required":["start","end","latitude","longitude"],"properties":{"start":{"type":"string","description":"First UTC date, YYYY-MM-DD (1800-01-08..2199-12-30)."},"end":{"type":"string","description":"Last UTC date, YYYY-MM-DD, at most 366 days after start."},"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Decimal degrees, north positive."},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Decimal degrees, east positive."},"elevation_m":{"type":"number","minimum":-500,"maximum":9000,"default":0,"description":"Height above the WGS84 ellipsoid, metres (no terrain or horizon dip is modelled)."},"timezone":{"type":"string","description":"IANA zone for local times, e.g. 'Europe/Paris'. Optional: resolved from the coordinates (with its historical DST rules)."},"kinds":{"type":"array","items":{"type":"string","enum":["solar","lunar"]},"description":"Eclipse kinds to return. Default: both."}}},"example_request":{"start":"2024-04-01","end":"2024-04-30","latitude":32.7767,"longitude":-96.797}},{"id":"western/natal","method":"POST","url":"https://astro-agent.dev/v1/western/natal","price_usd":"0.06","tier":"premium","title":"Sky configuration at a datetime & location (positional snapshot)","summary":"The sky at a date, time and place: planets in the ecliptic signs and in houses, ascendant, MC, 11 house systems, aspects, summary.","description":"A positional snapshot, 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 civil 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","description":"Optional calculation settings; every default is the common Western convention.","properties":{"house_system":{"type":"string","enum":["alcabitius","campanus","equal","koch","meridian","morinus","placidus","porphyry","regiomontanus","topocentric","whole_sign"],"default":"placidus","description":"House system for cusps and planet houses, e.g. 'placidus' (default) or 'whole_sign'."},"zodiac":{"type":"string","enum":["tropical","sidereal"],"default":"tropical","description":"'tropical' (Western, default) or 'sidereal' (pair it with 'ayanamsa')."},"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,"description":"Extra orb in degrees for aspects involving the Sun or the Moon. Example: 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":"Angles from the sky at a moment to a reference sky configuration, and exact hit times over up to a year.","description":"'transit': aspects from the sky at a moment to every point of the reference configuration (a datetime & location snapshot), with the reference house each transiting planet occupies. 'window': the exact UTC minute every transiting planet perfects each aspect to each reference 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 civil 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":"The reference datetime & location."},"transit":{"type":"object","properties":{"datetime":{"type":"string","description":"Local civil 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 reference place's zone."},"window":{"type":"object","description":"UTC dates YYYY-MM-DD, at most 366 days apart.","properties":{"start":{"type":"string","description":"First UTC date, YYYY-MM-DD. Example: '2026-10-01'."},"end":{"type":"string","description":"Last UTC date, YYYY-MM-DD, at most 366 days after start."},"include_moon":{"type":"boolean","description":"Also time the fast Moon transits; the window is then limited to 62 days."}}},"options":{"type":"object","description":"Optional calculation settings; every default is the common Western convention.","properties":{"house_system":{"type":"string","enum":["alcabitius","campanus","equal","koch","meridian","morinus","placidus","porphyry","regiomontanus","topocentric","whole_sign"],"default":"placidus","description":"House system for cusps and planet houses, e.g. 'placidus' (default) or 'whole_sign'."},"zodiac":{"type":"string","enum":["tropical","sidereal"],"default":"tropical","description":"'tropical' (Western, default) or 'sidereal' (pair it with 'ayanamsa')."},"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,"description":"Extra orb in degrees for aspects involving the Sun or the Moon. Example: 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":"Pairwise angular geometry between two sky states","summary":"Two sky configurations compared: cross-aspects, house overlays both ways, composite midpoints.","description":"Two sky configurations (datetime & location each) compared: every cross-aspect with orbs, where each configuration'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 civil 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":"First datetime & location."},"person_b":{"type":"object","properties":{"datetime":{"type":"string","description":"Local civil 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":"Second datetime & location."},"options":{"type":"object","description":"Optional calculation settings; every default is the common Western convention.","properties":{"house_system":{"type":"string","enum":["alcabitius","campanus","equal","koch","meridian","morinus","placidus","porphyry","regiomontanus","topocentric","whole_sign"],"default":"placidus","description":"House system for cusps and planet houses, e.g. 'placidus' (default) or 'whole_sign'."},"zodiac":{"type":"string","enum":["tropical","sidereal"],"default":"tropical","description":"'tropical' (Western, default) or 'sidereal' (pair it with 'ayanamsa')."},"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,"description":"Extra orb in degrees for aspects involving the Sun or the Moon. Example: 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":"finance/planetary-lines","method":"POST","url":"https://astro-agent.dev/v1/finance/planetary-lines","price_usd":"0.20","tier":"premium","title":"Planetary longitude series (geocentric + heliocentric)","summary":"Planetary longitudes (geocentric and heliocentric) at a moment or as a longitude time series at chosen intervals, with angular offsets and multi-body averages.","description":"Planetary longitude time series, data only: the longitude of each planet, seen from the Earth and from the Sun in one call, plus the angular offsets you ask for (+/-90, 120...), multi-body longitude averages (Jupiter..Pluto, Mercury..Pluto), speeds, retrograde flags and declinations. Snapshot ('datetime') or series ('start', 'end', 'interval' 1h..1w, up to 1000 samples, optionally unwrapped for plotting) in columns ready for pandas. With 'price_unit' (a scale factor) and 'price_range': the linear projection of each longitude onto a value scale, (degree + 360 k) x unit for every cycle k. Each result is hashed, so it can be cited and replayed.","mcp_tool":"planetary_lines","input_schema":{"type":"object","properties":{"datetime":{"type":"string","description":"A moment (snapshot): ISO 8601 with Z or an offset, e.g. '2024-01-01T00:00Z'. A local time needs 'timezone' or coordinates. Omit when giving start/end."},"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."},"start":{"type":"string","description":"Series: first UTC date, YYYY-MM-DD. Example: '2024-01-01'."},"end":{"type":"string","description":"Series: last UTC date, YYYY-MM-DD (at most 1000 samples)."},"interval":{"type":"string","enum":["1h","4h","12h","1d","1w"],"default":"1d","description":"Series sampling step, in candle-timeframe notation."},"time_utc":{"type":"string","default":"00:00","description":"Series: UTC time of day of the first sample, HH:MM."},"perspective":{"type":"string","enum":["geocentric","heliocentric","both"],"default":"both","description":"Geocentric, heliocentric, or both in one call (default)."},"bodies":{"type":"array","items":{"type":"string","enum":["sun","moon","mercury","venus","earth","mars","jupiter","saturn","uranus","neptune","pluto","mean_node","true_node"]},"description":"Bodies to draw. Default: Sun..Pluto (geo), Mercury..Pluto with Earth (helio)."},"aspects":{"description":"Aspect offsets added to every line (+angle and -angle). Default: the planet's own line only (conjunction).","oneOf":[{"type":"string","enum":["all"]},{"type":"array","items":{"type":"string","enum":["conjunction","opposition","trine","square","sextile","quincunx","semisextile","semisquare","sesquiquadrate","quintile","biquintile"]}}]},"averages":{"type":"array","items":{"type":"string","enum":["mean_of_5","circle_of_8"]},"description":"Multi-body longitude averages: mean_of_5 = (Jupiter+Saturn+Uranus+Neptune+Pluto)/5, circle_of_8 = (Mercury+Venus+Mars+Jupiter+Saturn+Uranus+Neptune+Pluto)/8, in each perspective."},"average_method":{"type":"string","enum":["arithmetic","circular"],"default":"arithmetic","description":"'arithmetic' mean of the 0-360 longitude values or 'circular' (vector) mean of the directions."},"price_unit":{"type":"number","exclusiveMinimum":0,"description":"Scale factor (value units per degree) for a linear projection of each longitude onto a value scale. With price_range: levels = (degree + 360 k) x price_unit, one per full 360-degree cycle k."},"price_range":{"type":"object","properties":{"min":{"type":"number","minimum":0,"description":"Lowest value on the scale to list."},"max":{"type":"number","description":"Highest value on the scale to list."}},"description":"The window of the value scale in which to list the projected levels, e.g. {min: 30000, max: 80000}."},"unwrap":{"type":"boolean","default":false,"description":"Series: continuous degrees (no 360 -> 0 jump), for plotting lines across a chart."},"include_declination":{"type":"boolean","default":false,"description":"Series: also a declination column per body."},"format":{"type":"string","enum":["columns","rows"],"default":"columns","description":"Series layout: 'columns' (pandas.DataFrame(result['series'])) or 'rows' (one object per sample)."},"options":{"type":"object","description":"Optional zodiac settings.","properties":{"zodiac":{"type":"string","enum":["tropical","sidereal"],"default":"tropical","description":"'tropical' (default) or 'sidereal' (pair it with 'ayanamsa')."},"ayanamsa":{"type":"string","enum":["fagan_bradley","krishnamurti","lahiri","raman","true_chitrapaksha","yukteshwar"],"default":"lahiri","description":"Only with zodiac=sidereal."}}}}},"example_request":{"datetime":"2024-01-01T00:00Z","aspects":["square","opposition"],"averages":["mean_of_5"],"price_unit":1000,"price_range":{"min":30000,"max":80000}}},{"id":"finance/events","method":"POST","url":"https://astro-agent.dev/v1/finance/events","price_usd":"0.25","tier":"premium","title":"Celestial event calendar (eclipses, stations, ingresses)","summary":"Eclipse and Mercury retrograde calendar: every solar and lunar eclipse, station (retrograde/direct), ingress, new and full moon, aspect, parallel and out-of-bounds between two dates (1800-2200), to the minute.","description":"A reproducible calendar of celestial events, historical or future: sign ingresses, retrograde/direct stations, new/full/quarter moons, solar eclipses (total, annular, hybrid, partial, with gamma) and lunar eclipses (with magnitudes), aspects between planets, declination parallels / contra-parallels and out-of-bounds crossings. Up to 366 days per call, geocentric or heliocentric, tropical or sidereal, Moon optional. Each event has exact_utc, a unix 'timestamp' to join on other time series and a stable 'key' for de-duplication across pages.","mcp_tool":"astro_event_calendar","input_schema":{"type":"object","required":["start","end"],"properties":{"start":{"type":"string","description":"First UTC date, YYYY-MM-DD, 1800..2199. Example: '2024-01-01'."},"end":{"type":"string","description":"Last UTC date, YYYY-MM-DD, at most 366 days after start (inclusive)."},"perspective":{"type":"string","enum":["geocentric","heliocentric"],"default":"geocentric","description":"Heliocentric gives ingresses and aspects only (no stations, lunations, eclipses)."},"include":{"type":"array","items":{"type":"string","enum":["ingress","station","lunation","eclipse","aspect","declination","out_of_bounds"]},"description":"Event types to return. Default: all that apply to the perspective."},"bodies":{"type":"array","items":{"type":"string","enum":["sun","mercury","venus","earth","mars","jupiter","saturn","uranus","neptune","pluto"]},"description":"Planets searched. Default: Sun..Pluto (geo), Mercury..Pluto with Earth (helio)."},"include_moon":{"type":"boolean","default":false,"description":"Also the Moon's ingresses, aspects, parallels and out-of-bounds (geocentric; many events)."},"aspects":{"description":"Aspects timed between planets. 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"]}}]},"options":{"type":"object","description":"Optional zodiac settings.","properties":{"zodiac":{"type":"string","enum":["tropical","sidereal"],"default":"tropical","description":"'tropical' (default) or 'sidereal' (pair it with 'ayanamsa')."},"ayanamsa":{"type":"string","enum":["fagan_bradley","krishnamurti","lahiri","raman","true_chitrapaksha","yukteshwar"],"default":"lahiri","description":"Only with zodiac=sidereal."}}}}},"example_request":{"start":"2024-01-01","end":"2024-12-31","include":["station","eclipse","ingress"],"bodies":["mercury","jupiter","saturn"]}},{"id":"finance/analogues","method":"POST","url":"https://astro-agent.dev/v1/finance/analogues","price_usd":"0.25","tier":"premium","title":"Sky similarity search (matching skies)","summary":"Find the past or future dates whose planetary positions best match a reference sky, ranked by a stated angular distance.","description":"Matching skies by geometry, data only: give a reference (a UTC moment, 'now', your own positions, or a the sky at a local date-time and place — data only) and get the dates in a range (past, future or both, 1800-2200, 1h..1w grid) whose sky is closest, ranked by a weighted mean of circular longitude differences (geocentric and/or heliocentric), pair angles (aspects), declination differences and retrograde-flag mismatches, in degrees. Each match gives its date, unix timestamp, score, every body's exact longitude and retrograde flag and each feature's distance, in columns ready for pandas. The metric formula is in the response; the same request returns the same bytes and hash, future dates included. Up to 100 matches and 36,600 candidate dates per call; no market data. Data for your own analysis — never a signal or forecast.","mcp_tool":"sky_analogues","input_schema":{"type":"object","properties":{"reference":{"description":"The sky to match: 'now' (default; the current UTC hour or day, echoed in result.reference.date_utc), a UTC moment ('2026-10-29T00:00Z' or 'YYYY-MM-DD'), {datetime: ...}, your own configuration {values: {feature id: value}} (add 'datetime' to anchor direction and range at a time), or a local date-time and place {birth: {datetime: local '1990-05-15T14:30', latitude, longitude, timezone?}} to compare the sky at that moment and place to past/future dates. That local moment is resolved as in /v1/western/positions (time zone from the coordinates or 'timezone'); a date alone means 12:00 local with a TIME_UNKNOWN warning (the Moon is then approximate, Jupiter..Pluto stay reliable). No houses or ascendant. meta.reference_resolution gives the equivalent {values, datetime} request, which returns the same result and result_sha256. Feature ids: '<geo|helio>.<body>' (longitude, 0-360), '<geo|helio>.<a>-<b>:angle' (separation, 0-180), '<geo|helio>.<body>:declination' (degrees) and 'geo.<body>:retrograde' (true/false).","oneOf":[{"type":"string"},{"type":"object","properties":{"datetime":{"type":"string"}},"required":["datetime"]},{"type":"object","properties":{"values":{"type":"object","additionalProperties":{"type":["number","boolean"]}},"datetime":{"type":"string"}},"required":["values"]},{"type":"object","properties":{"birth":{"type":"object","properties":{"datetime":{"type":"string","description":"Local civil date-time, e.g. '1990-05-15T14:30', or the date alone if the time is unknown."},"latitude":{"type":"number","minimum":-90,"maximum":90},"longitude":{"type":"number","minimum":-180,"maximum":180},"timezone":{"type":"string","description":"IANA zone, e.g. 'Europe/Paris'; optional with latitude/longitude or an offset in datetime."}},"required":["datetime"]}},"required":["birth"]}],"examples":["2026-10-29T00:00Z",{"birth":{"datetime":"1990-05-15T14:30","latitude":48.8566,"longitude":2.3522}}]},"direction":{"type":"string","enum":["past","future","both"],"default":"both","description":"Search before the reference (with a local date-time and place: before that moment), after it, or both (default; the only choice with reference.values without 'datetime')."},"range":{"type":"object","properties":{"start":{"type":"string","description":"First UTC date, YYYY-MM-DD, 1800..2199."},"end":{"type":"string","description":"Last UTC date, YYYY-MM-DD (inclusive)."}},"description":"Candidate dates. Default (a reference with a time): the longest window the caps allow, up to 100 years in the chosen direction (50 on each side for 'both')."},"resolution":{"type":"string","enum":["1h","4h","12h","1d","1w"],"default":"1d","description":"Step of the candidate grid. At most 36,600 candidate dates per call, and at most 660,000 dates x ephemeris series (one per body and perspective, plus one per retrograde-flagged body)."},"perspective":{"type":"string","enum":["geocentric","heliocentric","both"],"default":"geocentric","description":"Positions seen from the Earth, from the Sun, or both."},"bodies":{"type":"array","items":{"type":"string","enum":["sun","moon","mercury","venus","earth","mars","jupiter","saturn","uranus","neptune","pluto"]},"description":"Bodies to match. Default: Sun..Pluto (geo), Mercury..Pluto with Earth (helio)."},"features":{"type":"array","items":{"type":"string","enum":["longitude","aspects","declination","retrograde"]},"description":"What to compare: 'longitude' (default), 'aspects' (the angle between every pair of bodies), 'declination', 'retrograde' (geocentric flags, Mercury..Pluto)."},"weights":{"type":"object","additionalProperties":{"type":"number","minimum":0},"description":"Optional {feature id: weight}, default 1 each, e.g. {'geo.jupiter': 2}. Feature ids: '<geo|helio>.<body>' (longitude, 0-360), '<geo|helio>.<a>-<b>:angle' (separation, 0-180), '<geo|helio>.<body>:declination' (degrees) and 'geo.<body>:retrograde' (true/false)."},"top_n":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"How many matches."},"max_distance":{"type":"number","minimum":0,"maximum":180,"description":"Optional: only matches whose score (degrees) is at most this."},"min_separation_days":{"type":"number","minimum":0,"default":30,"description":"Minimum gap between two matches and between a match and the reference time, so one passage gives one match. Raise it (e.g. 3650) to skip the current cycle of slow planets."},"require_same_retrograde":{"type":"boolean","default":false,"description":"Keep only dates whose retrograde flags equal the reference's."},"format":{"type":"string","enum":["columns","rows"],"default":"columns","description":"'columns' (pandas.DataFrame(result['matches'])) or 'rows' (one object per match)."},"options":{"type":"object","description":"Optional zodiac settings.","properties":{"zodiac":{"type":"string","enum":["tropical","sidereal"],"default":"tropical","description":"'tropical' (default) or 'sidereal' (pair it with 'ayanamsa')."},"ayanamsa":{"type":"string","enum":["fagan_bradley","krishnamurti","lahiri","raman","true_chitrapaksha","yukteshwar"],"default":"lahiri","description":"Only with zodiac=sidereal."}}}}},"example_request":{"reference":"2026-10-29T00:00Z","direction":"past","bodies":["jupiter","saturn","uranus","neptune","pluto"],"min_separation_days":3650,"top_n":5}}],"formats":{"csv":"add ?format=csv to a tabular route for its table as CSV (gzip with Accept-Encoding: gzip); same price and quota; X-Result-SHA256 is the hash of the JSON result","bulk_export":"POST /v1/export {route, start, end, params}: a long range as one gzip CSV, Pro and Scale plans; N chunks count as N calls; every row carries its chunk's result_sha256; X-Export-Next-Start to continue. Docs: /docs/export"},"free_endpoints":{"GET /v1/catalog":"this document","GET /v1/health":"liveness + versions","POST /v1/verify":"recompute a result_sha256 from a response you hold","GET /v1/benchmark":"accuracy vs NASA/JPL Horizons, per body"},"accuracy":{"reference":"NASA/JPL Horizons API, ephemeris DE441, geocentre 500@399, TT instants","instants":1240,"range_tt":["1800-01-03","2199-12-29"],"max_arcsec_icrf_position":0.024372424115676666,"max_arcsec_longitude_as_served_1962_2026":0.06150114662659689,"max_arcsec_longitude_as_served_1800_2200":1.1861265651077701,"details":"https://astro-agent.dev/v1/benchmark","method":"https://astro-agent.dev/benchmark.md"},"support":{"email":"aidatatools@proton.me","page":"https://astro-agent.dev/support","privacy":"https://astro-agent.dev/privacy","terms":"https://astro-agent.dev/terms"},"sdk":{"python":{"name":"astro-agents","import":"astro_agents","language":"python","official":true,"install":"pip install \"astro-agents @ git+https://github.com/aidatatools-dev/astro-agents-clients#subdirectory=python\"","install_from_source":"pip install \"astro-agents @ git+https://github.com/aidatatools-dev/astro-agents-clients#subdirectory=python\"","docs":"https://github.com/aidatatools-dev/astro-agents-clients/tree/main/python#readme","examples":"https://github.com/aidatatools-dev/astro-agents-clients/tree/main/python/examples","summary":"pandas-first: planetary_lines(), events() and analogues() return DataFrames (long ranges paged for you), positions/aspects/parallels, every chart route, prepaid credits via ASTRO_CREDITS_TOKEN, offline result_sha256 verification."}},"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"},"credits":{"what":"Prepaid credits: pay once with x402 or MPP, then spend call by call with a token, no signature per call. 1 credit = $1 (USDC), credited in integer micro-USD. Credits never expire and pay for every paid route. Pay-per-call x402/MPP and the free call stay as they are.","packs":[{"id":"probe","name":"Probe","price_usd":"10.00","credits":10,"credits_usd":"10.00","bonus_pct":0,"value":"10 credits = 50 planetary-lines calls, or 40 event-calendar years, or 1000 planetary-position calls"},{"id":"backtest","name":"Survey","price_usd":"50.00","credits":60,"credits_usd":"60.00","bonus_pct":20,"value":"60 credits = 300 planetary-lines calls, or 240 event-calendar years, or 6000 planetary-position calls"},{"id":"quant","name":"Observatory","price_usd":"200.00","credits":260,"credits_usd":"260.00","bonus_pct":30,"value":"260 credits = 1300 planetary-lines calls, or 1040 event-calendar years, or 26000 planetary-position calls"},{"id":"autopilot","name":"Autopilot","price_usd":"1000.00","credits":1400,"credits_usd":"1400.00","bonus_pct":40,"value":"1400 credits = 7000 planetary-lines calls, or 5600 event-calendar years, or 140000 planetary-position calls"}],"buy":"POST https://astro-agent.dev/v1/credits/topup {\"pack\": \"probe\"} -> 402 with the x402 and MPP offers for the pack's price; pay and retry. The answer carries the token, shown once. Send the token in X-Credits-Token to top up the same balance again.","spend":"send 'X-Credits-Token: <token>' on any paid POST /v1/<route>; the route's price is deducted","balance":"GET https://astro-agent.dev/v1/credits/balance with X-Credits-Token","rotate":"POST https://astro-agent.dev/v1/credits/rotate with X-Credits-Token: returns a new token, the old one stops working","rules":["the bonus is applied by the server from the amount actually settled","each payment credits once","a balance never goes negative","the token is a bearer secret shown once and stored only as a hash; if it is lost, a new one can be issued to the owner of the paying wallet (aidatatools@proton.me)","credits do not reset or extend the free call","one account holds at most $10000"],"docs":"https://github.com/aidatatools-dev/astro-agents-clients/blob/main/docs/CREDITS.md"}}