Skip to main content
Glama
notluquis

mcp-pjud

by notluquis
OverviewSchemaSourceRelated ServersScoreDiscussionsAdmin
Python
Remote

Buscar causa por RUT de empresa

buscar_causa_por_rut_juridica
Read-onlyIdempotent

Search court cases for a legal entity by its RUT. Retrieve case listings for companies, the only method without requiring Clave Única.

Instructions

Busca causas de una persona jurídica por su RUT.

Es la única vía para empresas: no tienen Clave Única, así que no aparecen en "Mis Causas".

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
rutYesRUT sin dígito verificador ni puntos.
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.
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
digito_verificadorYesDígito verificador: 0-9 o K.

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

A4.6/5.0
Behavior5/5

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

The annotations already mark the tool read-only/idempotent, and the description adds valuable non-obvious behavior: field presence varies by competencia, null means the competence does not publish the field rather than the cause lacking it, and penal has no detail by decision. These details materially affect how results are interpreted and chained.

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 front-loaded with purpose and use-case, and most sentences carry warnings an agent needs. It loses the top score because the paragraph on per-competencia column publication overlaps with the output schema and makes the definition denser than strictly necessary.

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?

Given 7 parameters, 6 competencias, and several sibling interactions, the description covers critical call-routing and result-interpretation concerns: field variation, null semantics, detail-tool chaining, and required filters. With an output schema present, it is not required to restate return values, so no essential gap remains.

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 baseline applies. The prose mostly restates the schema's tribunal/corte requirements rather than adding new syntax or format details; the useful framing that RUT searches must be restricted is already implied by the schema's 'Obligatorio' conditions.

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 sentence names the exact operation ('Busca causas de una persona jurídica por su RUT'), including a specific resource and search key. It further differentiates the tool by stating it is the only route for companies and by explicitly routing history/parties/notifications to obtener_detalle_causa.

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 says when to use it ('Es la única vía para empresas') and when to switch to obtener_detalle_causa or listar_tribunales/listar_cortes. It also provides competence-specific routing rules: civil/cobranza/laboral/penal require tribunal, apelaciones requires corte and not tribunal, and suprema requires neither.

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

Install Server

Other Tools

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