KosmoKrator

data

Celestial MCP Integration for LangGraph

Connect Celestial to LangGraph through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

9 functions 9 read 0 write No credentials auth

Connect Celestial to LangGraph

Run KosmoKrator integration calls from LangGraph nodes while preserving local credentials and permissions.

Use a graph node that calls the KosmoKrator CLI for deterministic steps or an MCP client for dynamic tool selection. The gateway is local, scoped to this integration, and starts with --write=deny so LangGraph can inspect read-capable tools without receiving write access by default.

Celestial MCP Config for LangGraph

Headless CLI calls fit repeatable graph edges; MCP fits exploratory agent nodes.

{
  "mcpServers": {
    "kosmokrator-celestial": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=celestial",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=celestial --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Celestial instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Celestial Tools Visible to LangGraph

LangGraph sees stable MCP tool names generated from the Celestial integration catalog.

MCP toolSource functionTypeDescription
integration__celestial__celestial_moon_phase celestial.celestial_moon_phase Read Get current moon phase, illumination percentage, age, zodiac sign, and dates of next new/full moon.
integration__celestial__celestial_sun_info celestial.celestial_sun_info Read Get sunrise/sunset times, solar altitude/azimuth, twilight phase, day length, and zodiac position for a location.
integration__celestial__celestial_moon_info celestial.celestial_moon_info Read Get moon position, illumination, and visibility from a specific location.
integration__celestial__celestial_planet_position celestial.celestial_planet_position Read Get planet altitude/azimuth, zodiac position, and rise/set times. Set planet to "all" for an overview of all planets.
integration__celestial__celestial_solar_eclipse celestial.celestial_solar_eclipse Read Get solar eclipse data for a specific date and location — eclipse type, obscuration, contacts, and magnitude.
integration__celestial__celestial_lunar_eclipse celestial.celestial_lunar_eclipse Read Get lunar eclipse data for a specific date — eclipse type, magnitude, gamma, contact times (P1-P4, U1-U4), and semi-durations.
integration__celestial__celestial_night_sky celestial.celestial_night_sky Read Get what's visible in the night sky right now: sun/moon/planet positions, darkness level, and stargazing quality for a location.
integration__celestial__celestial_zodiac_report celestial.celestial_zodiac_report Read Get all celestial bodies mapped to zodiac signs with alignments for a given date.
integration__celestial__celestial_time_info celestial.celestial_time_info Read Get astronomical time data — Julian Day, sidereal time (GMST/GAST), and equation of time.

Related Celestial Pages