PJe-Calc MCP
This server lets an AI agent operate a local PJe-Calc installation to build, validate, liquidate, update, compare, and report Brazilian labor calculations, while also reading case documents and managing the app, its tables, database, and configuration.
Manage PJe-Calc: locate, start/stop, check status/logs, open its web interface, and inspect installation info/pages.
Read documents: inventory PDFs/pages, extract page text, export scanned pages as images, and import AuditorProcessual output.
Convert transcriptions: turn holerites, timecards, FGTS statements, and TRCTs into salary histories, journeys, FGTS operations, and payments.
Model and validate calculations: get the JSON specification format/examples, validate technical and audit rules, map the procedural posture, compose the title, and generate/approve an interpretation plan.
Create and liquidate: generate
.PJCfiles, import them, create full calculations, liquidate, regenerate occurrences, check pending issues, and produce PDF/HTML reports.Execution phase: update homologated calculations with payments, honors, costs, pension, and precatório/RPV; create external calculations and batch calculations.
Compare and verify: compare against a reference calculation and audit occurrence-level differences.
Catalogs: query verbas, municipalities, CNJ subjects, enums, salary floors/transport vouchers, economic activities, holidays, and timecard options.
Tables and REST services: check/update index tables and call SELIC, precatório, and table-sync REST endpoints.
Database tools: list tables, inspect schemas, run SELECTs, execute DML/DDL with confirmation, and back up/restore H2.
Configuration: read/edit Tomcat ports, JVM memory, REST token, and H2 DataSource.
Export/cleanup: export
.PJC, list recent calculations, and delete calculations with explicit confirmation.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@PJe-Calc MCP Monte o cálculo trabalhista desta sentença e gere o arquivo .PJC"
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.
PJe-Calc MCP
Conecta assistentes de inteligência artificial instalados no seu computador — Claude Desktop, Claude Code, Codex, Cursor, VS Code e outros — ao PJe-Calc Cidadão, o programa oficial de cálculos da Justiça do Trabalho.
Você entrega ao assistente a sentença e os documentos do processo. Ele monta o cálculo trabalhista inteiro dentro do PJe-Calc, e você só confere e clica em Liquidar.
Baixar a versão estável · Instalar · Como usar · Recursos · Stack · Desenvolvimento · Contribuir · Apoiar
Não funciona em chats de IA abertos no navegador (claude.ai, chatgpt.com, Gemini, Copilot na web...) nem em aplicativos de celular. O assistente precisa rodar no mesmo computador Windows em que o PJe-Calc está instalado. Veja onde funciona e onde não funciona.
Ferramenta de apoio. O cálculo é feito pelo próprio PJe-Calc, mas quem decide o que entra nele é o assistente, a partir do que você fornecer. Confira sempre o resultado antes de usar no processo. O assistente deve mostrar as premissas que adotou e o que não estava claro nos documentos.
Use um modelo de IA de ponta. A leitura de um processo inteiro (centenas de páginas, decisões que se reformam, cartões de ponto dia a dia) exige o modelo mais capaz que você tiver: GPT-6 Luna ou superior no Codex, Claude Sonnet 5.5 ou superior (como o Claude Opus 5.5) no Claude, e o equivalente de mesma geração nos outros assistentes. Veja qual modelo usar.
Jeito mais fácil: cole o link no seu agente
Se você já usa um agente de IA instalado no computador (Claude Code, Claude Desktop, Codex, Cursor, VS Code com Copilot...), basta colar o link nele:
https://github.com/lucianumm/PJeCalcMCP
Por exemplo: "Instale e configure este MCP para mim: https://github.com/lucianumm/PJeCalcMCP". O agente baixa, instala e registra a ferramenta seguindo as instruções para o agente abaixo.
Colar o link num chat aberto no navegador (claude.ai, chatgpt.com...) não instala nada: esse chat roda nos servidores da empresa e não tem acesso ao seu computador. Ele pode até explicar o projeto, mas não consegue baixar, instalar nem operar o PJe-Calc. Se você ainda não tem um agente no computador, veja a tabela em onde funciona ou use a instalação manual, que não precisa de agente nenhum.
Importante: é preciso ter o PJe-Calc Cidadão 2.16 instalado (baixado e extraído) no computador. Esta ferramenta opera o PJe-Calc da sua máquina: ela não substitui nem inclui o programa. Sem ele, nada funciona.
Related MCP server: ms-project-mcp
O que ele faz
Monta o cálculo completo no PJe-Calc:
dados do processo e das partes, datas do contrato e salários;
faltas, férias e cartão de ponto (inclusive horas extras a partir da jornada);
verbas e reflexos, com valores mês a mês quando os documentos pedem (o pago de cada contracheque, a quantidade de um mês);
piso salarial e vale-transporte das tabelas do PJe-Calc;
FGTS, INSS, imposto de renda, pensão, previdência privada, salário-família, seguro-desemprego, com os ajustes por competência das telas de ocorrências (base e depósito do FGTS, salários e contribuições já recolhidas do INSS, inclusive em lote);
honorários (inclusive sobre verbas escolhidas), multas, custas (inclusive custas fixas, autos e armazenamento), correção monetária e juros.
Na execução, atualiza o cálculo homologado com os pagamentos (depósitos, alvarás), os honorários, multas, pensão alimentícia e custas da execução (por ato, autos e armazenamento) e o precatório ou RPV, e atualiza também uma conta feita fora do PJe-Calc (Cálculo Externo). Faz vários cálculos de uma vez (um por reclamante ou por devedor).
Ajuda a ler os documentos: lista as páginas (e as escaneadas, que precisam ser vistas como imagem), extrai o texto de PDFs e as imagens das páginas escaneadas para o assistente enxergar, e confere holerites, cartões de ponto, extrato do FGTS e TRCT transcritos (somas, meses faltantes, marcações impossíveis). Aproveita também a leitura feita pelo AuditorProcessual: separa os documentos e as folhas pelo rodapé do PJe e traz a jornada, a folha de pagamento e os eventos do contrato já organizados.
Faz a auditoria pericial integral do processo antes de calcular: cada pedido da inicial até o comando final transitado, os documentos financeiros mês a mês, os cartões de ponto dia a dia e a parametrização de cada aba do PJe-Calc, com as lacunas e contradições apontadas.
Atualiza as tabelas de índices do PJe-Calc pelo tribunal do processo antes de liquidar.
Confere o que o PJe-Calc calculou: refaz a conta por conta própria (verbas, juros, FGTS, INSS, IR, honorários, custas) e compara ao centavo com os relatórios do programa; confere a soma das verbas, os valores negativos, as verbas que ficaram sem cálculo, os critérios que o sistema aplicou e as regras de validação do próprio PJe-Calc.
Compara com outra conta (do perito, da parte ou outro cenário), inclusive um relatório em PDF ou a conta transcrita, e mostra de onde vem cada diferença.
Entrega um arquivo de cálculo (
-PRONTO.PJC) que pode ser aberto em qualquer PJe-Calc 2.16 e liquidado direto, e, quando liquida, o relatório completo do PJe-Calc em PDF (-RELATORIO.pdf): resumo, dados, faltas e férias, histórico salarial, cartão de ponto, demonstrativo de cada verba com base, divisor, multiplicador e quantidade (dias e horas), juros, FGTS, contribuição social, IR, honorários, custas e justificativa, só com as seções que se aplicam ao cálculo.
Tudo roda no seu computador. O PJe-Calc é aberto e operado em segundo plano, sem você precisar mexer nele, e nenhum dado do processo é enviado a terceiros por esta ferramenta. O assistente de IA que você usar segue as regras dele.
Onde funciona e onde não funciona
Por que precisa de um agente no computador
Esta ferramenta é um servidor MCP. MCP (Model Context Protocol) é o padrão que permite a um assistente de IA usar programas que estão no seu computador. Aqui, o assistente usa o servidor para:
abrir o PJe-Calc instalado na sua máquina e operá-lo em segundo plano;
ler os documentos do processo que estão nas suas pastas;
criar, importar, liquidar e exportar os cálculos;
gravar os arquivos
.PJCe os relatórios no seu disco.
Por isso, o assistente tem de ser um programa instalado e aberto no mesmo computador Windows em que está o PJe-Calc, e precisa aceitar servidores MCP locais. Um chat que roda no site de uma empresa não enxerga o seu computador: para ele, o PJe-Calc e os seus arquivos não existem.
Funciona (assistentes instalados no Windows)
assistente | o que é | onde baixar (site oficial) | como o MCP entra |
Claude Desktop | aplicativo da Anthropic para Windows, com chat e a aba de código | extensão de um clique ( | |
Claude Code | agente da Anthropic no terminal, no VS Code e JetBrains e no Claude Desktop | https://claude.com/product/claude-code (documentação do MCP: https://code.claude.com/docs/en/mcp) | o instalador registra sozinho (comando |
Codex | agente da OpenAI no terminal, em extensões de editor e no aplicativo | https://github.com/openai/codex (documentação: https://developers.openai.com/codex) | o instalador registra sozinho ( |
Cursor | editor de código com agente de IA | https://cursor.com/download (documentação do MCP: https://cursor.com/docs/mcp) | o instalador registra sozinho |
VS Code com GitHub Copilot no modo agente | editor da Microsoft | https://code.visualstudio.com (documentação do MCP: https://code.visualstudio.com/docs/agent-customization/mcp-servers) | o instalador registra sozinho |
Windsurf, hoje chamado Devin Desktop | editor com agente de IA | o instalador registra na configuração do Windsurf; se não aparecer no Devin Desktop, registre à mão com o |
Cada assistente tem as próprias regras de conta e de plano: confira no site dele. Qualquer outro
programa que aceite servidores MCP locais também serve; os exemplos de registro estão em
mcp-config.json.
Não funciona
onde | por quê |
Chats de IA no navegador: claude.ai, chatgpt.com, gemini.google.com, Copilot na web e semelhantes | rodam nos servidores da empresa e não têm acesso ao seu computador nem ao PJe-Calc |
Aplicativos de celular e tablet (Claude, ChatGPT, Gemini...) | o PJe-Calc só roda no Windows, no computador |
Agentes que rodam na nuvem: Claude Code na web, Codex na nuvem (pelo site do ChatGPT) e semelhantes | trabalham numa máquina virtual remota, sem o seu PJe-Calc e sem os seus arquivos |
ChatGPT, pelo site ou pelo aplicativo | só aceita conectores que ficam na internet, não servidores MCP que rodam no seu computador; da OpenAI, use o Codex |
Computador com macOS ou Linux | a ferramenta e o instalador foram feitos e testados só para o PJe-Calc no Windows |
Também não funciona com o computador desligado ou com o assistente fechado: o assistente opera o PJe-Calc enquanto conversa com você.
Qual modelo usar
O MCP confere a aritmética e as regras do PJe-Calc, mas quem lê o processo e decide o que vai para o cálculo é o modelo de IA. Modelos menores ou mais rápidos pulam páginas, confundem decisões reformadas e erram datas. Para maior precisão:
assistente | modelo recomendado |
Codex (OpenAI) | GPT-6 Luna ou superior |
Claude Desktop e Claude Code (Anthropic) | Claude Sonnet 5.5 ou superior (por exemplo, Claude Opus 5.5) |
Cursor, VS Code com Copilot, Windsurf/Devin Desktop e outros | o modelo de ponta disponível, da mesma geração dos acima |
Escolha o modelo no seletor do próprio assistente. Quando houver nível de raciocínio ("esforço", reasoning effort), use o mais alto para ler processos e montar o plano.
Modelos de gerações anteriores ou versões "mini" e "rápidas" não são recomendados para montar cálculos; servem, no máximo, para perguntas simples sobre o PJe-Calc.
Nenhum modelo dispensa a sua revisão: o plano de interpretação existe para você conferir o que o assistente entendeu antes de calcular.
Como saber se está funcionando
Depois de instalar, feche e abra o assistente de novo.
Pergunte: "Verifique se o PJe-Calc MCP está funcionando."
O assistente deve usar ferramentas que começam com
pjecalc_,calculo_,catalogo_... (por exemplo,pjecalc_status) e responder se encontrou o PJe-Calc e se ele está aberto.
Se o assistente disser que não tem essas ferramentas, ele não carregou o MCP: rode
Conferir PJe-Calc MCP.bat, que mostra o que falta, e confira se o assistente usado é um dos da
tabela acima.
O que você precisa
Um computador com Windows.
Obrigatório: o PJe-Calc Cidadão 2.16 instalado, ou seja, baixado e extraído (disponível no site oficial do TRT da 8ª Região). Pode estar em qualquer pasta: o instalador encontra sozinho.
Um assistente de IA instalado no computador e compatível com MCP: Claude Desktop, Claude Code, Codex, Cursor, VS Code com Copilot ou Windsurf/Devin Desktop (veja a tabela, com os links oficiais). Chats no navegador não servem.
Como instalar
No Claude Desktop: extensão de um clique
Baixe o arquivo
pjecalc-mcp-<versão>.mcpbda página de versões.Dê dois cliques no arquivo (ou, no Claude Desktop, abra Configurações > Extensões e arraste o arquivo para a janela) e confirme a instalação.
Pronto. Os campos da extensão são opcionais: a pasta do PJe-Calc (em branco, o MCP encontra sozinho) e a pasta dos cálculos gerados (em branco,
Documentos\PJe-Calc MCP).
O Claude Desktop já traz o Node.js; não é preciso instalar mais nada além do PJe-Calc.
Em qualquer assistente: instalador para Windows
Baixe o arquivo
.zipda página de versões e extraia em qualquer pasta.Dê dois cliques em
Instalar PJe-Calc MCP.bat. O instalador:baixa o Node.js portátil oficial se ele não estiver no computador (sem instalar nada no Windows e sem pedir senha de administrador);
procura o PJe-Calc no computador. Se houver mais de uma instalação, pergunta qual usar; se não houver nenhuma, explica o que fazer;
pergunta em quais assistentes registrar e guarda uma cópia de segurança das configurações deles;
faz um teste rápido.
Feche e abra o assistente de novo.
Outros arquivos da pasta:
Conferir PJe-Calc MCP.batmostra se está tudo funcionando e o que falta.Desinstalar PJe-Calc MCP.battira o registro dos assistentes. O PJe-Calc e os seus cálculos não são tocados.
Instruções para o agente (instalação automática)
Se você é um assistente de IA instalando esta ferramenta para o usuário:
Confirme que você roda no computador do usuário, com acesso ao disco e ao terminal do Windows, e que aceita servidores MCP locais (stdio). Se você é um chat no navegador ou um agente na nuvem, não tente instalar: explique ao usuário que ele precisa de um assistente instalado no computador (tabela em onde funciona) ou da instalação manual.
Confirme que o PJe-Calc Cidadão 2.16 está instalado. Ele fica numa pasta que tem
binetomcat, baixada e extraída do site oficial do TRT da 8ª Região. Se não estiver, peça ao usuário que baixe e extraia o PJe-Calc. Não continue sem ele.Baixe a versão mais recente e extraia numa pasta do usuário. O arquivo
PJeCalcMCP-<versão>.zipestá em https://github.com/lucianumm/PJeCalcMCP/releases/latest. Também servegit clone https://github.com/lucianumm/PJeCalcMCP.Rode o instalador na pasta extraída.
Interativo, igual a
Instalar PJe-Calc MCP.bat: pergunta em quais assistentes registrar.powershell -NoProfile -ExecutionPolicy Bypass -File instalador\iniciar.ps1 instalarSem perguntas: defina antes
$env:INSTALADOR_SIM='1'. Ele registra em todos os assistentes encontrados.
O instalador garante o Node.js 20 ou mais novo (baixa o portátil oficial se faltar), localiza o PJe-Calc, registra o servidor com cópia de segurança das configurações e faz um teste. Se o PJe-Calc estiver numa pasta que ele não encontre, defina
PJECALC_HOMEcom essa pasta.Alternativa: registre só o seu próprio assistente. Use o servidor MCP (stdio)
node <pasta>\server\server.mjs, comPJECALC_HOMEapontando para o PJe-Calc. Omcp-config.jsontem exemplos para Claude, Codex, Cursor, VS Code e Windsurf. No Claude Code:claude mcp add pjecalc --scope user -e PJECALC_HOME=<pasta do PJe-Calc> -- node <pasta>\server\server.mjs.Confira a instalação. Rode
instalador\iniciar.ps1 conferire peça ao usuário que reabra o assistente.Para montar cálculos, siga o
SKILL.md. Comece pedindo os documentos (calculo_documentos_necessarios) e nunca grave cálculos direto no banco do PJe-Calc.
Como usar
Converse normalmente com o assistente, por exemplo:
Monte no PJe-Calc o cálculo desta sentença. Seguem a sentença, o acórdão, os holerites e os cartões de ponto.
Ou, para uma análise completa antes de calcular:
Faça a auditoria pericial integral deste processo e me mostre o plano.
O assistente:
identifica a fase do processo e os outros processos ligados a ele (ação anterior, coletiva, acordo, recuperação judicial...);
pede os documentos que o caso exige (sentença, acórdãos, holerites, cartões de ponto, TRCT, extrato do FGTS, documentos dos outros processos...) e confere se cobrem todo o período;
lê todas as páginas, inclusive as escaneadas, e pede os complementos que faltarem;
monta o título a partir de todas as decisões (vara, TRT, TST, STF, liquidação e execução);
mostra um plano de interpretação para você aprovar antes de calcular;
monta o cálculo no PJe-Calc e atualiza as tabelas de índices do seu tribunal;
mostra os valores, o que foi conferido e o arquivo pronto.
Na execução, por exemplo:
Atualize até hoje o cálculo homologado (arquivo anexo), abatendo o depósito de fl. 300 e o alvará de fl. 330, e inclua os honorários da execução.
Depois é só abrir o PJe-Calc, escolher o cálculo em "Abrir Cálculos Recentes", conferir e clicar em Operações > Liquidar.
Como funciona, em poucas palavras
O PJe-Calc tem uma função oficial de exportar e importar cálculos (arquivos .PJC). Esta ferramenta
monta esse arquivo a partir do que o assistente extraiu dos documentos.
Ela importa o arquivo no PJe-Calc do seu computador e usa as próprias telas do programa para os passos finais: regerar as verbas, apurar o cartão de ponto, atualizar tabelas, liquidar e, na execução, liquidar a atualização. Assim, todas as contas são feitas pelo motor oficial do PJe-Calc.
A ferramenta foi testada comparando cálculos montados por ela com os mesmos cálculos feitos à mão na tela do PJe-Calc, inclusive atualizações com pagamentos e cálculos externos. Os resultados foram idênticos, centavo por centavo.
Stack e arquitetura
Camada | Tecnologia | Papel no projeto |
Servidor local | Node.js >=20 e JavaScript ESM ( | Executa as ferramentas, lê documentos e gera os arquivos do cálculo. |
Protocolo | MCP SDK 2.3.1 ( | Conecta o agente ao servidor por entrada e saída padrão, sem hospedar um endpoint MCP na internet. |
Validação | Zod 4.4.3 e validadores do projeto | Descreve os parâmetros das ferramentas e confere as especificações antes da importação. |
Integração com o aplicativo | HTTP nativo do Node.js, formulários JSF/RichFaces e serviços REST locais | Opera a instalação do PJe-Calc e aciona o motor oficial pelas telas do programa. |
Inicialização | Utilitário Java com alvo Java 8 | Inicia o PJe-Calc em segundo plano usando a JRE que acompanha o aplicativo. |
Instalação | PowerShell, Batch e Node.js | Localiza o PJe-Calc e registra o MCP nos assistentes do Windows. |
Distribuição | ZIP e extensão MCPB | Oferece instalação para agentes locais e para o Claude Desktop. |
Verificação | Scripts Node.js e GitHub Actions no Windows | Testa protocolo, catálogos, validações e geração de |
flowchart TD
A[Agente de IA no Windows] -->|MCP / stdio| B[Servidor Node.js]
B --> C[Documentos e especificação JSON]
C --> D[Arquivo .PJC]
D -->|Importação e operações por HTTP local| E[PJe-Calc Cidadão 2.16]
E -->|Motor oficial| F[.PJC pronto e relatório PDF]O código do servidor é JavaScript; o SDK MCP é distribuído com o projeto, junto com o Zod, em
server/node_modules/. Uma cópia completa do repositório já contém essas
dependências e pode ser executada sem npm install.
O Tomcat, a JRE e o banco H2 pertencem à instalação do PJe-Calc, que deve ser obtida separadamente.
A montagem dos cálculos usa importação de .PJC e operações do aplicativo; não se deve gravar
cálculos diretamente no H2. O agente de IA e sua conexão com o provedor são configurados no próprio
assistente.
Desenvolvimento
Com Git e Node.js >=20 no Windows:
git -c core.autocrlf=false clone https://github.com/lucianumm/PJeCalcMCP.git
cd PJeCalcMCP
node scripts/test-mcp.mjsA opção do clone preserva os finais de linha LF usados pelos arquivos de teste no Windows. A suíte offline testa o servidor sem exigir o PJe-Calc instalado e é a mesma executada pelo GitHub Actions.
Para registrar o servidor em um agente, use node <pasta>\server\server.mjs e os exemplos do
mcp-config.json. As variáveis opcionais são:
Variável | Para que serve |
| Fixa a pasta do PJe-Calc, que contém |
| Escolhe a pasta dos |
Os testes de integração em scripts/test-ponta-a-ponta.mjs
exigem o PJe-Calc 2.16 e operam uma instalação real: criam, liquidam e excluem cálculos de teste
e trocam as tabelas regionais. Use uma instalação separada para testes; o preparo está em
CONTRIBUTING.md.
Contribuições e suporte
Para relatar uma falha ou sugerir um recurso, use os modelos de issue. Inclua versões, passos para reproduzir e um exemplo fictício ou anonimizado. Não publique documentos de processos, dados pessoais ou credenciais.
Contato: contato@lumenaxis.dev.br.
Perguntas frequentes
Funciona no ChatGPT, no Claude ou no Gemini pelo navegador? Não. Chats no navegador e aplicativos de celular rodam nos servidores da empresa e não alcançam o seu computador, onde estão o PJe-Calc e os documentos. Use um assistente instalado no Windows: Claude Desktop, Claude Code, Codex, Cursor, VS Code com Copilot ou Windsurf/Devin Desktop (links na tabela).
Tenho conta no ChatGPT. Posso usar? Pelo site ou aplicativo do ChatGPT, não. Da OpenAI, o que funciona é o Codex instalado no computador (https://github.com/openai/codex). O Codex na nuvem, aberto pelo site, também não serve, porque roda numa máquina remota.
Tenho conta no Claude. Posso usar? Sim, pelo Claude Desktop (https://claude.com/download) ou pelo Claude Code (https://claude.com/product/claude-code), instalados no computador. Pelo site claude.ai, pelo aplicativo de celular ou pelo Claude Code na web, não.
Preciso saber programar? Não. Depois de instalado, você conversa normalmente com o assistente. O Claude Code e o Codex podem rodar no terminal, mas também têm aplicativo ou extensão de editor; o Claude Desktop é um aplicativo comum.
Onde ele procura o PJe-Calc? Nesta ordem:
na pasta escolhida da última vez;
no PJe-Calc que estiver aberto;
na pasta onde a ferramenta foi extraída;
em Downloads, Área de Trabalho, Documentos, Arquivos de Programas e na raiz dos discos.
Se você mudar o PJe-Calc de pasta, ele procura de novo sozinho.
Precisa de internet? Só para baixar o Node.js na instalação e para atualizar as tabelas de índices do PJe-Calc.
Posso usar com mais de um assistente? Sim. O instalador registra em todos os que você escolher.
O resultado é garantido? Não. O PJe-Calc calcula corretamente o que foi informado, mas a interpretação da sentença e dos documentos precisa ser conferida por você. Para facilitar, cada informação do cálculo fica ligada ao documento e ao trecho da decisão de onde saiu, e a ferramenta informa em que ponto o cálculo está:
aceito pelo aplicativo: o PJe-Calc aceitou;
calculado: os números foram conferidos, inclusive se nenhuma verba ficou sem cálculo;
simulação: a conta depende de uma hipótese ainda não decidida (por exemplo, um recibo contestado);
auditado: cada item tem origem na prova e na decisão que vale, sem dúvidas abertas, com os alertas revisados e o plano aprovado por você;
provisório: marcado quando ainda há decisão sujeita a recurso.
Em todos os casos, a revisão final é sua. O cálculo também deixa um registro com as versões e os dados usados, para poder ser reproduzido depois.
Onde estão as instruções
SKILL.md: as regras que o assistente segue, do começo ao fim do cálculo.references/: todos os campos aceitos, o contrato de dados, o roteiro de auditoria pericial e as conferências por assunto (leitura, jornada, pagamentos, FGTS e tributos, atualização, execução, conta de referência).exemplos/: cálculos completos prontos para usar como modelo.scripts/: os testes.
Apoie o projeto
Se esta ferramenta poupou seu tempo, considere apoiar com um café pelo QR Code Pix acima. A contribuição ajuda a acompanhar novas versões do PJe-Calc e das tabelas, corrigir falhas e incluir novos tipos de cálculo.
Autoria e manutenção
Criado e mantido por Lucianum — Instagram @lucianum · GitHub @lucianumm
Aviso
Projeto independente, sem vínculo com a Justiça do Trabalho. O PJe-Calc Cidadão não faz parte deste repositório e deve ser baixado no site oficial.
Licença
Copyright (C) 2026 Lucianum.
Distribuído sob a GNU Affero General Public License v3.0 (AGPL-3.0). Você pode usar, estudar, modificar e redistribuir livremente. Quem distribuir uma versão modificada, ou oferecê-la como serviço pela rede, deve publicar o código-fonte sob a mesma licença.
Available Tools
72 toolsauditor_importarImportar a leitura do AuditorProcessualARead-onlyIdempotent
Lê a saída do AuditorProcessual (github.com/lucianumm/AuditorProcessual): as pastas do ingest_document.py (uma por arquivo: manifest.json, pages.jsonl, pendências) e, se houver, o livro-razão da jornada e da folha (labor_ledger), os eventos do contrato (labor_events) e a revisão com os fatos (página e trecho). Devolve sugestões para a especificação: contrato.documentos por peça (com o tipo provável), contrato.leitura (páginas sem texto nativo a ver como imagem, falhas de extração), o número do processo mais citado e os demais citados, apuracaoCartaoPonto.jornadas com as conferências do conversor de cartões, contrato.remuneracoes, contrato.pagamentos, contrato.afastamentos e datas do contrato, cada item com documento, folha e trecho quando os fatos os trazem. Sugestão não é leitura: confira cada página. Veja pjecalc://docs/modulos/leitura.
Inputs: pastas (required), ledger, eventos, prefixo, +3 more.
calculo_aprovar_planoRegistrar a aprovação do plano pelo usuárioA
Use SOMENTE depois que o usuário aprovou o plano de interpretação na conversa. Devolve o objeto contrato.aprovacao (quem, quando, observações, hash do contrato aprovado) para gravar na especificação; com arquivo_json e gravar=true, grava no próprio arquivo. Recusa se a auditoria tiver falhas. Qualquer mudança posterior no contrato ou no cenário invalida a aprovação.
Inputs: por (required), gravar, observacoes, arquivo_json, +1 more.
calculo_apurar_cartao_pontoApurar o cartão de ponto (jornadas) de um cálculoA
Para um cálculo já no PJe-Calc com apurações de cartão de ponto cadastradas: salva cada apuração (o PJe-Calc gera as jornadas pela programação/escala, respeitando feriados, férias e faltas), clica em Apurar Cartão de Ponto (cria as colunas Hs EXT, Hs Trabalhadas, Hs Noturnas...) e, se pedido, liga verbas às colunas (quantidade ou divisor importados do cartão). Devolve o quadro mensal apurado. O botão Apurar só existe enquanto o cálculo não tem cartões; para refazer, exclua os cartões em Cartão de Ponto > Visualizar Cartão.
Inputs: id_calculo (required), regerar, vinculos.
calculo_atualizarAtualizar cálculo homologado (execução: pagamentos e eventos)A
Fase de execução: atualiza um cálculo LIQUIDADO (arquivo_pjc exportado depois de liquidar, ou id_calculo) com o bloco "execucao": dataAtualizacao, pagamentos (com a divisão entre crédito do reclamante, recolhimentos, outros débitos e débitos a cobrar), honorários e multas da execução, pensão alimentícia, custas da execução (fixas, autos e armazenamento), precatório ou RPV, cobrarEncargosIrpf. Todos os campos e exemplos em pjecalc://docs/modulos/execucao e em calculo_modelo_json (exemplos "execucao" e "execucao-pensao-custas"). Confere antes de importar as regras da tela de pagamento do PJe-Calc (MSG0125 a MSG0138, MSG0181, MSG0126, MSG0003), grava os eventos numa CÓPIA do cálculo, roda "Liquidar Atualização" (rateio e imputação do próprio PJe-Calc) e devolve o Resumo da Atualização (saldo por credor, total do reclamado, eventos), as verificações e o "-ATUALIZADO.PJC". O cálculo de origem não é alterado.
Inputs: execucao (required), destino, iniciar, id_calculo, +1 more.
calculo_comparar_referenciaComparar com uma conta de referênciaARead-onlyIdempotent
Compara o cálculo com uma conta de referência (perito, parte, outro cenário) na mesma data-base. Cada lado é um cálculo do PJe-Calc (id) ou um .PJC exportado depois de liquidar (arquivo). Compara primeiro quantidades e valores nominais por ocorrência (com a causa local de cada diferença: quantidade, base, divisor, multiplicador, pago), depois a ponte por verba (nominal -> corrigido -> juros -> total, com o resíduo em relação ao bruto) e a ponte bruto -> FGTS/depósito/INSS/IR -> líquido. Não altera os cálculos. Igualdade de totais não substitui igualdade das ocorrências. Veja pjecalc://docs/modulos/referencia.
Inputs: data_base, id_calculo, tolerancia, id_referencia, +3 more.
calculo_criarCriar cálculo completo no PJe-CalcA
Fluxo completo e recomendado para montar um cálculo. Valida a especificação, gera o .PJC, inicia o PJe-Calc se preciso, importa, apura o cartão de ponto por jornadas e liga as verbas às colunas, regera as ocorrências de verbas e reflexos e devolve o número do cálculo, as pendências da tela de liquidação e o "-PRONTO.PJC" (importável em qualquer PJe-Calc 2.16.x). Com liquidar_em, liquida e confere: justificativa, soma do resumo, recálculo independente das ocorrências e dos encargos, especificação × arquivo × relatório; grava o -LIQUIDADO.PJC, o relatório completo -RELATORIO.pdf e o registro de reprodução. Devolve "estado" (rascunho, aceito_pelo_aplicativo, calculado, simulacao, auditado), "verificacoes" e "bloqueiosDeEntrega"; a revisão para entrega é sempre humana. Com contrato de dados, não gera nada enquanto faltar documento obrigatório, houver falha na auditoria ou o plano de interpretação não estiver aprovado: devolve as travas e o pedido de documentos.
Inputs: destino, iniciar, liquidar_em, arquivo_json, +4 more.
calculo_criar_loteCriar vários cálculos (lote: um por reclamante ou por devedor)A
Roda calculo_criar para cada especificação da lista (litisconsórcio ativo: um cálculo por reclamante; responsabilidade subsidiária ou sucessiva: um por devedor, com o período de cada um; cenários). Cada item passa pelas mesmas travas (documentos, mapa, título, aprovação). Devolve, por item, o número do cálculo, o estado, os totais e as falhas, e o consolidado (soma dos brutos, líquidos e totais dos itens liquidados). Um item com erro não interrompe os outros.
Inputs: liquidar_em, arquivos_json, especificacoes, ignorar_tabelas, +1 more.
calculo_documentos_necessariosDocumentos necessários ao cálculo (pedido ao usuário)ARead-onlyIdempotent
PRIMEIRO PASSO de todo cálculo. Diz quais documentos o caso exige (sentença, decisões posteriores, registro, TRCT, holerites de todo o período, cartões de ponto, recibos de férias e 13º, extrato do FGTS, norma coletiva...), confere se os recebidos cobrem todos os meses, lista as perguntas que só o usuário responde e devolve um texto pronto para pedir o que falta ("pedido"). Use com a especificação (mesmo parcial, com contrato.documentos e contrato.coleta) ou, antes dela, com respostas rápidas: parcelas deferidas, datas e documentos já recebidos. Repita a cada rodada até "completa": true. Veja pjecalc://docs/modulos/documentos.
Inputs: admissao, demissao, parcelas, arquivo_json, +2 more.
calculo_excluirExcluir cálculo do PJe-CalcADestructiveIdempotent
Exclui um cálculo do PJe-Calc (Operações > Excluir). IRREVERSÍVEL: exige confirmacao = "SIM, EXCLUIR". Faça calculo_exportar_pjc antes se quiser guardar.
Inputs: id_calculo (required), confirmacao (required).
calculo_exportar_pjcExportar cálculo do PJe-Calc (.PJC)AIdempotent
Exporta um cálculo do PJe-Calc como .PJC (Operações > Exportar) — útil para backup, para enviar a terceiros ou para conferir com calculo_ler_pjc.
Inputs: id_calculo (required), destino.
calculo_externo_criarCálculo Externo (conta homologada feita fora do PJe-Calc)A
Cria no PJe-Calc um Cálculo Externo: a conta homologada feita fora do aplicativo (perito, contadoria, acordo), com os valores consolidados na data-base, para o PJe-Calc atualizar. Preenche pela interface as telas "Novo Cálculo Externo" (processo, partes, data-base, índice, juros, FGTS, IR, contribuição social, custas) e "Parcelas Atualizáveis" (creditos, descontos, outrosDebitos, debitosReclamante); ao salvar, o próprio PJe-Calc converte as parcelas num cálculo liquidado na data-base. Todos os campos e um exemplo em pjecalc://docs/modulos/execucao e em calculo_modelo_json (exemplo "externo"). Exporta o .PJC e, com "execucao", atualiza a cópia como calculo_atualizar.
Inputs: calculoExterno (required), destino, iniciar.
calculo_gerar_pjcGerar arquivo .PJCA
Gera o arquivo .PJC (formato oficial de exportação/importação do PJe-Calc) a partir da especificação. Não precisa do PJe-Calc aberto. O arquivo pode ser importado em qualquer PJe-Calc 2.16.x (Cálculo > Importar). Depois da importação é preciso clicar em Verbas > Regerar (ou usar calculo_importar_pjc, que faz isso). Com "apuracaoCartaoPonto" grava também .mcp.json com os passos pós-importação (apurar o cartão e ligar as verbas às colunas), que calculo_importar_pjc executa.
Inputs: destino, arquivo_json, especificacao.
calculo_importar_pjcImportar .PJC no PJe-CalcA
Importa um arquivo .PJC (gerado pelo MCP ou exportado de outro PJe-Calc) no PJe-Calc em execução, executa os passos pós-importação de .mcp.json se existir (apuração do cartão de ponto e vínculos das verbas), regera as ocorrências (padrão) e devolve número do cálculo e pendências.
Inputs: arquivo (required), iniciar, regerar, exportar_final.
calculo_ler_pjcLer um arquivo .PJCARead-onlyIdempotent
Resumo legível de um .PJC: processo, partes, datas, históricos salariais, verbas (base, quantidade, reflexos ativos), férias, faltas, FGTS, honorários, multas, correção e juros. Serve para conferir um arquivo gerado ou entender um cálculo exportado.
Inputs: arquivo (required).
calculo_liquidarLiquidar cálculo (teste ou a pedido do usuário)AIdempotent
Liquida o cálculo no PJe-Calc (Operações > Liquidar) e devolve os totais do Resumo do Cálculo (bruto, líquido, total devido pelo reclamado, valores por verba). Normalmente quem liquida é o usuário; use para conferir o resultado ou quando ele pedir.
Inputs: id_calculo (required), regerar, regional, data_liquidacao, +3 more.
calculo_modelo_jsonFormato da especificação do cálculoARead-onlyIdempotent
Devolve a documentação completa do JSON que descreve um cálculo (processo, calculo, historicosSalariais, faltas, ferias, cartoesDePonto, apuracaoCartaoPonto, verbas, fgts, contribuicaoSocial, irpf, pensaoAlimenticia, previdenciaPrivada, salarioFamilia, seguroDesemprego, honorarios, multas, custas, correcaoJuros...) e exemplos testados. LEIA ANTES de montar um cálculo.
Inputs: exemplo, somente_exemplo.
calculo_pendenciasPendências do cálculo (validação do PJe-Calc)ARead-onlyIdempotent
Abre o cálculo no PJe-Calc e lê o quadro "Pendências do Cálculo" da tela Liquidar, SEM liquidar: erros (impedem a liquidação) e alertas. É a validação oficial do aplicativo.
Inputs: id_calculo (required).
calculo_plano_interpretacaoPlano de interpretação (para o usuário aprovar)ARead-onlyIdempotent
Gera o plano de interpretação legível (markdown) a partir do contrato e da especificação: processo, fase e processos ligados; matriz do título; cada parcela com comando, folha, trecho, período, reflexos e como será calculada no PJe-Calc; critérios gerais; eventos, pagamentos e destinos do crédito; premissas; conflitos, alertas, pendências e perguntas. MOSTRE o plano ao usuário e peça a aprovação ANTES de calcular. Devolve o hash do contrato a ser aprovado.
Inputs: arquivo_json, especificacao.
calculo_recentesCálculos recentes no PJe-CalcBRead-onlyIdempotent
Lista "Abrir Cálculos Recentes" da tela inicial do PJe-Calc (número / processo / reclamante).
Inputs: no named parameters.
calculo_regerar_ocorrenciasRegerar ocorrências das verbasADestructiveIdempotent
Verbas > selecionar todas (inclusive reflexos ativos) > Regerar. Necessário depois de importar ou de mudar parâmetros. manter_alteracoes=true preserva ocorrências editadas à mão.
Inputs: id_calculo (required), manter_alteracoes.
calculo_relatorioRelatório do cálculo liquidadoAIdempotent
Gera o relatório do PJe-Calc (Operações > Imprimir) de um cálculo já liquidado. Padrão: o relatório COMPLETO, com as seções que se aplicam ao cálculo (resumo, dados, faltas e férias, histórico salarial, cartão de ponto mensal e diário, demonstrativo das verbas com base, divisor, multiplicador e quantidade, juros, FGTS, contribuição social, eSocial, IR, multas, honorários, custas, justificativa). Formato HTML devolve o texto (e os totais extraídos do Resumo); formato PDF grava o arquivo. Tipos avulsos: RESUMO_DE_CALCULO, DADOS_DO_CALCULO, DEMONSTRATIVO_DE_CALCULO, APURACAO_DE_JUROS, DEMONSTRATIVO_FGTS, DEMONSTRATIVO_INSS, DEMONSTRATIVO_IRPF, DEMONSTRATIVO_HONORARIO, DEMONSTRATIVO_CUSTAS, DEMONSTRATIVO_MULTA, HISTORICO_SALARIAL, FALTAS_E_FERIAS, JUSTIFICATIVA, RESUMO_PRECATORIO, DEMONSTRATIVO_ESOCIAL_INSS_FGTS.
Inputs: id_calculo (required), tipos, formato, arquivo_pdf, +1 more.
calculo_validarValidar especificação do cálculoARead-onlyIdempotent
Validação técnica + auditoria, SEM gerar arquivo nem tocar no PJe-Calc. A auditoria (campo "auditoria") confere o contrato de dados: cada verba, reflexo, histórico e abatimento ligado a decisões e documentos, pagamento usado duas vezes, salário fora da vigência, trabalho em afastamento, ciclo de escala, base duplicada etc.; sem contrato fica "não verificado". Validação técnica: datas, número CNJ (dígito verificador), CPF/CNPJ, município, nomes de verbas e reflexos do catálogo, históricos usados como base, enums. Devolve erros (impedem gerar), avisos e um resumo do que será montado (verbas ativas, férias calculadas etc.).
Inputs: arquivo_json, especificacao.
cartoes_para_jornadasCartões de ponto transcritos -> jornadasARead-onlyIdempotent
Recebe as marcações dia a dia ({ data, marcacoes: ["08:00","12:00",...] } ou { data, turnos } ou { data, ocorrencia: FOLGA|FERIAS|FALTA|ATESTADO|FERIADO|DSR }) e devolve apuracaoCartaoPonto.jornadas. Acusa dia do período sem registro, número ímpar de marcações, turnos impossíveis (sobrepostos, > 16 h, > 20 h no dia), interjornada < 11 h e horários invariáveis (Súmula 338, III, do TST).
Inputs: dias (required), periodo, dias_sem_marcacao.
catalogo_assuntos_cnjAssuntos CNJARead-onlyIdempotent
Assuntos da Tabela Processual Unificada do CNJ cadastrados no PJe-Calc (código para verbas personalizadas: verbas[].personalizada.assuntoCnj).
Inputs: filtro.
catalogo_atividadesAtividades econômicas (INSS por atividade)ARead-onlyIdempotent
Atividades econômicas da tabela do PJe-Calc (id e descrição), para contribuicaoSocial.atividadeEconomica (alíquotas do empregador pela atividade).
Inputs: filtro.
catalogo_cartao_pontoOpções da apuração do cartão de pontoARead-onlyIdempotent
Colunas criadas por "Apurar Cartão de Ponto" (nomes aceitos em verbas[].quantidade.cartao e divisor.cartao), critérios de horas extras, preenchimentos, tipos de escala e horários noturnos aceitos em apuracaoCartaoPonto.
Inputs: no named parameters.
catalogo_enumsValores aceitos (enums do PJe-Calc)ARead-onlyIdempotent
Constantes aceitas pelos campos do PJe-Calc (ex.: IndiceMonetarioEnum, JurosEnum, TipoHonorarioEnum, SituacaoDaFeriasEnum, BaseDeCalculoDoPrincipalEnum). Sem argumento lista os nomes dos enums; com "classe" lista os campos enum de uma entidade (ex.: Fgts, Honorario, ParametrosDeAtualizacao).
Inputs: nome, classe.
catalogo_feriadosFeriados e pontos facultativosBRead-onlyIdempotent
Feriados (tipo F) e pontos facultativos (tipo P) do PJe-Calc: nacionais (abrangência F), estaduais (E) e municipais (M). Pontos facultativos são marcados no cálculo pelo nome em calculo.pontosFacultativos.
Inputs: uf, tipo, filtro, municipio.
catalogo_municipiosMunicípios do PJe-CalcARead-onlyIdempotent
Procura municípios (nome/UF/id) da tabela do PJe-Calc, para preencher calculo.uf e calculo.municipio.
Inputs: uf, nome.
catalogo_pisos_vtPisos salariais e vales-transporte cadastrados no PJe-CalcARead-onlyIdempotent
Lista as tabelas "Pisos Salariais" e "Vale-transporte" do PJe-Calc do usuário (id, nome ou linha, UF, município, período), lidas do banco por modelos_atualizar com alvo "catalogos" (PJe-Calc parado). Use o id em verbas[].base { tipo: "SALARIO_DA_CATEGORIA", piso: id } ou { tipo: "VALE_TRANSPORTE", valesTransporte: [ids] } (e em valorPago). O piso ou a linha precisa ser do mesmo estado (e município, no vale-transporte) dos parâmetros do cálculo. Se a tabela não existir no PJe-Calc do usuário, informe o piso da norma coletiva como histórico salarial (base HISTORICO_SALARIAL), com a origem na cláusula.
Inputs: uf, nome.
catalogo_validar_documentosValidar número CNJ, CPF e CNPJBRead-onlyIdempotent
Confere dígitos verificadores (o PJe-Calc recusa número de processo com dígito errado) e devolve o dígito CNJ correto.
Inputs: cpf, cnpj, numero_processo.
catalogo_verbasCatálogo de verbas (Expresso)ARead-onlyIdempotent
Verbas do lançamento "Expresso" do PJe-Calc com seus parâmetros padrão (característica, ocorrência de pagamento, incidências, base, divisor, multiplicador, quantidade) e a lista de reflexos disponíveis para cada uma. Use os nomes exatamente como aparecem aqui em "verbas[].verba" e "verbas[].reflexos".
Inputs: filtro.
config_datasourceLer/alterar DataSource H2ADestructiveIdempotent
Sem argumentos: lê o DataSource jdbc/pjeCalcDS de META-INF/context.xml. Com argumentos: altera url/username/password (backup automático). ATENÇÃO: mudar a url pode apontar para outro banco.
Inputs: url, senha, usuario.
config_lerLer arquivo de configuraçãoBRead-onlyIdempotent
Conteúdo de um arquivo de configuração do PJe-Calc (server.xml, context.xml, catalina.properties, .bat de inicialização, url_tribunal.properties, persistence.xml, web.xml). Arquivos são ISO-8859-1.
Inputs: arquivo (required).
config_memoriaLer/alterar memória da JVMADestructiveIdempotent
Sem argumentos: lê Xms/Xmx dos .bat. Com argumentos: altera -Xms/-Xmx nos dois .bat (backup automático). Valores em MB. Reinicie o app para aplicar.
Inputs: xms, xmx.
config_portasLer/alterar portas do TomcatADestructiveIdempotent
Sem argumentos: lê as portas atuais. Com argumentos: altera http/ajp/shutdown no tomcat/conf/server.xml (apenas conectores ativos; comentários preservados; backup automático .mcp-backup-). O launcher usa a porta HTTP para abrir a interface e troca de porta automaticamente se estiver ocupada.
Inputs: ajp, http, shutdown.
config_tokenLer/alterar token dos serviços RESTADestructiveIdempotent
Sem argumentos: mostra o token atual (seguranca.pjecalc.tokenServicos dos .bat). Com novo_token: substitui nos dois .bat (backup automático). O token protege os endpoints /servico/rest/*; o header HTTP é Authentication: Base64(token).
Inputs: novo_token.
db_backup_arquivoBackup físico do banco (cópia do .h2.db)A
Copia o arquivo .dados/pjecalc.h2.db byte a byte. Funciona mesmo com o app em execução? Não — copie sempre com o app parado para garantir consistência. O PJe-Calc mantém o banco bloqueado enquanto está em execução. Encerre o aplicativo (pjecalc_parar) antes de usar as ferramentas de banco.
Inputs: arquivo.
db_backup_sqlBackup lógico do banco (SQL)A
Gera backup completo (schema + dados, ~9 MB) em SQL usando org.h2.tools.Script com a JRE do próprio PJe-Calc. O PJe-Calc mantém o banco bloqueado enquanto está em execução. Encerre o aplicativo (pjecalc_parar) antes de usar as ferramentas de banco.
Inputs: arquivo.
db_consultarConsultar o banco H2 (SELECT)ARead-onlyIdempotent
Executa um SELECT no banco H2 (somente leitura) e devolve até max_linhas registros. Use db_tabelas/db_esquema para descobrir nomes. Ex.: SELECT * FROM TBSELICDIARIA ORDER BY DDTDIAINDICE DESC. O PJe-Calc mantém o banco bloqueado enquanto está em execução. Encerre o aplicativo (pjecalc_parar) antes de usar as ferramentas de banco.
Inputs: sql (required), max_linhas.
db_esquemaEsquema de uma tabela H2ARead-onlyIdempotent
Colunas (nome, tipo, nulidade, default) de uma tabela do banco H2. O PJe-Calc mantém o banco bloqueado enquanto está em execução. Encerre o aplicativo (pjecalc_parar) antes de usar as ferramentas de banco.
Inputs: tabela (required).
db_executarExecutar DML/DDL no banco H2ADestructiveIdempotent
Executa INSERT/UPDATE/DELETE/DDL no banco H2. PERIGOSO: exige confirmacao = "SIM, EXECUTAR" e cria backup do arquivo .h2.db antes. NÃO use para criar ou alterar cálculos: inserções diretas não avançam as sequências do Hibernate e o PJe-Calc passa a falhar com "Registro duplicado" ao criar cálculos (aconteceu nesta instalação). Para cálculos use calculo_criar. O PJe-Calc mantém o banco bloqueado enquanto está em execução. Encerre o aplicativo (pjecalc_parar) antes de usar as ferramentas de banco.
Inputs: sql (required), confirmacao (required).
db_restaurarRestaurar banco a partir de SQLADestructiveIdempotent
Restaura o banco executando um arquivo SQL (gerado por db_backup_sql) via org.h2.tools.RunScript. DESTRUTIVO: exige confirmacao = "SIM, RESTAURAR" e faz backup do .h2.db atual antes. O PJe-Calc mantém o banco bloqueado enquanto está em execução. Encerre o aplicativo (pjecalc_parar) antes de usar as ferramentas de banco.
Inputs: arquivo (required), confirmacao (required).
db_tabelasListar tabelas do banco H2ARead-onlyIdempotent
Tabelas do esquema PUBLIC do banco embutido (.dados/pjecalc.h2.db, 151 tabelas: cálculo, verbas, fórmulas, índices, INSS, IRPF, FGTS, precatórios etc.). O PJe-Calc mantém o banco bloqueado enquanto está em execução. Encerre o aplicativo (pjecalc_parar) antes de usar as ferramentas de banco.
Inputs: no named parameters.
documento_imagensImagens das páginas escaneadas de um PDFAIdempotent
Grava em arquivos as imagens das páginas de um PDF (JPEG como está; as demais em PNG), sem depender de programa externo, para você VER as páginas escaneadas: holerites, cartões de ponto, TRCT, recibos, atestados. Por página, a imagem "principal" (a maior) é em geral a página inteira; logotipos pequenos ficam de fora. Use nas páginas que documento_inventario marca sem texto (o carimbo de assinatura do PJe não conta como texto). Formatos CCITT, JBIG2 e JPEG 2000 não são convertidos e aparecem em "avisos". O MCP não faz OCR: leia a imagem e transcreva com a folha.
Inputs: arquivo (required), destino, paginas.
documento_inventarioInventário dos documentos (arquivos e páginas)ARead-onlyIdempotent
Lista cada arquivo (PDF, imagem, texto): hash sha256, número de páginas, páginas com e sem texto (as sem texto são escaneadas e precisam ser VISTAS como imagem), páginas com imagem, tipo provável (sentença, TRCT, holerites, cartões, extrato do FGTS...) e números de processo citados. Devolve a sugestão de contrato.documentos e o esqueleto de contrato.leitura (classificar TODAS as páginas: usadas, irrelevantes com motivo, ilegíveis com pedido). Use logo que receber os documentos (etapa 2). Veja pjecalc://docs/modulos/leitura.
Inputs: pasta, prefixo, arquivos, processo.
documento_textoTexto de um documento por páginaARead-onlyIdempotent
Texto extraído página por página de um PDF (ou arquivo de texto), para localizar trechos e conferir números. Página sem texto próprio vem marcada (o carimbo de assinatura do PJe não conta): é escaneada, veja como imagem com documento_imagens (o MCP não faz OCR). O texto pode sair fora da ordem visual das colunas: confira sempre na página.
Inputs: arquivo (required), paginas, max_caracteres.
extrato_para_fgtsExtrato do FGTS -> depósitos (fgts.operacoes)ARead-onlyIdempotent
Recebe os lançamentos do extrato analítico do FGTS ({ competencia, data, valor, tipo: DEPOSITO|JAM|SAQUE|MULTA }) e o saldo final; devolve fgts.operacoes (depósitos e saques a deduzir), os depósitos por competência e as conferências: soma dos lançamentos = saldo; competências do período sem depósito.
Inputs: lancamentos (required), saldo, periodo, documento.
holerites_para_historicosHolerites transcritos -> históricos salariaisARead-onlyIdempotent
Recebe a transcrição dos holerites (competência, rubricas com código, descrição, referência, valor e tipo P/D, totais e líquido, documento e folha) e o agrupamento das rubricas em históricos ({ nome, rubricas: [códigos ou descrições], fgts, inss }). Confere o fechamento de cada holerite (proventos − descontos = líquido), acusa competências faltantes no período, proventos que não entraram em histórico e meses sem a rubrica; devolve historicosSalariais (ocorrências com _origem) e contrato.remuneracoes (vigências).
Inputs: holerites (required), periodo, historicos.
modelos_atualizarAtualizar modelos extraídos do PJe-CalcADestructiveIdempotent
Refaz os modelos usados pelo gerador a partir da instalação: "verbas" (com o PJe-Calc em execução: lança todas as verbas do Expresso num cálculo temporário, exporta, monta a biblioteca e exclui o temporário) ou "catalogos" (com o PJe-Calc PARADO: lê municípios, assuntos CNJ e feriados do banco H2). O calculo_criar e o tabelas_atualizar já refazem a biblioteca sozinhos na primeira vez em cada PJe-Calc e depois de cada sincronização de tabelas (que muda as verbas do Expresso); use para forçar.
Inputs: alvo (required).
pjecalc_abrir_interfaceAbrir a interface no navegadorAIdempotent
Abre a interface web do PJe-Calc no navegador padrão do usuário (ou o Firefox portátil que acompanha o PJe-Calc). Requer o app em execução.
Inputs: pagina, firefox_portatil.
pjecalc_infoInformações do PJe-CalcBRead-onlyIdempotent
Identidade completa da instalação: versão/build do pjecalc.jar, módulos (base/negocio/integracao), stack tecnológico, portas do Tomcat, DataSource H2, parâmetros de JVM dos .bat, token de serviços e URLs dos 24 TRTs para sincronização de tabelas.
Inputs: no named parameters.
pjecalc_iniciarIniciar o PJe-CalcAIdempotent
Inicia o PJe-Calc e aguarda a aplicação responder (até 3 min). Modo "sem-navegador" (padrão): sobe o Tomcat como o launcher oficial, sem abrir janela/navegador (ideal para o agente). Modo "normal": igual ao iniciarPjeCalc.bat (janela + navegador). Em seguida o usuário pode abrir http://localhost:9257/pjecalc no navegador.
Inputs: modo.
pjecalc_localizarLocalizar o PJe-Calc no computadorAIdempotent
Mostra qual instalação do PJe-Calc o MCP está usando e como a encontrou (PJECALC_HOME, escolha guardada, PJe-Calc em execução, pasta acima do MCP ou busca em Downloads, Área de Trabalho, Documentos, Arquivos de Programas e raiz dos discos). Com "pasta", fixa a instalação escolhida pelo usuário (guardada para as próximas vezes). Com "procurar_de_novo", esquece a escolha e busca outra vez (use quando a pasta foi movida). Se houver várias instalações, pergunte ao usuário qual usar.
Inputs: pasta, procurar_de_novo.
pjecalc_logsLer logs do PJe-CalcARead-onlyIdempotent
Últimas linhas dos logs do Tomcat/MCP (tomcat/logs). Com somente_erros=true, lista só exceções e linhas GRAVE — útil quando uma operação devolve "Erro Interno no Servidor".
Inputs: linhas, arquivo, somente_erros.
pjecalc_paginasListar páginas do webappARead-onlyIdempotent
Mapa completo das páginas .xhtml do webapp (calculos, índices, INSS, IRPF, FGTS, custas, pagamento, cartão de ponto etc.). Use pjecalc_abrir_interface com o caminho retornado para abrir cada uma.
Inputs: no named parameters.
pjecalc_pararParar o PJe-CalcADestructiveIdempotent
Encerra o PJe-Calc. Se foi iniciado pelo MCP (sem-navegador), encerra o Tomcat de forma ordenada (o banco H2 fecha corretamente); caso contrário encerra o processo java, como o próprio launcher faria ao sair.
Inputs: forcar.
pjecalc_statusStatus do PJe-CalcARead-onlyIdempotent
Estado do PJe-Calc: processos java, porta HTTP, se a aplicação responde, versão e banco; quando não responde, o diagnóstico lido no log (por exemplo, falta de memória) e o que fazer. Não altera nada.
Inputs: no named parameters.
pjecalc_template_csvLer template CSV de importaçãoARead-onlyIdempotent
Conteúdo dos arquivos CSV de exemplo usados pela tela de importação (cartão de ponto, jornada, faltas, férias e histórico salarial). Use como referência para gerar arquivos de importação.
Inputs: arquivo.
processo_mapaMapa do processo (fase e processos ligados)ARead-onlyIdempotent
Confere o mapa do processo em contrato.processos: o processo principal (fase: PRE_PROCESSUAL, CONHECIMENTO, RECURSAL, LIQUIDACAO, EXECUCAO_PROVISORIA, EXECUCAO, ENCERRADO; trabalho: CALCULO_NOVO, ATUALIZACAO, EXECUCAO_COLETIVA, HABILITACAO, ENTE_PUBLICO) e todos os processos ligados (conexo, litispendência, coisa julgada, ação anterior arquivada, protesto, coletiva, acordo, recuperação judicial, falência, prova emprestada, rescisória...), cada um com o efeito no cálculo e os documentos exigidos da relação. Acusa números de processo citados nos documentos e decisões que não estão no mapa, prescrição incompatível com o marco interruptivo, parcela já decidida em outro processo, data-limite de recuperação judicial, devedores, pagamentos da execução e destinos do crédito. Use logo no começo (etapa 0). Veja pjecalc://docs/modulos/processo.
Inputs: arquivo_json, especificacao.
rest_precatorio_atualizarAtualizar precatório (REST)ARead-onlyIdempotent
POST /pjecalc/servico/rest/atualizacao/precatorios — envia um AtualizacaoPrecatorioDTO e recebe o precatório atualizado (correção por índices de precatórios). O DTO é um objeto JSON livre (campos como numeroPrecatorio, valor, dataBase, indices...). Consulte references/API-REST.md. Requer o app em execução.
Inputs: dto (required).
rest_precatorios_sipAtualizar precatórios SIP (REST)ADestructiveIdempotent
POST /pjecalc/servico/rest/atualizacao/sip/precatorios — atualiza em lote uma lista de AtualizacaoPrecatorioSIPDTO (precatórios do SIP) e devolve a lista processada. Requer o app em execução.
Inputs: lista (required).
rest_precatorios_sip_indicesAtualizar índices de precatórios SIP (REST)BDestructiveIdempotent
POST /pjecalc/servico/rest/atualizacao/sip/precatorios/indices — atualiza em lote uma lista de AtualizacaoPrecatorioSIPIndicesDTO. Requer o app em execução.
Inputs: lista (required).
rest_selic_periodoCalcular SELIC do período (REST)ARead-onlyIdempotent
GET /pjecalc/servico/rest/atualizacao/selic — devolve o fator SELIC acumulado entre duas datas. Datas no formato dd/MM/aaaa. Autenticação automática via header Authentication (Base64 do token dos .bat). Requer o app em execução.
Inputs: dataFinal (required), dataInicial (required).
rest_tabelas_sincronizar_nacionaisSincronizar tabelas nacionais (REST)AIdempotent
LADO SERVIDOR do PJe-Calc local (o serviço que ele oferece a outros TRTs): NÃO atualiza as tabelas deste PJe-Calc — para isso use tabelas_atualizar. GET /pjecalc/servico/rest/sincronizacao/nacionais/{hash}?versao=X — devolve SincronizacaoTabelasDTO com {tabelas: Base64(GZIP do SQL), hashServidor}. 404 = já está na versão mais recente. Com salvar_arquivo, grava o SQL descompactado no caminho indicado. Requer o app em execução.
Inputs: hash (required), versao, salvar_arquivo.
rest_tabelas_sincronizar_regionaisSincronizar tabelas regionais (REST)AIdempotent
LADO SERVIDOR do PJe-Calc local (o serviço que ele oferece a outros TRTs): NÃO atualiza as tabelas deste PJe-Calc — para isso use tabelas_atualizar. GET /pjecalc/servico/rest/sincronizacao/nacionaiseregionais/regional/{TRT}/hash/{hash} (ou ...proxy... para passar pelo TRT raiz). Tribunal deve ser TRT1..TRT24 (maiúsculo). Devolve SincronizacaoTabelasDTO regional. Requer o app em execução.
Inputs: hash (required), tribunal (required), proxy.
rest_tabelas_ultima_versaoÚltima versão das tabelas nacionais (REST)ARead-onlyIdempotent
LADO SERVIDOR do PJe-Calc local (o serviço que ele oferece a outros TRTs): NÃO atualiza as tabelas deste PJe-Calc — para isso use tabelas_atualizar. GET /pjecalc/servico/rest/sincronizacao/nacionais/ultimaVersao — devolve ControleAtualizacaoTabelasDTO com a última versão das tabelas auxiliares nacionais (404 se não houver controle). Requer o app em execução.
Inputs: no named parameters.
rest_tabelas_versaoBuscar versão específica das tabelas (REST)ARead-onlyIdempotent
LADO SERVIDOR do PJe-Calc local (o serviço que ele oferece a outros TRTs): NÃO atualiza as tabelas deste PJe-Calc — para isso use tabelas_atualizar. GET /pjecalc/servico/rest/sincronizacao/nacionais/versao/{hash} — busca o registro de controle de uma versão pelo hash (MD5). 404 = versão inexistente. Requer o app em execução.
Inputs: hash (required).
tabelas_atualizarAtualizar tabelas e índices do PJe-CalcADestructiveIdempotent
Executa Tabelas > Atualização de Tabelas e Índices > Online no PJe-Calc: o próprio aplicativo baixa as tabelas nacionais e as do TRT informado (se o TRT recusar, pelo proxy nacional do TRT8) e as aplica (10 a 60 s). Use o TRT do processo (o dígito TR do número CNJ: ...5.18.... = TRT18): as tabelas regionais de outros TRTs são substituídas. Requer internet. Devolve a situação das tabelas depois.
Inputs: regional (required).
tabelas_statusSituação das tabelas de índices do PJe-CalcARead-onlyIdempotent
Lê no PJe-Calc em execução a competência/data mais recente de cada índice (Tabela Única JT, IPCA-E, IPCA, INPC, TR, SELIC simples e composta, tabela diária de débitos, juros pela taxa legal). Com data_liquidacao diz se as tabelas cobrem a liquidação (até 2 meses de defasagem). Use antes de liquidar cálculos recentes.
Inputs: data_liquidacao.
titulo_comporCompor o título executivo (cadeia de decisões)ARead-onlyIdempotent
Monta a matriz de capítulos: para cada parcela e critério (ATUALIZACAO, HONORARIOS, CUSTAS...), a cadeia de decisões de todas as instâncias (vara, TRT, TST, STF, liquidação, execução), a decisão que vale (efeito substitutivo; recurso não conhecido não substitui; embargos integram; anulação com retorno), a situação e o trânsito por capítulo. Acusa capítulo sem decisão, decisão mal registrada, reforma por recurso não conhecido, capítulo anulado sem nova decisão, recurso pendente fora de execução provisória, conflito entre dispositivo e fundamentação, parcela que cita decisão superada e critério de correção que contraria precedente vinculante. Veja pjecalc://docs/modulos/titulo-executivo e pjecalc://docs/precedentes.
Inputs: arquivo_json, especificacao.
trct_para_pagamentosTRCT transcrito -> pagamentos do contratoARead-onlyIdempotent
Recebe os campos do TRCT ({ codigo, descricao, valor, tipo P/D }), os totais (bruto, descontos, líquido), a data do pagamento, o documento e a folha; devolve contrato.pagamentos (um por provento, com a parcela provável pelo código do campo — Portaria MTE 1.621/2010) e as conferências da soma dos campos com os totais. Ligue cada pagamento à parcela do contrato antes de abater.
Inputs: campos (required), data, folha, totais, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 72 tools
Long descriptions carefully differentiate most tools, but real overlap remains: rest_tabelas_ultima_versao / rest_tabelas_versao / rest_tabelas_sincronizar_nacionais / rest_tabelas_sincronizar_regionais all look like table-sync tools yet are server-side endpoints that explicitly do NOT update tables, and calculo_validar vs calculo_pendencias vs calculo_criar vs calculo_gerar_pjc vs calculo_importar_pjc form a dense cluster. An agent must read whole descriptions to pick correctly, which is a sign of marginal boundary clarity at 72 tools.
Consistent snake_case with clear domain prefixes (calculo_, catalogo_, documento_, db_, rest_, config_, tabelas_, pjecalc_), which gives a predictable grouping. Minor deviations in verb/noun ordering (titulo_compor, processo_mapa, holerites_para_historicos, trct_para_pagamentos) but nothing chaotic.
72 tools is very heavy for a single desktop-app MCP; while the domain (labor calculation authoring, auditing, DB, config, REST) is genuinely broad, many REST/tabela/catalog tools could be consolidated into generic operations. The surface is well past the point where an agent can hold the catalog in mind.
Coverage is unusually thorough: document ingestion, interpretation planning, validation, PJC generation/import, liquidation, updates, reports, comparison, batch creation, DB backup/restore/query, config editing, app lifecycle, and REST service parity. No obvious dead ends in the stated workflow.
Maintenance
Related MCP Connectors
Liquida cálculos trabalhistas no PJe-Calc oficial e devolve a planilha em PDF e o arquivo .PJC.
JusPronto is case-management software for Brazilian law firms. Its remote MCP server (OAuth 2.1 with PKCE, per-permission scopes, audit log) lets Claude and ChatGPT read the firm's own cases, deadlines, agenda, recent court movements and case files with the page cited. Write actions require the lawyer's approval. Requires a JusPronto account.
Connect AI assistants to your approved computer for files, commands, browser and desktop tasks.
Brazilian labor calculation for AI: update labor claims and awards with official correction, interes
Related MCP Servers
- FlicenseNot gradedqualityBmaintenanceEnables AI assistants to connect to a running openLCA instance for life cycle assessment workflows, including building models, running calculations, auditing, and extracting data quality assessments.83 PyPI6-
- AlicenseNot gradedqualityCmaintenanceEnables Claude and other AI agents to build, edit, and analyze Microsoft Project desktop schedules on Windows through natural language, covering tasks, WBS, dependencies, resources, calendars, baselines, critical path, resource leveling, and earned value, with live changes in Project and single-step undo. It also exports results to PDF or CSV and reads project health and time-phased data for S-curves and histograms.MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to control, automate, and query desktop project-management schedules in real time via native Windows COM, including task/WBS management, resource and cost assignment, baselines, critical path, status reporting, and PDF export.MIT
- FlicenseNot gradedqualityAmaintenanceEnables AI assistants like Claude for Desktop or Cursor to drive Windows CAD applications (AutoCAD, ZWCAD, GstarCAD, and BricsCAD) via COM, executing 56 drawing, layer, block, entity, file, and export commands through natural-language or direct tool calls. Supports batch operations, multi-drawing session management, and data extraction to JSON or Excel.-