# Latvia Legal Research MCP Server (`lv-legal-mcp`)

**[Latviešu](#lv-native) | [English Documentation](#english-documentation)**

---

<a id="lv-native"></a>
## Juridiskais MCP serveris Latvijai (`lv-legal-mcp`) — Latviešu

### Par šo repozitoriju

Savieno jūsu AI lietotni (Claude, Cursor, Windsurf, VS Code, Antigravity) ar `likumi.lv` un Latvijas Tiesu portālu (`eli.tiesas.lv` — rajona tiesas, apgabaltiesas, Senāts un Satversmes tiesa).

### 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)** | 9 Rajona (pilsētas) tiesas (District/City Courts) & Administratīvā rajona tiesa |
| **Tier 2 (Regional / Appellate)** | 5 Apgabaltiesas (Rīgas, Kurzemes, Latgales, Vidzemes, Zemgales Regional Courts) & Administratīvā apgabaltiesa |
| **Tier 3 (Supreme / Constitutional)** | Augstākā tiesa / Senāts (Supreme Court of Latvia) & Satversmes tiesa (Constitutional Court) |

- **Službeni glasnik / Legislation:** Likumi.lv Official Legislation Portal (Latvijas Vēstnesis) (`https://likumi.lv`)
- **Sudska praksa / Case Law Portal:** Latvijas Tiesu Portāls (eli.tiesas.lv — Anonymized Judgments of District, Regional & Supreme Courts) (`https://eli.tiesas.lv`)

---

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

Model Context Protocol (MCP) server providing direct, read-only access to **Latvia (LV)** 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 **Latvia**, allowing practitioners to filter research by procedural stage:

| Judicial Tier | Covered Courts & Tribunals |
|:---|:---|
| **Tier 1 — First Instance** | 9 Rajona (pilsētas) tiesas (District/City Courts) & Administratīvā rajona tiesa |
| **Tier 2 — Regional / Cantonal / Appellate** | 5 Apgabaltiesas (Rīgas, Kurzemes, Latgales, Vidzemes, Zemgales Regional Courts) & Administratīvā apgabaltiesa |
| **Tier 3 — Supreme & Constitutional** | Augstākā tiesa / Senāts (Supreme Court of Latvia) & Satversmes tiesa (Constitutional Court) |

#### Primary Legal Portals

- **National Legislation Registry:** Likumi.lv Official Legislation Portal (Latvijas Vēstnesis) (`https://likumi.lv`)
- **Multi-Tier Case Law Database:** Latvijas Tiesu Portāls (eli.tiesas.lv — Anonymized Judgments of District, Regional & Supreme Courts) (`https://eli.tiesas.lv`)
- **Supported Citation Format Example:** `ECLI:LV:AT:2024:0101.SKC000124 or Likumi.lv`

#### Indexed Court & Regional Sub-Portals

| Sub-Portal Identifier (`sub_court`) | Official Endpoint / Registry |
|:---|:---|
| `eli_tiesas_all_tiers` | `https://eli.tiesas.lv` |
| `augstaka_tiesa` | `https://www.at.gov.lv` |

---

### Available MCP Tools

| Tool | Description |
|:---|:---|
| `search_legislation` | Searches enacted statutes, codes, decrees, and official gazette publications in Latvia. |
| `search_case_law` | Searches national jurisprudence and European/ECLI-linked judgments for Latvia. |
| `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 Latvia. |
| `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": {
    "lv-legal-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jurisatlas/lv-legal-mcp",
        "lv-legal-mcp"
      ]
    }
  }
}
```
</details>