⚖️ Open Legal Chile

---

📑 Tabla de Contenidos

1. 🌟 Visión, Filosofía y Soberanía Jurídica
2. 🏗️ Arquitectura del Ecosistema
3. ⚡ Instalación y Puesta en Marcha
4. 🔌 Catálogo Exhaustivo de Herramientas MCP (64 Herramientas)
5. 🏛️ Los 10 Conectores Oficiales del Estado de Chile
6. 📚 La Base Doctrinal Canónica y la Dimensión Procesal Forense
7. ⚖️ Módulos Forenses y Pedagógicos de Especialidad
8. 🧠 Catálogo de Skills y Subagentes (18 Especialidades)
9. 💻 Guía Completa de la Consola CLI (openlegal)
10. 🛡️ Certificación de Auditoría Institucional 360° (AUDIT.md)
11. 🧪 Pruebas Automatizadas y Verificación Continua
12. 📜 Licencia, Ética Forense y Responsabilidad Profesional
13. 🌱 Cómo Contribuir

---

🌟 1. Visión, Filosofía y Soberanía Jurídica

Open Legal Chile es una infraestructura de software de código abierto diseñada para transformar la práctica legal, la docencia universitaria y la investigación forense en la República de Chile.

A diferencia de los modelos de inteligencia artificial genéricos y comerciales diseñados bajo la óptica del Common Law anglosajón, Open Legal Chile fue concebido desde sus cimientos para el Sistema de Derecho Continental (Civil Law) chileno:

🏛️ Principios Fundamentales del Sistema Jurídico Chileno

• Primacía de la Ley Escrita: La ley es una declaración de la voluntad soberana que, manifestada en la forma prescrita por la Constitución, manda, prohíbe o permite (Art. 1 del Código Civil).
• Efecto Relativo de las Sentencias: Las sentencias judiciales no tienen fuerza obligatoria sino respecto de las causas en que actualmente se pronunciaren (Art. 3 inc. 2 del Código Civil). No rige el precedente vinculante anglosajón (stare decisis), pero la unificación jurisprudencial de la Corte Suprema y la doctrina administrativa de la Contraloría (CGR) y la Dirección del Trabajo (DT) fijan los criterios rectores del ordenamiento.
• Prohibición Absoluta de Anglicismos y Figuras Foráneas: Queda terminantemente vetada la extrapolación de conceptos ajenos a la tradición procesal chilena (at-will employment, punitive damages, discovery, subpoena, grand jury, deposition, Title VII, FLSA). Se emplea exclusivamente el léxico forense y sustantivo chileno (necesidades de la empresa, finiquito con reserva de derechos, fuero laboral, tutela de derechos fundamentales, daño moral, daño emergente, lucro cesante, otrosí, reposición, apelación, casación en la forma y en el fondo, presuma OJV).
• Estándar Obligatorio de Citación Oficial:
  • Ley o Código: [BCN - Código Civil, Art. 1545] o [BCN - Ley N° 21.643 Ley Karin, Art. 2]
  • Constitución: [BCN - CPR, Art. 19 N° 1]
  • Fallo Corte Suprema: [CS - Rol N° 12.345-2023, Fecha: 15-11-2023]
  • Dictamen DT: [Dictamen DT N° 1234/15 de 2024]
  • Dictamen CGR: [Dictamen CGR N° E123456 (2024)]
  • Circular SII: [Circular SII N° 45 (2023)]
  • Norma CMF: [NCG CMF N° 461]

🛡️ Soberanía Tecnológica y Secreto Profesional ($0 y Cero API Keys)

El ejercicio del Derecho exige reserva y confidencialidad absoluta:

1. 100% Gratuito y Libre: No requiere licencias comerciales, tokens de pago ni tarjetas de crédito.
2. Cero Fuga de Datos (Zero Data Leak): El Motor Soberano Local y los modelos abiertos vía Ollama (llama3.2, deepseek-r1, qwen2.5) procesan causas, contratos y escritos judicialmente confidenciales de manera 100% local en tu propio computador, preservando el secreto profesional (Art. 247 del Código Penal) y la Ley N° 19.628 sobre Protección de la Vida Privada.
3. Acceso Público a Fuentes del Estado: Las conexiones con la BCN, CGR, DT, PJUD, CNE, CMF, SII, SMA y TDLC operan contra repositorios públicos abiertos del Estado de Chile sin necesidad de registro ni llaves de pago.

