Open Legal Chile

⚖️ Open Legal Chile

Infraestructura Abierta de Inteligencia Jurídica, Servidor MCP y Conectores Oficiales para el Ordenamiento Jurídico de la República de Chile

---

📑 Tabla de Contenidos

1. [🌟 Visión, Filosofía y Soberanía Jurídica](#-1-visión-filosofía-y-soberanía-jurídica)
2. [🏗️ Arquitectura del Ecosistema](#-2-arquitectura-del-ecosistema)
3. [⚡ Instalación y Puesta en Marcha](#-3-instalación-y-puesta-en-marcha)
4. [🔌 Catálogo Exhaustivo de Herramientas MCP (64 Herramientas)](#-4-catálogo-exhaustivo-de-herramientas-mcp-64-herramientas-oficiales)
5. [🏛️ Los 10 Conectores Oficiales del Estado de Chile](#-5-los-10-conectores-oficiales-del-estado-de-chile)
6. [📚 La Base Doctrinal Canónica y la Dimensión Procesal Forense](#-6-la-base-doctrinal-canónica-y-la-dimensión-procesal-forense)
7. [⚖️ Módulos Forenses y Pedagógicos de Especialidad](#-7-módulos-forenses-y-pedagógicos-de-especialidad)
8. [🧠 Catálogo de Skills y Subagentes (18 Especialidades)](#-8-catálogo-de-skills-y-subagentes-18-especialidades)
9. [💻 Guía Completa de la Consola CLI (openlegal)](#-9-guía-completa-de-la-consola-cli-openlegal)
10. [🛡️ Certificación de Auditoría Institucional 360° (AUDIT.md)](#-10-certificación-de-auditoría-institucional-360-auditmd)
11. [🧪 Pruebas Automatizadas y Verificación Continua](#-11-pruebas-automatizadas-y-verificación-continua)
12. [📜 Licencia, Ética Forense y Responsabilidad Profesional](#-12-licencia-ética-forense-y-responsabilidad-profesional)
13. [🌱 Cómo Contribuir](#-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](file:///home/pablo/Escritorio/Ultimaprensa/open-legal-chile/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:

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

1. Cursor detectará automáticamente .cursor/mcp.json y solicitará autorización para activar el servidor en un solo clic ("Enable").
2. 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:

``bash # 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 interr

…

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: elpabloultron
• Source: elpabloultron/open-legal-chile
• License: Apache-2.0
• Homepage: https://elpabloultron.github.io/open-legal-chile/

Install and usage instructions live in the source repository linked above.