Returns Tamil-specific Panchanga for a date and location: all four inauspicious periods (Rahu Kalam, Yamagandam, Kuligai, Emagandam), Nalla Neram (auspicious daytime windows between inauspicious periods), and the Tamil solar month name based on the Sun's sidereal sign at sunrise.
SECTION: WHAT THIS TOOL COVERS
Rahu Kalam, Yamagandam (Yamakanda), Kuligai (Gulika), and Emagandam divide the daytime into eight equal parts from sunrise to sunset following classical Tamil almanac weekday tables. Nalla Neram is every gap between the four inauspicious periods — the auspicious windows left for commencing ventures. Tamil solar month follows the Sun's Lahiri sidereal sign at local sunrise (Chithirai when Sun is in Mesha, through Panguni when Sun is in Meena). This tool does not return Vedic Panchanga limbs (asterwise_get_panchanga) or the standard Rahu/Gulika/Yamaganda breakdown used in North Indian tradition (asterwise_get_rahu_kaal).
SECTION: WORKFLOW
BEFORE: None — standalone.
AFTER: asterwise_get_panchanga — for full Vedic five-limb panchanga of the same date.
SECTION: INPUT CONTRACT
date: YYYY-MM-DD format.
Either location (city name) OR latitude + longitude + timezone must be provided.
SECTION: OUTPUT CONTRACT
data.date (string — YYYY-MM-DD)
data.sunrise (string — HH:MM local time)
data.sunset (string — HH:MM local time)
data.tamil_month (string — Tamil solar month name, e.g. 'Chithirai', 'Vaikasi')
data.rahu_kalam: start, end (HH:MM), duration_minutes (int), is_active (bool)
data.yamagandam: start, end (HH:MM), duration_minutes (int), is_active (bool)
data.kuligai: start, end (HH:MM), duration_minutes (int), is_active (bool)
data.emagandam: start, end (HH:MM), duration_minutes (int), is_active (bool)
data.nalla_neram: list of { start (HH:MM), end (HH:MM) } objects
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 — sunrise computation + lookup tables, no full natal chart.
SECTION: ERROR CONTRACT
INVALID_PARAMS (local): None — all validation upstream.
INTERNAL_ERROR: Any upstream API failure or timeout → MCP INTERNAL_ERROR
Edge cases:
— Polar latitudes where sunrise cannot be computed → MCP INTERNAL_ERROR.
— Emagandam part table: Sun=5, Mon=4, Tue=3, Wed=2, Thu=8, Fri=1, Sat=7.
SECTION: DO NOT CONFUSE WITH
asterwise_get_rahu_kaal — North Indian Rahu/Gulika/Yamaganda only; no Emagandam, Nalla Neram, or Tamil month.
asterwise_get_panchanga — five Vedic limbs (tithi, vara, nakshatra, yoga, karana); not Tamil-specific periods.