Doshas
asterwise_get_doshas
Scores twelve fixed dosha buckets from birth data and returns presence flags, typed detail objects, optional summaries, and remedy lines per dosha.
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 |
What it covers
Maps mangal_dosha, shani_dosha, shrapit_dosha, grahan_dosha, kala_sarpa, guru_chandal, kemadruma_dosha, paap_kartari, pitru_dosha, gandmool_dosha, nadi_dosha, and gulika — each with present, types[], details{}, interpretation_summary, keywords, remedies[]. 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.
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 twelve keys:
mangal_dosha, shani_dosha, shrapit_dosha, grahan_dosha, kala_sarpa, guru_chandal, kemadruma_dosha, paap_kartari, pitru_dosha, gandmool_dosha, nadi_dosha, gulika
Each value:
present (bool)
types[] (string array)
details{} (object — mangal_dosha includes mars_house, from_moon, from_venus, d9_present, severity, cancellations[]; gulika includes longitude, sign_index, sign_name, house, dosha_sensitive; 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 twelve 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.