search_law_articles

Semantic + keyword search across the full text of Iranian statutes (46,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.

Parameters3

query	string	required	The legal question or topic, in Persian or English. Persian gives better recall.
law_filter	string	optional	Optional: restrict to one law, e.g. «قانون مدنی» or «قانون کار».
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "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 «قانون کار»."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5,
      "default": 5
    }
  },
  "required": [
    "query"
  ]
}

lookup_law_article

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.

Parameters2

law	string	required	Law name in Persian, e.g. «قانون مدنی».
article_number	string	required	Article number, e.g. «۱۰» or «10».

Raw schema

{
  "type": "object",
  "properties": {
    "law": {
      "type": "string",
      "description": "Law name in Persian, e.g. «قانون مدنی»."
    },
    "article_number": {
      "type": "string",
      "description": "Article number, e.g. «۱۰» or «10»."
    }
  },
  "required": [
    "law",
    "article_number"
  ]
}

search_case_law

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.

Parameters2

query	string	required	The legal issue, in Persian.
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "The legal issue, in Persian."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5,
      "default": 5
    }
  },
  "required": [
    "query"
  ]
}

search_circular

Search official circulars and directives (بخشنامه‌ها) from the judiciary and government bodies — the source of current official RATES and procedures. Returns excerpts with source_url.

Parameters2

query	string	required	Topic, in Persian.
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Topic, in Persian."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5,
      "default": 5
    }
  },
  "required": [
    "query"
  ]
}

calculate_diyeh

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.

Parameters3

injury	string	required	Injury in Persian, e.g. «شکستگی دست»، «از دست دادن یک انگشت»، «دندان».
year	integer	optional	Persian year (e.g. 1405). Defaults to the current year.
is_haram_month	boolean	optional	Whether it occurred in a حرام month (تغلیظ applies to دیهٔ نفس).

Raw schema

{
  "type": "object",
  "properties": {
    "injury": {
      "type": "string",
      "description": "Injury in Persian, e.g. «شکستگی دست»، «از دست دادن یک انگشت»، «دندان»."
    },
    "year": {
      "type": "integer",
      "description": "Persian year (e.g. 1405). Defaults to the current year."
    },
    "is_haram_month": {
      "type": "boolean",
      "description": "Whether it occurred in a حرام month (تغلیظ applies to دیهٔ نفس)."
    }
  },
  "required": [
    "injury"
  ]
}

calculate_litigation_fee

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.

Parameters2

amount	number	required	Claim value in Toman.
stage	string	optional	Court stage.

Raw schema

{
  "type": "object",
  "properties": {
    "amount": {
      "type": "number",
      "description": "Claim value in Toman."
    },
    "stage": {
      "type": "string",
      "enum": [
        "بدوی",
        "تجدیدنظر",
        "فرجام"
      ],
      "description": "Court stage."
    }
  },
  "required": [
    "amount"
  ]
}

calculate_severance

Calculate an Iranian employee's end-of-service entitlements (حق سنوات، عیدی، مانده مرخصی) under قانون کار, using the current official minimum wage. Use this instead of computing by hand.

Parameters2

monthly_wage	number	required	Monthly wage in Toman.
years	number	required	Years of service (may be fractional).

Raw schema

{
  "type": "object",
  "properties": {
    "monthly_wage": {
      "type": "number",
      "description": "Monthly wage in Toman."
    },
    "years": {
      "type": "number",
      "description": "Years of service (may be fractional)."
    }
  },
  "required": [
    "monthly_wage",
    "years"
  ]
}

search_advisory_opinions

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.

Parameters2

query	string	required	Topic, in Persian (e.g. «مهریه عندالاستطاعه», «اعسار»).
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Topic, in Persian (e.g. «مهریه عندالاستطاعه», «اعسار»)."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5,
      "default": 5
    }
  },
  "required": [
    "query"
  ]
}

lookup_annual_rate

