Skip to main content
Glama

Buscar causa por rol

buscar_causa_por_rit
Read-onlyIdempotent

Find public Chilean court cases by role type, number, and year. Use it to retrieve court case listings and identify jurisdictions; combine with detail lookup for full records.

Instructions

Busca causas por rol en la consulta pública. Ej: tipo='E', rol=468, anio=2026.

El listado publica lo que la columna trae, y varios campos son de una competencia sola: ruc en cobranza y penal; estado en apelaciones, cobranza, laboral, penal y suprema; tipo_recurso en suprema; ubicacion en apelaciones. En nulo significa que esa competencia no lo publica, no que la causa no lo tenga.

Y no trae historia, partes ni notificaciones: eso es obtener_detalle_causa, repitiendo tipo, rol, año Y competencia, más el tribunal o la corte. Sin repetirlos abre el mismo rol de otra competencia o de otro juzgado, que existe y se ve bien. Si la búsqueda ya iba acotada se reusa ese mismo código; si no, la fila publica el NOMBRE del tribunal o de la corte y el código se resuelve con listar_tribunales o listar_cortes. En suprema no hay ninguno de los dos que resolver ni que repetir, y la competencia se repite igual que en el resto. En penal no hay detalle: se rechaza por decisión, no por no estar medido.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
rolYesNúmero del rol, sin la letra ni el año.
anioYesAño del rol, cuatro dígitos.
tipoYesLetra del rol en civil, cobranza y laboral; en civil son C, V, E, A, F o I y en cobranza A C D E J L P R y en laboral O, medidas. En apelaciones va el LIBRO en vez de una letra (por ejemplo 'Protección' o 'Exhorto'): ahí el número de rol se repite entre libros, así que sin él la consulta es ambigua y la herramienta falla en vez de abrir la causa equivocada. En penal el rol también lleva libro pero se busca por su CÓDIGO: medido, '1' es Ordinaria, y con el nombre el listado vuelve vacío. En suprema el rol no lleva nada adelante y este campo va VACÍO.
corteNoCódigo de la corte. En apelaciones el mismo número de rol existe en varias, así que omitirla devuelve una causa por corte. En el resto, OMITIR salvo certeza: fijarla produce falsos negativos, porque excluye causas radicadas en otra jurisdicción.
paginasNoCuántas páginas de resultados recorrer como máximo. La plataforma devuelve 100 por página. Si la búsqueda excede este tope, la herramienta falla en vez de devolver una lista recortada, porque un listado truncado en silencio se leería como si no hubiera más resultados.
tribunalNoCódigo del tribunal. En civil, cobranza, laboral y penal la plataforma lo acepta opcional, y un rol sin tribunal no identifica una causa: la búsqueda lo devuelve de cada juzgado que lo tenga, y en civil eso midió 43 causas de 43 personas distintas para un solo rol: omitirlo no amplía la búsqueda, la hace barrer y devuelve una causa por juzgado, cada una con sus partes. Indicarlo salvo que se quiera justamente ese barrido. En apelaciones y suprema la plataforma no lo usa.
competenciaNoUna de: apelaciones, civil, cobranza, laboral, penal, suprema.civil

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
resultYes

Schema Changelog

Changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. Changed11 schema fields changedv0.19.3
    • changedInput schema / properties / corte / description
      Previous value: -"Código de la corte. Obligatorio en las búsquedas de nombre, RUT y fecha cuando la competencia es una de: apelaciones, donde la plataforma responde 'Por favor seleccione una Corte para la búsqueda'. En el resto, OMITIR salvo certeza: fijarla produce falsos negativos, porque excluye causas radicadas en otra jurisdicción."New value: +"Código de la corte. En apelaciones el mismo número de rol existe en varias, así que omitirla devuelve una causa por corte. En el resto, OMITIR salvo certeza: fijarla produce falsos negativos, porque excluye causas radicadas en otra jurisdicción."
    • changedInput schema / properties / tipo / description
      Previous value: -"Letra del rol. En civil: C, V, E, A, F o I. En apelaciones, penal va el LIBRO en vez de una letra (por ejemplo 'Protección' o 'Exhorto'): ahí el número de rol se repite entre libros, así que sin él la consulta es ambigua y la herramienta falla en vez de abrir la causa equivocada."New value: +"Letra del rol en civil, cobranza y laboral; en civil son C, V, E, A, F o I y en cobranza A C D E J L P R y en laboral O, medidas. En apelaciones va el LIBRO en vez de una letra (por ejemplo 'Protección' o 'Exhorto'): ahí el número de rol se repite entre libros, así que sin él la consulta es ambigua y la herramienta falla en vez de abrir la causa equivocada. En penal el rol también lleva libro pero se busca por su CÓDIGO: medido, '1' es Ordinaria, y con el nombre el listado vuelve vacío. En suprema el rol no lleva nada adelante y este campo va VACÍO."
    • changedInput schema / properties / tribunal / description
      Previous value: -"Código del tribunal. Obligatorio en las búsquedas de nombre, RUT y fecha cuando la competencia es una de: civil, cobranza, laboral, penal. En apelaciones, suprema la plataforma no lo usa. En la búsqueda por rol es opcional siempre, y omitirlo AMPLÍA los resultados."New value: +"Código del tribunal. En civil, cobranza, laboral y penal la plataforma lo acepta opcional, y un rol sin tribunal no identifica una causa: la búsqueda lo devuelve de cada juzgado que lo tenga, y en civil eso midió 43 causas de 43 personas distintas para un solo rol: omitirlo no amplía la búsqueda, la hace barrer y devuelve una causa por juzgado, cada una con sus partes. Indicarlo salvo que se quiera justamente ese barrido. En apelaciones y suprema la plataforma no lo usa."
    • removedOutput schema / $defs / CausaEncontrada / description
      Removed value: -"Una fila del listado de resultados de búsqueda.\n\nLos campos opcionales existen porque las competencias no publican las mismas columnas:\nla civil no trae estado ni RUC, la penal trae los dos, y la de apelaciones trae la\nubicación física del expediente. Se declaran como opcionales en vez de inventar un valor,\nporque vacío y ausente no son lo mismo."
    • removedOutput schema / $defs / CausaEncontrada / properties / competencia / description
      Removed value: -"Competencia en la que se encontró."
    • removedOutput schema / $defs / CausaEncontrada / properties / estado / description
      Removed value: -"Lo que la competencia publica en su columna de estado, textual. No es el mismo dato en todas: cobranza publica 'Estado Procesal' y laboral, penal, apelaciones y suprema publican 'Estado Causa'. Civil no publica ninguno. Se entrega sin normalizar para no aplanar dos cosas distintas en una."
    • removedOutput schema / $defs / CausaEncontrada / properties / referencia / description
      Removed value: -"Identificador opaco para pedir el detalle. Caduca a los 30 minutos; no se construye ni se guarda, se usa en el acto."
    • removedOutput schema / $defs / CausaEncontrada / properties / ruc / description
      Removed value: -"Sólo en penal y cobranza."
    • removedOutput schema / $defs / CausaEncontrada / properties / tipo_recurso / description
      Removed value: -"Sólo en suprema."
    • removedOutput schema / $defs / CausaEncontrada / properties / tribunal / description
      Removed value: -"Tribunal o corte donde está radicada. En apelaciones y suprema es la corte."
    • removedOutput schema / $defs / CausaEncontrada / properties / ubicacion / description
      Removed value: -"Sólo en apelaciones."
  2. Changed12 schema fields changedv0.4.0
    • changedInput schema / properties / competencia / description
      Previous value: -"Una de: apelaciones, civil, cobranza, familia, laboral, penal, suprema."New value: +"Una de: apelaciones, civil, cobranza, laboral, penal, suprema."
    • changedInput schema / properties / corte / description
      Previous value: -"Código de la corte. OMITIR salvo certeza: fijarla produce falsos negativos, porque excluye causas radicadas en otra jurisdicción."New value: +"Código de la corte. Obligatorio en las búsquedas de nombre, RUT y fecha cuando la competencia es una de: apelaciones, donde la plataforma responde 'Por favor seleccione una Corte para la búsqueda'. En el resto, OMITIR salvo certeza: fijarla produce falsos negativos, porque excluye causas radicadas en otra jurisdicción."
    • changedInput schema / properties / tipo / description
      Previous value: -"Letra del rol. En civil: C, V, E, A, F o I."New value: +"Letra del rol. En civil: C, V, E, A, F o I. En apelaciones, penal va el LIBRO en vez de una letra (por ejemplo 'Protección' o 'Exhorto'): ahí el número de rol se repite entre libros, así que sin él la consulta es ambigua y la herramienta falla en vez de abrir la causa equivocada."
    • changedInput schema / properties / tribunal / description
      Previous value: -"Código del tribunal. Omitir para buscar en todos."New value: +"Código del tribunal. Obligatorio en las búsquedas de nombre, RUT y fecha cuando la competencia es una de: civil, cobranza, laboral, penal. En apelaciones, suprema la plataforma no lo usa. En la búsqueda por rol es opcional siempre, y omitirlo AMPLÍA los resultados."
    • changedOutput schema / $defs / CausaEncontrada / description
      Previous value: -"Una fila del listado de resultados de búsqueda."New value: +"Una fila del listado de resultados de búsqueda.\n\nLos campos opcionales existen porque las competencias no publican las mismas columnas:\nla civil no trae estado ni RUC, la penal trae los dos, y la de apelaciones trae la\nubicación física del expediente. Se declaran como opcionales en vez de inventar un valor,\nporque vacío y ausente no son lo mismo."
    • addedOutput schema / $defs / CausaEncontrada / properties / competencia
      Added value: +{
      +  "description": "Competencia en la que se encontró.",
      +  "title": "Competencia",
      +  "type": "string"
      +}
    • addedOutput schema / $defs / CausaEncontrada / properties / estado
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Lo que la competencia publica en su columna de estado, textual. No es el mismo dato en todas: cobranza publica 'Estado Procesal' y laboral, penal, apelaciones y suprema publican 'Estado Causa'. Civil no publica ninguno. Se entrega sin normalizar para no aplanar dos cosas distintas en una.",
      +  "title": "Estado"
      +}
    • addedOutput schema / $defs / CausaEncontrada / properties / ruc
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Sólo en penal y cobranza.",
      +  "title": "Ruc"
      +}
    • addedOutput schema / $defs / CausaEncontrada / properties / tipo_recurso
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Sólo en suprema.",
      +  "title": "Tipo Recurso"
      +}
    • addedOutput schema / $defs / CausaEncontrada / properties / tribunal / description
      Added value: +"Tribunal o corte donde está radicada. En apelaciones y suprema es la corte."
    • addedOutput schema / $defs / CausaEncontrada / properties / ubicacion
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Sólo en apelaciones.",
      +  "title": "Ubicacion"
      +}
    • changedOutput schema / $defs / CausaEncontrada / required
      Previous value: -[
      -  "rol",
      -  "fecha_ingreso",
      -  "caratulado",
      -  "tribunal",
      -  "referencia"
      -]New value: +[
      +  "rol",
      +  "fecha_ingreso",
      +  "caratulado",
      +  "tribunal",
      +  "referencia",
      +  "competencia"
      +]
  3. First observedv0.1.0

