Measures malefic stress from Lagna, Moon, and Venus references for each partner, compares totals, and labels compatibility level against a threshold.
SECTION: WHAT THIS TOOL 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 ('Good', 'Moderate', 'Poor'), and numeric threshold. It does not output Ashtakoota points (asterwise_get_compatibility) or porutham passes (asterwise_get_porutham).
SECTION: WORKFLOW
BEFORE: RECOMMENDED — asterwise_get_compatibility — establish baseline match quality.
AFTER: None.
SECTION: INPUT CONTRACT
Two BirthData objects per global contract.
SECTION: 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)
data.compatibility_level (string — 'Good', 'Moderate', or 'Poor')
data.threshold (float)
SECTION: 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.
SECTION: COMPUTE CLASS
MEDIUM_COMPUTE
SECTION: ERROR CONTRACT
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).
SECTION: 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.