eu.ansvar/botswana-law-mcp

Install

Config snippet generator goes here (5 client tabs)

README

# Botswana Law MCP Server

**The BACLAYS alternative for the AI age.**

[![npm version](https://badge.fury.io/js/@ansvar%2Fbotswana-law-mcp.svg)](https://www.npmjs.com/package/@ansvar/botswana-law-mcp)
[![MCP Registry](https://img.shields.io/badge/MCP-Registry-blue)](https://registry.modelcontextprotocol.io)
[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
[![GitHub stars](https://img.shields.io/github/stars/Ansvar-Systems/Botswana-law-mcp?style=social)](https://github.com/Ansvar-Systems/Botswana-law-mcp)
[![CI](https://github.com/Ansvar-Systems/Botswana-law-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/Ansvar-Systems/Botswana-law-mcp/actions/workflows/ci.yml)
[![Daily Data Check](https://github.com/Ansvar-Systems/Botswana-law-mcp/actions/workflows/check-updates.yml/badge.svg)](https://github.com/Ansvar-Systems/Botswana-law-mcp/actions/workflows/check-updates.yml)
[![Database](https://img.shields.io/badge/database-pre--built-green)](https://github.com/Ansvar-Systems/Botswana-law-mcp)
[![Provisions](https://img.shields.io/badge/provisions-7%2C626-blue)](https://github.com/Ansvar-Systems/Botswana-law-mcp)

Query **882 Botswanan Acts** -- from the Data Protection Act 2018 and the Penal Code to the Companies Act, Employment Act, and more -- directly from Claude, Cursor, or any MCP-compatible client.

If you're building legal tech, compliance tools, or doing Botswanan legal research, this is your verified reference database.

Built by [Ansvar Systems](https://ansvar.eu) -- Stockholm, Sweden

---

## Why This Exists

Botswanan legal research means navigating laws.parliament.bw, botswanalii.org, and scattered government PDF publications. Whether you're:

- A **lawyer** validating citations in a brief or contract
- A **compliance officer** checking obligations under the Data Protection Act 2018 or the Financial Intelligence Act
- A **legal tech developer** building tools on Botswanan law
- A **researcher** tracing legislative provisions across 882 Acts

...you shouldn't need dozens of browser tabs and manual PDF cross-referencing. Ask Claude. Get the exact provision. With context.

This MCP server makes Botswanan law **searchable, cross-referenceable, and AI-readable**.

---

## Quick Start

### Use Remotely (No Install Needed)

> Connect directly to the hosted version -- zero dependencies, nothing to install.

**Endpoint:** `https://botswana-law-mcp.vercel.app/mcp`

| Client | How to Connect |
|--------|---------------|
| **Claude.ai** | Settings > Connectors > Add Integration > paste URL |
| **Claude Code** | `claude mcp add botswana-law --transport http https://botswana-law-mcp.vercel.app/mcp` |
| **Claude Desktop** | Add to config (see below) |
| **GitHub Copilot** | Add to VS Code settings (see below) |

**Claude Desktop** -- add to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "botswana-law": {
      "type": "url",
      "url": "https://botswana-law-mcp.vercel.app/mcp"
    }
  }
}
```

**GitHub Copilot** -- add to VS Code `settings.json`:

```json
{
  "github.copilot.chat.mcp.servers": {
    "botswana-law": {
      "type": "http",
      "url": "https://botswana-law-mcp.vercel.app/mcp"
    }
  }
}
```

### Use Locally (npm)

```bash
npx @ansvar/botswana-law-mcp
```

**Claude Desktop** -- add to `claude_desktop_config.json`:

**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "botswana-law": {
      "command": "npx",
      "args": ["-y", "@ansvar/botswana-law-mcp"]
    }
  }
}
```

**Cursor / VS Code:**

```json
{
  "mcp.servers": {
    "botswana-law": {
      "command": "npx",
      "args": ["-y", "@ansvar/botswana-law-mcp"]
    }
  }
}
```

---

## Example Queries

Once connected, just ask naturally:

- *"What does the Data Protection Act 2018 say about consent for data processing?"*
- *"Find provisions in the Penal Code about fraud and financial crimes"*
- *"Search for company law requirements under the Companies Act"*
- *"What does the Employment Act say about termination and severance?"*
- *"Is the Financial Intelligence Act still in force?"*
- *"Find provisions about competition law under the Competition Act"*
- *"Build a legal stance on corporate governance obligations in Botswana"*
- *"Validate the citation 'Section 12 of the Data Protection Act 2018'"*

---

## What's Included

| Category | Count | Details |
|----------|-------|---------|
| **Acts** | 882 statutes | Comprehensive Botswanan legislation |
| **Provisions** | 7,626 sections | Full-text searchable with FTS5 |
| **Legal Definitions** | 7,703 definitions | Extracted from Act texts |
| **Database Size** | ~17 MB | Optimized SQLite, portable |
| **Freshness Checks** | Automated | Monitoring against laws.parliament.bw |

**Verified data only** -- every citation is validated against official sources (laws.parliament.bw, botswanalii.org