# Hungary Legal Research MCP Server (`hu-legal-mcp`)

**[Magyar](#hu-native) | [English Documentation](#english-documentation)**

---

<a id="hu-native"></a>
## Jogi MCP Szerver Magyarország számára (`hu-legal-mcp`) — Magyar

### A tárolóról

Összeköti az Ön által használt AI alkalmazást (Claude, Cursor, Windsurf, VS Code, Antigravity) a Nemzeti Jogszabálytárral (`njt.hu`) és a Bírósági Határozatok Gyűjteményével (`eakta.birosag.hu` — járásbíróságok, törvényszékek, ítélőtáblák, Kúria és Alkotmánybíróság).

### Installation (AI Client Selection)

1. **Download:** Click **`<> Code` -> `Download ZIP`** and extract the folder.
2. **Run Setup:** Double-click **`Click_Here_To_Install_Windows.bat`** (Windows) or **`Click_Here_To_Install_Mac.command`** (macOS).
3. **Select AI Applications:** Check the AI clients you use (Claude Desktop, Cursor, Windsurf, VS Code / Copilot, Cline, Antigravity), click Install, and restart your chosen AI application.

**Read-Only Operation:** This tool does not read or modify any personal files on your computer.

### Judicial Hierarchy

| Tier | Courts |
|:---|:---|
| **Tier 1 (First Instance)** | 113 Járásbíróságok (District Courts across Hungary) |
| **Tier 2 (Regional / Appellate)** | 20 Törvényszékek (Regional Courts) & 5 Ítélőtáblák (Regional Courts of Appeal: Budapest, Debrecen, Győr, Pécs, Szeged) |
| **Tier 3 (Supreme / Constitutional)** | Kúria (Supreme Court of Hungary) & Alkotmánybíróság (Constitutional Court) |

- **Službeni glasnik / Legislation:** Nemzeti Jogszabálytár (njt.hu) (`https://njt.hu`)
- **Sudska praksa / Case Law Portal:** Bírósági Határozatok Gyűjteménye BHGY (eakta.birosag.hu — Járásbíróságok, Törvényszékek, Ítélőtáblák & Kúria) (`https://eakta.birosag.hu/anonimizalt-hatarozatok`)

---

<a id="english-documentation"></a>
## English Documentation

Model Context Protocol (MCP) server providing direct, read-only access to **Hungary (HU)** legislation, multi-tier judicial decisions (First Instance, Regional/Cantonal/Appellate, and Supreme/Constitutional courts), and statutory citation verification across major AI clients (**Claude Desktop, Cursor, Windsurf, VS Code / GitHub Copilot, Cline, Continue.dev, and Antigravity**).

---

### Interactive Desktop Setup (Select Your AI Assistant)

This package includes a graphical installer for legal practitioners and non-technical users that lets you select which AI application(s) you use:

1. **Download:** Click **`<> Code`** at the top right of this repository, select **`Download ZIP`**, and extract the folder to your computer.
2. **Run the Setup Utility:**
   - **Windows:** Double-click `Click_Here_To_Install_Windows.bat`
   - **macOS:** Double-click `Click_Here_To_Install_Mac.command`
3. **Select Your AI Client(s) & Connect:** Check the box(es) for the AI assistant(s) installed on your computer (**Claude Desktop**, **Cursor**, **Windsurf**, **VS Code / GitHub Copilot**, **Cline**, **Continue.dev**, or **Antigravity**), click **Install to Selected AI Clients**, and restart your selected AI application.

**System Integrity Note:** The setup utility operates strictly in read-only mode with respect to your personal files and documents. It installs an isolated Python runtime inside the extracted folder and registers the server entry only in the AI client configuration files you select.

---

### Multi-Tier Judicial Hierarchy & Official Sources

This server indexes and queries decisions across the full judicial hierarchy of **Hungary**, allowing practitioners to filter research by procedural stage:

| Judicial Tier | Covered Courts & Tribunals |
|:---|:---|
| **Tier 1 — First Instance** | 113 Járásbíróságok (District Courts across Hungary) |
| **Tier 2 — Regional / Cantonal / Appellate** | 20 Törvényszékek (Regional Courts) & 5 Ítélőtáblák (Regional Courts of Appeal: Budapest, Debrecen, Győr, Pécs, Szeged) |
| **Tier 3 — Supreme & Constitutional** | Kúria (Supreme Court of Hungary) & Alkotmánybíróság (Constitutional Court) |

#### Primary Legal Portals

- **National Legislation Registry:** Nemzeti Jogszabálytár (njt.hu) (`https://njt.hu`)
- **Multi-Tier Case Law Database:** Bírósági Határozatok Gyűjteménye BHGY (eakta.birosag.hu — Járásbíróságok, Törvényszékek, Ítélőtáblák & Kúria) (`https://eakta.birosag.hu/anonimizalt-hatarozatok`)
- **Supported Citation Format Example:** `ECLI:HU:KURI:2024:100 or 2013. évi V. törvény`

#### Indexed Court & Regional Sub-Portals

| Sub-Portal Identifier (`sub_court`) | Official Endpoint / Registry |
|:---|:---|
| `bhgy_all_tiers` | `https://eakta.birosag.hu/anonimizalt-hatarozatok` |

---

### Available MCP Tools

| Tool | Description |
|:---|:---|
| `search_legislation` | Searches enacted statutes, codes, decrees, and official gazette publications in Hungary. |
| `search_case_law` | Searches national jurisprudence and European/ECLI-linked judgments for Hungary. |
| `search_tiered_court_decisions` | Filters case law specifically by judicial instance (`first_instance`, `appellate_regional`, `supreme_constitutional`) or regional/cantonal court key (`sub_court`). |
| `list_court_hierarchy` | Returns the complete 3-tier court structure and registered sub-portal endpoints for Hungary. |
| `get_legal_document_markdown` | Retrieves full statutory or judicial texts and converts them into clean Markdown. |
| `verify_citation` | Validates statutory and case law citations against official registries. |

---

<details>
<summary><b>Manual Configuration for Developers (Optional)</b></summary>

```json
{
  "mcpServers": {
    "hu-legal-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jurisatlas/hu-legal-mcp",
        "hu-legal-mcp"
      ]
    }
  }
}
```
</details>