Rahu Kaal
asterwise_get_rahu_kaal
Computes Rahu Kaal, Gulika Kaal, and Yamaganda Kaal intervals from diurnal length at a location and marks whether Rahu Kaal is active now in local time.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
location | object | yes | For tools that need location but not birth time. Fields: date, lat, lon*, timezone, response_format |
What it covers
Returns sunrise/sunset anchors plus three inauspicious bands with start, end, duration_minutes (~93 for Rahu Kaal), and is_active on Rahu Kaal. Polar latitudes where sunrise/sunset cannot be solved fail upstream. It does not return Panchanga tithi/nakshatra (asterwise_get_panchanga) or scored muhurta search (asterwise_get_muhurta).
Workflow
BEFORE: None — this tool is standalone.
AFTER: asterwise_get_choghadiya — broader auspicious/inauspicious grid for the day.
Input
LocationInput validates date pattern and coordinates locally.
Output contract
data.date (string)
data.sunrise (string — HH:MM local)
data.sunset (string — HH:MM local)
data.rahu_kaal:
start (string — HH:MM local)
end (string — HH:MM local)
duration_minutes (int — typically 93)
is_active (bool)
data.gulika_kaal — same shape as data.rahu_kaal
data.yamaganda_kaal — same shape as data.rahu_kaal
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.
Compute class
FAST_LOOKUP
Errors
INVALID_PARAMS (local — caught before upstream call):
— Invalid LocationInput fields → MCP INVALID_PARAMS
INVALID_PARAMS (upstream):
— None — polar or astronomical failures surface as MCP INTERNAL_ERROR at the tool layer.
INTERNAL_ERROR:
— Any upstream API failure or timeout → MCP INTERNAL_ERROR
Edge cases:
— Polar latitudes may make sunrise/sunset undefined for the solver → MCP INTERNAL_ERROR.
Do not confuse with
asterwise_get_choghadiya — full day/night slot tables, not only the three kaal bands.
asterwise_get_panchanga — Panchanga limbs, not kaal timers.
Connect
Remote MCP endpoint: https://mcp.asterwise.com/mcp. Authenticate with Authorization: Bearer <API key> or OAuth. See the MCP setup guide.