Lê uma página do acervo em Markdown, com as seções, as perguntas frequentes e as fontes oficiais com URL — é por elas que se confere o que a página afirma.
| Name | Required | Description | Default |
|---|---|---|---|
| caminho | Yes | rota canônica devolvida pela busca, com barra final (ex.: /consumidor/produto-com-defeito/) |
| Name | Required | Description | Default |
|---|---|---|---|
| titulo | Yes | ||
| caminho | Yes | ||
| dossier | No | ||
| markdown | Yes | ||
| url_canonica | Yes |
Changes observed during successful MCP inspections.
Output schema / properties / dossierAdded value: +{
+ "additionalProperties": false,
+ "properties": {
+ "claims": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "kind": {
+ "type": "string"
+ },
+ "literal_span": {
+ "additionalProperties": false,
+ "properties": {
+ "derivative_ref": {
+ "type": "string"
+ },
+ "end_byte": {
+ "type": "integer"
+ },
+ "quote": {
+ "type": "string"
+ },
+ "quote_sha256": {
+ "type": "string"
+ },
+ "source_reference_id": {
+ "type": "string"
+ },
+ "start_byte": {
+ "type": "integer"
+ },
+ "text_sha256": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "source_reference_id",
+ "derivative_ref",
+ "text_sha256",
+ "start_byte",
+ "end_byte",
+ "quote",
+ "quote_sha256"
+ ],
+ "type": [
+ "null",
+ "object"
+ ]
+ },
+ "source_refs": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "null",
+ "array"
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "verification": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "kind",
+ "text",
+ "source_refs",
+ "verification"
+ ],
+ "type": "object"
+ },
+ "type": [
+ "null",
+ "array"
+ ]
+ },
+ "content_sha256": {
+ "type": "string"
+ },
+ "context": {
+ "additionalProperties": false,
+ "properties": {
+ "area": {
+ "type": "string"
+ },
+ "genre": {
+ "type": "string"
+ },
+ "id": {
+ "type": "string"
+ },
+ "jurisdiction_status": {
+ "type": "string"
+ },
+ "knowledge_as_of": {
+ "type": "string"
+ },
+ "legal_time_status": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "path",
+ "area",
+ "genre",
+ "knowledge_as_of",
+ "jurisdiction_status",
+ "legal_time_status"
+ ],
+ "type": "object"
+ },
+ "id": {
+ "type": "string"
+ },
+ "projection_version": {
+ "type": "string"
+ },
+ "recipe": {
+ "type": "string"
+ },
+ "refinement_issues": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "action": {
+ "type": "string"
+ },
+ "code": {
+ "type": "string"
+ },
+ "id": {
+ "type": "string"
+ },
+ "scope": {
+ "type": "string"
+ },
+ "severity": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "code",
+ "scope",
+ "action",
+ "severity"
+ ],
+ "type": "object"
+ },
+ "type": [
+ "null",
+ "array"
+ ]
+ },
+ "schema": {
+ "type": "string"
+ },
+ "sources": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "capture": {
+ "additionalProperties": false,
+ "properties": {
+ "binding": {
+ "type": "string"
+ },
+ "derivative": {
+ "additionalProperties": false,
+ "properties": {
+ "extractor": {
+ "type": "string"
+ },
+ "extractor_version": {
+ "type": "string"
+ },
+ "index_policy": {
+ "type": "string"
+ },
+ "model_sha256": {
+ "type": "string"
+ },
+ "pages": {
+ "type": "integer"
+ },
+ "profile": {
+ "type": "string"
+ },
+ "publication_allowed": {
+ "type": "boolean"
+ },
+ "ref": {
+ "type": "string"
+ },
+ "render_allowed": {
+ "type": "boolean"
+ },
+ "runtime_sha256": {
+ "type": "string"
+ },
+ "sitemap_allowed": {
+ "type": "boolean"
+ },
+ "source_bytes": {
+ "type": "integer"
+ },
+ "source_receipt_sha256": {
+ "type": "string"
+ },
+ "source_ref": {
+ "type": "string"
+ },
+ "source_sha256": {
+ "type": "string"
+ },
+ "text_bytes": {
+ "type": "integer"
+ },
+ "text_runes": {
+ "type": "integer"
+ },
+ "text_sha256": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "ref",
+ "source_ref",
+ "source_receipt_sha256",
+ "source_sha256",
+ "source_bytes",
+ "text_sha256",
+ "text_bytes",
+ "text_runes",
+ "pages",
+ "extractor",
+ "extractor_version",
+ "profile",
+ "runtime_sha256",
+ "model_sha256",
+ "publication_allowed",
+ "render_allowed",
+ "sitemap_allowed",
+ "index_policy"
+ ],
+ "type": "object"
+ },
+ "excerpt": {
+ "additionalProperties": false,
+ "properties": {
+ "derivative_ref": {
+ "type": "string"
+ },
+ "end_byte": {
+ "type": "integer"
+ },
+ "quote": {
+ "type": "string"
+ },
+ "quote_sha256": {
+ "type": "string"
+ },
+ "source_reference_id": {
+ "type": "string"
+ },
+ "start_byte": {
+ "type": "integer"
+ },
+ "text_sha256": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "source_reference_id",
+ "derivative_ref",
+ "text_sha256",
+ "start_byte",
+ "end_byte",
+ "quote",
+ "quote_sha256"
+ ],
+ "type": "object"
+ },
+ "proof": {
+ "additionalProperties": false,
+ "properties": {
+ "adquirido_em": {
+ "type": "string"
+ },
+ "aquisicao_ate_referencia": {
+ "type": [
+ "null",
+ "boolean"
+ ]
+ },
+ "fonte_oficial_certificada": {
+ "type": "boolean"
+ },
+ "receipt_sha256": {
+ "type": "string"
+ },
+ "referencia_em": {
+ "type": "string"
+ },
+ "schema": {
+ "type": "string"
+ },
+ "source_bytes": {
+ "type": "integer"
+ },
+ "source_ref": {
+ "type": "string"
+ },
+ "source_sha256": {
+ "type": "string"
+ },
+ "status": {
+ "type": "string"
+ },
+ "url_conferida_no_recibo": {
+ "type": "string"
+ },
+ "vigencia_certificada": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "schema",
+ "status",
+ "source_ref",
+ "source_sha256",
+ "source_bytes",
+ "receipt_sha256",
+ "url_conferida_no_recibo",
+ "adquirido_em",
+ "fonte_oficial_certificada",
+ "vigencia_certificada"
+ ],
+ "type": "object"
+ },
+ "text_coverage": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text_coverage",
+ "binding",
+ "proof",
+ "derivative",
+ "excerpt"
+ ],
+ "type": [
+ "null",
+ "object"
+ ]
+ },
+ "checked_at": {
+ "type": "string"
+ },
+ "id": {
+ "type": "string"
+ },
+ "license_note": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "origin_id": {
+ "type": "string"
+ },
+ "source_id": {
+ "type": "string"
+ },
+ "text_version": {
+ "type": "string"
+ },
+ "text_version_checked_at": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "source_id",
+ "name",
+ "url",
+ "checked_at"
+ ],
+ "type": "object"
+ },
+ "type": [
+ "null",
+ "array"
+ ]
+ },
+ "status": {
+ "type": "string"
+ },
+ "title": {
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ },
+ "version": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "schema",
+ "recipe",
+ "id",
+ "version",
+ "content_sha256",
+ "context",
+ "title",
+ "url",
+ "sources",
+ "claims",
+ "refinement_issues",
+ "status"
+ ],
+ "type": [
+ "null",
+ "object"
+ ]
+}Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true, so safety is covered; the description adds useful content-level context by naming the sections, FAQ, and URL-bearing sources that come back and framing their verification purpose. It says nothing about failure modes (invalid/non-canonical path, missing page) or result size, which matter for a fetch-style tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
One front-loaded sentence stating the action, the format, and the payload. The trailing clause about verifying claims earns its place as a usage cue, though the em-dash aside is slightly verbose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With an output schema present, the description needn't enumerate return fields, and it still gives a useful shape of what's inside (sections, FAQ, sourced URLs). For a one-parameter read-only tool this is nearly complete; only error/edge behavior is absent.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% and the single 'caminho' parameter is fully documented in the schema (canonical route with trailing slash, example given). The description adds no parameter detail beyond that, so baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Names a specific verb and resource ('Lê uma página do acervo') and the returned format (Markdown), plus the payload contents (seções, perguntas frequentes, fontes oficiais com URL). It doesn't explicitly differentiate itself from siblings like buscar_paginas or ler_duvida, but the read-single-canonical-page scope is inferable.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Implies it is used to open a page obtained from search and to verify what the page asserts via its official sources, but never states when to prefer it over buscar_paginas or ler_duvida, nor any exclusions or prerequisites.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.