Documentation

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

OpenAPI 4.11.0 · MCP server 0.17.0 · 41 MCP tools · openapi.yaml · llms.txt

Recent API changes
v3.1 — Capabilities caller context
GET /v1/capabilities and MCP get_capabilities: optional Bearer API key adds caller.tier and caller.modules.
v3.4.1 — Per-module versions
Each module exposes moduleVersion, packageVersion, and optional constantsVersion. MCP tools/list reflects your plan.
v3.0 — Ephemeris module
Module id ephemeris (@astronomycore/engine). Removed /v1/catalog/fixed-stars — use /v1/catalog/stars.
Modules & versions

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

Module Package moduleVersion Free tier
ephemeris Ephemeris @astronomycore/engine 3.5.0
sky Sky @astronomycore/sky 2.1.0
westernAstrology Western Astrology @astronomycore/western-astrology 5.0.0
astrocartography Astrocartography @astronomycore/astrocartography 2.2.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.0.0
galacticTime Galactic Time @astronomycore/galactic-time 2.0.1
chineseAstrology Chinese Astrology @astronomycore/eastern-astrology 2.1.2
vedicAstrology Vedic Astrology @astronomycore/vedic-astrology 2.0.0

Discovery

Need full parameter schemas?

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

Open OpenAPI explorer →