PJe-Calc MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PJECALC_HOME | No | Path to the installed PJe-Calc Cidadão 2.16 folder. Optional when the server can auto-detect the installation; set it explicitly if PJe-Calc is in a location the installer/server does not find. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Servidor MCP do PJe-Calc Cidadão 2.16.0 (Justiça do Trabalho). Para montar um cálculo: (1) leia calculo_modelo_json; (2) consulte catalogo_verbas/catalogo_municipios/catalogo_enums; (3) monte o JSON a partir da sentença; (4) calculo_validar até não haver erros; (5) calculo_criar — gera o .PJC, importa no PJe-Calc, apura o cartão de ponto (se houver jornadas), regera as ocorrências, devolve as pendências e grava o arquivo final "-PRONTO.PJC". O usuário então só clica em Liquidar (ou importa o -PRONTO.PJC em outro PJe-Calc). Antes de liquidar datas recentes: tabelas_status; se desatualizadas, tabelas_atualizar com o TRT do processo (o próprio PJe-Calc baixa do TRT/TRT8). Documentos: documento_inventario (arquivos e páginas, escaneadas a ver como imagem) ou auditor_importar (a leitura feita pelo AuditorProcessual), documento_texto, documento_imagens (as páginas escaneadas em arquivos de imagem), e os conversores holerites_para_historicos, cartoes_para_jornadas, extrato_para_fgts e trct_para_pagamentos (conferem fechamentos; não substituem a leitura). Execução: calculo_atualizar (pagamentos, honorários, multas, pensão alimentícia e custas da execução, precatório/RPV sobre o cálculo homologado liquidado) e calculo_externo_criar (conta homologada feita fora do PJe-Calc). Vários reclamantes ou devedores: calculo_criar_lote. Conta de referência: calculo_comparar_referencia aceita outro cálculo, o relatório em PDF/HTML/texto ou a conta transcrita (referencia_manual). Não use rest_tabelas_* para atualizar índices: são o lado servidor do PJe-Calc local. Nunca escreva cálculos direto no banco H2: isso dessincroniza as sequências do Hibernate e impede o PJe-Calc de criar cálculos.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| pjecalc_localizarA | 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. |
| pjecalc_statusA | 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_iniciarA | 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. |
| pjecalc_pararA | 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. |
| pjecalc_abrir_interfaceA | 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. |
| pjecalc_logsA | Ú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". |
| calculo_modelo_jsonA | 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. |
| processo_mapaA | 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. |
| titulo_comporA | 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. |
| calculo_plano_interpretacaoA | 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. |
| calculo_aprovar_planoA | 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. |
| calculo_documentos_necessariosA | 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. |
| documento_inventarioA | 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. |
| auditor_importarA | 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. |
| documento_textoA | 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. |
| documento_imagensA | 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. |
| holerites_para_historicosA | 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). |
| cartoes_para_jornadasA | 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). |
| extrato_para_fgtsA | 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. |
| trct_para_pagamentosA | 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. |
| calculo_validarA | 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.). |
| calculo_gerar_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. |
| calculo_criarA | 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. |
| calculo_importar_pjcA | 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. |
| calculo_apurar_cartao_pontoA | 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. |
| calculo_ler_pjcA | 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. |
| calculo_pendenciasA | 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. |
| calculo_regerar_ocorrenciasA | 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. |
| calculo_liquidarA | 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. |
| calculo_atualizarA | 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. |
| calculo_externo_criarA | 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. |
| tabelas_statusA | 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. |
| tabelas_atualizarA | 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. |
| calculo_relatorioA | 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. |
| calculo_comparar_referenciaA | 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. |
| calculo_criar_loteA | 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. |
| calculo_exportar_pjcA | 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. |
| calculo_excluirA | 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. |
| calculo_recentesB | Lista "Abrir Cálculos Recentes" da tela inicial do PJe-Calc (número / processo / reclamante). |
| catalogo_verbasA | 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". |
| catalogo_municipiosA | Procura municípios (nome/UF/id) da tabela do PJe-Calc, para preencher calculo.uf e calculo.municipio. |
| catalogo_assuntos_cnjA | Assuntos da Tabela Processual Unificada do CNJ cadastrados no PJe-Calc (código para verbas personalizadas: verbas[].personalizada.assuntoCnj). |
| catalogo_enumsA | 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). |
| catalogo_validar_documentosB | Confere dígitos verificadores (o PJe-Calc recusa número de processo com dígito errado) e devolve o dígito CNJ correto. |
| catalogo_pisos_vtA | 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. |
| catalogo_atividadesA | Atividades econômicas da tabela do PJe-Calc (id e descrição), para contribuicaoSocial.atividadeEconomica (alíquotas do empregador pela atividade). |
| catalogo_feriadosB | 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. |
| catalogo_cartao_pontoA | 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_atualizarA | 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. |
| pjecalc_infoB | 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_paginasA | 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_csvA | 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. |
| rest_selic_periodoA | 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. |
| rest_precatorio_atualizarA | 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. |
| rest_precatorios_sipA | 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. |
| rest_precatorios_sip_indicesB | POST /pjecalc/servico/rest/atualizacao/sip/precatorios/indices — atualiza em lote uma lista de AtualizacaoPrecatorioSIPIndicesDTO. Requer o app em execução. |
| rest_tabelas_ultima_versaoA | 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_versaoA | 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. |
| rest_tabelas_sincronizar_nacionaisA | 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. |
| rest_tabelas_sincronizar_regionaisA | 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. |
| db_tabelasA | 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_esquemaA | 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. |
| db_consultarA | 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. |
| db_executarA | 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. |
| db_backup_sqlA | 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. |
| db_backup_arquivoA | 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. |
| db_restaurarA | 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. |
| config_lerB | 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. |
| config_portasA | 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. |
| config_memoriaA | 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. |
| config_tokenA | 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). |
| config_datasourceA | 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. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| montar-calculo-da-sentenca | Roteiro para o agente transformar sentença/acórdão + dados do contrato num cálculo pronto para liquidar no PJe-Calc. |
| auditoria-pericial-integral | Roteiro de perito calculista: lê o processo inteiro (pedidos, defesa, documentos financeiros, cartões de ponto, todas as decisões e o trânsito) e entrega o plano técnico de liquidação para aprovação, ligado ao contrato de dados. |
| guia-backup-restauracao | Procedimentos de backup/restauração do banco H2 embutido. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| doc-contrato-de-dados | Documentos, decisões, parcelas, afastamentos, remunerações, pagamentos e premissas; vínculos "origem"; o que a auditoria detecta; cenários. |
| doc-modulos-processo | Mapa do processo: fases (pré-processual a execução), processos ligados e seus efeitos, situações especiais (devedores, ente público, recuperação judicial, destinos do crédito). |
| doc-modulos-leitura | Protocolo de leitura de documentos, textos e imagens: inventário, página por página, extração por tipo, dupla leitura, fechamentos, confronto entre documentos, pedidos × decisão. |
| doc-modulos-plano | Estrutura do plano mostrado ao usuário, aprovação com hash do contrato e revisão plano × resultado. |
| doc-precedentes | Precedentes com efeito no cálculo (ADC 58, Lei 14.905/2024, Fazenda Pública, OJ 394, súmulas do TST), com vigência, modulação e parametrização no PJe-Calc. |
| doc-modulos-documentos | Rodadas de coleta, matriz parcela -> documentos, cobertura mês a mês, contrato.coleta e a trava antes de calcular. |
| doc-modulos-titulo-executivo | Cadeia de decisões, alcance, reflexos, contradições. |
| doc-modulos-jornada | Ciclos, limites, domingos, feriados, compensações e afastamentos. |
| doc-modulos-remuneracao-reflexos | Vigências, componentes, médias e duplicidades. |
| doc-modulos-pagamentos | Identidade, abrangência e alocação dos abatimentos. |
| doc-modulos-fgts-tributos | Bases, depósitos, multa, incidências e destino. |
| doc-modulos-atualizacao | Marcos, índices, juros, tabelas e data de comparação. |
| doc-modulos-execucao | Pagamentos da execução (parcelas e componentes, imputação nos juros), honorários, multas, pensão alimentícia e custas da execução, precatório/RPV, Cálculo Externo, regras do aplicativo conferidas antes de importar e a conferência do Resumo da Atualização. |
| doc-modulos-referencia | Comparação com a conta exata na mesma data-base, pontes por verba e bruto -> líquido, causas das diferenças. |
| doc-auditoria-pericial | Roteiro de perito calculista: mapa processual e trânsito, matriz da coisa julgada pedido a pedido, auditoria financeira mês a mês, cartões dia a dia em minutos, parametrização aba por aba e relatório de inconsistências, tudo ligado às ferramentas e ao contrato de dados. |
| doc-controles-interpretacao | Matriz por rubrica, classificação de premissas, componentes da remuneração, conciliação de pagamentos, bases de INSS, juros por fase e reconciliação final — obrigatórios antes de entregar. |
| doc-especificacao-calculo | Todos os campos aceitos pelo gerador, com exemplos. |
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.