Skip to main content
Glama
edsonsousa

Legalis MCP Server

by edsonsousa
OverviewSchemaRelated ServersScoreDiscussions
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: Legal Document AI MCP

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 installed

A
license - permissive license
-
quality - not tested
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/edsonsousa/legalis-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server