data
Celestial MCP Integration for LangChain
Connect Celestial to LangChain through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.
Connect Celestial to LangChain
Bridge LangChain agents to local KosmoKrator integration tools through MCP or headless CLI calls.
Use the MCP gateway when the agent should discover tools, or wrap kosmo integrations:call for fixed chains. The gateway is local, scoped to this integration, and starts with
--write=deny so LangChain can inspect read-capable tools without receiving write access by default.
Celestial MCP Config for LangChain
Keep the gateway scoped to the integration and operation class needed by the chain.
{
"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
Expose only Celestial instead of a broad multi-service tool list.
Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.
Start read-only, then opt into ask or allow for trusted workspaces.
Celestial Tools Visible to LangChain
LangChain sees stable MCP tool names generated from the Celestial integration catalog.
| MCP tool | Source function | Type | Description |
|---|---|---|---|
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. |