---

🏗️ 2. Arquitectura del Ecosistema

La suite opera bajo el estándar internacional Model Context Protocol (MCP), permitiendo a cualquier agente o entorno interactuar con la infraestructura jurídica chilena:

┌─────────────────────────────────────────────────────────────────────────────────────────┐
│                           CLIENTES Y AGENTES DE IA SOPORTADOS                           │
│                                                                                         │
│   Google Antigravity      Claude Code (CLI)      Claude Desktop      Cursor / VS Code   │
│   (Google AI Pro)         (Anthropic)            (Cowork)            (Codex / Roo Code) │
└────────────────────────────────────────┬────────────────────────────────────────────────┘
                                         │ JSON-RPC 2.0 (stdio)
┌────────────────────────────────────────▼────────────────────────────────────────────────┐
│                       SERVIDOR MAESTRO MCP (mcp_server.py)                              │
│                                                                                         │
│   • 63 Herramientas Forenses Registradas (v1.4.0 Suite Edition)                         │
│   • Motor de Agentes Jurídicos Autónomos Soberanos (agents_runtime.py)                  │
│   • Generador Estandarizado de Recursos de Protección OJV (recurso_proteccion.py)       │
│   • Knowledge Graph Jurídico y Ahorro de Tokens (legal_graphify.py)                     │
│   • Telemetría Ética de Adopción y Auto-Actualización (stats_tracker.py, update_checker.py)│
│   • Motor de Estudio de Títulos Decenal CBR (cbr_titles.py)                              │
│   • Auditor de Mandatos Judiciales Art. 7 CPC (cbr_titles.py)                            │
│   • Deconstructor Estructural de Sentencias Art. 170 CPC (sentencias_parser.py)         │
│   • Validador Oficial de RUT y Directorio de Órganos Públicos (entes_publicos.py)       │
│   • Guías Oficiales de la Academia Judicial de Chile (academia_judicial_connector.py)   │
│   • Sincronizador de Biblioteca Online y Datasets Markdown (online_library_sync.py)     │
│   • Motor de Doctrina Canónica FTS5 BM25 (doctrina_connector.py)                        │
│   • Motor de Crítica Forense en 5 Dimensiones (critique.py)                             │
│   • Vigilante de Proveídos y Plazos Fatales OJV (docket_watcher.py)                     │
│   • Simulador Socrático de Examen de Grado (examen_grado.py)                            │
│   • Asistente Social de Clínica Jurídica y Lenguaje Claro (clinica_juridica.py)         │
│   • Módulo de Peritaje OCR y Compilador de Expedientes A4 (pdf_dossier_compiler.py)     │
│   • Modelador de Grafos de Vínculos y Probidad Pública (grafo_vinculos.py)              │
│   • Exportador Forense OJV Ley N° 20.886 (exporters.py)                                 │
└────────────────────────────────────────┬────────────────────────────────────────────────┘
                                         │ Consultas Locales y Red Oficial
┌────────────────────────────────────────▼────────────────────────────────────────────────┐
│                     10 CONECTORES OFICIALES DEL ESTADO DE CHILE                         │
│                                                                                         │
│   [BCN Ley Chile XML]   [Contraloría CGR]   [Dirección del Trabajo DT]  [PJUD / Suprema]│
│   [Tribunal Const.]     [CNE Energía]       [Panel de Expertos]         [CMF Valores]   │
│   [SII Tributario]      [SMA SNIFA Ambient] [TDLC Libre Competencia]                    │
└─────────────────────────────────────────────────────────────────────────────────────────┘

---

⚡ 3. Instalación y Puesta en Marcha

[!TIP] ¿Deseas instalar Open Legal Chile como Plugin en 1-Click o 1-Comando?
Consulta la guía detallada en PLUGINS.md para Claude Code, Cursor, VS Code, Windsurf y Smithery.ai.

Opción A: Como Plugin Nativo en Claude Code (1-Comando)

claude plugin add elpabloultron/open-legal-chile

O como servidor MCP:

claude mcp add open-legal-chile python3 -m openlegal mcp

Opción B: Autodetección 1-Click en Cursor y VS Code / Windsurf

