Brlaw MCP Server

🚀 Brazilian Law Research MCP Server

A MCP (Model Context Protocol) server for agent - driven research on Brazilian law using official sources.

🇧🇷 Read in Portuguese

🚀 Quick Start

This server empowers models with scraping capacities, thus making research easier for anyone legitimately interested in Brazilian legal matters.

However, this facility comes with a price: the risk of overloading the official sources' servers if misused. Please be sure to keep the load on the sources to a reasonable amount.

⚠️ Important Note

There is a risk of overloading the official sources' servers if the server is misused. Please keep the load on the sources at a reasonable level.

📦 Installation

Requirements

• git
• uv (recommended) or Python >= 3.12
• Google Chrome

Steps

1. Clone the repository:

git clone https://github.com/pdmtt/brlaw_mcp_server.git

2. Install the dependencies

uv run patchright install

💻 Usage Examples

Basic Usage

1. Setup your MCP client (e.g. Claude Desktop):

{
  "mcpServers": {
    "brlaw_mcp_server": {
      "command": "uv",
      "args": [
        "--directory",
        "/<path>/brlaw_mcp_server",
        "run",
        "serve"
      ]
    }
  }
}

Available Tools

• StjLegalPrecedentsRequest: Research legal precedents made by the National High Court of Brazil (STJ) that meet the specified criteria.
• TstLegalPrecedentsRequest: Research legal precedents made by the National High Labor Court of Brazil (TST) that meet the specified criteria.
• StfLegalPrecedentsRequest: Research legal precedents made by the Supreme Court (STF) that meet the specified criteria.

🔧 Technical Details

Tooling

The project uses:

• Ruff for linting and formatting.
• BasedPyright for type checking.
• Pytest for testing.

Language

Resources, tools and prompts related stuff must be written in Portuguese, because this project aims to be used by non - dev folks, such as lawyers and law students.

Technical legal vocabulary is highly dependent on a country's legal tradition and translating it is no trivial task.

Development related stuff should stick to English as conventional, such as source code.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.