Inheritance shares (محاسبهٔ سهمالارث)
calculate_inheritanceDivide a deceased person's net estate among the heirs under the Civil Code's classes and fixed shares (فروض), with return (رد) and shortfall (ورود نقص; no عول, as in Shia law) and a bequest of up to one third, flagging the rule on a wife's share of land. Use it when the question is who inherits how much; for the articles behind a share use search_iranian_law or get_law_article (قانون مدنی, مواد ۸۶۱ تا ۹۴۹). Give only the living heirs: a later class inherits only when every earlier class is empty, and a spouse inherits with every class. Returns each heir's fraction and amount in rial with the articles applied. Amounts in rial; dates in the Jalali calendar.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"net_estate_rial": "<net_estate_rial>"
},
"name": "calculate_inheritance"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sons | No | Living sons. | |
| wives | No | Number of surviving wives when spouse is wife. | |
| father | No | The father is alive. | |
| mother | No | The mother is alive. | |
| spouse | No | The surviving spouse, if any; none when not given. Values: none = ندارد; husband = زوج (شوهر); wife = زوجه (همسر). | |
| daughters | No | Living daughters. | |
| bequest_rial | No | A bequest (وصیت) in rial; capped at one third. | |
| full_sisters | No | Sisters of the same father and mother (class 2). | |
| full_brothers | No | Brothers of the same father and mother (class 2). | |
| maternal_aunts | No | Mother's sisters, خاله (class 3). | |
| mother_blocked | No | The mother's share is reduced by siblings (حاجب, Civil Code 892): two brothers, four sisters, or a brother and two sisters, with the father alive. | |
| paternal_aunts | No | Father's sisters, عمه (class 3). | |
| maternal_uncles | No | Mother's brothers, دایی (class 3). | |
| net_estate_rial | Yes | Net estate in rial, after debts, funeral costs and financial obligations. | |
| paternal_uncles | No | Father's brothers, عمو (class 3). | |
| paternal_sisters | No | Sisters by the father only (class 2). | |
| maternal_siblings | No | Brothers and sisters by the mother only (class 2). | |
| paternal_brothers | No | Brothers by the father only (class 2). | |
| maternal_grandfather | No | Mother's father is alive (class 2). | |
| maternal_grandmother | No | Mother's mother is alive (class 2). | |
| paternal_grandfather | No | Father's father is alive (class 2). | |
| paternal_grandmother | No | Father's mother is alive (class 2). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | The result, in Persian, as it should be quoted. | |
| links | Yes | The dadrasai.com pages the result cites, in order. |