Search Iranian statutes, court rulings, advisory opinions and circulars, with legal calculators.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Calculate حقالزحمهٔ داوری under the arbitration fee bylaw approved 1401/06/05 by the head of the judiciary (applies when the arbitrator and the parties have not agreed a fee): marginal 2% / 1% / 0.5% / 0.25% bands on the claim with a 1.5 billion rial cap, shared equally among arbitrators; a non-financial claim is 5–30 million rial per arbitrator.
financial or non-financial / un-valued claim.
Number of arbitrators (default 1).
Claim value in Toman (financial).
Calculate حقالزحمهٔ داوری under the arbitration fee bylaw approved 1401/06/05 by the head of the judiciary (applies when the arbitrator and the parties have not agreed a fee): marginal 2% / 1% / 0.5% / 0.25% bands on the claim with a 1.5 billion rial cap, shared equally among arbitrators; a non-financial claim is 5–30 million rial per arbitrator.
| Argument | Type | Description |
|---|---|---|
| kind* | string | financial or non-financial / un-valued claim. |
| arbitrators | integer | Number of arbitrators (default 1). |
| claim_toman | number | Claim value in Toman (financial). |
{
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"financial",
"non_financial"
],
"type": "string",
"description": "financial or non-financial / un-valued claim."
},
"arbitrators": {
"type": "integer",
"description": "Number of arbitrators (default 1)."
},
"claim_toman": {
"type": "number",
"description": "Claim value in Toman (financial)."
}
}
}Calculate خسارت تأخیر تأدیه under art. 522 ق.آ.د.م and unification ruling 850: (CBI index of the payment MONTH ÷ index of the due MONTH) × principal, from the Central Bank's official monthly table. When that table is not loaded the tool answers with the limitation and the official link instead of a number — never approximate it. Dates are Jalali.
| Argument | Type | Description |
|---|---|---|
| end_year* | integer | Jalali year of calculation/payment. |
| end_month | integer | Jalali end month 1–12 (optional). |
| principal* | number | Principal debt amount. |
| start_year* | integer | Jalali year the debt fell due. |
| start_month | integer | Jalali due month 1–12 (needed: ruling 850 reads that month's index). |
| principal_unit | string | Unit of the principal (default Toman). |
{
"type": "object",
"required": [
"principal",
"start_year",
"end_year"
],
"properties": {
"end_year": {
"type": "integer",
"description": "Jalali year of calculation/payment."
},
"end_month": {
"type": "integer",
"description": "Jalali end month 1–12 (optional)."
},
"principal": {
"type": "number",
"description": "Principal debt amount."
},
"start_year": {
"type": "integer",
"description": "Jalali year the debt fell due."
},
"start_month": {
"type": "integer",
"description": "Jalali due month 1–12 (needed: ruling 850 reads that month's index)."
},
"principal_unit": {
"enum": [
"toman",
"rial"
],
"type": "string",
"description": "Unit of the principal (default Toman)."
}
}
}Calculate دیه for a bodily injury using the CURRENT official rate and the fractions set by قانون مجازات اسلامی. ALWAYS use this instead of computing دیه yourself: the full-دیه rate changes every Persian year and the per-injury fractions are statutory. Returns the amount with the governing article and the official rate source.
| Argument | Type | Description |
|---|---|---|
| year | integer | Persian year (e.g. 1405). Defaults to the latest loaded rate. |
| count | integer | How many (fingers, teeth …). Default 1. |
| gender | string | Gender of the injured/deceased. |
| fraction | number | دیه fraction between 0 and 1 — only when no injury_type fits. |
| death_date | string | Jalali date of death when it differs from the act. |
| injury_type | string | Injury key from the standard list (e.g. full = دیهٔ کامل, hand_one = یک دست, tooth_front = دندان جلویی). Pick the key, not free text. |
| sacred_month | boolean | Only when no date is known: the act AND the death were in a ماه حرام (تغلیظ — a death, injury_type=full, only; ماده ۵۵۷). |
| incident_date |
Calculate نیمعشر اجرایی (the state execution fee on a civil judgment): 5% of the judgment sum (Civil Judgments Enforcement Act art. 158), half on settlement and none if complied with within ten days of service of the writ (art. 160), 10% of three months' rent for an eviction (art. 159), the 1405 budget-table range for a non-financial judgment, and the Dispute Settlement Council's art. 27 exemptions for a settlement report.
| Argument | Type | Description |
|---|---|---|
| kind* | string | money = financial judgment; eviction = lease eviction; non_financial = non-financial or un-valued; shora_settlement = Dispute Settlement Council settlement report. |
| timing | string | Court judgment: complied after ten days of service of the writ (default), within ten days, or the parties settled (half). |
| amount_toman | number | Judgment sum in Toman (money, shora_settlement). |
| shora_timing | string | Settlement report: before the execution order (exempt), within a month of the notice (half), later. |
| monthly_rent_toman | number | Monthly rent in Toman (eviction). |
{
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"money",
"eviction",
"non_financial",
"shora_settlement"
],
"type": "string",
"description": "money = financial judgment; eviction = lease eviction; non_financial = non-financial or un-valued; shora_settlement = Dispute Settlement Council settlement report."
},
"timing": {
"enum": [
"after_ten_days",
"within_ten_days",
"settled"
],
"type": "string",
"description": "Court judgment: complied after ten days of service of the writ (default), within ten days, or the parties settled (half)."
},
"amount_toman": {
"type": "number",
"description": "Judgment sum in Toman (money, shora_settlement)."
},
"shora_timing": {
"enum": [
"before_order",
"within_month",
"later"
],
"type": "string",
"description": "Settlement report: before the execution order (exempt), within a month of the notice (half), later."
},
"monthly_rent_toman": {
"type": "number",
"description": "Monthly rent in Toman (eviction)."
}
}
}Calculate the official تعرفهٔ دستمزد کارشناسان رسمی دادگستری as replaced by the 1405 instrument (approved 1405/05/07, promulgated 1405/05/20; supersedes the 1398/12/25 tariff and its 1402 amendment). `valuation` is a marginal ladder on the ارزش موضوع کارشناسی (art. 11) with a hard per-expert cap (1,350,000,000 rial) and explicit percentage add-ons for a few named subject matters (art. 11 notes 3–4, art. 22(2)); `residual` is expert work with no specific tariff in this instrument (art. 9) — a RANGE of 20,000,000–100,000,000 rial set on the expert's proposal with the referring authority's agreement, and the tool returns only the floor and says so; `evidence` is the flat minimum for تأمین دلیل (art. 7, 20,000,000 rial). Dozens of OTHER specialties (arts. 13–55) carry their own separate tariff and are not modelled here. Never guess a court expert's statutory fee.
| Argument | Type | Description |
|---|---|---|
| kind* | string | valuation = art. 11 ladder (needs value_rial); residual = flat minimum, no specific tariff (art. 9); evidence = تأمین دلیل flat minimum (art. 7). |
| modifiers | array | valuation only; usually at most one: contract_dispute = employer/contractor/consulting-engineer dispute or صورتوضعیت review over the whole contract value (+100%, art. 11 note 3); contract_dispute_partial = appraisal of only part of the contract, e.g. finding breach or delay (+50%, note 3); intangible_assets = valuation of intangible assets such as brands (+50%, art. 11 note 4 in the 1405 tariff); underground_mine = underground mineral reserves (+35%, art. 22(2)). |
| value_rial | number | Value of the subject matter under appraisal, in RIAL — valuation only. Never pass Toman. |
Calculate Iranian inheritance shares (سهمالارث) of the spouse, parents and children under قانون مدنی arts. 861–949 (رد، نقص، the mother's حاجب), in exact fractions that always sum to the estate. Grandchildren and class-2/3 heirs (siblings, grandparents, uncles …) are refused with the governing articles, never estimated — do not compute those yourself.
| Argument | Type | Description |
|---|---|---|
| son_count | integer | Number of sons. |
| has_father | boolean | Father alive? |
| has_mother | boolean | Mother alive? |
| has_spouse | boolean | Surviving spouse? |
| wife_count | integer | Permanent wives of a male deceased, 1–4 (ماده ۹۴۲). |
| sister_count | integer | Full or paternal sisters of the deceased (ماده ۸۹۲ ب). |
| brother_count | integer | Full or paternal brothers of the deceased (ماده ۸۹۲ ب). |
| sibling_count | integer | Deceased's siblings when their sex is unknown (for the mother's حاجب). Prefer brother_count / sister_count. |
Sum the fixed judicial service fees of 1405 (budget law 1405, table 16): criminal complaint, criminal record certificate, notice service, objections, appeals of orders, Administrative Justice Court petitions, translation seals and more. Without services, returns the whole schedule.
| Argument | Type | Description |
|---|---|---|
| services | array | Service ids (repeat an id to count it twice), e.g. criminal_complaint, no_record_first, ezharname_service, divan_first. |
{
"type": "object",
"required": [],
"properties": {
"services": {
"type": "array",
"items": {
"type": "string"
},
"description": "Service ids (repeat an id to count it twice), e.g. criminal_complaint, no_record_first, ezharname_service, divan_first."
}
}
}Calculate حقالوکاله from آییننامهٔ تعرفهٔ حقالوکاله (1398/12/28): financial claims are a marginal ladder on the claim value (art. 9); family, non-financial, criminal and administrative matters are a min–max RANGE independent of value (arts. 13, 14, 20). `stage` is art. 21's share of the whole-case fee (60% first instance / 40% appeal). The tariff does not scale by winning or losing. Never guess a lawyer's statutory fee.
| Argument | Type | Description |
|---|---|---|
| stage* | string | first = 60%, appeal = 40%, cassation = on the appeal tariff (arts. 16–17). |
| outcome | string | How the case ends (default judgment). Settlement is paid in full (art. 23); art. 12 halves or quarters a fee for قرار رد / ابطال. |
| case_type | string | civil = financial claim (art. 9); family = family/حسبی (art. 13a); non_financial (art. 13b); criminal (art. 14, needs criminal_grade); admin = دیوان عدالت اداری / تعزیرات (art. 20); board = non-judicial boards e.g. labour (art. 20). |
| membership | string | bar = Bar Association member (fund 50% + bar 25% of the stamp); center = مرکز وکلا member (5% of the fee) — bylaw art. 29. |
| criminal_grade | string | Criminal only: court (کیفری یک / دو) and offence grade. |
| case_value_toman | number | Claim value in Toman — civil only. |
Calculate Iranian court filing fees (هزینهٔ دادرسی) for a monetary claim at a given stage (بدوی / تجدیدنظر / فرجام), using the current official percentages. Use this instead of estimating — the rates are statutory and stage-dependent.
| Argument | Type | Description |
|---|---|---|
| stage* | string | Stage: first = بدوی, appeal = تجدیدنظر, supreme = فرجام/دیوان عالی. |
| case_type | string | financial = مالی (needs claim_amount_toman), non_financial = غیرمالی (fixed official figure). |
| claim_amount_toman | number | Claim value in TOMAN (financial claims only). |
{
"type": "object",
"required": [
"stage"
],
"properties": {
"stage": {
"enum": [
"first",
"appeal",
"supreme"
],
"type": "string",
"description": "Stage: first = بدوی, appeal = تجدیدنظر, supreme = فرجام/دیوان عالی."
},
"case_type": {
"enum": [
"financial",
"non_financial"
],
"type": "string",
"description": "financial = مالی (needs claim_amount_toman), non_financial = غیرمالی (fixed official figure)."
},
"claim_amount_toman": {
"type": "number",
"description": "Claim value in TOMAN (financial claims only)."
}
}
}Calculate the present-day value of a مهریه: coins at the live market rate, and any cash portion adjusted by the Central Bank index (تبصرهٔ مادهٔ ۱۰۸۲ قانون مدنی). Never guess coin prices or the adjustment index — this tool reads both from the database. If there is a cash portion, ask for marriage_year; without it the cash stays nominal and must not be called «ارزش روز».
| Argument | Type | Description |
|---|---|---|
| coins | number | Number of coins in the مهریه. |
| coin_type | string | Coin type (default azadi = تمام بهار آزادی). |
| cash_toman | number | Cash portion in Toman (optional). |
| marriage_year | number | Jalali marriage year (needed to adjust the cash portion to today's value). |
{
"type": "object",
"required": [],
"properties": {
"coins": {
"type": "number",
"description": "Number of coins in the مهریه."
},
"coin_type": {
"enum": [
"azadi",
"emami",
"half",
"quarter",
"gram"
],
"type": "string",
"description": "Coin type (default azadi = تمام بهار آزادی)."
},
"cash_toman": {
"type": "number",
"description": "Cash portion in Toman (optional)."
},
"marriage_year": {
"type": "number",
"description": "Jalali marriage year (needed to adjust the cash portion to today's value)."
}
}
}Calculate حقالتحریر (the notary office's fee) from the official 1405 tariff for دفاتر اسناد رسمی. Distinct from حقالثبت (use calculate_stamp_duty for that). Never estimate the tariff.
| Argument | Type | Description |
|---|---|---|
| doc_type* | string | Document type. Rate-based types (need amount_toman): immovable/sale, movable/vehicle, financial/mortgage/partnership, lease. Others are fixed-fee. |
| amount_toman | number | Document amount in Toman (rate-based types only; for real estate this is ارزش معاملاتی, not market price). |
| obligor_count | number | Number of obligors (optional; each beyond two adds a surcharge). |
{
"type": "object",
"required": [
"doc_type"
],
"properties": {
"doc_type": {
"enum": [
"immovable",
"sale",
"movable",
"vehicle",
"financial",
"mortgage",
"partnership",
"lease",
"poa_sale",
"poa_vehicle",
"power_of_attorney",
"undertaking",
"mahrieh_release",
"division",
"student_undertaking",
"endowment",
"will",
"will_ahdi",
"settlement",
"collateral_swap",
"other_nonfinancial",
"mortgage_release",
"execution_writ",
"signature_cert",
"sana_signup"
],
"type": "string",
"description": "Document type. Rate-based types (need amount_toman): immovable/sale, movable/vehicle, financial/mortgage/partnership, lease. Others are fixed-fee."
},
"amount_toman": {
"type": "number",
"description": "Document amount in Toman (rate-based types only; for real estate this is ارزش معاملاتی, not market price)."
},
"obligor_count": {
"type": "number",
"description": "Number of obligors (optional; each beyond two adds a surcharge)."
}
}
}Calculate an Iranian employee's end-of-service entitlements (حق سنوات، عیدی، مانده مرخصی) under قانون کار, using the current official minimum wage. Use this instead of computing by hand.
| Argument | Type | Description |
|---|---|---|
| year | integer | Persian year for the minimum-wage basis. Defaults to the latest. |
| years | number | Years of service (may be fractional). |
| months | integer | Extra months of service (0–11). |
| contract_type | string | permanent = دائمی, fixed = موقت. Default permanent. |
| last_salary_toman | number | Last monthly salary in TOMAN. Below the statutory minimum wage the minimum is used instead. |
| unused_leave_days | number | Stored unused annual leave days (ماده ۶۶ ق.کار caps storage at 9 days/yr). |
{
"type": "object",
"required": [],
"properties": {
"year": {
"type": "integer",
"description": "Persian year for the minimum-wage basis. Defaults to the latest."
},
"years": {
"type": "number",
"description": "Years of service (may be fractional)."
},
"months": {
"type": "integer",
"description": "Extra months of service (0–11)."
},
"contract_type": {
"enum": [
"permanent",
"fixed"
],
"type": "string",
"description": "permanent = دائمی, fixed = موقت. Default permanent."
},
"last_salary_toman": {
"type": "number",
"description": "Last monthly salary in TOMAN. Below the statutory minimum wage the minimum is used instead."
},
"unused_leave_days": {
"type": "number",
"description": "Stored unused annual leave days (ماده ۶۶ ق.کار caps storage at 9 days/yr)."
}
}
}Calculate حقالثبت, the STATE registration duty on a notarised document: 0.5% of the amount in a financial document (art. 123 of the Registration Act, as amended 1384), and the 1405 fixed amounts of art. 124 items (budget law 1405, table 16). Distinct from حقالتحریر (the notary's own fee — use calculate_notary_fee). Marriage/divorce and company registration are refused (no official 1405 tariff / a separate capital ladder).
| Argument | Type | Description |
|---|---|---|
| count | integer | Pages or items (optional). |
| doc_kind* | string | financial = sale/gift/mortgage/lease…; vehicle_sale_poa = vehicle sale power of attorney; non_valued = a document whose subject cannot be valued; signature_cert; rescission (فسخ/اقاله); copy_page (per page); registry_certificate; duplicate_deed (المثنی); true_copy_page (برابر اصل, per page). |
| amount_toman | number | Amount in the document, or its statutory base, in Toman (financial and vehicle_sale_poa only). |
{
"type": "object",
"required": [
"doc_kind"
],
"properties": {
"count": {
"type": "integer",
"description": "Pages or items (optional)."
},
"doc_kind": {
"enum": [
"financial",
"vehicle_sale_poa",
"non_valued",
"signature_cert",
"rescission",
"copy_page",
"registry_certificate",
"duplicate_deed",
"true_copy_page"
],
"type": "string",
"description": "financial = sale/gift/mortgage/lease…; vehicle_sale_poa = vehicle sale power of attorney; non_valued = a document whose subject cannot be valued; signature_cert; rescission (فسخ/اقاله); copy_page (per page); registry_certificate; duplicate_deed (المثنی); true_copy_page (برابر اصل, per page)."
},
"amount_toman": {
"type": "number",
"description": "Amount in the document, or its statutory base, in Toman (financial and vehicle_sale_poa only)."
}
}
}Calculate Iranian salary, property-transfer, inheritance or rental tax. For inheritance: rates depend on asset kind and heir class (arts. 17–18 ق.م.م) with NO general monetary exemption, and pre/post-1395 death dates differ — ask before calling. Property basis is ارزش معاملاتی, not market price.
| Argument | Type | Description |
|---|---|---|
| tax_type* | string | Tax type. |
| asset_kind | string | Asset kind (required for inheritance). |
| heir_class | integer | Heir class (inheritance, art. 18): 1=parents/spouse/children, 2=grandparents/siblings ×2 rate, 3=aunts/uncles ×4 rate. |
| value_toman | number | Property value (property_transfer) or taxable asset value (inheritance). |
| monthly_toman | number | Monthly salary (for salary). |
| no_other_income | boolean | Rental: individual landlord with no other income (art. 57 exemption). |
| monthly_rent_toman | number | Monthly rent (for rental). |
| residential_under_exempt_area | boolean |
Fetch official Iranian yearly rates from the database: minimum wage (min_wage), court filing fees (court_fee_*), salary tax exemption (salary_tax_exemption_annual), daily severance (sanavat_daily). Delay damages and cash mahr come ONLY from calculate_delay_penalty / calculate_mahrieh — never from an index row of this table. حقالوکاله is NOT an annual rate — use calculate_lawyer_fee. ALWAYS use this instead of recalling a rate — yearly figures are exactly what models misremember. For دیه use calculate_diyeh instead. Read each row's `unit` field: «rials» means Rial and «درصد» means percent — never report a percentage as a Rial amount.
| Argument | Type | Description |
|---|---|---|
| rate_type* | string | Rate key, e.g. min_wage, court_fee_financial_first, sanavat_daily. |
| year_jalali | number | Persian year (optional — defaults to the latest available). |
{
"type": "object",
"required": [
"rate_type"
],
"properties": {
"rate_type": {
"type": "string",
"description": "Rate key, e.g. min_wage, court_fee_financial_first, sanavat_daily."
},
"year_jalali": {
"type": "number",
"description": "Persian year (optional — defaults to the latest available)."
}
}
}Fetch the VERBATIM text of a specific article when you already know the law and the article number (e.g. «ماده ۱۰ قانون مدنی»). Use this to verify wording before quoting it. Never paraphrase an article from memory — quote what this returns, and link the source_url. Also returns, when we hold them: `section_path` (the article's place in the law: کتاب/باب/فصل), `clauses` (its بند/جزء as labelled parts, so you can cite «بند ۲ ماده ۱۹۰»), `summary`/`summary_plain` (machine-written explanations — NOT statute text; never quote them as law), `keywords`, `topics`, `answers_in_text` (question → the exact slice of this article that answers it) and `related_articles` with their own source_urls.
| Argument | Type | Description |
|---|---|---|
| law* | string | Law name in Persian, e.g. «قانون مدنی». |
| part | integer | Only for very long texts (treaties, annexes stored as one article): which part of the verbatim text the summary carries, from 1 (default 1). When the summary ends «متن ادامه دارد — بخش k از N», call again with the same law and article_number and part=k. |
| article_number* | string | Article number, e.g. «۱۰» or «10». |
{
"type": "object",
"required": [
"law",
"article_number"
],
"properties": {
"law": {
"type": "string",
"description": "Law name in Persian, e.g. «قانون مدنی»."
},
"part": {
"type": "integer",
"minimum": 1,
"description": "Only for very long texts (treaties, annexes stored as one article): which part of the verbatim text the summary carries, from 1 (default 1). When the summary ends «متن ادامه دارد — بخش k از N», call again with the same law and article_number and part=k."
},
"article_number": {
"type": "string",
"description": "Article number, e.g. «۱۰» or «10»."
}
}
}Look up Iranian procedural deadlines (مهلت تجدیدنظر، واخواهی، اعتراض ثالث، اجرای حکم…) with the governing law and article, by case type. Use when the user asks how long they have for a procedural step. Deadlines differ by case type — never answer from memory.
| Argument | Type | Description |
|---|---|---|
| case_type* | string | Case type, in Persian. |
| procedure_name | string | Optional procedure key (e.g. tajdid_nazar_madani, faryad_khahi); omit to list all procedures for the case type. |
{
"type": "object",
"required": [
"case_type"
],
"properties": {
"case_type": {
"enum": [
"حقوقی",
"کیفری",
"خانواده",
"کار",
"اداری"
],
"type": "string",
"description": "Case type, in Persian."
},
"procedure_name": {
"type": "string",
"description": "Optional procedure key (e.g. tajdid_nazar_madani, faryad_khahi); omit to list all procedures for the case type."
}
}
}Look up the statutory punishment for an Iranian crime — imprisonment, fine, lashes, قصاص, دیه — with the governing article. Use when the user asks what the punishment for a crime is, or for criminal-risk analysis. Never state a sentencing range from memory.
| Argument | Type | Description |
|---|---|---|
| crime_type* | string | Crime, in Persian (e.g. «کلاهبرداری»، «سرقت»، «خیانت در امانت»). |
| crime_grade | number | Optional تعزیری grade (1–8). |
{
"type": "object",
"required": [
"crime_type"
],
"properties": {
"crime_type": {
"type": "string",
"description": "Crime, in Persian (e.g. «کلاهبرداری»، «سرقت»، «خیانت در امانت»)."
},
"crime_grade": {
"type": "number",
"description": "Optional تعزیری grade (1–8)."
}
}
}Check Iranian limitation periods (مرور زمان) — prosecution, execution, and filing deadlines — for a case category. Use when the user asks whether a claim is time-barred or how long they have to file.
| Argument | Type | Description |
|---|---|---|
| crime_grade | number | Optional تعزیری grade (1–8), criminal only. |
| case_category* | string | Case category. |
{
"type": "object",
"required": [
"case_category"
],
"properties": {
"crime_grade": {
"type": "number",
"description": "Optional تعزیری grade (1–8), criminal only."
},
"case_category": {
"enum": [
"criminal",
"civil",
"family",
"labor",
"administrative"
],
"type": "string",
"description": "Case category."
}
}
}Search the advisory opinions (نظریات مشورتی) of the Judiciary's legal department (اداره کل حقوقی قوه قضائیه) — the official, citable interpretation of Iranian statutes. Use when the user asks how a provision is officially interpreted, or to support an argument. Advisory opinions are authoritative guidance, not binding law — say so when citing. Returns opinion number, date, and excerpt with source_url.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| query* | string | Topic, in Persian (e.g. «مهریه عندالاستطاعه», «اعسار»). |
{
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"default": 5,
"maximum": 5,
"minimum": 1
},
"query": {
"type": "string",
"description": "Topic, in Persian (e.g. «مهریه عندالاستطاعه», «اعسار»)."
}
}
}Search 31,000+ Iranian court rulings and آرای وحدت رویه (binding precedent). Use when the user asks how courts have actually decided an issue, or for precedent supporting a position. Returns excerpts with source_url.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| query* | string | The legal issue, in Persian. |
{
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"default": 5,
"maximum": 5,
"minimum": 1
},
"query": {
"type": "string",
"description": "The legal issue, in Persian."
}
}
}Search official circulars and directives (بخشنامهها) from the judiciary and government bodies — the source of current official RATES and procedures. Returns excerpts with source_url.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| query* | string | Topic, in Persian. |
{
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"default": 5,
"maximum": 5,
"minimum": 1
},
"query": {
"type": "string",
"description": "Topic, in Persian."
}
}
}Semantic + keyword search across the full text of Iranian statutes (60,000+ articles: قانون مدنی، مجازات اسلامی، کار، تجارت، آیین دادرسی و…). USE THIS BEFORE ANSWERING ANY QUESTION ABOUT IRANIAN LAW — do not rely on memory; article numbers and wording are frequently misremembered, and amended articles are a common trap. Returns matching articles with their exact article number, law title, a text excerpt, and a source_url to the full article. Cite the article number and link the source_url.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| query* | string | The legal question or topic, in Persian or English. Persian gives better recall. |
| law_filter | string | Optional: restrict to one law, e.g. «قانون مدنی» or «قانون کار». |
{
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"default": 5,
"maximum": 5,
"minimum": 1
},
"query": {
"type": "string",
"description": "The legal question or topic, in Persian or English. Persian gives better recall."
},
"law_filter": {
"type": "string",
"description": "Optional: restrict to one law, e.g. «قانون مدنی» or «قانون کار»."
}
}
}| string |
| Jalali date of the act, e.g. 1405/09/25 — the ماه حرام is derived from the official Hijri calendar (ماده ۵۵۵). |
{
"type": "object",
"required": [],
"properties": {
"year": {
"type": "integer",
"description": "Persian year (e.g. 1405). Defaults to the latest loaded rate."
},
"count": {
"type": "integer",
"description": "How many (fingers, teeth …). Default 1."
},
"gender": {
"enum": [
"male",
"female"
],
"type": "string",
"description": "Gender of the injured/deceased."
},
"fraction": {
"type": "number",
"description": "دیه fraction between 0 and 1 — only when no injury_type fits."
},
"death_date": {
"type": "string",
"description": "Jalali date of death when it differs from the act."
},
"injury_type": {
"enum": [
"full",
"eye_one",
"eye_both",
"ear_one",
"ear_both",
"ear_lobe_one",
"ear_lobe_both",
"hand_one",
"hand_both",
"foot_one",
"foot_both",
"finger_thumb",
"finger_other",
"finger_phalanx",
"finger_thumb_phalanx",
"toe_phalanx",
"toe_thumb_phalanx",
"tooth_front",
"tooth_molar",
"nose_full",
"nose_fracture",
"kidney_one",
"kidney_both",
"rib_heart",
"rib_each",
"rib_other",
"spleen",
"skull_fracture",
"spine_fracture",
"spine_fracture_healed",
"spinal_cord",
"eyelid_upper",
"eyelid_lower",
"testicle_left",
"testicle_right"
],
"type": "string",
"description": "Injury key from the standard list (e.g. full = دیهٔ کامل, hand_one = یک دست, tooth_front = دندان جلویی). Pick the key, not free text."
},
"sacred_month": {
"type": "boolean",
"description": "Only when no date is known: the act AND the death were in a ماه حرام (تغلیظ — a death, injury_type=full, only; ماده ۵۵۷)."
},
"incident_date": {
"type": "string",
"description": "Jalali date of the act, e.g. 1405/09/25 — the ماه حرام is derived from the official Hijri calendar (ماده ۵۵۵)."
}
}
}| expert_count |
| integer |
| Number of same-specialty experts working the SAME subject jointly (valuation only). More than 1 applies a 30% reduction per expert, with the cap checked after the reduction (art. 56). Default 1 (no reduction). Do not use for a multi-specialty panel — price each specialty separately. |
| travel_days_same_province | integer | Mission days within the expert's own province (art. 6 daily travel allowance) — added to any kind. |
| travel_days_other_province | integer | Mission days outside the expert's own province (art. 6). |
{
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"valuation",
"residual",
"evidence"
],
"type": "string",
"description": "valuation = art. 11 ladder (needs value_rial); residual = flat minimum, no specific tariff (art. 9); evidence = تأمین دلیل flat minimum (art. 7)."
},
"modifiers": {
"type": "array",
"items": {
"enum": [
"contract_dispute",
"contract_dispute_partial",
"intangible_assets",
"underground_mine"
],
"type": "string"
},
"description": "valuation only; usually at most one: contract_dispute = employer/contractor/consulting-engineer dispute or صورتوضعیت review over the whole contract value (+100%, art. 11 note 3); contract_dispute_partial = appraisal of only part of the contract, e.g. finding breach or delay (+50%, note 3); intangible_assets = valuation of intangible assets such as brands (+50%, art. 11 note 4 in the 1405 tariff); underground_mine = underground mineral reserves (+35%, art. 22(2))."
},
"value_rial": {
"type": "number",
"description": "Value of the subject matter under appraisal, in RIAL — valuation only. Never pass Toman."
},
"expert_count": {
"type": "integer",
"description": "Number of same-specialty experts working the SAME subject jointly (valuation only). More than 1 applies a 30% reduction per expert, with the cap checked after the reduction (art. 56). Default 1 (no reduction). Do not use for a multi-specialty panel — price each specialty separately."
},
"travel_days_same_province": {
"type": "integer",
"description": "Mission days within the expert's own province (art. 6 daily travel allowance) — added to any kind."
},
"travel_days_other_province": {
"type": "integer",
"description": "Mission days outside the expert's own province (art. 6)."
}
}
}| daughter_count | integer | Number of daughters. |
| deceased_gender* | string | Gender of the deceased. |
| total_assets_toman* | number | Total estate value in Toman. |
{
"type": "object",
"required": [
"total_assets_toman",
"deceased_gender"
],
"properties": {
"son_count": {
"type": "integer",
"description": "Number of sons."
},
"has_father": {
"type": "boolean",
"description": "Father alive?"
},
"has_mother": {
"type": "boolean",
"description": "Mother alive?"
},
"has_spouse": {
"type": "boolean",
"description": "Surviving spouse?"
},
"wife_count": {
"type": "integer",
"description": "Permanent wives of a male deceased, 1–4 (ماده ۹۴۲)."
},
"sister_count": {
"type": "integer",
"description": "Full or paternal sisters of the deceased (ماده ۸۹۲ ب)."
},
"brother_count": {
"type": "integer",
"description": "Full or paternal brothers of the deceased (ماده ۸۹۲ ب)."
},
"sibling_count": {
"type": "integer",
"description": "Deceased's siblings when their sex is unknown (for the mother's حاجب). Prefer brother_count / sister_count."
},
"daughter_count": {
"type": "integer",
"description": "Number of daughters."
},
"deceased_gender": {
"enum": [
"male",
"female"
],
"type": "string",
"description": "Gender of the deceased."
},
"total_assets_toman": {
"type": "number",
"description": "Total estate value in Toman."
}
}
}| contract_fee_toman | number | Fee written in the power of attorney, in Toman — for the 5% tax stamp (Direct Taxes Act art. 103), which is never below the tariff floor. |
| final_at_first_instance | boolean | Civil only: first-instance judgment is final as to value ⇒ flat 10% (art. 9 opening). |
{
"type": "object",
"required": [
"stage"
],
"properties": {
"stage": {
"enum": [
"first",
"appeal",
"cassation"
],
"type": "string",
"description": "first = 60%, appeal = 40%, cassation = on the appeal tariff (arts. 16–17)."
},
"outcome": {
"enum": [
"judgment",
"settlement",
"dismissed_no_merits",
"rejected_after_defence",
"voided_before_defence"
],
"type": "string",
"description": "How the case ends (default judgment). Settlement is paid in full (art. 23); art. 12 halves or quarters a fee for قرار رد / ابطال."
},
"case_type": {
"enum": [
"civil",
"family",
"non_financial",
"criminal",
"admin",
"board"
],
"type": "string",
"description": "civil = financial claim (art. 9); family = family/حسبی (art. 13a); non_financial (art. 13b); criminal (art. 14, needs criminal_grade); admin = دیوان عدالت اداری / تعزیرات (art. 20); board = non-judicial boards e.g. labour (art. 20)."
},
"membership": {
"enum": [
"bar",
"center"
],
"type": "string",
"description": "bar = Bar Association member (fund 50% + bar 25% of the stamp); center = مرکز وکلا member (5% of the fee) — bylaw art. 29."
},
"criminal_grade": {
"enum": [
"k1_grade1",
"k1_grade2_3",
"k1_other",
"k2_hodud_diyat_grade4_5",
"k2_grade6",
"k2_other"
],
"type": "string",
"description": "Criminal only: court (کیفری یک / دو) and offence grade."
},
"case_value_toman": {
"type": "number",
"description": "Claim value in Toman — civil only."
},
"contract_fee_toman": {
"type": "number",
"description": "Fee written in the power of attorney, in Toman — for the 5% tax stamp (Direct Taxes Act art. 103), which is never below the tariff floor."
},
"final_at_first_instance": {
"type": "boolean",
"description": "Civil only: first-instance judgment is final as to value ⇒ flat 10% (art. 9 opening)."
}
}
}| Rental: residential unit within the exempt floor-area (150m² Tehran / 200m² elsewhere). |
{
"type": "object",
"required": [
"tax_type"
],
"properties": {
"tax_type": {
"enum": [
"salary",
"property_transfer",
"inheritance",
"rental"
],
"type": "string",
"description": "Tax type."
},
"asset_kind": {
"enum": [
"real_estate",
"goodwill",
"bank_deposit",
"listed_shares",
"unlisted_shares",
"vehicle",
"other"
],
"type": "string",
"description": "Asset kind (required for inheritance)."
},
"heir_class": {
"enum": [
1,
2,
3
],
"type": "integer",
"description": "Heir class (inheritance, art. 18): 1=parents/spouse/children, 2=grandparents/siblings ×2 rate, 3=aunts/uncles ×4 rate."
},
"value_toman": {
"type": "number",
"description": "Property value (property_transfer) or taxable asset value (inheritance)."
},
"monthly_toman": {
"type": "number",
"description": "Monthly salary (for salary)."
},
"no_other_income": {
"type": "boolean",
"description": "Rental: individual landlord with no other income (art. 57 exemption)."
},
"monthly_rent_toman": {
"type": "number",
"description": "Monthly rent (for rental)."
},
"residential_under_exempt_area": {
"type": "boolean",
"description": "Rental: residential unit within the exempt floor-area (150m² Tehran / 200m² elsewhere)."
}
}
}