PJE (Brazilian Electronic Court System) MCP server for AI agents

The PJE MCP Server provides integration with the Brazilian Electronic Judicial Process (PJE) system, supporting digital certificates (A1 and A3) for secure access to judicial data and process management across multiple courts.

Installation

To install the PJE MCP Server, follow these steps:

git clone https://github.com/seu-usuario/pje-mcp-server.git
cd pje-mcp-server
npm install
cp .env.example .env
# Edit the .env file with your settings
npm run build

Configuration

Basic Configuration

Edit the .env file with your court information and certificate details:

# Your court URL
PJE_BASE_URL=https://pje.tjce.jus.br
PJE_APP_NAME=pje-tjce-1g

# Digital Certificate (choose one option)
# Option 1: PFX File
PJE_CERTIFICATE_PFX_PATH=C:\certificado.pfx
PJE_CERTIFICATE_PFX_PASSWORD=senha123

# Option 2: Windows Store
PJE_CERTIFICATE_THUMBPRINT=abc123...

Claude Desktop Integration

Windows Configuration

Add to the file %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "pje": {
      "command": "node",
      "args": ["C:\\caminho\\para\\pje-mcp-server\\build\\index.js"]
    }
  }
}

Mac/Linux Configuration

Add to the file ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "pje": {
      "command": "node",
      "args": ["/caminho/para/pje-mcp-server/build/index.js"]
    }
  }
}

Using with Claude

After configuration, restart Claude Desktop and use natural language commands:

"Configure o PJE do TJCE"
"Liste meus processos"
"Busque o processo 1234567-89.2024.8.06.0001"
"Mostre os órgãos julgadores"
"Quais são minhas audiências esta semana?"

Digital Certificates

Identifying Your Certificate (Windows)

To list available certificates in Windows:

certutil -store My

Supported Certificate Types

Type	Description	Configuration
A1	File .pfx/.p12	`PJE_CERTIFICATE_PFX_PATH`
A3	Token/Smartcard	`PJE_CERTIFICATE_THUMBPRINT`

Certified Authorities

The server supports certificates from:

SERPRO
Certisign
Serasa Experian
Valid
Soluti
AC Caixa

Tested Courts

The server has been tested with:

TJCE - Ceará State Court
TRF5 - Federal Regional Court of the 5th Region
TJMG - Minas Gerais State Court
TJSP - São Paulo State Court
TJRJ - Rio de Janeiro State Court

Available Commands

Configuration Commands

pje_configurar - Configure court connection
pje_configurar_certificado - Configure digital certificate
pje_listar_certificados - List installed certificates
pje_info_certificado - Current certificate information
pje_status - Configuration status

Query Commands

pje_listar_processos - List processes with filters
pje_buscar_processo - Search for a process by number
pje_listar_orgaos_julgadores - List judicial bodies
pje_listar_classes - List procedural classes
pje_listar_assuntos - List available subjects

Troubleshooting

"Certificate not found" Error

# List available certificates
certutil -store My
# Copy the correct thumbprint to the .env file

"Command not found" Error

Completely restart Claude Desktop
Verify the path in claude_desktop_config.json

"Authentication failed" Error

Check certificate validity
Confirm the court URL
Test with another certificate

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "pje" '{"command":"node","args":["path/to/pje-mcp-server/build/index.js"]}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "pje": {
            "command": "node",
            "args": [
                "path/to/pje-mcp-server/build/index.js"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "pje": {
            "command": "node",
            "args": [
                "path/to/pje-mcp-server/build/index.js"
            ]
        }
    }
}

3. Restart Claude Desktop for the changes to take effect