Vedic Events (date range)
asterwise_get_vedic_events
One timeline of everything that happens to a chart over 1 to 31 days, each event with its exact time. Sidereal sign ingresses with the new sign's house from the natal Moon, stations, Moon nakshatra changes with Tarabala, Moon sign changes with Chandrabala, exact degree conjunctions with natal planets, eclipses with their contacts, Purnima and Amavasya (exact full and new Moon, with the tithi's start and end), and Vimshottari dasha changes (to the day). Each event carries the verdict its own rule gives, or null.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
birth | object | yes | Birth data for a single person. Required fields: date, lat, lon. Optional fields: time, person_name, timezone, ayanamsa. |
response_format | enum: markdown, json | no | Output format: 'markdown' (default) for a readable report, or 'json' for the raw structured payload. |
from_date | string/null | no | First day, YYYY-MM-DD. Defaults to today in the birth timezone. |
days | integer | no | Number of civil days, 1 to 31 (7 for a week, 30 for a month). |
target_timezone | string/null | no | IANA timezone for the days and local times. Defaults to the birth timezone. |
What it covers
The backbone for calendars and notifications: every dated event over a week or a month, in time order, UTC and local. No weighting.
Workflow
BEFORE: asterwise_get_natal_chart.
AFTER: asterwise_get_vedic_daily_factors — the full picture of one of the days.
Input
birth — BirthData. from_date (optional YYYY-MM-DD; defaults to today). days (1-31, default 7). target_timezone (optional IANA; defaults to the birth timezone).
Output contract
data.events[] — kind (ingress|station|moon_nakshatra|moon_sign|natal_conjunction|eclipse|moon_phase|dasha_change), planet, title, time_utc, time_local, time_precision (second|day), detail{}, verdict, verdict_rule, rule_source, significations[], depends_on_birth_time
data.kinds{}, data.range_start_utc, data.range_end_utc
Response format
response_format=json — structured data. response_format=markdown — readable report.
Compute class
MEDIUM_COMPUTE
Errors
INVALID_PARAMS (local): BirthData validation failures; days outside 1-31.
INVALID_PARAMS (upstream): a bad date or an unknown timezone → 422, surfaces as MCP INTERNAL_ERROR with the API message.
INTERNAL_ERROR: Any upstream API failure → MCP INTERNAL_ERROR
Do not confuse with
asterwise_get_transits — ingresses and stations for everyone, nothing personal.
asterwise_get_dasha — the whole dasha tree.
Connect
Remote MCP endpoint: https://mcp.asterwise.com/mcp. Authenticate with Authorization: Bearer <API key> or OAuth. See the MCP setup guide.