Skip to main content
Glama
Sign In

Clerk - IA Legal Dominicana

by do.clerk
OverviewDiscussionsAdmin

Leer doctrina

leer_doctrina
Read-only

El texto de una obra de la biblioteca, por páginas, extraído de su PDF oficial. Se pide con el isbn13 que devuelve buscar_doctrina, o con la clave de un artículo de articulos_de_revista.

Cinco modos. Sin más argumentos, la FICHA: cuántas páginas tiene y, si el PDF lo trae, su ÍNDICE con la página de cada sección. Con articulo, la página donde empieza ese artículo de un código o reglamento (reconoce el encabezado «Art. N.-», no las menciones del artículo dentro de otros ni el índice). Con buscar, las páginas donde aparece el término y su contexto; no distingue tildes ni mayúsculas. Con desde/hasta, ese tramo entero (hasta 120 páginas por lectura). Con pagina, esa página sola. Y con entrada (sin isbn13), el lema del Diccionario Jurídico Dominicano: va directo a su página.

⚠️ Empieza por la ficha. Si la obra trae índice, localiza la sección por ahí y pide sus páginas con desde/hasta: es más barato y más fiel que barrer el libro. Si no trae índice, usa buscar.

⚠️ La página que devuelve es la del PDF, y es la que se usa en la cita («pág. 214»). Cita SOLO lo leído con pagina o desde/hasta, literal: el contexto de buscar localiza, no se cita.

⚠️⚠️ Si la respuesta trae aviso_cobertura, la búsqueda NO miró la obra entera. Un cero ahí significa «no está en las páginas que miré», nunca «no está en la obra»: dilo así o no lo digas.

⚠️⚠️ DE QUIÉN SON LAS PALABRAS. Cada tramo dice dónde cae y de quién es, igual que el texto de una sentencia: · es_cita: true → el tramo está DENTRO DE COMILLAS: son palabras que el autor CITA, no suyas. Atribuírselas es el mismo error que citar un voto disidente como criterio del tribunal. · autor → en una OBRA COLECTIVA, quién firma ESE capítulo. Se cita a esa persona, no al coordinador ni a la institución que edita. · es_aparato: true → el acierto está en el índice, las abreviaturas o la bibliografía. La palabra sale de verdad, pero la obra NO trata el asunto ahí. · seccion → el epígrafe bajo el que cae, para juzgar si viene a cuento. · aviso_citas → el libro no marca sus citas, así que NO se puede saber si un pasaje es del autor o de alguien a quien cita. No lo atribuyas.

⚠️ Con un término frecuente, mira donde_aparece ANTES que los tramos: dice en qué epígrafes se concentra el término y quién los firma. Ocho tramos sueltos de un término que sale 500 veces son ruido; el reparto dice dónde vive el asunto, y entonces se piden ESAS páginas con desde/hasta.

⚠️ La primera lectura tarda unos segundos; las siguientes son inmediatas. No es un fallo: no reintentes por lentitud.

Input Schema

NameRequiredDescriptionDefault
claveNoLa clave de un artículo de revista (`articulos_de_revista` de buscar_doctrina), en lugar del isbn13.
desdeNoPrimera página de un tramo a leer entero (1-based). Úsalo con lo que diga el índice.
hastaNoÚltima página del tramo. Como mucho 120 páginas por lectura; si pides más, se recorta y se dice.
buscarNoTérmino a localizar dentro de la obra. No distingue tildes ni mayúsculas.
isbn13NoEl isbn13 de la obra, tal como lo devuelve buscar_doctrina.
paginaNoPágina del PDF a leer entera (1-based).
entradaNoUn lema del Diccionario Jurídico Dominicano («anatocismo», «desahucio»). Lee su página directamente, en cualquiera de los dos tomos, sin isbn13.
articuloNoNúmero del artículo a localizar en un código o reglamento. Devuelve la página donde empieza.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / clave
      Added value: +{
+  "description": "La clave de un artículo de revista (`articulos_de_revista` de buscar_doctrina), en lugar del isbn13.",
+  "type": "string"
+}
  2. Changed2 schema fields changed
    • addedInput schema / properties / entrada
      Added value: +{
+  "description": "Un lema del Diccionario Jurídico Dominicano («anatocismo», «desahucio»). Lee su página directamente, en cualquiera de los dos tomos, sin isbn13.",
+  "type": "string"
+}
    • removedInput schema / required
      Removed value: -[
-  "isbn13"
-]
  3. First observed

TDQS

A4.5/5.0
Behavior4/5

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

Beyond readOnlyHint/openWorldHint it discloses latency on first read, the truncation behavior («se recorta y se dice») and, critically, the meaning of aviso_cobertura — a zero means 'not in the pages I scanned'. It even warns about attribution risks via es_cita, autor, es_aparato and aviso_citas, which annotations cannot express. Slight deduction because this is delivered as long policy prose rather than a compact behavioral contract.

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

Conciseness3/5

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

Front-loaded purpose and mode enumeration are good, but the ⚠️ stack is long and partly restates schema text (the 120-page cap appears in both the description and two schema fields), and the citation-etiquette block is agent policy rather than tool-selection information. Density is justified by complexity, but trimming is possible.

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?

There is no output schema, and the description compensates by naming every returned field of consequence — ficha/índice, es_cita, autor, es_aparato, seccion, aviso_citas, donde_aparece, aviso_cobertura — with enough semantics to interpret them correctly. Nothing an agent needs to call or read the result 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, but the description adds real meaning the schema lacks: the mutual-exclusion/mode model across eight all-optional params, that `articulo` matches the «Art. N.-» heading and not in-text mentions or the index, and that `entrada` bypasses isbn13 entirely.

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+resource+scope: «El texto de una obra de la biblioteca, por páginas, extraído de su PDF oficial», and immediately states the identifier source (isbn13 from buscar_doctrina, clave from articulos_de_revista). An agent can tell this apart from the retrieval siblings without opening the schema.

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?

Explicitly enumerates five invocation modes and what each returns, plus routing advice: «Empieza por la ficha… Si no trae índice, usa buscar». It also covers the alternative sources of identifiers and a negative case («no reintentes por lentitud»).

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

All Clerk - IA Legal Dominicana 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