Computes KP ruling planets for the instantaneous chart at lat/lon with no birth data and returns day lord, Moon/Ascendant lord chains, and a deduplicated ruling_planets list.
SECTION: WHAT THIS TOOL COVERS
Current-moment KP snapshot: target_utc, day_lord, Moon and Ascendant tuples with sign/nakshatra/sub lords, ruling_planets[] unique names. Not natal positions (asterwise_get_kp_chart) and not house significators (asterwise_get_kp_significators). Coordinate sanity is upstream — not locally validated floats beyond whatever FastMCP passes.
SECTION: WORKFLOW
BEFORE: None — this tool is standalone.
AFTER: asterwise_get_kp_chart — if natal confirmation is needed afterwards.
SECTION: INPUT CONTRACT
lat and lon only; no date parameter — "now" is implicit on the server clock.
SECTION: OUTPUT CONTRACT
data.ayanamsa (string — 'kp')
data.target_utc (string — ISO UTC)
data.day_lord (string — planet name)
data.moon:
longitude (float)
rashi (string)
sign_lord (string)
nakshatra_lord (string)
sub_lord (string)
data.ascendant — same fields as data.moon
data.ruling_planets[] (string array — unique names, deduplicated)
SECTION: RESPONSE FORMAT
response_format=json serialises the complete response as indented JSON — use this for programmatic parsing, typed clients, and downstream tool chaining. response_format=markdown renders the same data as a human-readable report. Both modes return identical underlying data — no fields are added, removed, or filtered by either mode.
SECTION: COMPUTE CLASS
FAST_LOOKUP
SECTION: ERROR CONTRACT
INVALID_PARAMS (local — caught before upstream call):
None — lat/lon not range-checked locally.
INVALID_PARAMS (upstream):
— None — coordinate errors surface as MCP INTERNAL_ERROR at the tool layer.
INTERNAL_ERROR:
— Any upstream API failure or timeout → MCP INTERNAL_ERROR
Edge cases:
— Represents instantaneous sky — differs from natal stored charts.
SECTION: DO NOT CONFUSE WITH
asterwise_get_kp_chart — needs BirthData and returns full natal KP cusps.
asterwise_get_prashna_chart — horary keyword workflow, not ruling-planet snapshot.
Connector