Legalis Ia

Created By

edsonsousaa month ago

O Legalis MCP traz todo o fluxo de trabalho jurídico da sua area de trabalho. Advogados podem criar e gerenciar casos, gerar peças processuais profissionais seção por seção com IA, conduzir entrevistas guiadas de intake processual e monitorar o uso de cota — sem sair da conversa. Desenvolvido para o direito brasileiro. Funciona com Claude Desktop, Claude Code e qualquer cliente compatível com MCP. Autenticação via OAuth no browser — nenhuma senha armazenada em arquivos de configuração ---------- English Version ----------------- Legalis MCP brings your entire legal workflow into Claude. Attorneys can create and manage cases, generate professional legal documents (peças processuais) section by section using AI, run guided case intake interviews, and monitor AI quota usage — without ever leaving the conversation. Built for Brazilian law. Works with Claude Desktop, Claude Code, and any MCP-compatible client. Authentication via secure browser OAuth flow — no passwords stored in config files.

# brasil

# advogado

Overview Content Tools Comments

Overview

Legalis MCP Server

Assistente jurídico com IA para advogados brasileiros

Leia em Português

MCP (Model Context Protocol) server for Legalis — Brazilian legal document AI for attorneys.

Connect Claude (or any MCP-compatible client) to your Legalis account and interact with cases, generate legal documents, search legislation, and more using natural language.

Quick start

1. Install

pip install legalis-mcp
# or with uv:
uv tool install legalis-mcp

2. Authenticate

legalis-mcp auth

This opens your browser. Log in to Legalis normally — tokens are saved to ~/.legalis/credentials.json (owner-readable only).

3. Configure Claude

Add to your Claude configuration (~/.claude/claude_desktop_config.json for Claude Desktop, or claude_code_config.json for Claude Code):

{
  "mcpServers": {
    "legalis": {
      "command": "legalis-mcp",
      "args": ["serve"]
    }
  }
}

4. Use

In Claude, try:

"Liste meus casos no Legalis"
"Crie um caso de rescisão indireta para João Silva"
"Gere a seção de fundamentos jurídicos da peça X do caso Y"
"Pesquise legislação trabalhista sobre justa causa"
"Quantas gerações ainda tenho disponíveis este mês?"

Available tools

Tool	Description
`list_cases`	List cases (paginated, filterable by status)
`get_case`	Get case details by ID
`create_case`	Create a new case
`update_case`	Update case fields
`search_cases`	Full-text search across cases
`list_legal_documents`	List peças processuais for a case
`get_legal_document`	Get a document with all sections
`create_legal_document`	Create a new legal document
`generate_section`	AI-generate a document section (fatos, fundamentos, pedidos…)
`get_case_context`	Get case context (facts, parties, evidence)
`run_interview`	AI-guided case intake interview
`search_legislation`	Search Brazilian legislation (LexML)
`get_my_usage`	Check AI quota and billing period usage

CLI commands

legalis-mcp auth      # Authenticate via browser
legalis-mcp serve     # Start MCP server (stdio)
legalis-mcp status    # Verify authentication
legalis-mcp logout    # Remove stored credentials

Development

git clone <repo>
cd mcp
pip install -e ".[test]"

# Run unit tests (no external services needed)
pytest tests/unit/ -v

# Run integration tests (requires Docker)
cd ../integration && docker-compose up -d
cd ../mcp
LEGALIS_API_URL=http://localhost:8000 \
LEGALIS_ACCESS_TOKEN=<token> \
LEGALIS_REFRESH_TOKEN=<refresh> \
pytest tests/integration/ -v

Environment variables

Variable	Default	Description
`LEGALIS_API_URL`	`https://hai-production-612f.up.railway.app`	Backend URL
`LEGALIS_ACCESS_TOKEN`	—	Pre-issued token (CI/test only)
`LEGALIS_REFRESH_TOKEN`	—	Refresh token (CI/test only)
`LEGALIS_CREDENTIALS_FILE`	`~/.legalis/credentials.json`	Credentials file path
`LEGALIS_OAUTH_PORT`	`3742`	Local OAuth callback port

Security

Credentials are stored in ~/.legalis/credentials.json with 600 permissions (owner read/write only).
The OAuth redirect is restricted to http://localhost — open-redirect attacks are blocked at the backend.
Tokens are never stored in the MCP configuration file.
All API calls go through the existing Legalis backend — RBAC, rate limiting, and quotas apply normally.

Publishing

# PyPI
pip install build twine
python -m build
twine upload dist/*

# Then register at:
# - smithery.ai (MCP marketplace)
# - mcp.so (community directory)
# - github.com/modelcontextprotocol/servers (official list)