Brazilian Law MCP Server

The Planalto alternative for the AI age.

Query Brazilian legislation -- covering data protection, cybersecurity, corporate law, and more -- directly from Claude, Cursor, or any MCP-compatible client.

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

Built by Ansvar Systems -- Stockholm, Sweden

Why This Exists

Brazilian legal research is scattered across official government databases, commercial legal platforms, and institutional archives. Whether you're:

• A lawyer validating citations in a brief or contract
• A compliance officer checking if a statute is still in force
• A legal tech developer building tools on Brazilian law
• A researcher tracing legislative history

...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 Brazilian 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://brazilian-law-mcp.vercel.app/mcp

| Client | How to Connect | |--------|---------------| | Claude.ai | Settings > Connectors > Add Integration > paste URL | | Claude Code | claude mcp add brazil-law --transport http https://brazilian-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:

{
  "mcpServers": {
    "brazil-law": {
      "type": "url",
      "url": "https://brazilian-law-mcp.vercel.app/mcp"
    }
  }
}

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

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

Use Locally (npm)

npx @ansvar/brazil-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

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

Cursor / VS Code:

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

Example Queries

Once connected, just ask naturally:

• "What does the Brazilian data protection law say about consent?"
• "Search for cybersecurity requirements in Brazilian legislation"
• "Is this statute still in force?"
• "Find provisions about personal data in Brazilian law"
• "What EU directives does this Brazilian law implement?"
• "Which Brazilian laws implement the GDPR?"
• "Validate this legal citation"
• "Build a legal stance on data breach notification requirements"

Key Legislation Covered

| Law | Year | Domain | Key Topics | |-----|------|--------|------------| | Lei Geral de Protecao de Dados (LGPD) | 2018 (Lei 13.709) | Data Protection | Personal data processing, consent, data subject rights, ANPD, international data transfers, extraterritorial application | | Marco Civil da Internet | 2014 (Lei 12.965) | Internet Regulation | Net neutrality, data retention, intermediary liability, freedom of expression, privacy of communications | | Cybercrime Law (Carolina Dieckmann Law) | 2012 (Lei 12.737) | Cybercrime | Unauthorized access to computer devices, data interception, criminal penalties | | Consumer Protection Code | 1990 (Lei 8.078) | Consumer Rights | Consumer rights, product liability, unfair commercial practices, class actions | | General Telecommunications Law | 1997 (Lei 9.472) | Telecommunications | Telecom regulation, ANATEL, service licensing, spectrum management | | Brazilian Civil Code | 2002 (Lei 10.406) | Civil Law | Persons, obligations, contracts, property, privacy and personality rights |

Deployment Tier

MEDIUM -- dual tier, free database bundled in npm package.

| Tier | Platform | Database | Content | |------|----------|----------|---------| | Free | Vercel (Hobby) / npm (stdio) | Core federal laws (~120-200 MB) | Key federal legislation (LGPD, Marco Civil, Cybercrime Law, Consumer Protection Code, Civil Code), FTS search, EU/international cross-references | | Professional | Azure Container Apps / Docker / Local | Full database (~600 MB - 1 GB) | + All federal laws and decrees, ANPD regulations and guidance, STF/STJ case law summaries, supplementary instruments |

The full database is larger due to the comprehensive scope of Brazilian federal legislation and supplementary regulatory materials from ANPD. The free tier contains all key data protection, cybercrime, consumer, and internet legislation from Planalto.

Database Estimates

| Component | Free Tier | Full (Professional) | |-----------|-----------|---------------------| | Core federal laws | ~90-140 MB | ~90-140 MB | | All federal decrees & instruments | -- | ~300-500 MB | | ANPD guidance & resolutions | -- | ~30-50 MB | | STF/STJ case law summaries | -- | ~100-200 MB | | Cross-references & metadata | ~5 MB | ~15 MB | | Total | ~120-200 MB | ~600 MB - 1 GB |

Delivery strategy: Free-tier DB bundled in npm package (Strategy A -- fits within Vercel 250 MB function limit). If final size exceeds 250 MB after ingestion, switch to Strategy B (runtime download from GitHub Releases).

Available Tools (13)

Core Legal Research Tools (8)

| Tool | Description | |------|-------------| | search_legislation | FTS5 full-text search across all provisions with BM25 ranking | | get_provision | Retrieve specific provision by statute + chapter/section | | check_currency | Check if statute is in force, amended, or repealed | | validate_citation | Validate citation against database (zero-hallucination check) | | build_legal_stance | Aggregate citations from statutes for a legal topic | | format_citation | Format citations per Brazilian conventions (full/short/pinpoint) | | list_sources | List all available statutes with metadata | | about | Server info, capabilities, and coverage summary |

EU/International Law Integration Tools (5)

| Tool | Description | |------|-------------| | get_eu_basis | Get EU directives/regulations for Brazilian statute | | get_brazilian_implementations | Find Brazilian laws implementing EU act | | search_eu_implementations | Search EU documents with Brazilian implementation counts | | get_provision_eu_basis | Get EU law references for specific provision | | validate_eu_compliance | Check implementation status of EU directives |

Why This Works

Verbatim Source Text (No LLM Processing):

• All statute text is ingested from official Brazilian government sources
• Provisions are returned unchanged from SQLite FTS5 database rows
• Zero LLM summarization or paraphrasing -- the database contains regulation text, not AI interpretations