1. Clona o abre la carpeta del proyecto en Cursor o VS Code:

   git clone https://github.com/elpabloultron/open-legal-chile.git
   cursor open-legal-chile
   

2. Cursor detectará automáticamente .cursor/mcp.json y solicitará autorización para activar el servidor en un solo clic ("Enable").
3. En VS Code / Windsurf / Cline, .vscode/mcp.json activa las 64 herramientas de inmediato.

Opción C: Instalación Global vía Smithery.ai (1-Comando)

Registro oficial: smithery.ai/servers/pablobenavidesjorquera/open-legal-chile

# Conectar servidor en clientes compatibles (Claude, Cursor, etc.):
npx -y smithery mcp add pablobenavidesjorquera/open-legal-chile

Opción D: Instalación vía PyPI (Producción)

pip install openlegal-chile

El paquete incluye el corpus doctrinal (58 obras canónicas en Markdown) y el grafo de conocimiento ya construido, así que graphify_* y doctrina_search funcionan sin clonar nada más. El índice FTS5 de doctrina se construye solo en la primera búsqueda (unos segundos). Si instalas solo los módulos (por ejemplo copiando archivos sueltos), el motor lo dirá en vez de responder "no encontrado" a todo: esa fue la falla silenciosa de las versiones anteriores a la 1.5.4.

Para leer documentos escaneados o fotografiados (boletas, escrituras, expedientes), instala el extra de OCR:

pip install "openlegal-chile[ocr]"

Sin ese extra el motor usa Tesseract, que sirve para escaneos limpios pero falla con fotos torcidas o de baja resolución (en pruebas con dos boletas notariales fotografiadas: 0 caracteres con Tesseract a cualquier rotación, 553 y 525 caracteres con RapidOCR). El extractor informa siempre qué motor usó y, si una página no rinde texto, lo advierte en vez de reportar éxito.

Opción E: Instalación desde Código Fuente (Desarrollo)

git clone https://github.com/elpabloultron/open-legal-chile.git
cd open-legal-chile
pip install -e .

Opción F: Integración en Google Antigravity

Configura tu mcp_config.json apuntando al repositorio:

{
  "mcpServers": {
    "open-legal-chile": {
      "command": "python3",
      "args": ["-m", "openlegal", "mcp"],
      "env": {
        "PYTHONIOENCODING": "utf-8"
      }
    }
  }
}

⚙️ Modos de Inferencia: Soberano vs. Modelos Externos

Open Legal Chile opera por defecto en Modo Soberano (100% gratuito y sin enviar datos al exterior):

• Motor Soberano: Se activa automáticamente sin necesidad de configurar claves.
• Ollama Local (Opcional): Si tienes Ollama corriendo en localhost:11434, la suite detecta y utiliza tus modelos locales de forma inmediata.
• Proveedores Comerciales (Opcionales): Si decides voluntariamente conectar APIs comerciales de pago, puedes configurar las variables en tu archivo .env:

  # Totalmente opcionales (el sistema funciona al 100% sin ellas)
  ANTHROPIC_API_KEY="sk-ant-..."
  GEMINI_API_KEY="AIzaSy..."
  DEEPSEEK_API_KEY="sk-..."
  OPENAI_API_KEY="sk-..."
  

---

🔌 4. Catálogo Exhaustivo de Herramientas MCP (64 Herramientas Oficiales)

El servidor MCP expone 64 herramientas oficiales categorizadas funcionalmente:

A. Legislación y Códigos de la República

Herramienta MCP	Parámetros	Descripción de Operatividad
bcn_get_codigo	codigo (str), articulo (str, opc)	Consulta artículos o estructura de los 9 Códigos fundamentales chilenos (Civil, Trabajo, Procedimiento Civil, Penal, Comercio, Tributario, Minería, Aguas, Procesal Penal) en la BCN.
bcn_get_ley	numero (int), articulo (str, opc)	Descarga y parsea el texto oficial de cualquier ley de la República (ej. Ley 21.643 Karin, Ley 21.561 40 Horas, Ley 20.886 OJV).

B. Jurisprudencia y Dictámenes Vinculantes

