Jusratio Case File
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GEMINI_API_KEY | No | Recommended (BYOK) — used locally for OCR and semantic search. Without it, native PDFs work fully; scanned pages stay pending OCR. | |
| GEMINI_OCR_MODEL | No | Optional OCR model override. Default: gemini-3.5-flash. | |
| JUSRATIO_CASES_DIR | Yes | Required local directory for all case files and generated artifacts. | |
| GEMINI_EMBEDDING_MODEL | No | Optional embedding model override for semantic search. Default: gemini-embedding-2. | |
| JUSRATIO_OCR_MAX_CONCURRENCY | No | Optional OCR concurrency limit. Default: 2. | |
| JUSRATIO_OCR_MAX_RETRY_ATTEMPTS | No | Optional per-page OCR retry limit. Default: 3. | |
| JUSRATIO_OCR_APPROVAL_PAGE_THRESHOLD | No | Pages of pending OCR above which explicit approval is required. Default: 25. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| criar_caso_localB | Cria um caso local a partir de um PDF que ja esteja dentro da pasta autorizada e inicia a ingestao em background. Retorne ao usuario o case_id e acompanhe com status_caso. |
| status_casoA | Progresso da ingestao local: paginas processadas, OCR pendente, alertas e estado do job. |
| listar_casosA | Lista os casos existentes na pasta autorizada, com partes, páginas, estado e achados no dossiê. Use quando o usuário não nomear o caso — NUNCA presuma qual é. |
| case_fileB | Mapa compacto do caso (cobertura, eventos datados e radar quando existirem), sem paginas inteiras. |
| mapa_do_cadernoA | Índice dos autos: os DOCUMENTOS do caderno processual (peças, contratos, certidões) com intervalo de páginas, assinante e data de juntada, extraídos do rodapé do PJe. Use para montar linha do tempo, localizar a fonte primária de um documento e atribuir alegações à peça correta. Filtro opcional por tipo de peça. |
| linha_do_tempoA | Cronologia determinística do caso: eventos datados + data de juntada de cada documento do caderno (rodapé do PJe), ordenados. Use ESTA tool para linha do tempo em vez de abrir páginas uma a uma. Filtro opcional por período (de/ate, ISO). |
| anotar_achadoA | Registra no DOSSIÊ persistente do caso um fato apurado (frase curta) com seus evidence_ids — o lastro é validado contra o índice. Use durante investigações longas: o dossiê sobrevive à compactação da conversa e a novas sessões. |
| dossieB | Restaura o estado da investigação: todos os achados registrados no caso, cada um com seus evidence_ids. Comece por aqui ao retomar uma investigação (nova conversa ou histórico compactado). |
| buscar_no_processoA | Busca local nas evidencias do processo (hibrida quando o caso tem indice semantico; senao lexical com ranking). Cada resultado traz evidence_id, pagina, um trecho e o DOCUMENTO de origem (peça/contrato + data de juntada) — hit dentro de uma petição é alegação da parte, não fato provado. Abra o verbatim com abrir_trecho antes de citar. |
| abrir_trechoB | Reabre o verbatim de uma evidencia pelo evidence_id. Use antes de citar qualquer trecho em pecas ou relatorios. |
| abrir_paginaB | Texto extraido de uma pagina especifica do processo. Devolve tambem 'original': caminho local + link file:// do PDF da pagina, para o usuario conferir no original com um clique. |
| exportar_documentoA | Converte um relatorio/minuta/pacote em DOCX (Word) e grava em exports/ dentro da pasta do caso; por padrao ja abre o arquivo no computador. TODO entregavel para o usuario final sai por aqui — nunca arquivo solto em pasta temporaria. Formatacao forense automatica (A4, Times 12, justificado, titulos pretos). Passe o titulo COM acentuacao normal (so o nome do arquivo e gerado sem acentos). Se o markdown ja abrir com um titulo (#), nao sera duplicado. Markdown suportado: titulos, listas, negrito/italico, tabelas e citacoes em recuo (>). |
| abrir_no_computadorA | Abre NO COMPUTADOR do usuario o PDF da pagina (visualizador padrao) ou o processo integral; com revelar=true, revela o arquivo no Explorer/Finder. Use quando o usuario quiser VER o original. So abre arquivos do proprio caso, dentro da pasta autorizada. |
| montar_pacote_evidenciasC | Pacote compacto de fatos com evidence_id, cobertura e queries sugeridas para o MCP de jurisprudencia conectado no workspace. |
| indexar_semanticaA | Gera embeddings locais BYOK para busca por significado (variações morfológicas e paráfrases). Opt-in com teto explícito de chamadas Gemini; idempotente — re-rodar só embeda o que falta. |
| retomar_ingestaoA | Retoma a ingestao local sem repetir trabalho ja feito: use apos reinicio do cliente, quando a chave Gemini passar a existir ou apos autorizar_ocr. |
| autorizar_ocrA | Autoriza a execucao de OCR BYOK com tetos explicitos de paginas e chamadas. Obrigatorio quando status_caso indicar paused_awaiting_ocr_approval. |
| analisar_radar_processual_civelC | Apontamentos processuais civeis candidatos (prazos e oportunidades) ancorados em evidence_ids; nao emite conclusao final de prazo. |
| analisar_caso_civelD | Macro local: combina cobertura, radar processual e pacote de evidencias, com lacunas explicitas. Respeite global_analysis_allowed. |
| consultar_prazos_referenciaA | Tabela local CURADA de prazos cíveis (CPC) com base legal — fonte única de prazos do produto. Filtro opcional por ato/tipo/artigo. Referência para conferência do advogado; nunca calcule data final. |
| registrar_jurisprudenciaA | Registra no caso os doc_ids REAIS retornados pelo MCP de jurisprudencia conectado. Unico caminho para que verificar_referencias aceite um doc_id. |
| verificar_referenciasB | Valida evidence_ids do processo e doc_ids registrados ANTES do relatorio final. Nada deve ser afirmado ao usuario sem passar por aqui. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 22 tools
Most tools have clearly distinct purposes with detailed descriptions that remove ambiguity: buscar_no_processo searches, abrir_trecho opens a verbatim excerpt, anotar_achado writes to the dossier. A few pairs could still confuse an agent, notably case_file vs mapa_do_caderno (both are 'maps' of the case, though one is a summary and the other a document index) and analisar_radar_processual_civel vs analisar_caso_civel (both analyses, distinguished mainly by scope).
The dominant pattern is Portuguese infinitive verb + object (anotar_achado, abrir_pagina, exportar_documento, verificar_referencias), but several tools break it: case_file is in English, and dossie, status_caso, mapa_do_caderno, and linha_do_tempo are noun phrases rather than verb-led names. The mixed conventions remain readable, but the English outlier is a notable inconsistency.
At 22 tools, the surface sits in the 16-25 range that feels heavy for an agent to navigate. The scope is broad (ingestion, search, analysis, export, validation) so most tools earn their place, but some could plausibly be merged, such as the two analisar_* tools or the several abrir_* variants.
The tool set covers the full investigation lifecycle well: create/ingest a case (criar_caso_local, status_caso, retomar_ingestao, autorizar_ocr), navigate and search (mapa_do_caderno, linha_do_tempo, buscar_no_processo), record findings (anotar_achado, dossie), analyze (analisar_caso_civel, consultar_prazos_referencia), validate (verificar_referencias), and export (exportar_documento). Minor gaps exist: there is no way to update or delete a registered achado, and no tool to list or query registered jurisprudence directly.