data
Celestial MCP, CLI, and Lua Integration for AI Agents
Celestial integration docs for AI agents: MCP gateway setup, Celestial CLI commands, Lua API reference, credentials, and function schemas.Celestial for agents
No credentials required; available in web and CLI hosts when runtime dependencies are installed.
Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.
Agent Surfaces
Machine-Readable Metadata
Function Catalog
| Function | Type | Parameters | Description |
|---|---|---|---|
celestial.celestial_moon_phase | Read read | 2 | Get current moon phase, illumination percentage, age, zodiac sign, and dates of next new/full moon. |
celestial.celestial_sun_info | Read read | 4 | Get sunrise/sunset times, solar altitude/azimuth, twilight phase, day length, and zodiac position for a location. |
celestial.celestial_moon_info | Read read | 4 | Get moon position, illumination, and visibility from a specific location. |
celestial.celestial_planet_position | Read read | 5 | Get planet altitude/azimuth, zodiac position, and rise/set times. Set planet to "all" for an overview of all planets. |
celestial.celestial_solar_eclipse | Read read | 3 | Get solar eclipse data for a specific date and location — eclipse type, obscuration, contacts, and magnitude. |
celestial.celestial_lunar_eclipse | Read read | 1 | Get lunar eclipse data for a specific date — eclipse type, magnitude, gamma, contact times (P1-P4, U1-U4), and semi-durations. |
celestial.celestial_night_sky | Read read | 3 | Get what's visible in the night sky right now: sun/moon/planet positions, darkness level, and stargazing quality for a location. |
celestial.celestial_zodiac_report | Read read | 1 | Get all celestial bodies mapped to zodiac signs with alignments for a given date. |
celestial.celestial_time_info | Read read | 1 | Get astronomical time data — Julian Day, sidereal time (GMST/GAST), and equation of time. |