Papasamyam
asterwise_get_papasamyam
Scores malefic affliction for each partner from Lagna, Moon and Venus and checks that the bride's score does not exceed the groom's. Points: one per malefic (Sun, Mars, Saturn, Rahu, Ketu) in houses 1, 2, 4, 7, 8, 12, at full value from Lagna, half from Moon, a quarter from Venus.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
person1 | object | yes | Birth data for a single person. Required fields: date, lat, lon. Optional fields: time, person_name, timezone, ayanamsa. |
person2 | 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. |
What it covers
Papa Samyam balancing for marriage: per-person lagna/moon/venus scores, effective_score, cancellation flag, per-planet breakdown rows, then pairwise score_difference, compatible boolean, qualitative level ('Excellent', 'Good', 'Average', 'Incompatible'), imbalance direction, and threshold. Compatible means the bride's score does not exceed the groom's. It does not output Ashtakoota points (asterwise_get_compatibility) or porutham passes (asterwise_get_porutham).
Workflow
BEFORE: RECOMMENDED — asterwise_get_compatibility — establish baseline match quality.
AFTER: None.
Input
Two BirthData objects per global contract.
Output contract
data.person1 and data.person2 — each:
lagna_score (float)
moon_score (float)
venus_score (float)
total_score (float)
effective_score (float)
cancellation (bool)
breakdown[] — each:
planet (string)
house_lagna (int)
house_moon (int)
house_venus (int)
weight_lagna (float)
weight_moon (float)
weight_venus (float)
score (float)
data.score_difference (float)
data.compatible (bool — bride's effective_score ≤ groom's)
data.compatibility_level (string — 'Excellent', 'Good', 'Average', or 'Incompatible')
data.imbalance (string — 'Balanced', 'Groom heavier', or 'Bride heavier')
data.threshold (float — how far the bride may exceed the groom; 0)
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):
— None — upstream rejection surfaces as MCP INTERNAL_ERROR at the tool layer.
INTERNAL_ERROR:
— Any upstream API failure or timeout → MCP INTERNAL_ERROR
Edge cases:
— Both charts with zero malefics in the scanned houses → score_difference=0 and compatible=true (not an error).
Do not confuse with
asterwise_get_doshas — twelve natal dosha buckets for one chart, not pairwise malefic balance.
asterwise_get_compatibility — Guna Milan totals and vetoes, not Papa Samyam scoring.
Connect
Remote MCP endpoint: https://mcp.asterwise.com/mcp. Authenticate with Authorization: Bearer <API key> or OAuth. See the MCP setup guide.