# PJe-Calc MCP (mcpb · pjecalc-mcp-2.16.0-mcp.18.mcpb)

Monta, liquida, confere e atualiza cálculos trabalhistas no PJe-Calc Cidadão (Windows).

- Trust score: 45/100 (low)
- Change this week: 0
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-05

## Components

- mcpb · `pjecalc-mcp-2.16.0-mcp.18.mcpb`: 45/100 (this document), [markdown](https://verifymcp.io/servers/lucianumm-pjecalc-mcp/pjecalc-mcp-mcp-18.md), [page](https://verifymcp.io/servers/lucianumm-pjecalc-mcp/pjecalc-mcp-mcp-18)

## Channel facts

- Registry: `mcpb`
- Package: `https://github.com/lucianumm/PJeCalcMCP/releases/download/v2.16.0-mcp.18/pjecalc-mcp-2.16.0-mcp.18.mcpb`
- Transport: `stdio`
- SHA-256: `7310589ac704bb10e8331e1b1921d50773c931b1197c99d3d3acd17f516a074c`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-05.

- **Supply Chain Security**: 13/100
  - No malware scan is available for this kind of package: the supply-chain vendors we use do not cover it. This is a permanent gap in our coverage, not a finding about the package.
  - Known CVEs could not be checked: we found no dependency list to check in this bundle: either it runs a compiled binary, whose bundled manifests we do not read, or none of the package.json, requirements.txt, pyproject.toml or uv.lock files it ships for its runtime declares a dependency we can read (a requirements.txt that only points at a setup.py project, a local path, or a nested requirements file we cannot follow counts as none).
  - No install/post-install scripts declared.
  - Dependency health could not be checked: we found no dependency list to check in this bundle: either it runs a compiled binary, whose bundled manifests we do not read, or none of the package.json, requirements.txt, pyproject.toml or uv.lock files it ships for its runtime declares a dependency we can read (a requirements.txt that only points at a setup.py project, a local path, or a nested requirements file we cannot follow counts as none).
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (AGPL-3.0-only).
  - Actively maintained (last published 11 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 79/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 12540 tokens (~140/item across 89 items; 72 tools + 17 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 72 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 74 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### How do I install the PJe-Calc MCP server?

PJe-Calc MCP ships as an MCPB bundle, a single file you download and open in an MCP host that supports MCPB bundles, such as Claude Desktop. The host reads the launch command from the bundle's own manifest, so there is no command to copy. Before opening it, check the file's SHA-256 matches the one the MCP registry declares for it, 7310589ac704bb10e8331e1b1921d50773c931b1197c99d3d3acd17f516a074c; the commands to do that are on this page. If it does not match, do not open it.

- Download bundle: `https://github.com/lucianumm/PJeCalcMCP/releases/download/v2.16.0-mcp.18/pjecalc-mcp-2.16.0-mcp.18.mcpb`
- SHA-256: `7310589ac704bb10e8331e1b1921d50773c931b1197c99d3d3acd17f516a074c`

### Verify on macOS / Linux

```bash
echo "7310589ac704bb10e8331e1b1921d50773c931b1197c99d3d3acd17f516a074c  pjecalc-mcp-2.16.0-mcp.18.mcpb" | shasum -a 256 -c
```

### Verify on Windows (PowerShell)

```powershell
(Get-FileHash -Algorithm SHA256 .\pjecalc-mcp-2.16.0-mcp.18.mcpb).Hash -eq "7310589ac704bb10e8331e1b1921d50773c931b1197c99d3d3acd17f516a074c"
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-10-27 (score 45, +1)

- [functional improvement] Maintenance: unverified → pass

### 2026-10-25 (score 44)

First indexed and scored.

## MCP tools (72)

### `pjecalc_localizar` (~188 tokens)

Localizar o PJe-Calc no computador

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.

Input parameters:

- `pasta` (string): Pasta do PJe-Calc (a que contém "bin" e "tomcat").
- `procurar_de_novo` (boolean): Esquece a instalação guardada e procura o PJe-Calc de novo (use quando a pasta foi movida).

### `pjecalc_status` (~59 tokens)

Status do PJe-Calc

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.

### `pjecalc_iniciar` (~122 tokens)

Iniciar o PJe-Calc

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.

Input parameters:

- `modo` (string): sem-navegador (padrão) ou normal.

### `pjecalc_parar` (~80 tokens)

Parar o PJe-Calc

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.

Input parameters:

- `forcar` (boolean): Encerra o processo java diretamente.

### `pjecalc_abrir_interface` (~86 tokens)

Abrir a interface no navegador

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.

Input parameters:

- `firefox_portatil` (boolean): Usa navegador/windows/FirefoxPortable.exe.
- `pagina` (string): Caminho relativo (padrão: página inicial pages/principal.jsf).

### `pjecalc_logs` (~109 tokens)

Ler logs do PJe-Calc

Ú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".

Input parameters:

- `arquivo` (string): Arquivo específico dentro de tomcat/logs.
- `linhas` (integer): Linhas por arquivo (padrão 60).
- `somente_erros` (boolean): Lista só exceções e linhas GRAVE/SEVERE.

### `calculo_modelo_json` (~151 tokens)

Formato da especificação do cálculo

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.

Input parameters:

- `exemplo` (string): Devolve só este exemplo (JSON).
- `somente_exemplo` (boolean): Compatibilidade: devolve só o exemplo "referencia".

### `processo_mapa` (~278 tokens)

Mapa do processo (fase e processos ligados)

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.

Input parameters:

- `arquivo_json` (string): Alternativa: caminho de um arquivo .json com a especificação.
- `especificacao` (object): Especificação do cálculo (JSON). Formato em calculo_modelo_json.

### `titulo_compor` (~223 tokens)

Compor o título executivo (cadeia de decisões)

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.

Input parameters:

- `arquivo_json` (string): Alternativa: caminho de um arquivo .json com a especificação.
- `especificacao` (object): Especificação do cálculo (JSON). Formato em calculo_modelo_json.

### `calculo_plano_interpretacao` (~163 tokens)

Plano de interpretação (para o usuário aprovar)

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.

Input parameters:

- `arquivo_json` (string): Alternativa: caminho de um arquivo .json com a especificação.
- `especificacao` (object): Especificação do cálculo (JSON). Formato em calculo_modelo_json.

### `calculo_aprovar_plano` (~189 tokens)

Registrar a aprovação do plano pelo usuário

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.

Input parameters:

- `arquivo_json` (string): Alternativa: caminho de um arquivo .json com a especificação.
- `especificacao` (object): Especificação do cálculo (JSON). Formato em calculo_modelo_json.
- `gravar` (boolean): Com arquivo_json: grava a aprovação no arquivo.
- `observacoes` (string): Correções ou ressalvas feitas pelo usuário ao aprovar.
- `por` (string, required): Quem aprovou (nome do usuário).

### `calculo_documentos_necessarios` (~293 tokens)

Documentos necessários ao cálculo (pedido ao usuário)

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.

Input parameters:

- `admissao` (string): Sem especificação: data de admissão.
- `arquivo_json` (string): Alternativa: caminho de um arquivo .json com a especificação.
- `demissao` (string): Sem especificação: data de saída.
- `documentos_recebidos` (array): Sem especificação: documentos já recebidos.
- `especificacao` (object): Especificação do cálculo (JSON). Formato em calculo_modelo_json.
- `parcelas` (array): Sem especificação: parcelas deferidas (ex.: ["HORAS EXTRAS 50%", "FGTS + 40%"]).

### `documento_inventario` (~210 tokens)

Inventário dos documentos (arquivos e páginas)

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.

Input parameters:

- `arquivos` (array): Caminhos dos arquivos.
- `pasta` (string): Alternativa: pasta com os documentos.
- `prefixo` (string): Prefixo dos ids sugeridos (padrão "D").
- `processo` (string): Id do processo de origem (contrato.processos) para as sugestões.

### `auditor_importar` (~392 tokens)

Importar a leitura do AuditorProcessual

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.

Input parameters:

- `eventos` (string): Arquivo labor_events (contratação, afastamentos, rescisão), se houver.
- `ledger` (string): Arquivo labor_ledger (jornada dia a dia e folha de pagamento), se houver.
- `numero_processo` (string): Número CNJ do processo, para conferir o que o AuditorProcessual identificou.
- `pastas` (array, required): Pastas de saída do ingest_document.py do AuditorProcessual (uma por arquivo dos autos).
- `prefixo` (string): Prefixo dos ids de documento sugeridos (padrão "D").
- `processo` (string): Id do processo em contrato.processos para as sugestões.
- `revisao` (string): Revisão do AuditorProcessual com os fatos (id, página e trecho), para ligar cada item ao documento e à folha.

### `documento_texto` (~140 tokens)

Texto de um documento por página

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.

Input parameters:

- `arquivo` (string, required): Caminho do PDF ou do arquivo de texto.
- `max_caracteres` (integer): Padrão 60000.
- `paginas` (string): Ex.: "1-3,7" (padrão: todas).

### `documento_imagens` (~218 tokens)

Imagens das páginas escaneadas de um PDF

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.

Input parameters:

- `arquivo` (string, required): Caminho do PDF.
- `destino` (string): Pasta dos arquivos (padrão: "<nome do PDF>-paginas" ao lado do PDF).
- `paginas` (string): Ex.: "24-39,56-92" (padrão: todas).

### `holerites_para_historicos` (~251 tokens)

Holerites transcritos -> históricos salariais

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).

Input parameters:

- `historicos` (array): Agrupamento das rubricas em históricos: [{ nome, rubricas: [códigos ou descrições], fgts, inss }].
- `holerites` (array, required): Holerites transcritos: { competencia, rubricas: [{ codigo, descricao, referencia, valor, tipo P|D }], totais, liquido, documento, folha }.
- `periodo` (object): Período do contrato (aaaa-mm), para acusar competências faltantes.

### `cartoes_para_jornadas` (~245 tokens)

Cartões de ponto transcritos -> jornadas

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).

Input parameters:

- `dias` (array, required): Marcações dia a dia: { data, marcacoes: ["08:00", "12:00", ...] }, { data, turnos } ou { data, ocorrencia }.
- `dias_sem_marcacao` (array): Dias da semana sem trabalho (0=domingo ... 6=sábado). Padrão [0].
- `periodo` (object): Período a conferir (aaaa-mm-dd), para acusar dias sem registro.

### `extrato_para_fgts` (~192 tokens)

Extrato do FGTS -> depósitos (fgts.operacoes)

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.

Input parameters:

- `documento` (string): Id do extrato em contrato.documentos (vira a origem das operações).
- `lancamentos` (array, required): Lançamentos do extrato analítico: { competencia, data, valor, tipo DEPOSITO|JAM|SAQUE|MULTA }.
- `periodo` (object): Período do contrato (aaaa-mm), para acusar competências sem depósito.
- `saldo` (number): Saldo final do extrato, para conferir a soma dos lançamentos.

### `trct_para_pagamentos` (~208 tokens)

TRCT transcrito -> pagamentos do contrato

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.

Input parameters:

- `campos` (array, required): Campos do TRCT: { codigo, descricao, valor, tipo P|D }.
- `data` (string): Data do pagamento das verbas rescisórias (aaaa-mm-dd).
- `documento` (string): Id do TRCT em contrato.documentos.
- `folha` (string): Folha do TRCT nos autos.
- `totais` (object): Totais do TRCT (bruto, descontos, líquido), para conferir a soma dos campos.

### `calculo_validar` (~207 tokens)

Validar especificação do cálculo

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.).

Input parameters:

- `arquivo_json` (string): Alternativa: caminho de um arquivo .json com a especificação.
- `especificacao` (object): Especificação do cálculo (JSON). Formato em calculo_modelo_json.

### `calculo_gerar_pjc` (~225 tokens)

Gerar arquivo .PJC

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 <arquivo>.mcp.json com os passos pós-importação (apurar o cartão e ligar as verbas às colunas), que calculo_importar_pjc executa.

Input parameters:

- `arquivo_json` (string): Alternativa: caminho de um arquivo .json com a especificação.
- `destino` (string): Arquivo .PJC ou pasta de destino (padrão: pjecalc-mcp-skill/saida).
- `especificacao` (object): Especificação do cálculo (JSON). Formato em calculo_modelo_json.

### `calculo_criar` (~503 tokens)

Criar cálculo completo no PJe-Calc

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.

Input parameters:

- `arquivo_json` (string): Alternativa: caminho de um arquivo .json com a especificação.
- `atualizar_tabelas` (boolean): Se as tabelas de índices não cobrirem a liquidação, atualiza-as pelo TRT do processo (Atualização de Tabelas e Índices > Online). Padrão false: só avisa.
- `destino` (string): Onde gravar o .PJC (padrão: pjecalc-mcp-skill/saida).
- `especificacao` (object): Especificação do cálculo (JSON). Formato em calculo_modelo_json.
- `exportar_final` (boolean): Grava o "-PRONTO.PJC" exportado após a importação (padrão true).
- `ignorar_tabelas` (boolean): Faz a liquidação de teste mesmo com tabelas desatualizadas (o resultado ficará errado).
- `iniciar` (boolean): Inicia o PJe-Calc se estiver parado (padrão true).
- `liquidar_em` (string): Opcional: data (dd/mm/aaaa ou aaaa-mm-dd) para uma liquidação de TESTE (o usuário pode liquidar de novo depois).

### `calculo_importar_pjc` (~184 tokens)

Importar .PJC no PJe-Calc

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 <arquivo>.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.

Input parameters:

- `arquivo` (string, required): Caminho do .PJC.
- `exportar_final` (boolean): Grava "<arquivo>-PRONTO.PJC" exportado depois da importação (padrão: só quando houve passos pós-importação).
- `iniciar` (boolean): Inicia o PJe-Calc se estiver parado (padrão true).
- `regerar` (boolean): Regera as ocorrências após importar (padrão true).

### `calculo_apurar_cartao_ponto` (~223 tokens)

Apurar o cartão de ponto (jornadas) de um cálculo

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.

Input parameters:

- `id_calculo` (integer, required): Número do cálculo no PJe-Calc.
- `regerar` (boolean): Regera as ocorrências das verbas no fim (padrão true).
- `vinculos` (array): Verbas a ligar às colunas apuradas (quantidade ou divisor importados do cartão).

### `calculo_ler_pjc` (~89 tokens)

Ler um arquivo .PJC

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.

Input parameters:

- `arquivo` (string, required): Caminho do .PJC.

### `calculo_pendencias` (~79 tokens)

Pendências do cálculo (validação do PJe-Calc)

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.

Input parameters:

- `id_calculo` (integer, required): Número do cálculo no PJe-Calc.

### `calculo_regerar_ocorrencias` (~99 tokens)

Regerar ocorrências das verbas

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.

Input parameters:

- `id_calculo` (integer, required): Número do cálculo no PJe-Calc.
- `manter_alteracoes` (boolean): Mantém as alterações feitas à mão nas ocorrências (padrão: regera tudo).

### `calculo_liquidar` (~289 tokens)

Liquidar cálculo (teste ou a pedido do usuário)

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.

Input parameters:

- `acumular_indices` (string): Desde quando acumular os índices de correção: mês subsequente ao vencimento, mês do vencimento ou a combinação dos dois (padrão: o da tela).
- `atualizar_tabelas` (boolean): Atualiza as tabelas de índices (online, pelo TRT informado) se não cobrirem a data de liquidação.
- `data_liquidacao` (string): dd/mm/aaaa ou aaaa-mm-dd (padrão: a sugerida pelo PJe-Calc).
- `id_calculo` (integer, required): Número do cálculo no PJe-Calc.
- `ignorar_tabelas` (boolean): Liquida mesmo com tabelas desatualizadas (não recomendado).
- `regerar` (boolean): Regera as ocorrências (mantendo alterações manuais) antes de liquidar. Use depois de tabelas_atualizar; é automático quando a própria chamada atualiza as tabelas.
- `regional` (string): TRT do processo, usado se for preciso atualizar as tabelas.

### `calculo_atualizar` (~406 tokens)

Atualizar cálculo homologado (execução: pagamentos e eventos)

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.

Input parameters:

- `arquivo_pjc` (string): .PJC do cálculo liquidado (exportado depois de liquidar).
- `destino` (string): Pasta dos arquivos -EXECUCAO.PJC e -ATUALIZADO.PJC (padrão: ao lado do arquivo de origem ou saida/).
- `execucao` (object, required): Bloco "execucao" (formato em calculo_modelo_json e no módulo execução).
- `id_calculo` (integer): Alternativa: número do cálculo liquidado no PJe-Calc (é exportado e copiado).
- `iniciar` (boolean): Inicia o PJe-Calc se estiver parado (padrão true).

### `calculo_externo_criar` (~284 tokens)

Cálculo Externo (conta homologada feita fora do PJe-Calc)

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.

Input parameters:

- `calculoExterno` (object, required): Especificação do Cálculo Externo (processo, dataBase, parametros, creditos, descontos, outrosDebitos, debitosReclamante, execucao).
- `destino` (string): Pasta dos arquivos (padrão: saida/).
- `iniciar` (boolean): Inicia o PJe-Calc se estiver parado (padrão true).

### `tabelas_status` (~115 tokens)

Situação das tabelas de índices do PJe-Calc

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.

Input parameters:

- `data_liquidacao` (string): dd/mm/aaaa (padrão: hoje).

### `tabelas_atualizar` (~141 tokens)

Atualizar tabelas e índices do PJe-Calc

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.

Input parameters:

- `regional` (string, required): TRT do processo (TRT1..TRT24).

### `calculo_relatorio` (~383 tokens)

Relatório do cálculo liquidado

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.

Input parameters:

- `arquivo_pdf` (string): Destino do PDF (formato PDF).
- `formato` (string): HTML devolve o texto; PDF grava o arquivo (padrão HTML).
- `id_calculo` (integer, required): Número do cálculo no PJe-Calc.
- `max_caracteres` (integer): Corta o texto devolvido (padrão 20000).
- `tipos` (array): Padrão: ["COMPLETO"] (as seções que se aplicam ao cálculo). Ou a lista de seções avulsas.

### `calculo_comparar_referencia` (~413 tokens)

Comparar com uma conta de referência

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.

Input parameters:

- `arquivo_calculo` (string): Alternativa: .PJC exportado do cálculo liquidado.
- `arquivo_referencia` (string): Alternativa: .PJC da conta de referência, ou o relatório do PJe-Calc da referência em PDF, HTML ou texto copiado (só o resumo é comparado).
- `data_base` (string): Data-base da referência (AAAA-MM-DD) quando o relatório não a mostra.
- `id_calculo` (integer): Cálculo a conferir (no PJe-Calc, já liquidado).
- `id_referencia` (integer): Conta de referência no PJe-Calc (liquidada na mesma data).
- `referencia_manual` (object): Alternativa: conta de referência transcrita (perito, planilha): { dataLiquidacao, verbas: [{ descricao, valorCorrigido, juros, total }], brutoDevidoAoReclamante, totalDescontos, liquidoDevidoAoReclam…
- `tolerancia` (number): Tolerância em reais (padrão 0,01).

### `calculo_criar_lote` (~250 tokens)

Criar vários cálculos (lote: um por reclamante ou por devedor)

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.

Input parameters:

- `arquivos_json` (array): Alternativa: caminhos dos .json.
- `atualizar_tabelas` (boolean): Se as tabelas de índices não cobrirem a liquidação, atualiza-as pelo TRT do processo (padrão false).
- `especificacoes` (array): Lista de especificações completas.
- `ignorar_tabelas` (boolean): Liquida mesmo com tabelas desatualizadas (o resultado fica errado).
- `liquidar_em` (string): dd/mm/aaaa ou aaaa-mm-dd: liquidação de teste de todos os itens (mesma data-base).

### `calculo_exportar_pjc` (~94 tokens)

Exportar cálculo do PJe-Calc (.PJC)

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.

Input parameters:

- `destino` (string): Arquivo ou pasta (padrão: pjecalc-mcp-skill/saida).
- `id_calculo` (integer, required): Número do cálculo no PJe-Calc.

### `calculo_excluir` (~92 tokens)

Excluir cálculo do PJe-Calc

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.

Input parameters:

- `confirmacao` (string, required): Deve ser exatamente "SIM, EXCLUIR".
- `id_calculo` (integer, required): Número do cálculo no PJe-Calc.

### `calculo_recentes` (~37 tokens)

Cálculos recentes no PJe-Calc

Lista "Abrir Cálculos Recentes" da tela inicial do PJe-Calc (número / processo / reclamante).

### `catalogo_verbas` (~104 tokens)

Catálogo de verbas (Expresso)

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

Input parameters:

- `filtro` (string): Parte do nome (ex.: "horas extras", "férias").

### `catalogo_municipios` (~65 tokens)

Municípios do PJe-Calc

Procura municípios (nome/UF/id) da tabela do PJe-Calc, para preencher calculo.uf e calculo.municipio.

Input parameters:

- `nome` (string): Parte do nome.
- `uf` (string): Sigla da UF (ex.: PA).

### `catalogo_assuntos_cnj` (~65 tokens)

Assuntos CNJ

Assuntos da Tabela Processual Unificada do CNJ cadastrados no PJe-Calc (código para verbas personalizadas: verbas[].personalizada.assuntoCnj).

Input parameters:

- `filtro` (string): Parte do nome ou do código do assunto.

### `catalogo_enums` (~110 tokens)

Valores aceitos (enums do PJe-Calc)

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).

Input parameters:

- `classe` (string): Nome da entidade.
- `nome` (string): Nome do enum.

### `catalogo_validar_documentos` (~97 tokens)

Validar número CNJ, CPF e CNPJ

Confere dígitos verificadores (o PJe-Calc recusa número de processo com dígito errado) e devolve o dígito CNJ correto.

Input parameters:

- `cnpj` (string): CNPJ, com ou sem pontuação.
- `cpf` (string): CPF, com ou sem pontuação.
- `numero_processo` (string): Número CNJ do processo, com ou sem pontuação.

### `catalogo_pisos_vt` (~212 tokens)

Pisos salariais e vales-transporte cadastrados no PJe-Calc

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.

Input parameters:

- `nome` (string): Parte do nome do piso ou da linha.
- `uf` (string): Sigla da UF para filtrar.

### `catalogo_atividades` (~59 tokens)

Atividades econômicas (INSS por atividade)

Atividades econômicas da tabela do PJe-Calc (id e descrição), para contribuicaoSocial.atividadeEconomica (alíquotas do empregador pela atividade).

Input parameters:

- `filtro` (string): Parte da descrição ou o id.

### `catalogo_feriados` (~125 tokens)

Feriados e pontos facultativos

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.

Input parameters:

- `filtro` (string): Parte do nome.
- `municipio` (string): Nome do município (filtra os municipais).
- `tipo` (string): F feriado, P ponto facultativo.
- `uf` (string): Sigla da UF dos feriados estaduais e municipais.

### `catalogo_cartao_ponto` (~71 tokens)

Opções da apuração do cartão de ponto

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.

### `modelos_atualizar` (~180 tokens)

Atualizar modelos extraídos do PJe-Calc

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.

Input parameters:

- `alvo` (string, required): "verbas": biblioteca das verbas do Expresso; "catalogos": municípios, feriados, pisos e demais catálogos.

### `pjecalc_info` (~71 tokens)

Informações do PJe-Calc

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.

### `pjecalc_paginas` (~65 tokens)

Listar páginas do webapp

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.

### `pjecalc_template_csv` (~84 tokens)

Ler template CSV de importação

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.

Input parameters:

- `arquivo` (string): Caminho relativo (ex.: templateCartaoDePonto/ExemploCartaoDePonto.csv). Deixe vazio para listar.

### `rest_selic_periodo` (~99 tokens)

Calcular SELIC do período (REST)

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.

Input parameters:

- `dataFinal` (string, required): Data final dd/MM/aaaa.
- `dataInicial` (string, required): Data inicial dd/MM/aaaa.

### `rest_precatorio_atualizar` (~104 tokens)

Atualizar precatório (REST)

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.

Input parameters:

- `dto` (object, required): Objeto AtualizacaoPrecatorioDTO (JSON).

### `rest_precatorios_sip` (~83 tokens)

Atualizar precatórios SIP (REST)

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.

Input parameters:

- `lista` (array, required): Lista de objetos AtualizacaoPrecatorioSIPDTO.

### `rest_precatorios_sip_indices` (~74 tokens)

Atualizar índices de precatórios SIP (REST)

POST /pjecalc/servico/rest/atualizacao/sip/precatorios/indices — atualiza em lote uma lista de AtualizacaoPrecatorioSIPIndicesDTO. Requer o app em execução.

Input parameters:

- `lista` (array, required): Lista de objetos AtualizacaoPrecatorioSIPIndicesDTO.

### `rest_tabelas_ultima_versao` (~111 tokens)

Última versão das tabelas nacionais (REST)

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.

### `rest_tabelas_versao` (~121 tokens)

Buscar versão específica das tabelas (REST)

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.

Input parameters:

- `hash` (string, required): Hash da versão (hashSolicitante).

### `rest_tabelas_sincronizar_nacionais` (~193 tokens)

Sincronizar tabelas nacionais (REST)

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.

Input parameters:

- `hash` (string, required): Hash solicitante (ex.: 0 para forçar).
- `salvar_arquivo` (string): Caminho para gravar o SQL descompactado (opcional).
- `versao` (string): Versão desejada (opcional).

### `rest_tabelas_sincronizar_regionais` (~170 tokens)

Sincronizar tabelas regionais (REST)

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.

Input parameters:

- `hash` (string, required): Hash solicitante.
- `proxy` (boolean): Usa o endpoint nacionaiseregionaisproxy (via TRT responsável).
- `tribunal` (string, required): TRT1..TRT24.

### `db_tabelas` (~94 tokens)

Listar tabelas do banco H2

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.

### `db_esquema` (~93 tokens)

Esquema de uma tabela H2

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.

Input parameters:

- `tabela` (string, required): Nome da tabela (ex.: TBSELICDIARIA, TBVERBA, TBCALCULO).

### `db_consultar` (~127 tokens)

Consultar o banco H2 (SELECT)

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.

Input parameters:

- `max_linhas` (integer): Limite de linhas (padrão 200).
- `sql` (string, required): Comando SELECT.

### `db_executar` (~175 tokens)

Executar DML/DDL no banco H2

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.

Input parameters:

- `confirmacao` (string, required): Deve ser exatamente "SIM, EXECUTAR".
- `sql` (string, required): Comando SQL (DML/DDL).

### `db_backup_sql` (~107 tokens)

Backup lógico do banco (SQL)

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.

Input parameters:

- `arquivo` (string): Caminho do .sql de saída (padrão: .dados/pjecalc-backup-<timestamp>.sql).

### `db_backup_arquivo` (~113 tokens)

Backup físico do banco (cópia do .h2.db)

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.

Input parameters:

- `arquivo` (string): Caminho de destino (padrão: .dados/pjecalc.h2.db.bak-<timestamp>).

### `db_restaurar` (~131 tokens)

Restaurar banco a partir de SQL

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.

Input parameters:

- `arquivo` (string, required): Caminho do .sql a executar.
- `confirmacao` (string, required): Deve ser exatamente "SIM, RESTAURAR".

### `config_ler` (~70 tokens)

Ler arquivo de configuração

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.

Input parameters:

- `arquivo` (string, required): Nome do arquivo.

### `config_portas` (~129 tokens)

Ler/alterar portas do Tomcat

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-<timestamp>). O launcher usa a porta HTTP para abrir a interface e troca de porta automaticamente se estiver ocupada.

Input parameters:

- `ajp` (integer): Nova porta AJP (padrão 9258).
- `http` (integer): Nova porta HTTP (padrão 9257).
- `shutdown` (integer): Nova porta de shutdown (padrão 9256).

### `config_memoria` (~74 tokens)

Ler/alterar memória da JVM

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.

Input parameters:

- `xms` (integer): Heap inicial em MB.
- `xmx` (integer): Heap máximo em MB.

### `config_token` (~77 tokens)

Ler/alterar token dos serviços REST

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).

Input parameters:

- `novo_token` (string): Novo token (opcional).

### `config_datasource` (~81 tokens)

Ler/alterar DataSource H2

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.

Input parameters:

- `senha` (string): Nova senha.
- `url` (string): Nova URL JDBC.
- `usuario` (string): Novo usuário.

## Diagnostics

Captured diagnostic sections: Provenance. The full working is on the page: https://verifymcp.io/servers/lucianumm-pjecalc-mcp/pjecalc-mcp-mcp-18#diagnostics

## Score history

- 2026-11-05: 45
- 2026-11-04: 45
- 2026-11-03: 45
- 2026-11-02: 45
- 2026-11-01: 45
- 2026-10-31: 45
- 2026-10-30: 45
- 2026-10-29: 45
- 2026-10-28: 45
- 2026-10-27: 45
- 2026-10-26: 44
- 2026-10-25: 44

## Common questions

### What is the PJe-Calc MCP server?

PJe-Calc MCP is listed in the public MCP registry as io.github.lucianumm/pjecalc-mcp. Monta, liquida, confere e atualiza cálculos trabalhistas no PJe-Calc Cidadão (Windows). This page covers its MCPB bundle (https://github.com/lucianumm/PJeCalcMCP/releases/download/v2.16.0-mcp.18/pjecalc-mcp-2.16.0-mcp.18.mcpb).

### Is the PJe-Calc MCP server safe to use?

PJe-Calc MCP scores 45 out of 100 on VerifyMCP. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the PJe-Calc MCP server expose?

PJe-Calc MCP exposes 72 tools: pjecalc_localizar, pjecalc_status, pjecalc_iniciar, pjecalc_parar, pjecalc_abrir_interface, and 67 more. Their descriptions and schemas cost roughly 11,444 tokens of context every time the server is loaded.

### What licence is the PJe-Calc MCP server under?

PJe-Calc MCP declares the AGPL-3.0-only licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- Repository: https://github.com/lucianumm/PJeCalcMCP
- Changelog RSS feed: https://verifymcp.io/servers/lucianumm-pjecalc-mcp/pjecalc-mcp-mcp-18.xml
- Changelog JSON feed: https://verifymcp.io/servers/lucianumm-pjecalc-mcp/pjecalc-mcp-mcp-18.json
- HTML version of this page: https://verifymcp.io/servers/lucianumm-pjecalc-mcp/pjecalc-mcp-mcp-18