Pitra Dosha
asterwise_get_pitra_dosha
Detects and analyses Pitru Dosha (Pitru Shapa — Ancestral Curse) using all five classical Pitru Dosha combinations.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
birth | object | yes | Birth data for a single person. Fields: date, time, lat, lon*, 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. |
What it covers
Standalone Pitru Dosha endpoint with deeper analysis than the pitru_dosha field inside asterwise_get_doshas. Returns: presence flag, severity (mild/moderate/severe), which of the 5 classical combinations triggered, Sun analysis (house, sign, debilitation, afflictions), 9th lord analysis (identity, house, debilitation, afflictions), all contributing factors, cancellation conditions (Jupiter protective), classical symptoms, and remedies.
Primary classical symptom for Purvajanma Shapa (karmic affliction): denial of progeny or difficulties with children. Afflicting planets: Saturn, Rahu, Mars, Ketu.
Workflow
BEFORE: None — birth data computes everything needed.
AFTER: asterwise_get_puja_suggestions — recommend remedial pujas for Sun/Mars.
Input
birth — BirthData (date, time, lat, lon, timezone).
Output contract
data.present (bool)
data.severity (string — 'mild', 'moderate', 'severe', or null)
data.severity_note (string or null)
data.combinations_triggered[] — each: combination (string), description (string), factors[] (string array), weight (int)
data.combinations_count (int)
data.sun_analysis{}: house (int), sign_index (int), debilitated (bool), afflictions[] (string array)
data.ninth_lord_analysis{}: planet (string), house (int), sign_index (int), debilitated (bool), afflictions[] (string array)
data.all_factors[] (string array — deduplicated list of all triggers)
data.cancellations[] (string array — Jupiter protective conditions)
data.interpretation (string)
data.classical_symptoms[] (string array)
data.remedies[] (string array)
Compute class
MEDIUM_COMPUTE — natal chart computation.
Errors
INVALID_PARAMS (local): BirthData Pydantic violations → MCP INVALID_PARAMS
INTERNAL_ERROR: Any upstream API failure → MCP INTERNAL_ERROR
Do not confuse with
asterwise_get_doshas — returns pitru_dosha as one of twelve doshas with less detail. Use this tool when dedicated Pitru Dosha analysis is needed.
Connect
Remote MCP endpoint: https://mcp.asterwise.com/mcp. Authenticate with Authorization: Bearer <API key> or OAuth. See the MCP setup guide.