# چیستارا — Iranian Legal Corpus

> Search Iranian statutes, court rulings, advisory opinions and circulars, with legal calculators.

- name: ai.hoghogh/chistara
- version: 1.0.0
- connection class: R0 (autonomous)
- trust: 79/100 flags: no-repository
- quality: 75/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/ai.hoghogh%2Fchistara
- tools: https://api.protogrid.dev/v1/servers/ai.hoghogh%2Fchistara/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "chistara": {
      "type": "http",
      "url": "https://hoghogh.ai/mcp"
    }
  }
}
```


## Trust

- hygiene: 80
- liveness: 98
- freshness: 85
- provenance: 55
- drivers: +dns-namespace +website +reachable +uptime-95% ~updated-68d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 75/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-06-18; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 100 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 23 of 23 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 6,505 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 25 (weight 15)

- warn `stability.changes`: 13 tool changes in 30 days
- fail `stability.rug_pull`: 3 tools kept their name but changed most of their description in 30 days; review before trusting them

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 23, about 6,505 tokens to load them all
- tool set hash: b0289201749f100d5f466bf9b3e74129
- tools last changed: 2026-10-14T07:50:31.866Z
- badge: [![protogrid quality](https://protogrid.dev/badge/ai.hoghogh/chistara.svg)](https://protogrid.dev/servers/ai.hoghogh/chistara)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-14 `calculate_judicial_service_fee` added
  - 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.
- 2026-10-14 `calculate_arbitration_fee` added
  - 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.
- 2026-10-14 `calculate_execution_fee` added
  - 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.
- 2026-10-14 `calculate_lawyer_fee` changed (inputSchema)
- 2026-10-14 `calculate_stamp_duty` changed (description, inputSchema) **meaning changed**
  - before: Calculate حق‌الثبت (registration duty) for property, vehicle, company, marriage and divorce documents. Distinct from حق‌التحریر (the notary's own fee — use calculate_notary_fee for that).
  - after: 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).
- 2026-10-11 `calculate_delay_penalty` changed (description, inputSchema) **meaning changed**
  - before: Calculate خسارت تأخیر تأدیه under art. 522 ق.آ.د.م using the Central Bank price index. The index series is official data — never approximate it. Dates are Jalali.
  - after: 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.
- 2026-10-11 `calculate_inheritance` changed (description, inputSchema) **meaning changed**
  - before: Calculate Iranian inheritance shares (سهم‌الارث) under قانون مدنی arts. 862–949, including حجب نقصانی reduction rules. The jurisprudential edge cases make hand computation unreliable — always use this tool.
  - after: 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.
- 2026-10-11 `lookup_annual_rate` changed (description, inputSchema)
  - before: 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), daily severance (sanavat_daily). حق‌الوکاله 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.
  - after: 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.
- 2026-10-11 `calculate_diyeh` changed (inputSchema)
- 2026-10-07 `lookup_law_article` changed (inputSchema)

Full history: https://api.protogrid.dev/v1/servers/ai.hoghogh%2Fchistara/changes

## Remotes

- https://hoghogh.ai/mcp (streamable-http, auth none, reachable true, uptime30d 0.9478261)

## Packages

_none_

## Tools (23)

- `calculate_arbitration_fee`: 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.
- `calculate_delay_penalty`: 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.
- `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.
- `calculate_execution_fee`: 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.
- `calculate_expert_fee`: 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.
- `calculate_inheritance`: 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.
- `calculate_judicial_service_fee`: 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.
- `calculate_lawyer_fee`: 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.
- `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.
- `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 «ارزش روز».
- `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.
- `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.
- `calculate_stamp_duty`: 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).
- `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.
- `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), 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.
- `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.
- `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.
- `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.
- `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.
- `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.
- `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.
- `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.
- `search_law_articles`: 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.
