Documentation

Browse REST endpoints by commercial package and module, copy curl examples, then open the full OpenAPI explorer for parameters and types. MCP tools mirror the same modules — see the connect guide.

OpenAPI 5.16.0 · MCP server 0.28.4 · 48 MCP tools · openapi.yaml · llms.txt

Recent API changes
5.16.0 — L1/L2 wire accuracy (documentation)
Stricter UTC datetime validation (0001–9999 envelope); tropical ascendant fix at high latitude; published star altitude and aboveHorizon below the horizon (#27); IAU iauConstellation on the bright-star catalog; highlight observing windows use geometric twilight (−6°/−12°/−18°, ~3 min shift vs earlier apparent-sun sampling). Rise/set search times unchanged.
v4.12 — Operation registry catalog
Sidebar organized by commercial package → module. Endpoint browser with curl examples from the registry.
v3.4.1 — Per-module versions
Each module exposes moduleVersion, packageVersion, and optional constantsVersion. MCP tools/list reflects your plan.
v3.1 — Capabilities caller context
GET /v1/capabilities and MCP get_capabilities: optional Bearer API key adds caller.tier and caller.modules.
Modules & versions

Default free tier: Ephemeris + Sky. Live entitlements: GET /v1/capabilities.

Module Package moduleVersion Free tier
ephemeris Ephemeris @astronomycore/engine 3.19.0 ✓
sky Sky @astronomycore/sky 2.4.0 ✓
westernAstrology Western Astrology @astronomycore/western-astrology 5.3.0 —
astrocartography Astrocartography @astronomycore/astrocartography 2.4.0 —
numerology Numerology @astronomycore/numerology 3.1.1 —
gematria Gematria @astronomycore/gematria 3.1.1 —
earthGrid Earth Grid @astronomycore/earth-grid 1.2.0 —
locations Locations @astronomycore/locations 2.2.2 ✓
galacticTime Galactic Time @astronomycore/galactic-time 2.0.2 —
chineseAstrology Chinese Astrology @astronomycore/eastern-astrology 2.2.0 —
vedicAstrology Vedic Astrology @astronomycore/vedic-astrology 2.2.0 —

Need full parameter schemas?

Interactive OpenAPI explorer with types, enums, and try-it-out.

Open OpenAPI explorer →