Ayanamsha
asterwise_get_ayanamsha
Returns ayanamsha values for all four supported systems (Lahiri, Raman, KP, Tropical) for a given date.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
response_format | enum: markdown, json | no | Output format: 'markdown' (default) for a readable report, or 'json' for the raw structured payload. |
date | string/null | no | Date to compute the ayanamsha for, YYYY-MM-DD. Defaults to today. |
What it covers
Ayanamsha is the angular difference between the tropical and sidereal zodiacs due to the precession of the equinoxes (~50.3" per year). Returns each system's value in decimal degrees and DMS (degrees/minutes/seconds) format, with a description of each system's tradition. Lahiri (Chitrapaksha) is the Indian government standard. KP ayanamsha is used for Krishnamurti Paddhati calculations. Computed using Swiss Ephemeris DE431.
Workflow
BEFORE: None — standalone reference.
AFTER: None.
Input
date (optional): Date in YYYY-MM-DD format. Defaults to today.
Output contract
data.date (string)
data.ayanamsha{}: lahiri, raman, kp, tropical — each:
value_decimal (float), degrees (int), minutes (int), seconds (float),
dms (string e.g. '24° 13' 29.82"'), description (string)
data.note (string — recommendation to use Lahiri for Jyotish)
Compute class
FAST_LOOKUP
Errors
INTERNAL_ERROR: Any upstream API failure → MCP INTERNAL_ERROR
Do not confuse with
asterwise_get_natal_chart — applies Lahiri ayanamsha automatically to natal positions.
asterwise_get_western_natal — uses tropical zodiac (ayanamsha = 0).
Connect
Remote MCP endpoint: https://mcp.asterwise.com/mcp. Authenticate with Authorization: Bearer <API key> or OAuth. See the MCP setup guide.