MCP Legal Chile

Conector MCP libre y gratuito de derecho chileno para Claude, Cursor y apps compatibles.

Licencia: MIT — código abierto
Producción: https://mcp-legal-chile.onrender.com/mcp
Versión: 1.23.3
Roadmap: docs/ROADMAP.md · Changelog: CHANGELOG.md

Proyecto libre

Este MCP usa solo fuentes públicas sin costo de API:

No se usan APIs comerciales (Serper, Brave, vLex, etc.).
PJUD no publica API de texto: para citar Corte Suprema / Apelaciones, pega el fallo en citar_jurisprudencia.

Acceso abierto por defecto (sin MCP_API_KEYS). Redis es opcional para self-host.
CONTACT_EMAIL activa el polite pool de OpenAlex/Crossref (mailto=).

Excepción — pjudCauses (§ Case-tracking PJUD): a diferencia de todo lo anterior, esta función sí elude una protección anti-bot (paga un solver de CAPTCHA para pasar el WAF F5/TSPD de PJUD). Está deshabilitada por defecto y es responsabilidad de quien la active.

Related MCP server: saij-mcp

Matriz de honestidad (qué trae cada tool)

Integridad (anti-alucinación): cada resultado lleva integrity:

Calidad de citas: jurisprudencia unifica el formato chileno (tribunal, tipo, ROL, año, considerando); la web ya no usa el título de página como cita. Doctrina normaliza autores (Apellido, N.), completa vol./páginas DOAJ y prioriza relevancia temática + catálogo Chile. Niveles de integrity: verified | candidate | portal_stub (evidence puede ser full_text / metadata / link_only).

Reglas: si evidence=link_only o integrity es portal_stub/candidate, no afirmes el contenido. citar_jurisprudencia rechaza un considerando que no exista en el texto (no sustituye por otro). Sin resultados → decirlo; no completar con memoria.

Cómo usarlo sin quedarse corto

1. Empieza con catalogo_flujos o preparar_entregable / asesorar (modo=auto infiere el flujo).

2. Extrae texto con citar_texto_legal, obtener_articulo, obtener_fallo_tc o citar_jurisprudencia.

3. Fallos PJUD: abre el portal unificado, copia el texto → indice_considerandos y/o pegar_fallo_pjud.

4. Dictámenes CGR: resolver_dictamen (enlace) → pega el cuerpo en citar_dictamen_pegado.

5. Entregables: plantilla_escrito, anexo_citas, minuta_cliente / aviso_desde_causa.

6. Carpeta: lista_antecedentes → minuta_cliente (solicitud_antecedentes).

7. Seguimiento: obtener_causa_pjud → comparar_actuaciones → aviso al cliente.

8. Resources MCP: legalchile://guia/memo, .../escrito, .../seguimiento, .../honestidad, .../dia-tipico.

9. Si te trabas: siguiente_paso con el estado actual (pack_listo, causa_obtenida, etc.).

10. Guía completa: docs/flujo-estudio.md.

SLOs (objetivos P95)

Métricas en vivo: GET /metrics

Capacidades principales

• Texto oficial LeyChile (artículos, índice/cuerpo, inciso/literal heurístico)

• Doctrina OA: ranking por relevancia, abstracts (backfill Crossref), enrich SciELO

• citar_jurisprudencia con considerando (TC o texto pegado)

• Caché en memoria (Redis opcional)

• Rate limit / circuit breaker por proveedor (LeyChile XML aislado de BCN SPARQL/HTML; DOAJ aislado de Crossref; abort/deadline no abre circuitos; un solo conteo terminal tras reintentos)

• Warmup boot + GET /warmup (cron) omiten XML si LeyChile está en cooldown 429 / circuito abierto

• Endurecimiento de producción: CORS explícito para clientes MCP en navegador, rate limit por IP en /mcp (60 req/min por defecto, independiente de las cuotas por API key), errores JSON-RPC limpios (sin stack traces ni rutas de archivo aunque NODE_ENV no esté seteado), apagado ordenado ante SIGTERM/SIGINT, timeouts de socket HTTP contra clientes lentos, y uncaughtException/unhandledRejection no derriban el proceso

Nota clientes MCP (Hermes, etc.): un mensaje global tipo «MCP unreachable» tras ~3 errores suele ser protección del cliente, no del servidor. En el servidor los circuitos son por host; ante 429 o circuito abierto de LeyChile las tools de texto devuelven markdown útil (URL oficial + reintento) sin marcar isError cuando es posible.

Inicio rápido

npm install
npm run dev
npm test
SMOKE_BASE=http://127.0.0.1:3000 npm run smoke

MCP: http://localhost:3000/mcp

Variables de entorno

Case-tracking PJUD (experimental/no oficial)

buscar_causa_pjud / obtener_causa_pjud automatizan la Consulta Unificada de Causas de PJUD (Oficina Judicial Virtual) para devolver estado, litigantes y movimientos por RUT/nombre o ROL/RIT/RUC. A diferencia de todo el resto de este proyecto:

• Elude activamente el WAF anti-bot (F5/TSPD) de PJUD usando un navegador headless (Playwright) y un servicio de pago de resolución de CAPTCHA (2Captcha o CapSolver).

• No es una API oficial ni endorsada por PJUD: los datos son siempre integrity=candidate, obtenidos por scraping, y pueden romperse sin aviso si PJUD cambia su HTML/anti-bot.

• Implica un riesgo de Términos de Servicio que asume explícitamente quien habilite la función (ver docs/pjud-casetracking-solution.md para el diseño completo).

Deshabilitada por defecto (kill switch): si PJUD_CAUSAS_ENABLED != 1 o no hay un solver de CAPTCHA configurado, ambas tools degradan a una respuesta tipo portal_stub con el link a la Consulta Unificada, nunca fallan en silencio ni inventan datos.

npm run build/postinstall no descarga Chromium salvo que PJUD_CAUSAS_ENABLED=1 esté seteado en tiempo de instalación (ver scripts/installPlaywright.mjs), así el build por defecto (p. ej. render.yaml) permanece liviano.

Deploy

Blueprint: render.yaml — plan free, sin Key Value de pago ni API keys comerciales. pjudCauses está comentado en el blueprint por defecto: requiere una API key de pago (agrégala manualmente en el dashboard de Render si decides habilitarla).

Aviso

No sustituye asesoría jurídica. PJUD/CGR no ofrecen API abierta de texto completo. El MCP es un puente gratuito a fuentes oficiales y OA.