# Conector MCP — Tribunal Ambiental (Segundo TA, Santiago)

Conecta Claude a la información pública de causas del **Segundo Tribunal
Ambiental** (Santiago), sobre su API REST/JSON (lexsoft). Pensado para rastrear
la judicialización de RCA de proyectos (renovables incluidos): quién reclama qué
resolución, en qué estado va la causa y qué dice el expediente.

## Herramientas

| Herramienta | Qué hace |
|---|---|
| `novedades(dias, limite)` | Movimientos recientes (estado diario): resoluciones/escritos con rol, carátula, referencia, tipo y fecha. |
| `buscar_causas(consulta, dias, limite)` | Busca causas por rol, carátula o parte dentro de la ventana de días. |
| `ver_causa(id_causa)` | Detalle: estado, materia, partes, ministros, plazos, cuadernos, acumuladas. |
| `expediente(id_causa, limite)` | Lista de trámites de la causa (resoluciones y escritos) con fecha, etapa, estado y foja. |
| `leer_documento(url, paginas)` | Descarga un PDF (p. ej. una sentencia) y extrae su texto. |

## Cómo funciona

Usa endpoints **públicos y stateless** confirmados: estado diario por rango de
fechas, cuadernos y trámites por causa, y los datos de la causa (partes,
ministros, plazos). La búsqueda se arma sobre los movimientos de los últimos N
días (por defecto 60); para causas sin movimiento reciente, amplía `dias`.

## Despliegue (igual que los otros conectores)

1. **GitHub**: sube estos archivos a un repo.
2. **Railway**: New Project → Deploy from GitHub repo → detecta el Dockerfile →
   Settings → Networking → Generate Domain. (Escucha en el puerto 8080.)
3. **Claude**: Configuración → Conectores → Agregar conector personalizado →
   `https://TU-DOMINIO.up.railway.app/mcp`.

## Alcance y límites (honesto)

- **Público y funciona**: buscar/ver causas, expediente, partes, ministros,
  plazos, y leer **sentencias** (PDF público en tribunalambiental.cl).
- **Requiere sesión**: la descarga de algunos documentos *dentro* del sistema
  (escritos de parte, ciertas resoluciones) redirige a login de abogado.
  `leer_documento` lo detecta y avisa (`requiere_sesion`).
- **Búsqueda por ventana**: encuentra causas con movimiento en los últimos
  `dias`; no es un buscador histórico completo (el buscador oficial está
  acoplado a sesión).
- **Un tribunal**: cubre el 2º TA (Santiago). El 1º (Antofagasta) y 3º
  (Valdivia) usan la misma plataforma; se agregan apuntando `TRIBUNAL_BASE`
  a sus hosts.

## Variables de entorno

| Variable | Efecto | Default |
|---|---|---|
| `TRIBUNAL_BASE` | Base del sistema de causas | `https://2ta.lexsoft.cl/2ta` |
| `MCP_TRANSPORT` | `streamable-http` o `stdio` | `streamable-http` |
| `PORT` | Puerto HTTP | `8080` |