# Bosnia and Herzegovina Legal Research MCP Server (`ba-legal-mcp`)

Model Context Protocol (MCP) server providing direct, read-only access to **Bosnia and Herzegovina (BA)** legislation, multi-tier judicial decisions (First Instance, Regional/Cantonal/Appellate, and Supreme/Constitutional courts), and statutory citation verification for Claude Desktop, Cursor, and Antigravity.

---

## Quick Desktop Setup (No Command Line Required)

This package includes a graphical installer for legal practitioners who prefer not to use terminal commands or edit JSON configuration files manually.

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. **Connect:** Click **Install & Connect Automatically** in the setup window and restart Claude Desktop.

**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 environment inside the extracted folder and registers the server entry in your AI client configuration.

---

## Multi-Tier Judicial Hierarchy & Official Sources

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

| Judicial Tier | Covered Courts & Tribunals |
|:---|:---|
| **Tier 1 — First Instance** | Općinski sudovi u FBiH (28 Municipal Courts), Osnovni sudovi u RS (19 Basic Courts), Okružni privredni sudovi u RS & Osnovni sud Brčko distrikta BiH |
| **Tier 2 — Regional / Cantonal / Appellate** | 10 Kantonalnih sudova u FBiH (Sarajevo, Tuzla, Mostar, Zenica, Bihać, Novi Travnik, Odžak, Goražde, Široki Brijeg, Livno), 6 Okružnih sudova u RS (Banja Luka, Bijeljina, Doboj, Istočno Sarajevo, Prijedor, Trebinje), Viši privredni sud u Banjoj Luci & Apelacioni sud Brčko distrikta BiH |
| **Tier 3 — Supreme & Constitutional** | Ustavni sud BiH, Sud Bosne i Hercegovine (State Court Appellate & Trial Divisions), Vrhovni sud Federacije BiH & Vrhovni sud Republike Srpske |

### Primary Legal Portals

- **National Legislation Registry:** Official Gazette of BiH (sluzbenilist.ba), Službene novine FBiH & Službeni glasnik RS (`http://www.sluzbenilist.ba`)
- **Multi-Tier Case Law Database:** VSTV BiH Centralna Baza Sudskih Odluka (sudskapraksa.pravosudje.ba / pravosudje.ba/csd) & Kantonalni/Okružni Sudski Portali (`https://sudskapraksa.pravosudje.ba`)
- **Supported Citation Format Example:** `AP-123/23, 65 0 P 123456 23 Pž or Službeni glasnik BiH br. 10/24`

### Indexed Court & Regional Sub-Portals

| Sub-Portal Identifier (`sub_court`) | Official Endpoint / Registry |
|:---|:---|
| `central_csd` | `https://sudskapraksa.pravosudje.ba` |
| `kanton_sarajevo` | `https://katsud-sarajevo.pravosudje.ba` |
| `kanton_tuzla` | `https://katsud-tuzla.pravosudje.ba` |
| `kanton_mostar` | `https://katsud-mostar.pravosudje.ba` |
| `kanton_zenica` | `https://katsud-zenica.pravosudje.ba` |
| `kanton_bihac` | `https://katsud-bihac.pravosudje.ba` |
| `kanton_novi_travnik` | `https://katsud-novitravnik.pravosudje.ba` |
| `kanton_odzak` | `https://katsud-odzak.pravosudje.ba` |
| `kanton_gorazde` | `https://katsud-gorazde.pravosudje.ba` |
| `kanton_siroki_brijeg` | `https://katsud-sirokibrijeg.pravosudje.ba` |
| `kanton_livno` | `https://katsud-livno.pravosudje.ba` |
| `okruzni_banja_luka` | `https://okruznisud-banjaluka.pravosudje.ba` |
| `okruzni_bijeljina` | `https://okruznisud-bijeljina.pravosudje.ba` |
| `okruzni_doboj` | `https://okruznisud-doboj.pravosudje.ba` |
| `okruzni_istocno_sarajevo` | `https://okruznisud-istocnosarajevo.pravosudje.ba` |
| `okruzni_prijedor` | `https://okruznisud-prijedor.pravosudje.ba` |
| `okruzni_trebinje` | `https://okruznisud-trebinje.pravosudje.ba` |
| `apelacioni_brcko` | `https://apsud-brcko.pravosudje.ba` |
| `vrhovni_fbih` | `https://vsud-fbih.pravosudje.ba` |
| `vrhovni_rs` | `https://vsud-rs.pravosudje.ba` |
| `sud_bih` | `https://www.sudbih.gov.ba` |
| `ustavni_bih` | `https://www.ustavnisud.ba` |

---

## Available MCP Tools

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