Fetch official Iranian yearly rates from the database: minimum wage (min_wage), court filing fees (court_fee_*), salary tax exemption (salary_tax_exemption_annual), Central Bank price index for delay damages (cbi_price_index), bar-association lawyer tariffs (lawyer_tariff_*), daily severance (sanavat_daily). 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.

Parameters2

rate_type	string	required	Rate key, e.g. min_wage, court_fee_financial_first, cbi_price_index, lawyer_tariff_nonfinancial.
year_jalali	number	optional	Persian year (optional — defaults to the latest available).

Raw schema

{
  "type": "object",
  "properties": {
    "rate_type": {
      "type": "string",
      "description": "Rate key, e.g. min_wage, court_fee_financial_first, cbi_price_index, lawyer_tariff_nonfinancial."
    },
    "year_jalali": {
      "type": "number",
      "description": "Persian year (optional — defaults to the latest available)."
    }
  },
  "required": [
    "rate_type"
  ]
}

lookup_sentencing_range

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.

Parameters2

crime_type	string	required	Crime, in Persian (e.g. «کلاهبرداری»، «سرقت»، «خیانت در امانت»).
crime_grade	number	optional	Optional تعزیری grade (1–8).

Raw schema

{
  "type": "object",
  "properties": {
    "crime_type": {
      "type": "string",
      "description": "Crime, in Persian (e.g. «کلاهبرداری»، «سرقت»، «خیانت در امانت»)."
    },
    "crime_grade": {
      "type": "number",
      "description": "Optional تعزیری grade (1–8)."
    }
  },
  "required": [
    "crime_type"
  ]
}

lookup_statute_of_limitations

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.

Parameters2

case_category	string	required	Case category.
crime_grade	number	optional	Optional تعزیری grade (1–8), criminal only.

Raw schema

{
  "type": "object",
  "properties": {
    "case_category": {
      "type": "string",
      "enum": [
        "criminal",
        "civil",
        "family",
        "labor",
        "administrative"
      ],
      "description": "Case category."
    },
    "crime_grade": {
      "type": "number",
      "description": "Optional تعزیری grade (1–8), criminal only."
    }
  },
  "required": [
    "case_category"
  ]
}

lookup_procedure

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.

Parameters2

case_type	string	required	Case type, in Persian.
procedure_name	string	optional	Optional procedure key (e.g. tajdid_nazar_madani, faryad_khahi); omit to list all procedures for the case type.

Raw schema

{
  "type": "object",
  "properties": {
    "case_type": {
      "type": "string",
      "enum": [
        "حقوقی",
        "کیفری",
        "خانواده",
        "کار",
        "اداری"
      ],
      "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."
    }
  },
  "required": [
    "case_type"
  ]
}

calculate_mahrieh

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 «ارزش روز».

Parameters4

