Hora
asterwise_get_hora
Builds the twenty-four planetary Horas between successive sunrises for a location date and tags each hour with ruler, quality text, and whether it is current.
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
Classical hora muhurta: sequence restarts from the weekday lord, spans day and night until next sunrise, and exposes start/end in local time. It is not a natal divisional chart, not Choghadiya (asterwise_get_choghadiya), and not full Panchanga (asterwise_get_panchanga).
Workflow
BEFORE: None — this tool is standalone.
AFTER: asterwise_get_choghadiya — alternative same-day slot system.
Input
LocationInput date/coordinate rules apply locally (YYYY-MM-DD, bounded lat/lon).
Output contract
data.date (string)
data.sunrise (string — HH:MM)
data.next_sunrise (string — HH:MM)
data.horas[] — twenty-four objects:
hora (int — 1–24)
ruling_planet (string)
start (string — HH:MM local)
end (string — HH:MM local)
quality (string — suitable activities description)
is_current (bool)
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 — upstream rejection surfaces as MCP INTERNAL_ERROR at the tool layer.
INTERNAL_ERROR:
— Any upstream API failure or timeout → MCP INTERNAL_ERROR
Edge cases:
— Horas bridge midnight until the next sunrise reference.
Do not confuse with
asterwise_get_choghadiya — sixteen Choghadiya segments, not twenty-four Horas.
asterwise_get_natal_chart — natal analysis, not hourly muhurta tables.
Connect
Remote MCP endpoint: https://mcp.asterwise.com/mcp. Authenticate with Authorization: Bearer <API key> or OAuth. See the MCP setup guide.