How do I use Legalis MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Legalis MCP Server Crie um caso de rescisão indireta para João Silva" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Legalis MCP Server

by edsonsousa

Overview Schema Source Related Servers Discussions Admin

Python

Remote

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?"

Related MCP server: Argentina Legal Law MCP Server

Available tools

Cases

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
`delete_case`	Delete a case permanently

Legal documents

Tool	Description
`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…)
`update_section_text`	Manually edit a document section
`get_case_context`	Get case context (facts, parties, evidence)
`update_case_context`	Update case context
`delete_legal_document`	Delete a legal document
`export_legal_document_docx`	Export a document as DOCX

Events & Tasks

Tool	Description
`create_case_event`	Create an event on a case (internal or client-visible)
`list_case_events`	List events for a case
`delete_case_event`	Delete a case event
`create_case_task`	Create a task with due date and priority
`list_case_tasks`	List tasks for a case
`update_case_task`	Update a task's fields
`complete_case_task`	Mark a task as complete
`delete_case_task`	Delete a task
`list_upcoming_tasks`	List upcoming tasks across all cases
`list_overdue_tasks`	List all overdue tasks

Other

Tool	Description
`run_interview`	AI-guided case intake interview
`list_templates`	List available document templates
`get_template`	Get template details and sections
`search_legislation`	Search Brazilian legislation (LexML)
`get_my_usage`	Check AI quota and billing period usage

API coverage

The table below maps every Legalis backend endpoint to its MCP tool (when available).

Cases

Endpoint	Method	MCP Tool
`/api/cases`	GET	`list_cases` ✅
`/api/cases`	POST	`create_case` ✅
`/api/cases/{id}`	GET	`get_case` ✅
`/api/cases/{id}`	PUT	`update_case` ✅
`/api/cases/{id}`	DELETE	`delete_case` ✅
`/api/cases/search`	GET	`search_cases` ✅
`/api/cases/{id}/overview`	GET	—
`/api/cases/{id}/portal-token`	POST / DELETE	—

Legal documents

Endpoint	Method	MCP Tool
`/api/cases/{id}/legal-documents`	GET	`list_legal_documents` ✅
`/api/cases/{id}/legal-documents`	POST	`create_legal_document` ✅
`/api/cases/{id}/legal-documents/{doc}`	GET	`get_legal_document` ✅
`/api/cases/{id}/legal-documents/{doc}`	DELETE	`delete_legal_document` ✅
`/api/cases/{id}/legal-documents/{doc}/sections/{key}/generate`	POST	`generate_section` ✅
`/api/cases/{id}/legal-documents/{doc}/sections/{key}/text`	PUT	`update_section_text` ✅
`/api/cases/{id}/legal-documents/{doc}/export/docx`	GET	`export_legal_document_docx` ✅

Case context

Endpoint	Method	MCP Tool
`/api/cases/{id}/context`	GET	`get_case_context` ✅
`/api/cases/{id}/context`	PUT	`update_case_context` ✅
`/api/cases/{id}/context/history`	GET	—

Tasks

Endpoint	Method	MCP Tool
`/api/cases/{id}/tasks`	GET	`list_case_tasks` ✅
`/api/cases/{id}/tasks`	POST	`create_case_task` ✅
`/api/cases/{id}/tasks/{task}`	PUT	`update_case_task` ✅
`/api/cases/{id}/tasks/{task}`	DELETE	`delete_case_task` ✅
`/api/cases/{id}/tasks/{task}/complete`	POST	`complete_case_task` ✅
`/api/tasks/upcoming`	GET	`list_upcoming_tasks` ✅
`/api/tasks/overdue`	GET	`list_overdue_tasks` ✅

Events

Endpoint	Method	MCP Tool
`/api/cases/{id}/events`	GET	`list_case_events` ✅
`/api/cases/{id}/events`	POST	`create_case_event` ✅
`/api/cases/{id}/events/{event}`	DELETE	`delete_case_event` ✅

Templates & Legislation

Endpoint	Method	MCP Tool
`/api/templates`	GET	`list_templates` ✅
`/api/templates/{id}`	GET	`get_template` ✅
`/api/legislacao`	GET	`search_legislation` ✅

Usage

Endpoint	Method	MCP Tool
`/api/plans/my-usage`	GET	`get_my_usage` ✅

Not yet covered

Endpoint	Notes
`/api/cases/{id}/overview`	BFF endpoint — case + tasks + events in one call
`/api/cases/{id}/portal-token`	Share case status with clients via public link
`/api/cases/{id}/context/history`	Context version history
`/api/users/me`	User profile read/update
`/api/users/settings`	Notification and UI preferences
`/api/users/documents`	Uploaded documents (non-generated)
`/api/voice-agent/*`	Voice assistant (plan-gated feature)
`/api/corporates/{id}/users`	Team member management
`/api/subordinates/invite`	Invite team members

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)

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

Jus MCP A
io.github.mcp-dir
Brazilian legal stack in one MCP: lawsuits, court publications, case law, tenders, certificates.
Legal & Compliance Government Data
7112
Lawstronaut A
com.lawstronaut
Connect AI to millions of laws and court cases with the Lawstronaut MCP.
Legal & Compliance Research & Data Web Scraping
1631
Legal Mcp
io.github.varvararatta
MCP server for Legal
Legal & Compliance Documentation Access
2
Codey 律所管理系統OAuth
com.thecodey
Law firm management MCP: manage cases, clients, tasks, calendar and documents via Claude AI.
Legal & Compliance Project Management Calendar Management
2

Related MCP Servers

Legal Document AI MCP
Legal & Compliance AI & Machine Learning
CSOAI-ORG
A
license
Not graded
quality
B
maintenance
Legal Document AI - MCP server providing AI-powered tools and automation by MEOK AI Labs
Updated 17 days ago (2026-09-04 12:40 UTC)
7 npm
43 PyPI
MIT
Argentina Legal Law MCP Server
Legal & Compliance Documentation Access Search
guidobonomini
A
license
Not graded
quality
D
maintenance
A specialized MCP server for Argentine legal professionals, enabling legal research, document processing, case analysis, and practice management through integration with official Argentine legal databases.
Updated a year ago (2025-07-30 15:53 UTC)
8
MIT
pje-mcp-server
Legal & Compliance Government Data
ma-serra
F
license
Not graded
quality
D
maintenance
MCP server for integrating with the Brazilian PJE judicial system via MNI and BNP, enabling consultation of legal processes, communications, and precedents.
Updated 8 months ago (2026-01-11 12:30 UTC)
-
LegalMCP
Legal & Compliance Search Government Data
Mahender22
A
license
A
quality
C
maintenance
LegalMCP is a comprehensive US legal MCP server that enables AI assistants to search over 4 million US court opinions, manage Clio practice data, and access PACER federal filings through natural language.
Updated 3 months ago (2026-06-19 04:47 UTC)
18
67
MIT

Legalis MCP Server

Assistente jurídico com IA para advogados brasileiros

Quick start

1. Install

2. Authenticate

3. Configure Claude

4. Use

Available tools

Cases

Legal documents

Events & Tasks

Other

API coverage

Cases

Legal documents

Case context

Tasks

Events

Templates & Legislation

Usage

Not yet covered

CLI commands

Development

Environment variables

Security

Publishing

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Legal Document AI MCP

Argentina Legal Law MCP Server

pje-mcp-server

LegalMCP