coins	number	optional	Number of coins in the مهریه.
coin_type	string	optional	Coin type (default azadi = تمام بهار آزادی).
cash_toman	number	optional	Cash portion in Toman (optional).
marriage_year	number	optional	Jalali marriage year (needed to adjust the cash portion to today's value).

Raw schema

{
  "type": "object",
  "properties": {
    "coins": {
      "type": "number",
      "description": "Number of coins in the مهریه."
    },
    "coin_type": {
      "type": "string",
      "enum": [
        "azadi",
        "emami",
        "half",
        "quarter",
        "gram"
      ],
      "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)."
    }
  },
  "required": []
}

calculate_inheritance

Calculate Iranian inheritance shares (سهم‌الارث) under قانون مدنی arts. 862–949, including حجب نقصانی reduction rules. The jurisprudential edge cases make hand computation unreliable — always use this tool.

Parameters8

total_assets_toman	number	required	Total estate value in Toman.
deceased_gender	string	required	Gender of the deceased.
has_spouse	boolean	optional	Surviving spouse?
has_father	boolean	optional	Father alive?
has_mother	boolean	optional	Mother alive?
son_count	integer	optional	Number of sons.
daughter_count	integer	optional	Number of daughters.
sibling_count	integer	optional	Deceased's siblings (for حجب نقصانی).

Raw schema

{
  "type": "object",
  "properties": {
    "total_assets_toman": {
      "type": "number",
      "description": "Total estate value in Toman."
    },
    "deceased_gender": {
      "type": "string",
      "enum": [
        "male",
        "female"
      ],
      "description": "Gender of the deceased."
    },
    "has_spouse": {
      "type": "boolean",
      "description": "Surviving spouse?"
    },
    "has_father": {
      "type": "boolean",
      "description": "Father alive?"
    },
    "has_mother": {
      "type": "boolean",
      "description": "Mother alive?"
    },
    "son_count": {
      "type": "integer",
      "description": "Number of sons."
    },
    "daughter_count": {
      "type": "integer",
      "description": "Number of daughters."
    },
    "sibling_count": {
      "type": "integer",
      "description": "Deceased's siblings (for حجب نقصانی)."
    }
  },
  "required": [
    "total_assets_toman",
    "deceased_gender"
  ]
}

calculate_delay_penalty

Calculate خسارت تأخیر تأدیه under art. 522 ق.آ.د.م using the Central Bank price index. The index series is official data — never approximate it. Dates are Jalali.

Parameters6

principal	number	required	Principal debt amount.
principal_unit	string	optional	Unit of the principal (default Toman).
start_year	integer	required	Jalali year the debt fell due.
start_month	integer	optional	Jalali start month 1–12 (optional).
end_year	integer	required	Jalali year of calculation/payment.
end_month	integer	optional	Jalali end month 1–12 (optional).

Raw schema

{
  "type": "object",
  "properties": {
    "principal": {
      "type": "number",
      "description": "Principal debt amount."
    },
    "principal_unit": {
      "type": "string",
      "enum": [
        "toman",
        "rial"
      ],
      "description": "Unit of the principal (default Toman)."
    },
    "start_year": {
      "type": "integer",
      "description": "Jalali year the debt fell due."
    },
    "start_month": {
      "type": "integer",
      "description": "Jalali start month 1–12 (optional)."
    },
    "end_year": {
      "type": "integer",
      "description": "Jalali year of calculation/payment."
    },
    "end_month": {
      "type": "integer",
      "description": "Jalali end month 1–12 (optional)."
    }
  },
  "required": [
    "principal",
    "start_year",
    "end_year"
  ]
}

calculate_stamp_duty

Calculate حق‌الثبت (registration duty) for property, vehicle, company, marriage and divorce documents. Distinct from حق‌التحریر (the notary's own fee — use calculate_notary_fee for that).

Parameters2

tx_type	string	required	Transaction/document type.
amount_toman	number	optional	Transaction amount in Toman (for rate-based types).

Raw schema

{
  "type": "object",
  "properties": {
    "tx_type": {
      "type": "string",
      "enum": [
        "property_sale",
        "property_gift",
        "vehicle",
        "mortgage",
        "power_attorney",
        "marriage",
        "divorce",
        "company",
        "will"
      ],
      "description": "Transaction/document type."
    },
    "amount_toman": {
      "type": "number",
      "description": "Transaction amount in Toman (for rate-based types)."
    }
  },
  "required": [
    "tx_type"
  ]
}

calculate_notary_fee

Calculate حق‌التحریر (the notary office's fee) from the official 1405 tariff for دفاتر اسناد رسمی. Distinct from حق‌الثبت (use calculate_stamp_duty for that). Never estimate the tariff.

Parameters3

doc_type	string	required	Document type. Rate-based types (need amount_toman): immovable/sale, movable/vehicle, financial/mortgage/partnership, lease. Others are fixed-fee.
amount_toman	number	optional	Document amount in Toman (rate-based types only; for real estate this is ارزش معاملاتی, not market price).
obligor_count	number	optional	Number of obligors (optional; each beyond two adds a surcharge).

Raw schema

{
  "type": "object",
  "properties": {
    "doc_type": {
      "type": "string",
      "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"
      ],
      "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)."
    }
  },
  "required": [
    "doc_type"
  ]
}

calculate_lawyer_fee

Calculate حق‌الوکاله from the official bar-association tariff (تعرفهٔ کانون وکلا) by case type, stage and outcome. Never guess a lawyer's statutory fee.

Parameters4

case_type	string	optional	Case type.
stage	string	required	Court stage.
outcome	string	required	Case outcome (or projection).
case_value_toman	number	optional	Case value in Toman.

Raw schema

{
  "type": "object",
  "properties": {
    "case_type": {
      "type": "string",
      "enum": [
        "civil",
        "criminal",
        "admin"
      ],
      "description": "Case type."
    },
    "stage": {
      "type": "string",
      "enum": [
        "first",
        "appeal",
        "cassation"
      ],
      "description": "Court stage."
    },
    "outcome": {
      "type": "string",
      "enum": [
        "full_win",
        "partial_win",
        "settlement",
        "lose"
      ],
      "description": "Case outcome (or projection)."
    },
    "case_value_toman": {
      "type": "number",
      "description": "Case value in Toman."
    }
  },
  "required": [
    "stage",
    "outcome"
  ]
}

calculate_tax

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.

Parameters8

tax_type	string	required	Tax type.
monthly_toman	number	optional	Monthly salary (for salary).
value_toman	number	optional	Property value (property_transfer) or taxable asset value (inheritance).
asset_kind	string	optional	Asset kind (required for inheritance).
heir_class	integer	optional	Heir class (inheritance, art. 18): 1=parents/spouse/children, 2=grandparents/siblings ×2 rate, 3=aunts/uncles ×4 rate.
monthly_rent_toman	number	optional	Monthly rent (for rental).
residential_under_exempt_area	boolean	optional	Rental: residential unit within the exempt floor-area (150m² Tehran / 200m² elsewhere).
no_other_income	boolean	optional	Rental: individual landlord with no other income (art. 57 exemption).

Raw schema

{
  "type": "object",
  "properties": {
    "tax_type": {
      "type": "string",
      "enum": [
        "salary",
        "property_transfer",
        "inheritance",
        "rental"
      ],
      "description": "Tax type."
    },
    "monthly_toman": {
      "type": "number",
      "description": "Monthly salary (for salary)."
    },
    "value_toman": {
      "type": "number",
      "description": "Property value (property_transfer) or taxable asset value (inheritance)."
    },
    "asset_kind": {
      "type": "string",
      "enum": [
        "real_estate",
        "goodwill",
        "bank_deposit",
        "listed_shares",
        "unlisted_shares",
        "vehicle",
        "other"
      ],
      "description": "Asset kind (required for inheritance)."
    },
    "heir_class": {
      "type": "integer",
      "enum": [
        1,
        2,
        3
      ],
      "description": "Heir class (inheritance, art. 18): 1=parents/spouse/children, 2=grandparents/siblings ×2 rate, 3=aunts/uncles ×4 rate."
    },
    "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)."
    },
    "no_other_income": {
      "type": "boolean",
      "description": "Rental: individual landlord with no other income (art. 57 exemption)."
    }
  },
  "required": [
    "tax_type"
  ]
}

چیستارا — Iranian Legal Corpus

ai.hoghogh/chistara (MCP Server) — Iranian Legal Search & Calculators

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

search_law_articles

lookup_law_article

search_case_law

search_circular

calculate_diyeh

calculate_litigation_fee

calculate_severance

search_advisory_opinions

lookup_annual_rate

lookup_sentencing_range

lookup_statute_of_limitations

lookup_procedure

calculate_mahrieh

calculate_inheritance

calculate_delay_penalty

calculate_stamp_duty

calculate_notary_fee

calculate_lawyer_fee

calculate_tax

Install

Remote endpoint

Related servers