Can I use Celestial as a CLI?

Yes. KosmoKrator exposes a Celestial CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Celestial through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Celestial tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Celestial credentials stored?

Celestial credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Celestial MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

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.

9 functions 9 read 0 write No credentials auth

Submit Celestial feedback View package source

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.

Machine-Readable Metadata

integration_slug: celestial
route_slug: celestial
package: celestial
auth_strategy: none No credentials
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true
supports_multi_account: false

Quick Links

Lua APIAgent-facing namespace and function reference. Celestial CLIHeadless setup and direct function calls. Celestial MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.

Celestial MCP Client Matrix

Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for Celestial.

Celestial CLI Matrix

Use these pages for direct Celestial CLI workflows in scripts, CI, cron, and agent wrappers.

CI Celestial CLI for CI. Cron Jobs Celestial CLI for cron jobs. Shell Scripts Celestial CLI for shell scripts. Headless Automation Celestial CLI for headless automation. Coding Agents Celestial CLI for coding agents.

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.