Herramienta MCP	Parámetros	Descripción de Operatividad
cgr_search_jurisprudencia	query (str)	Busca dictámenes vinculantes en la jurisprudencia administrativa de la Contraloría General de la República.
cgr_search_auditorias	query (str)	Consulta el catálogo de más de 9.600 Informes Finales de Auditoría e investigaciones especiales de la CGR.
dt_search_doctrina	query (str)	Busca dictámenes y doctrina laboral vinculante de la Dirección del Trabajo (DT) con enlace al texto completo.
pjud_search_jurisprudencia	query (str), sala (str, opc)	Busca fallos rectores de la Corte Suprema (Unificación Laboral, Tercera Sala Constitucional, Primera Sala Civil) y fallos del Tribunal Constitucional (TC).

C. Regulación Sectorial e Instituciones Públicas

Herramienta MCP	Parámetros	Descripción de Operatividad
cne_get_centrales_y_proyectos	region (str, opc)	Consulta centrales generadoras activas, capacidad instalada y proyectos energéticos en el SEA de la Comisión Nacional de Energía.
panel_expertos_search	query (str)	Busca dictámenes vinculantes e inapelables sobre discrepancias técnicas y tarifarias en el Panel de Expertos de la Ley Eléctrica.
cmf_search_normativa	query (str)	Consulta Normas de Carácter General (NCG) y circulares de la Comisión para el Mercado Financiero (CMF).
sii_search_circulares	query (str)	Consulta circulares oficiales e instrucciones del Director del Servicio de Impuestos Internos (SII).
sma_search_sancionatorios	query (str)	Consulta expedientes sancionatorios ambientales y Programas de Cumplimiento (PdC) en el SNIFA de la SMA.
tdlc_search_jurisprudencia	query (str)	Consulta sentencias y resoluciones del Tribunal de Defensa de la Libre Competencia (TDLC).

D. Doctrina Dogmática y Dimensión Procesal Forense

Herramienta MCP	Parámetros	Descripción de Operatividad
doctrina_search	query (str), area (str, opc), autor (str, opc), limit (int)	Búsqueda por relevancia semántica FTS5 y BM25 en tratados chilenos (Peñailillo, Ramos Pazos, Barros Bourie, Gamonal, Bermúdez, Cury, Maturana, Cea Egaña).
doctrina_get_institucion	nombre (str), area (str, opc)	Recupera la ficha dogmática y forense completa: definición canónica, requisitos, operativa procesal forense, concordancias BCN y fallos rectores.
doctrina_list_obras	(ninguno)	Lista todos los manuales y tratados dogmáticos indexados con sus estadísticas de instituciones y tokens.
doctrina_ingestar_documento	file_path (str), area (str, opc), tratadista (str, opc), obra (str, opc), actualizar_grafo (bool)	Convierte documentos (PDF, DOCX, TXT, MD) a Markdown canónico token-optimizado (RAE/ASALE y BCN/CS) y sincroniza de inmediato el Knowledge Graph y SQLite FTS5.

E. Docencia y Examen de Grado

Herramienta MCP	Parámetros	Descripción de Operatividad
grado_interrogar	materia (str), dificultad (str)	Simula una interrogación socrática de examen de grado en Derecho Civil o Procesal, evaluando respuestas con pauta dogmática estricta.
grado_generar_cedula	tema (str)	Genera una cédula completa de examen de grado con casos prácticos, artículos legales vinculados, doctrina canónica y pauta de evaluación.
grado_obtener_flashcards	area (str), tipo (str)	Genera fichas mnemotécnicas de definiciones sacramentales y plazos procesales fatales para estudio intensivo.

F. Vigilancia Procesal y Proveídos Judiciales

Herramienta MCP	Parámetros	Descripción de Operatividad
vigilante_analizar_resolucion	resolucion_texto (str), procedimiento (str)	Analiza proveídos judiciales de la OJV ("traslado", "autos para resolver", "téngase por contestada"), clasifica sus efectos y calcula plazos fatales en días hábiles (Art. 66 CPC).
vigilante_radar_normativo	materia (str), dias_atras (int)	Monitorea novedades normativas del Diario Oficial, dictámenes de la Contraloría y circulares tributarias.
vigilante_contrato_plazos	tipo_contrato (str), fecha_vencimiento (str), preaviso_dias (int)	Calcula ventanas de preaviso, plazos de desahucio y cláusulas de tácita reconducción para contratos civiles y mercantiles.

G. Clínica Jurídica y Lenguaje Claro