TDQS

A4.6/5.0
Behavior5/5

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

Annotations already mark the tool read-only and idempotent, and the description adds meaningful behavioral context beyond that: null fields mean that competence does not publish them, the listing excludes history/parties/notifications, and some fields are only populated for specific competences. It also warns that penal has no detalle by design.

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?

The description is long but dense: it front-loads the core purpose and example, then covers output caveats, alternative tools, and edge cases. It could be better structured with shorter paragraphs or bullets, but nearly every sentence earns its place given the tool's complexity.

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?

For a tool with seven parameters, multiple competences with different semantics, and nuanced output behavior, the description covers the important edge cases: null meaning, per-competence fields, the detalle alternative, suprema behavior, penal rejection, and tribunal/corte disambiguation. The output schema covers return structure, so nothing an agent needs for correct invocation 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 all seven parameters thoroughly. The description adds contextual examples and calls out how tipo/tribunal/competencia behave differently across competences, but the parameter-heavy lifting is already done in the schema, making the baseline of 3 appropriate.

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?

The description opens with a specific verb and resource ('Busca causas por rol en la consulta pública') and a concrete example ('tipo='E', rol=468, anio=2026'). It clearly distinguishes this tool from obtener_detalle_causa and related lookup tools, so an agent can tell what it is for.

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?

It states when this tool is appropriate (searching by RIT) and explicitly routes to obtener_detalle_causa when history, parties, or notifications are needed. It also explains when to use listar_tribunales or listar_cortes to resolve names to codes, and notes the penal exclusion, which is strong usage guidance.

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

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/notluquis/mcp-pjud-cl'

If you have feedback or need assistance with the MCP directory API, please join our Discord server