mcp-pjud

Servidor MCP no oficial de solo lectura para la consulta pública de causas del Poder Judicial de Chile.

Proyecto independiente, sin relación alguna con el Poder Judicial de Chile ni con la Corporación Administrativa del Poder Judicial.

Solo consulta información pública. No permite el ingreso de escritos ni ninguna operación de escritura, y no existe código para hacerlo, ni siquiera desactivado.

Qué resuelve

Consulta cualquier causa civil pública y devuelve sus actuaciones del ministro de fe con la fecha real de diligencia, que es la que corre los plazos procesales.

Ese dato no viene en el ebook que entrega la Oficina Judicial Virtual, y en la interfaz web aparece en un formato que se presta a confusión:

Fec. Trámite:  31/03/2026 (27/03/2026)
                registro    diligencia

Las dos fechas comparten una celda y sólo la del paréntesis corre plazos. Acá salen como campos separados y en ISO 8601.

C-1156-2026 del 2º Juzgado Civil de Concepción, seis actuaciones en dos cuadernos:

Leer sólo el cuaderno que la web abre por defecto habría devuelto las tres del principal y ninguna del apremio.

Related MCP server: bjn-uy-mcp

Antes de instalar: la licencia

PolyForm Strict 1.0.0 permite ejecutar el software con fines no comerciales, y nada más.

Si facturas a tus clientes necesitas permiso escrito, aunque uses la herramienta sólo para tus propias causas. También para modificarla o distribuirla.

Se pide abriendo un issue y se otorga caso a caso, sin costo. La licencia restrictiva existe para saber quién usa esto y para qué, no para cobrar.

Dos aclaraciones que suelen hacer falta:

• No es open source en sentido estricto, porque restringe modificación, distribución y uso comercial. El término correcto es source-available. Que GitHub permita forkear no otorga derecho a redistribuir: eso lo define la licencia, no el botón.

• Los pull requests sí son bienvenidos. El acuerdo de contribución te da el permiso para modificar que la licencia por sí sola no otorga, y conservas la propiedad de tu aporte. La idea es que se contribuya al proyecto, no que cualquiera publique su versión.

El razonamiento completo, con las familias de licencia que se descartaron y por qué, está en la página de licencia.

Instalación

No hace falta clonar: uvx descarga y ejecuta. Requiere uv y Python 3.13 o superior.

Reemplaza tu@correo.cl por tu correo real en cualquiera de las formas de abajo. Ese dato viaja en el User-Agent para que el Poder Judicial pueda identificar a quien consulta, y sin él el servidor no arranca.

Claude Code

claude mcp add pjud -e MCP_PJUD_CONTACTO=tu@correo.cl \
  -- uvx --from git+https://github.com/notluquis/mcp-pjud-cl mcp-pjud

Cursor y VS Code

Los botones dejan el correo como marcador. Edítalo en la configuración del editor, o el servidor falla con un mensaje que te lo recuerda.

Claude Desktop, Codex y cualquier otro cliente

{
  "mcpServers": {
    "pjud": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/notluquis/mcp-pjud-cl", "mcp-pjud"],
      "env": { "MCP_PJUD_CONTACTO": "tu@correo.cl" }
    }
  }
}

El transporte es stdio: no abre puertos ni escucha en la red. Para fijar una versión, agrega @v0.1.0 al final de la URL de git.

Herramientas

Ambas anotadas como readOnlyHint y destructiveHint: false en el protocolo. Referencia completa de campos y ejemplos resueltos.

Cómo se comporta

Uso responsable

• Una consulta cada 5 segundos como mínimo, no configurable hacia abajo. Es la cláusula CUARTA de las condiciones de uso de la Oficina Judicial Virtual, que prohíbe sobrecargar el portal, implementada en código.

• Detención total ante 403, 429 o captcha. Sin reintento, sin rotación de IP, sin evasión.

• Sin persistencia. Se consulta y se devuelve.

• Bitácora de peticiones en memoria, para acreditar uso razonable.

Perder el acceso mientras corren plazos en un litigio activo es peor que no obtener el dato. Ese criterio manda sobre cualquier ganancia de velocidad.

Límites conocidos

• Sólo competencia civil verificada. Las otras seis se rechazan en vez de adivinar sus parámetros.

• Las causas reservadas no aparecen. Un resultado vacío no prueba que la causa no exista.

• Una búsqueda muy amplia levanta excepción en vez de devolver una lista recortada. Acota la consulta o sube el tope de páginas.

• corte sin valor por defecto a propósito: fijarla produce falsos negativos.

• Si la plataforma cambia, el parser levanta excepción en vez de devolver vacío. Una lista vacía se leería como "no hubo actuaciones", y así se pierden plazos.

Documentación

mcp-pjud-cl.readthedocs.io, organizada por tarea:

En el repositorio: cómo contribuir · acuerdo de contribución · uso aceptable · seguridad · soporte · código de conducta · cambios · instrucciones para agentes de IA

Desarrollo

git clone https://github.com/notluquis/mcp-pjud-cl && cd mcp-pjud-cl
uv sync --all-groups
uv run pytest        # sin red
uv run ruff check .

Los tests corren contra HTML real guardado en tests/fixtures/, anonimizado. Ninguno consulta al Poder Judicial.

main exige pull request. Antes de proponer cambios, lee cómo contribuir.

Esto acerca la fuente oficial. No reemplaza la revisión de un abogado ni la lectura del expediente.