Herramienta MCP	Parámetros	Descripción de Operatividad
clinica_lenguaje_claro	texto_resolucion (str), destinatario (str)	Traduce proveídos y sentencias técnicas a lenguaje ciudadano, empático y comprensible para personas en situación de vulnerabilidad.
clinica_intake_social	materia (str), datos_usuario (dict)	Genera la ficha sociojurídica de ingreso para consultorios de asistencia judicial en materias de familia, precario y alimentos.
clinica_auditar_borrador	borrador_texto (str), tribunal (str)	Audita formalmente el borrador de un escrito redactado por un pasante o alumno antes del visado del tutor (presuma, patrocinio y petitorio).

H. Transparencia, Probidad y Modelado de Redes

Herramienta MCP	Parámetros	Descripción de Operatividad
infoprobidad_get_dip	query_or_url (str)	Extrae y estructura las Declaraciones de Intereses y Patrimonio (DIP) de autoridades públicas desde InfoProbidad (Ley N° 20.880).
generar_grafo_vinculos	nodes, edges, title	Modela redes societarias, parentescos y relaciones de interés público en diagramas Mermaid y exportaciones JSON.

I. Peritaje Documental y Tramitación OJV

Herramienta MCP	Parámetros	Descripción de Operatividad
ocr_extract_pdf	pdf_path, start_page, end_page, force_ocr, dpi, lang	Extrae texto nativo o ejecuta OCR pericial (Tesseract) sobre expedientes judiciales escaneados y escrituras públicas notariales.
compile_legal_dossier	markdown_content, output_pdf_path, annexes	Compila escritos judiciales en formato PDF A4 institucional, ensambla anexos documentales foliados y genera versión optimizada.
export_brief_ojv	titulo, tribunal, comparecencia, hechos, derecho, peticiones, otrosies	Genera y formatea un escrito judicial formal para la Oficina Judicial Virtual (OJV) en .html, .md, .txt y .json.

J. Privacidad (ARCO) y Propiedad Industrial (INAPI)

Herramienta MCP	Parámetros	Descripción de Operatividad
privacidad_tramitar_arco	tipo_derecho, solicitante, rut, datos_solicitados	Tramita y redacta modelos oficiales de respuesta a solicitudes de Acceso, Rectificación, Cancelación u Oposición (Ley N° 19.628).
inapi_cease_and_desist	marca_afectada, titular, infractor, hechos_infraccion	Redacta cartas notariales formales de Cese y Desistimiento por infracción marcaria (Ley N° 19.039) o derechos de autor (Ley N° 17.336).
inapi_evaluar_marca	marca_propuesta, clase_niza	Evalúa la viabilidad y distintividad de un signo en el Clasificador de Niza ante el registro marcario de INAPI.

K. Investigación Analítica Asistida (Google NotebookLM)

Herramienta MCP	Parámetros	Descripción de Operatividad
notebooklm_list_notebooks	(ninguno)	Lista todos los cuadernos de investigación jurídica creados con metadatos y fuentes.
notebooklm_create_notebook	title (str)	Crea un nuevo cuaderno de investigación jurídica estructurado en NotebookLM.
notebooklm_add_source	notebook_id, file_path, title	Ingesta expedientes, sentencias o doctrina local como fuentes probatorias en el cuaderno.
notebooklm_query	notebook_id, prompt	Ejecuta consultas de alta precisión con citas exactas referenciadas (grounded citations).

L. Práctica Forense Inmobiliaria, Títulos CBR y Mandato Judicial

Herramienta MCP	Parámetros	Descripción de Operatividad
cbr_estudio_titulos	inscripciones (list), anios_requeridos (int)	Audita la cadena de dominio decenal (10 años, Arts. 2510-2511 Código Civil) e inscripciones CBR detectando rupturas en la tradición, gravámenes no alzados o falta de posesión efectiva.
cbr_checklist_documentos	tipo_inmueble (str)	Retorna el checklist exhaustivo de documentos obligatorios para estudio de títulos (GP 30 años, dominio vigente, certificados DOM, TGR).
cpc_validar_mandato	texto_mandato (str)	Audita formalmente el otrosí o escritura de patrocinio y poder (Ley N° 18.120), verificando facultades ordinarias (Art. 7 inc. 1) y extraordinarias expresas (Art. 7 inc. 2 CPC: transigir, percibir, desistirse).