Skip to main content
Glama
Sign In

acervo-juridico

by br.com.wikijuridica
OverviewDiscussionsAdmin

contexto_juridico

Read-only

Monta o contexto jurídico denso para uma pergunta: para cada página relevante, tese (resumo), dispositivos legais com URN LexML, precedentes do grafo que citam os mesmos dispositivos, fontes oficiais com data de conferência e a citação pronta (cite-as). Junta a busca por significado (quando armada) com a lexical. Nada é gerado: cada bloco é o que a página publicada afirma, com a URL para conferir.

Input Schema

NameRequiredDescriptionDefault
areaNoslug da área para filtrar (opcional)
paginasNoquantas páginas compõem o contexto (padrão 3, teto 8)
perguntaYespergunta jurídica em português

Output Schema

NameRequiredDescriptionDefault
avisoYes
blocosYes
metodoYes
perguntaYes
risco_de_superacaoYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedOutput schema / properties / blocos / items / properties / dossier
      Added 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"
+  ]
+}
    • addedOutput schema / properties / blocos / items / properties / dossier_error
      Added value: +{
+  "type": "string"
+}
  2. Changed2 schema fields changed
    • addedOutput schema / properties / blocos / items / properties / risco_de_superacao
      Added value: +true
    • changedOutput schema / properties / blocos / items / required
      Previous value: -[
-  "caminho",
-  "titulo",
-  "area",
-  "url",
-  "url_markdown",
-  "tese",
-  "dispositivos",
-  "precedentes",
-  "fontes_oficiais",
-  "revisado_em",
-  "origem"
-]New value: +[
+  "caminho",
+  "titulo",
+  "area",
+  "url",
+  "url_markdown",
+  "tese",
+  "dispositivos",
+  "precedentes",
+  "fontes_oficiais",
+  "revisado_em",
+  "origem",
+  "risco_de_superacao"
+]
  3. Added

TDQS

A3.8/5.0
Behavior4/5

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

The annotations already declare readOnlyHint=true, openWorldHint=false and idempotentHint=false, so the description does not need to establish safety. It adds real behavioural context: 'Nada é gerado: cada bloco é o que a página publicada afirma, com a URL para conferir', a no-generation grounding guarantee. It also describes how retrieval is assembled, combining semantic search when armed with lexical search.

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

Conciseness5/5

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

The description is three dense sentences: it states the purpose first, then the composition of the output, and ends with a grounding guarantee. Every clause carries information, and no wording repeats the title or the schema.

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

Completeness4/5

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

An output schema exists and the annotations cover the read-only profile, so the return shape and safety profile need no explanation. The description still tells the agent what the blocks are grounded in and how retrieval is fused, which is the remaining gap for an aggregation tool. Only sibling differentiation is missing.

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

Parameters3/5

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

Schema description coverage is 100%, so the schema already documents pergunta, area and paginas (including the default of 3 and the cap of 8). The description adds only the loose phrase 'para cada página relevante' and never explains the area filter or the page cap. Baseline 3 applies because the schema does the heavy lifting.

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

Purpose4/5

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

The description uses a specific verb and resource ('Monta o contexto jurídico denso para uma pergunta') and then enumerates what the result contains: tese, dispositivos com URN LexML, precedentes, fontes com data de conferência and a citação pronta. This makes the tool's output shape unambiguous. However, it never names a sibling tool, so the agent must infer by itself how this differs from buscar_hibrido, buscar_semantico or responder_pergunta.

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

Usage Guidelines3/5

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

Usage is only implied: the tool is for a legal question, and it 'junta a busca por significado (quando armada) com a lexical', which hints at its relation to the semantic and lexical search siblings. The description nonetheless gives no explicit when-to-use rule, no when-not to use it, and it never names an alternative tool; the agent has to infer selection.

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

All acervo-juridico toolsInspect
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