Conector Juspronto

Ler páginas dos autos

ler_paginas

Read-only

Lê o texto de uma ou mais páginas (máximo 8 páginas ou 40 mil caracteres por chamada). Use após uma busca para ler o conteúdo completo de uma evidência. Se vier has_more true, chame de novo com inicio = proximaPagina. inicio e fim são páginas do PDF importado, a mesma numeração de listar_pecas e buscar_autos (paginaLocal). Com pecaId (de listar_pecas ou buscar_autos) a leitura fica dentro da peça: sem inicio começa na primeira página dela, um fim além corta no fim dela e um inicio fora dela devolve PAGINA_FORA_DA_PECA. Cada página traz a citação pronta, como (ID 100000001, p. 2) ou (p. 37 do PDF) sem rodapé do PJe, e o link que abre o processo no JusPronto com o documento destacado. Página que repete o texto de outra dos autos vem com copiaDe (evidenceId, página no PDF e ID do documento da original): cite a original. pecaId que não existe mais devolve PECA_NAO_ENCONTRADA: chame listar_pecas de novo. Sem pecaId, o inicio é obrigatório e a leitura mistura documentos: prefira informar o pecaId.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "processoId": "<processoId>"
    },
    "name": "ler_paginas"
  }
}

Input Schema

Name	Required	Description
`fim`	No	Última página a ler, no número do PDF importado. Com pecaId, além da peça corta no fim dela
`inicio`	No	Primeira página a ler, no número do PDF importado. Com pecaId pode faltar: começa na primeira página da peça. Sem pecaId é obrigatório
`pecaId`	No	ID da peça (de listar_pecas ou de buscar_autos). Com ele, a leitura fica dentro das páginas da peça
`processoId`	Yes	ID do processo

Output Schema

Name	Required	Description	Default
`frescor`	No
`paginas`	No
`has_more`	No
`totalChars`	No
`avisoConteudo`	No
`proximaPagina`	No
`limiteAtingido`	No
`totalPaginasDaPeca`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 26, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": {},
+  "properties": {
+    "avisoConteudo": {
+      "type": "string"
+    },
+    "frescor": {
+      "anyOf": [
+        {
+          "additionalProperties": {},
+          "properties": {
+            "andamentosAte": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "atosDepoisDosAutos": {
+              "items": {
+                "additionalProperties": {},
+                "properties": {
+                  "andamentoId": {
+                    "type": "string"
+                  },
+                  "data": {
+                    "type": "string"
+                  },
+                  "descricao": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "autosAte": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "aviso": {
+              "type": "string"
+            },
+            "djenAte": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "truncado": {
+              "type": "boolean"
+            }
+          },
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "has_more": {
+      "type": "boolean"
+    },
+    "limiteAtingido": {
+      "type": "boolean"
+    },
+    "paginas": {
+      "items": {
+        "additionalProperties": {},
+        "properties": {
+          "autoPaginaId": {
+            "type": "string"
+          },
+          "evidenceId": {
+            "type": "string"
+          },
+          "paginaLocal": {
+            "type": "number"
+          },
+          "texto": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "proximaPagina": {
+      "anyOf": [
+        {
+          "type": "number"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "totalChars": {
+      "type": "number"
+    },
+    "totalPaginasDaPeca": {
+      "type": "number"
+    }
+  },
+  "type": "object"
+}

Changed4 schema fields changedOct 25, 2026

changedInput schema / properties / fim / description

Previous value: -"Número da última página"New value: +"Última página a ler, no número do PDF importado. Com pecaId, além da peça corta no fim dela"

changedInput schema / properties / inicio / description

Previous value: -"Número da primeira página (1‑based)"New value: +"Primeira página a ler, no número do PDF importado. Com pecaId pode faltar: começa na primeira página da peça. Sem pecaId é obrigatório"

changedInput schema / properties / pecaId / description

Previous value: -"ID da peça (opcional)"New value: +"ID da peça (de listar_pecas ou de buscar_autos). Com ele, a leitura fica dentro das páginas da peça"

changedInput schema / required

Previous value: -[
-  "processoId",
-  "inicio",
-  "fim"
-]New value: +[
+  "processoId"
+]

First observedOct 4, 2026

TDQS

A4.8/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations cover only the safety profile (readOnly, non-destructive); the description adds substantial behavior the agent otherwise could not know: clipping within a peça, the PAGINA_FORA_DA_PECA and PECA_NAO_ENCONTRADA error outcomes, the copiaDe duplicate signal with instructions to cite the original, and the citation/link format returned per page.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose, limits and the primary usage rule are front-loaded, and nearly every sentence carries operational content. It is a dense single block, however, and the error/dedup details could be bulleted for faster scanning.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present, the return shape is already structured; the description still covers what matters for correct invocation — pagination, peça scoping, cross-document risk without pecaId, and error recovery. Nothing an agent needs to call this correctly is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3; the description goes beyond it by tying inicio/fim to the same PDF numbering used by listar_pecas and buscar_autos (paginaLocal) and by defining what pecaId does to those bounds. It stops short of, e.g., clarifying the maximum sensible range or interaction of the 8-page cap with inicio/fim.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Opens with a specific verb and resource ('Lê o texto de uma ou mais páginas') plus hard limits (8 páginas / 40 mil caracteres), and explicitly positions itself downstream of a search ('Use após uma busca'). An agent can distinguish it from listar_pecas/buscar_autos, which the description names as its ID sources.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives explicit when-to-use ('após uma busca para ler o conteúdo completo'), a continuation rule ('Se vier has_more true, chame de novo com inicio = proximaPagina'), and a preference statement ('Sem pecaId... prefira informar o pecaId'). It also routes recovery: PECA_NAO_ENCONTRADA → call listar_pecas again.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Conector Juspronto tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?