Skip to main content
Glama

Buscar causa por nombre

buscar_causa_por_nombre
Read-onlyIdempotent

Search public Chilean court cases by litigant name. Merges accented and unaccented surname variants in one query, preventing incomplete results.

Instructions

Busca causas por nombre de litigante.

Exige al menos DOS de los tres campos de nombre. El año no cuenta para ese mínimo.

LA TILDE IMPORTA: la plataforma distingue tildes y guarda el mismo apellido de las dos formas. Medido en un tribunal: sin tilde salen 5 causas, con tilde 25, casi sin repetirse. Esta herramienta busca las DOS grafías y las fusiona, así que no hay que repetir la búsqueda. Pero no puede adivinar dónde va la tilde: si el nombre se pasa SIN acentos, sólo trae la forma sin acentos. Pásalo con sus tildes correctas, o la lista seguirá incompleta sin que se note.

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.

Las búsquedas por nombre, por RUT y por fecha hay que acotarlas, y con qué depende de la competencia: civil, cobranza, laboral y penal exigen tribunal; apelaciones exige corte y NO acepta tribunal; suprema no exige ninguna de las dos. La búsqueda por rol no exige acotar en ninguna.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
anioNoAño de ingreso, opcional.
corteNoCódigo de la corte, para acotar la búsqueda. Obligatorio 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.
nombreNoNombres del litigante.
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, para acotar la búsqueda. Obligatorio cuando la competencia es una de: civil, cobranza, laboral y penal. En apelaciones y suprema la plataforma no lo usa.
competenciaNoUna de: apelaciones, civil, cobranza, laboral, penal, suprema.civil
apellido_maternoNoApellido materno del litigante.
apellido_paternoNoApellido paterno del litigante.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
resultYes

Schema Changelog

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

  1. Changed10 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, para acotar la búsqueda. Obligatorio 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 / 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, para acotar la búsqueda. Obligatorio cuando la competencia es una de: civil, cobranza, laboral y penal. 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. Changed11 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 / 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

A5/5.0
Behavior5/5

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

Beyond the readOnly/idempotent annotations, the description discloses accent-sensitive matching, the tool's fusion of both accent spellings, the failure mode when `paginas` is exceeded, the meaning of null values for different competencias, and the fact that penal has no detalle by decision. These are non-obvious platform behaviors an agent must know before calling the tool.

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 long but every paragraph earns its place: purpose, name-field requirement, accent warning, field/null semantics, detail-routing, and scoping rules. It is front-loaded with the core purpose and organized into coherent blocks. Despite the density, there is no filler.

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 complex 8-parameter search with zero required fields in the schema, the description resolves the most dangerous ambiguities: minimum name fields, accent behavior, pagination failure, per-competencia scoping, and routing to detail/search siblings. Since an output schema exists, return-value documentation is not required. Nothing essential is missing.

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

Parameters5/5

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

Although schema coverage is 100%, the description adds the critical rule that at least two of the three name parameters are required and that `anio` does not count toward that minimum. It also adds competition-dependent semantics for `tribunal` and `corte`, and explains that `paginas` over the cap causes failure rather than silent truncation. This goes well beyond the schema's field descriptions.

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 opening line 'Busca causas por nombre de litigante' names the verb, resource, and search axis. It also differentiates from siblings by stating that history, partes, and notificaciones belong to `obtener_detalle_causa`. Even the grouping with 'por RUT y por fecha' clarifies that this is the name-based sibling.

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?

The description explicitly tells the agent when to use `obtener_detalle_causa` instead, including the fields to repeat, and when to use `listar_tribunales` or `listar_cortes` to resolve codes. It also explains per-competencia scoping requirements for `tribunal` and `corte`, including that apelaciones rejects tribunal and suprema requires neither. This is direct, alternative-aware 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