Skip to main content

Tamil Panchanga

asterwise_get_tamil_panchanga

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.

Parameters

ParameterTypeRequiredDescription
datestringyes
response_formatenum: markdown, jsonno
locationstring/nullno
latitudenumber/nullno
longitudenumber/nullno
timezonestring/nullno

What it covers

Rahu Kalam, Yamagandam (Yamakanda), Kuligai (Gulika), and Emagandam divide the daytime into eight equal parts from sunrise to sunset following the Tamil weekday table. 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).

Workflow

BEFORE: None — standalone.
AFTER: asterwise_get_panchanga — for full Vedic five-limb panchanga of the same date.

Input

date: YYYY-MM-DD format.
Either location (city name) OR latitude + longitude + timezone must be provided.

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

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 — sunrise computation + lookup tables, no full natal chart.

Errors

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.

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.

Connect

Remote MCP endpoint: https://mcp.asterwise.com/mcp. Authenticate with Authorization: Bearer <API key> or OAuth. See the MCP setup guide.