Skip to main content

Doshas

asterwise_get_doshas

Scores thirteen fixed dosha buckets from birth data and returns presence flags, typed detail objects, optional summaries, and remedy lines per dosha.

Parameters​

ParameterTypeRequiredDescription
birthobjectyesBirth data for a single person. Required fields: date, lat, lon. Optional fields: time, person_name, timezone, ayanamsa.
response_formatenum: markdown, jsonnoOutput format: 'markdown' (default) for a readable report, or 'json' for the raw structured payload.

What it covers​

Maps mangal_dosha, shani_dosha, shrapit_dosha, grahan_dosha, kala_sarpa, kala_amrita, guru_chandal, kemadruma_dosha, paap_kartari, pitru_dosha, gandmool_dosha, nadi_dosha, and gulika — each with present, types[], details{}, needs_birth_time, interpretation_summary, keywords, remedies[]. Conjunction is the same sign everywhere (Grahan, Guru Chandal, Shrapit). Kala Sarpa returns its named type (Anant … Sheshnag, by Rahu's house); the reverse arc is the separate kala_amrita bucket. Kemadruma follows BPHS 37.11 (details.formed; cancelled only by a graha in a kendra from the lagna). pitru_dosha uses the eleven BPHS 83.20–83.30 combinations (as asterwise_get_pitra_dosha). Gulika uses the day or night table (BPHS 3.67) and the Vedic weekday. It does not replace compatibility Nadi scoring (asterwise_get_compatibility) or Shadbala (asterwise_get_chart_strength). Cancellation arrays inside details (e.g. mangal_dosha) must be read before treating a dosha as final. Aspects are full Parashari graha drishti counted from the aspecting planet's sign (Mars 4/7/8, Jupiter 5/7/9, Saturn 3/7/10, Rahu 7); house lords (e.g. the Pitru 9th lord) are whole sign from the lagna. Works at polar latitudes: the lagna comes from the ascendant when quadrant cusps cannot be computed.

Workflow​

BEFORE: RECOMMENDED — asterwise_get_natal_chart — chart familiarity before dosha interpretation.
AFTER: asterwise_get_remedies — classical remedial suggestions after dosha review.

Input​

BirthData follows the global contract. Unknown birth time at midnight is accepted silently.

Output contract​

data.doshas — object with exactly thirteen keys:
mangal_dosha, shani_dosha, shrapit_dosha, grahan_dosha, kala_sarpa, kala_amrita, guru_chandal, kemadruma_dosha, paap_kartari, pitru_dosha, gandmool_dosha, nadi_dosha, gulika
Each value:
present (bool)
types[] (string array — kala_sarpa: its named type; guru_chandal: 'with Rahu'/'with Ketu')
needs_birth_time (bool — true when the bucket depends on the lagna and no birth time was given)
details{} (object — mangal_dosha includes present_by_placement, mars_house, from_moon, from_venus, reference_points[], per_reference[], severity (placement tier from the lagna, kept even when cancelled), cancellations[] (only real cancellations, only when Mars is placed), notes[], benefic_aspects_not_counted[], d9_present (null: D9 is not computed); kemadruma_dosha includes formed, cancellations[]; pitru_dosha includes combinations[], combinations_detail[], indicators[], severity (null); gulika includes longitude, sign_index, sign_name, house, dosha_sensitive, period ('day'/'night'), vedic_weekday; other keys vary)
interpretation_summary (string or null)
keywords (array or null)
remedies[] (string array or null)
data.birth_time_provided (bool)

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​

MEDIUM_COMPUTE

Errors​

INVALID_PARAMS (local — caught before upstream call):
None — all validation is upstream.

INVALID_PARAMS (upstream):
— Dates before 1800 or after 2100 → MCP INTERNAL_ERROR at the tool layer.

INTERNAL_ERROR:
— Any upstream API failure or timeout → MCP INTERNAL_ERROR

Edge cases:
— Many doshas include cancellation lists inside details — read before concluding severity.

Do not confuse with​

asterwise_get_chart_strength — Shadbala/Vimshopaka power metrics, not dosha booleans.
asterwise_get_compatibility — pair scoring including nadi_dosha flags, not the thirteen natal dosha buckets.

Connect​

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