Smart Context Management:

• Search returns ranked provisions with BM25 scoring (safe for context)
• Provision retrieval gives exact text by statute identifier + chapter/section
• Cross-references help navigate without loading everything at once

Technical Architecture:

Official Sources --> Parse --> SQLite --> FTS5 snippet() --> MCP response
                     ^                       ^
              Provision parser         Verbatim database query

Traditional Research vs. This MCP

| Traditional Approach | This MCP Server | |---------------------|-----------------| | Search official databases by statute number | Search by plain language | | Navigate multi-chapter statutes manually | Get the exact provision with context | | Manual cross-referencing between laws | build_legal_stance aggregates across sources | | "Is this statute still in force?" --> check manually | check_currency tool --> answer in seconds | | Find EU basis --> dig through EUR-Lex | get_eu_basis --> linked EU directives instantly | | No API, no integration | MCP protocol --> AI-native |

Data Sources & Freshness

All content is sourced from authoritative Brazilian legal databases:

• Planalto -- Official Brazilian government legal database

Verified data only -- every citation is validated against official sources. Zero LLM-generated content.

Security

This project uses multiple layers of automated security scanning:

| Scanner | What It Does | Schedule | |---------|-------------|----------| | CodeQL | Static analysis for security vulnerabilities | Weekly + PRs | | Semgrep | SAST scanning (OWASP top 10, secrets, TypeScript) | Every push | | Gitleaks | Secret detection across git history | Every push | | Trivy | CVE scanning on filesystem and npm dependencies | Daily | | Socket.dev | Supply chain attack detection | PRs | | Dependabot | Automated dependency updates | Weekly |

See SECURITY.md for the full policy and vulnerability reporting.

Important Disclaimers

Legal Advice

THIS TOOL IS NOT LEGAL ADVICE

Statute text is sourced from official Brazilian government publications. However:

• This is a research tool, not a substitute for professional legal counsel
• Court case coverage is limited -- do not rely solely on this for case law research
• Verify critical citations against primary sources for court filings
• EU cross-references are extracted from statute text, not EUR-Lex full text

Before using professionally, read: DISCLAIMER.md | SECURITY.md

Client Confidentiality

Queries go through the Claude API. For privileged or confidential matters, use on-premise deployment.

Development

Setup

git clone https://github.com/Ansvar-Systems/Brazil-law-mcp
cd Brazil-law-mcp
npm install
npm run build
npm test

Running Locally

npm run dev                                       # Start MCP server
npx @anthropic/mcp-inspector node dist/index.js   # Test with MCP Inspector

Related Projects: Complete Compliance Suite

This server is part of Ansvar's Compliance Suite -- MCP servers that work together for end-to-end compliance coverage:

@ansvar/eu-regulations-mcp

Query 49 EU regulations directly from Claude -- GDPR, AI Act, DORA, NIS2, MiFID II, eIDAS, and more. Full regulatory text with article-level search. npx @ansvar/eu-regulations-mcp

@ansvar/us-regulations-mcp

Query US federal and state compliance laws -- HIPAA, CCPA, SOX, GLBA, FERPA, and more. npx @ansvar/us-regulations-mcp

@ansvar/security-controls-mcp

Query 261 security frameworks -- ISO 27001, NIST CSF, SOC 2, CIS Controls, SCF, and more. npx @ansvar/security-controls-mcp

@ansvar/automotive-cybersecurity-mcp

Query UNECE R155/R156 and ISO 21434 -- Automotive cybersecurity compliance. npx @ansvar/automotive-cybersecurity-mcp

30+ national law MCPs covering Australia, Brazil, Canada, China, Denmark, Finland, France, Germany, Ghana, Iceland, India, Ireland, Israel, Italy, Japan, Kenya, Netherlands, Nigeria, Norway, Singapore, Slovenia, South Korea, Sweden, Switzerland, Thailand, UAE, UK, and more.

Contributing

Contributions welcome! See CONTRIBUTING.md for guidelines.

Priority areas:

• Court case law expansion
• EU cross-reference improvements
• Historical statute versions and amendment tracking
• Additional statutory instruments and regulations

Roadmap

• [x] Core statute database with FTS5 search
• [x] EU/international law cross-references
• [x] Vercel Streamable HTTP deployment
• [x] npm package publication
• [ ] Court case law expansion
• [ ] Historical statute versions (amendment tracking)
• [ ] Preparatory works / explanatory memoranda
• [ ] Lower court and tribunal decisions

Citation

If you use this MCP server in academic research:

@software{brazil_law_mcp_2025,
  author = {Ansvar Systems AB},
  title = {Brazilian Law MCP Server: AI-Powered Legal Research Tool},
  year = {2025},
  url = {https://github.com/Ansvar-Systems/Brazil-law-mcp},
  note = {Brazilian legal database with full-text search and EU cross-references}
}

License

Apache License 2.0. See LICENSE for details.

Data Licenses

• Statutes & Legislation: Brazilian Government (public domain)
• EU Metadata: EUR-Lex (EU public domain)

About Ansvar Systems

We build AI-accelerated compliance and legal research tools for the global market. This MCP server started as our internal reference tool -- turns out everyone building compliance tools has the same research frustrations.

So we're open-sourcing it.

ansvar.eu -- Stockholm, Sweden