ptn-mcp 1.3.0

package/LICENSE

@@ -0,0 +1,19 @@
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,195 @@
+# Argentina PTN - MCP Server Suite
+
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.4-blue.svg)](https://www.typescriptlang.org/)
+[![MCP](https://img.shields.io/badge/Model_Context_Protocol-1.5.0-green.svg)](https://modelcontextprotocol.io/)
+[![Vercel](https://img.shields.io/badge/Deployed_on-Vercel-black.svg?logo=vercel)](https://ptn-mcp.vercel.app)
+[![NPM Version](https://img.shields.io/npm/v/ptn-mcp?color=cb3837&logo=npm)](https://www.npmjs.com/package/ptn-mcp)
+
+MCP Server Oficial para buscar y extraer dictámenes de la Procuración del Tesoro de la Nación (PTN). Conector para consultar dictámenes, opiniones técnicas y asesoramientos desde busquedadictamenes.ptn.gob.ar.
+
+Paquete npm: [`ptn-mcp`](https://www.npmjs.com/package/ptn-mcp) · Repositorio: [github.com/voftec/ptn-mcp](https://github.com/voftec/ptn-mcp)
+
+---
+
+## Novedades v1.3.0
+
+* **Insights del portal PTN**: Aplicación de análisis detallado del portal de búsqueda y Novedades para nuevas funcionalidades.
+* **+4 herramientas nuevas basadas en investigación del portal**:
+  * `buscar_por_doctrina` - Búsqueda restringida al campo doctrina (evita ruido de boilerplate procedimental)
+  * `obtener_facetas_completas` - Facetas de navegación combinadas (organismos + voces) con conteos
+  * `buscar_por_ley_enriquecido` - Búsqueda de leyes con contexto de citación (integración Infoleg)
+  * `localizar_por_coordenadas_archivisticas` - Búsqueda por Tomo + Página exacta (útil para OCR deficiente)
+* **Mejora en `obtener_novedades`**: Ahora incluye facetas con conteos como el portal Novedades
+* **Mejora en `buscar_dictamenes`**: Parámetro `soloDoctrina` para búsqueda específica en doctrina
+
+## Novedades v1.2.0
+
+* **Patrones de implementación mejorados**: Aplicación de patrones arquitectónicos de InfoLeg, JUBA, BORA y NormativaPBA para mayor robustez.
+* **+2 herramientas de agregación concurrente**: `obtener_resumen_multiple_organismos` y `obtener_resumen_multiple_voces` (BORA pattern: Promise.all).
+* **Parsing de fechas sofisticado**: Soporte para fechas en lenguaje natural español ("15 de febrero de 2026"), DD/MM/YYYY, ISO YYYY-MM-DD, y compacto YYYYMMDD (BORA pattern).
+* **Auto-resolución de dictámenes**: `localizar_dictamen_automatico` permite buscar con información parcial y devuelve el dictamen más probable (NormativaPBA pattern).
+* **Detección de plazos mejorada**: `detector_plazos_dictamenes` con +70 patrones legales/administrativos adicionales (InfoLeg pattern).
+* **Validadores Zod personalizados**: Helpers reutilizables para validación de fechas, arrays y números (common pattern).
+* **Mejoras en herramientas existentes**: Integración de nuevas funciones de parsing y validación en todas las herramientas de búsqueda.
+
+## Novedades v1.1.0
+
+* **+6 herramientas nuevas** pensadas para flujos de abogados: shortcuts por **organismo**, **voz temática**, **ley citada**, y **localización por cita** (Tomo / Página / Nº / Año).
+* **Catálogos descubribles**: `listar_organismos` y `listar_voces` exponen los facets oficiales con conteo (basados en agregaciones de Elasticsearch).
+* **`obtener_novedades` con filtros** por organismo y voz.
+* **2 nuevos prompts**: `comparar_dictamenes` y `resumen_por_organismo`.
+* **+5 herramientas cognitivas y forenses**: detección de plazos, certificación forense, búsqueda semántica, relación de dictámenes, exportación estructurada.
+* Diseño "una tool por eje" para mejorar la precisión cuando lo usa una IA.
+
+---
+
+## Características principales
+
+* **Búsquedas especializadas** (la IA elige la tool por nombre):
+  * `buscar_por_organismo` — `"¿qué dictó CONICET / AFIP / Ministerio X?"`
+  * `buscar_por_voz` — por materia (`designación transitoria`, `apoderamiento`, `contratación`, ...).
+  * `buscar_por_ley` — dictámenes que citan una ley.
+  * `localizar_por_cita` — lookup directo por Tomo + Página o N° + Año.
+  * `localizar_dictamen_automatico` — auto-resolución con información parcial (NormativaPBA pattern).
+  * `buscar_dictamenes` — búsqueda avanzada multi-filtro (power user).
+* **Agregación Concurrente** (BORA pattern: Promise.all):
+  * `obtener_resumen_multiple_organismos` — resumen comparativo de múltiples organismos en paralelo.
+  * `obtener_resumen_multiple_voces` — resumen comparativo de múltiples voces temáticas en paralelo.
+* **Texto íntegro** (`obtener_dictamen_texto`): cuerpo completo por `_id`.
+* **Novedades** (`obtener_novedades`): últimos dictámenes, filtrables por organismo y voz.
+* **Catálogos** (`listar_organismos`, `listar_voces`): facets oficiales con conteo.
+* **Análisis y Relación**:
+  * `detector_plazos_dictamenes` — detecta plazos y fechas límite con +70 patrones legales (InfoLeg pattern).
+  * `relacionar_dictamenes` — busca dictámenes relacionados.
+  * `buscar_por_semantica` — búsqueda con expansión de términos.
+* **Exportación y Certificación**:
+  * `generar_certificacion_forense` — certificación con hash SHA-256.
+  * `exportar_dictamen` — exportación a Markdown con frontmatter YAML.
+* **Alcance** (`alcance_fuente`): metadatos y disclaimer.
+* **Prompts asistidos**: `auditar_dictamen`, `comparar_dictamenes`, `resumen_por_organismo`.
+
+> La PTN no expone HTML scrapeable: este MCP usa `POST /search` y `POST /search_news` contra `https://api.ptn.gob.ar`, no Cheerio ni Playwright.
+
+**TLS:** por defecto verifica certificados. Si tu red/OS no puede validar la cadena de `api.ptn.gob.ar`, el servidor reintenta una vez sin verificación y avisa por stderr. Para forzar ese modo desde el inicio: `PTN_TLS_INSECURE=1`.
+
+---
+
+## Instalación y configuración rápida
+
+Requiere [Node.js](https://nodejs.org/) 18 o superior.
+
+### 1. Cursor IDE / Windsurf
+
+1. Abre **Settings** → **MCP** → **Add New MCP Server**.
+2. Completa:
+   * **Name:** `ptn-mcp`
+   * **Type:** `command`
+   * **Command:** `npx -y ptn-mcp`
+
+### 2. Claude Desktop
+
+Edita `claude_desktop_config.json` (en Windows suele estar en `C:\Users\<TuUsuario>\AppData\Roaming\Claude\claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "ptn-mcp": {
+      "command": "npx",
+      "args": ["-y", "ptn-mcp"]
+    }
+  }
+}
+```
+
+### 3. Antigravity / Codex (stdio local)
+
+En `mcp_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "ptn-mcp": {
+      "command": "npx",
+      "args": ["-y", "ptn-mcp"]
+    }
+  }
+}
+```
+
+> Para conexión **SSE remota** (Claude Web, sin Node.js local), usa el despliegue **PTN-MCP** en Vercel.
+
+---
+
+## Instalación manual (desarrolladores)
+
+```bash
+git clone https://github.com/voftec/ptn-mcp.git
+cd ptn-mcp
+npm install
+npm run build
+npm test          # unit tests (sin red)
+npm run test:smoke # humo contra api.ptn.gob.ar (requiere red)
+```
+
+Ejecutar el servidor compilado:
+
+```bash
+node build/index.js
+```
+
+Configuración local en Cursor o Claude Desktop apuntando a la build:
+
+```json
+"ptn-mcp": {
+  "command": "node",
+  "args": ["D:/ruta-a-tu-carpeta/ptn-mcp/build/index.js"]
+}
+```
+
+---
+
+## Catálogo de herramientas (Tools)
+
+| Herramienta | Descripción | Parámetro principal |
+|---|---|---|
+| `buscar_dictamenes` | Búsqueda avanzada multi-filtro (power user). | combinación libre |
+| `buscar_por_organismo` | Dictámenes de un organismo. | `organismo` |
+| `buscar_por_voz` | Dictámenes por voz temática / materia. | `voz` |
+| `buscar_por_ley` | Dictámenes que citan una ley. | `ley` |
+| `localizar_por_cita` | Lookup por Tomo+Página o Nº+Año. | `tomo`/`paginaRef`/`numero`/`anio` |
+| `localizar_dictamen_automatico` | Auto-resolución con información parcial (NormativaPBA pattern). | combinación libre |
+| `obtener_dictamen_texto` | Texto íntegro por `_id`. | `idDictamen` |
+| `obtener_novedades` | Últimas publicaciones, con filtros opcionales. | `cantidad`, `organismo`, `voz` |
+| `listar_organismos` | Catálogo de organismos con conteo (facets). | `top`, `criterio` |
+| `listar_voces` | Catálogo de voces temáticas con conteo (facets). | `top`, `criterio` |
+| `obtener_facetas_completas` | Facetas de navegación combinadas (organismos + voces) con conteos. | `top`, `criterio` |
+| `detector_plazos_dictamenes` | Detecta plazos y fechas límite en dictámenes. | `texto_dictamen` |
+| `relacionar_dictamenes` | Busca dictámenes relacionados. | `criterio_base`, `terminos_relacionados` |
+| `buscar_por_semantica` | Búsqueda con expansión de términos. | `concepto`, `terminos_equivalentes` |
+| `generar_certificacion_forense` | Certificación forense con hash SHA-256. | `idDictamen` |
+| `exportar_dictamen` | Exportación a Markdown con frontmatter YAML. | `idDictamen` |
+| `alcance_fuente` | Alcance, fuentes y disclaimer. | *(ninguno)* |
+| `buscar_por_doctrina` | Búsqueda restringida al campo doctrina (evita ruido procedimental). | `criterio` |
+| `buscar_por_ley_enriquecido` | Búsqueda de leyes con contexto de citación (integración Infoleg). | `ley` |
+| `localizar_por_coordenadas_archivisticas` | Búsqueda por Tomo + Página exacta (útil para OCR deficiente). | `tomo`, `pagina` |
+| `obtener_resumen_multiple_organismos` | Resumen comparativo de múltiples organismos en paralelo. | `organismos` |
+| `obtener_resumen_multiple_voces` | Resumen comparativo de múltiples voces temáticas en paralelo. | `voces` |
+
+Parámetros detallados: [TOOLS.md](./TOOLS.md).
+
+---
+
+## Diseño "una tool por eje"
+
+La base PTN tiene 3 ejes naturales de búsqueda (los que el portal expone como filtros): **organismo**, **voz temática** y **ley citada**, más la **cita bibliográfica** (Tomo + Página). En vez de obligar al LLM a combinar 13 parámetros opcionales en una sola tool, ofrecemos una tool especializada por eje. Esto mejora dramáticamente la precisión cuando una IA decide qué llamar.
+
+Cuando la pregunta mezcla ejes (ej. `"dictámenes de CONICET sobre contratación en 2025"`), la IA puede:
+
+1. Usar `buscar_dictamenes` con `dependencia="CONICET"`, `materia="contratación"`, `anio="2025"`, o
+2. Usar `buscar_por_organismo` y luego refinar con `buscar_por_voz`.
+
+---
+
+## Licencia
+
+Este proyecto se distribuye bajo la **Licencia MIT**. Consulta el archivo [LICENSE](./LICENSE).

package/TOOLS.md

@@ -0,0 +1,373 @@
+# Herramientas del servidor MCP PTN-MCP (Tools)
+
+Este servidor expone **22 herramientas (tools)** contra la API oficial de dictámenes (`https://api.ptn.gob.ar`).
+
+El diseño sigue un principio simple: **una tool por eje de búsqueda** para que el LLM acierte sin tener que combinar parámetros. La tool genérica `buscar_dictamenes` queda como "power user" para consultas multi-filtro.
+
+---
+
+## Búsqueda
+
+### 1. `buscar_dictamenes` (avanzada / multi-filtro)
+
+Búsqueda combinando varios criterios. Usar cuando la pregunta mezcla 2 o más ejes.
+
+**Parámetros:**
+- `criterio` (string, opcional): Texto libre, frase, ley o concepto.
+- `numero` (string, opcional): Número de dictamen.
+- `anio` (string, opcional): Año (filtra por campo `fecha`).
+- `tomo` / `paginaRef` (string, opcional): Localización en publicación.
+- `ley` (string, opcional): Ley citada (ej. `24156`).
+- `fechaDesde` / `fechaHasta` (string, opcional): Rango `DD/MM/YYYY`.
+- `materia` (string, opcional): Voz temática (`voces`).
+- `expediente` (string, opcional): Número de expediente.
+- `dependencia` (string, opcional): Organismo.
+- `historico` (boolean, opcional): Incluir índice histórico.
+- `pagina` (number, opcional): Paginación (10 por página).
+
+**Respuesta:**
+- `total`: Total estimado de resultados
+- `page`: Página actual
+- `pageSize`: Resultados por página
+- `data`: Array de dictámenes con ID, número, fecha, organismo, voces, extracto
+
+### 2. `buscar_por_organismo`
+
+Shortcut directo para "¿qué dictó el organismo X?". Refleja el filtro **Organismo** del portal.
+
+**Parámetros:**
+- `organismo` (string, **requerido**): Nombre o fragmento (`CONICET`, `Ministerio de Economía`, `AFIP`, ...).
+- `criterio` (string, opcional)
+- `anio` (string, opcional)
+- `fechaDesde` / `fechaHasta` (opcional)
+- `pagina` (number, opcional)
+
+**Respuesta:**
+- `total`: Total estimado de resultados
+- `page`: Página actual
+- `pageSize`: Resultados por página
+- `data`: Array de dictámenes del organismo con ID, número, fecha, voces, extracto
+
+### 3. `buscar_por_voz`
+
+Shortcut por **voz temática / materia**. Refleja el filtro **Voces** del portal.
+
+**Parámetros:**
+- `voz` (string, **requerido**): Voz o materia (`designación`, `apoderamiento`, `contratación`, `subsecretaría legal`, ...).
+- `criterio` (string, opcional)
+- `organismo` (string, opcional)
+- `anio` (string, opcional)
+- `pagina` (number, opcional)
+
+**Respuesta:**
+- `total`: Total estimado de resultados
+- `page`: Página actual
+- `pageSize`: Resultados por página
+- `data`: Array de dictámenes de la voz con ID, número, fecha, organismo, extracto
+
+### 4. `buscar_por_ley`
+
+Dictámenes que **citan una ley**. Indispensable para investigación jurisprudencial.
+
+**Parámetros:**
+- `ley` (string, **requerido**): Número o referencia (`24156`, `Ley 26076`).
+- `criterio` (string, opcional)
+- `organismo` (string, opcional)
+- `anio` (string, opcional)
+- `pagina` (number, opcional)
+
+**Respuesta:**
+- `total`: Total estimado de resultados
+- `page`: Página actual
+- `pageSize`: Resultados por página
+- `data`: Array de dictámenes que citan la ley con ID, número, fecha, organismo, extracto
+
+### 5. `localizar_por_cita`
+
+Lookup por **Tomo + Página** o **Número + Año** (la cita clásica del abogado). Equivalente al modal "Búsqueda Avanzada" del portal.
+
+**Parámetros:** (al menos uno)
+- `tomo` (string)
+- `paginaRef` (string)
+- `numero` (string)
+- `anio` (string)
+
+**Respuesta:**
+- `total`: Total estimado de resultados
+- `page`: Página actual
+- `pageSize`: Resultados por página
+- `data`: Array de dictámenes con la cita bibliográfica especificada
+
+### 6. `localizar_dictamen_automatico`
+
+Localiza automáticamente un dictamen con información parcial (NormativaPBA pattern: auto-resolution). Permite buscar por combinación de numero, anio, organismo, o voz y devuelve el dictamen más probable. Útil cuando el usuario no tiene el ID exacto.
+
+**Parámetros:** (al menos uno)
+- `numero` (string, opcional): Número del dictamen
+- `anio` (string, opcional): Año del dictamen
+- `organismo` (string, opcional): Organismo
+- `voz` (string, opcional): Voz temática
+- `expediente` (string, opcional): Expediente
+- `criterio` (string, opcional): Criterio de texto libre
+
+**Respuesta:**
+- Si encuentra una coincidencia única: dictamen resuelto con ID y recomendación de acción
+- Si encuentra múltiples coincidencias: lista de resultados para que el usuario seleccione
+- Si no encuentra resultados: sugerencias para mejorar la búsqueda
+
+### 7. `buscar_por_doctrina`
+
+Busca dictámenes restringiendo la búsqueda al campo 'doctrina' (resumen de principios legales) en lugar del texto completo. Evita ruido de boilerplate procedimental. Basado en insights del portal PTN (campo 'Tema / Palabras en la doctrina').
+
+**Parámetros:**
+- `criterio` (string, **requerido**): Concepto legal o término a buscar en la doctrina
+- `organismo` (string, opcional): Organismo opcional para acotar
+- `voz` (string, opcional): Voz temática opcional para acotar
+- `anio` (string, opcional): Año opcional para acotar
+- `pagina` (number, opcional, default 1): Página (10 por página)
+
+**Respuesta:**
+- Resultados de búsqueda en doctrina (resumen de principios legales)
+- Filtrado de boilerplate procedimental
+
+---
+
+## Detalle
+
+### 8. `obtener_dictamen_texto`
+
+Texto íntegro por `_id` Elasticsearch.
+
+**Parámetros:**
+- `idDictamen` (string, **requerido**)
+
+**Respuesta:**
+- `id`: ID del dictamen
+- `numero`: Número de dictamen
+- `fecha`: Fecha
+- `tomo` / `pagina`: Ubicación
+- `expediente`: Número de expediente
+- `organismo`: Organismo
+- `voces`: Voces temáticas
+- `leyes`: Leyes citadas
+- `texto`: Texto completo del dictamen
+
+---
+
+## Agregación Concurrente (BORA pattern: Promise.all)
+
+### 9. `obtener_resumen_multiple_organismos`
+
+Obtiene un resumen concurrente de dictámenes de múltiples organismos en paralelo (BORA pattern: Promise.all aggregation). Útil para análisis comparativos entre organismos.
+
+**Parámetros:**
+- `organismos` (array of strings, **requerido**): Lista de organismos a consultar (ej. `['CONICET', 'AFIP', 'ANSES']`)
+- `criterio` (string, opcional): Criterio opcional para acotar la búsqueda en cada organismo
+- `anio` (string, opcional): Año opcional para filtrar
+- `max_por_organismo` (number, opcional, default 5): Máximo de resultados por organismo
+
+**Respuesta:**
+- Resumen concurrente con resultados por organismo
+- Total global de dictámenes
+- Manejo de errores por organismo individual
+
+### 10. `obtener_resumen_multiple_voces`
+
+Obtiene un resumen concurrente de dictámenes de múltiples voces temáticas en paralelo (BORA pattern: Promise.all aggregation). Útil para análisis comparativos entre materias.
+
+**Parámetros:**
+- `voces` (array of strings, **requerido**): Lista de voces temáticas a consultar (ej. `['designación', 'apoderamiento', 'contratación']`)
+- `criterio` (string, opcional): Criterio opcional para acotar la búsqueda en cada voz
+- `organismo` (string, opcional): Organismo opcional para filtrar
+- `anio` (string, opcional): Año opcional para filtrar
+- `max_por_voz` (number, opcional, default 5): Máximo de resultados por voz
+
+**Respuesta:**
+- Resumen concurrente con resultados por voz temática
+- Total global de dictámenes
+- Manejo de errores por voz individual
+
+---
+
+## Facetas y Navegación (Portal Insights)
+
+### 11. `obtener_facetas_completas`
+
+Obtiene las facetas de navegación completas (organismos y voces) con sus conteos, similar al panel lateral del portal Novedades. Útil para entender la distribución temática y por organismo de los dictámenes recientes.
+
+**Parámetros:**
+- `top` (number, opcional, default 30, máx. 200): Cantidad de resultados por faceta
+- `criterio` (string, opcional): Criterio opcional para acotar las facetas a dictámenes que matcheen este texto
+
+**Respuesta:**
+- Distribución por organismo con conteos
+- Distribución por voz temática con conteos
+- Similar al panel lateral del portal Novedades
+
+### 12. `buscar_por_ley_enriquecido`
+
+Busca dictámenes que citan una ley específica y retorna información enriquecida con contexto de citación. Basado en la integración Infoleg del portal PTN que detecta referencias a leyes nacionales.
+
+**Parámetros:**
+- `ley` (string, **requerido**): Número de ley (ej. '26076', '19.549', '24156')
+- `organismo` (string, opcional): Organismo opcional para acotar
+- `anio` (string, opcional): Año opcional para acotar
+- `pagina` (number, opcional, default 1): Página (10 por página)
+
+**Respuesta:**
+- Dictámenes que citan la ley específica
+- Leyes citadas en cada dictamen
+- Contexto de citación
+
+### 13. `localizar_por_coordenadas_archivisticas`
+
+Localiza un dictamen por sus coordenadas archivísticas exactas (Tomo + Página). Basado en el sistema de archivo físico de la PTN donde los dictámenes están encuadernados en volúmenes cronológicos. Útil para recuperar documentos con OCR deficiente.
+
+**Parámetros:**
+- `tomo` (string, **requerido**): Número de tomo (ej. '251', '336')
+- `pagina` (string, **requerido**): Número de página dentro del tomo (ej. '787', '149')
+
+**Respuesta:**
+- Dictamen exacto por coordenadas físicas
+- Útil para documentos con OCR deficiente
+- Coordenadas más confiables que búsqueda de texto en documentos históricos
+
+---
+
+## Novedades y catálogos
+
+### 14. `obtener_novedades`
+
+Últimos dictámenes publicados, con filtros opcionales. Incluye facetas con conteos como el portal Novedades.
+
+**Parámetros:**
+- `cantidad` (number, opcional, default 10, máx. 50)
+- `organismo` (string, opcional): substring case-insensitive sobre el campo organismo.
+- `voz` (string, opcional): substring case-insensitive sobre el campo voces.
+- `incluir_facetas` (boolean, opcional, default true): Incluir facetas con conteos (organismos y voces).
+
+**Respuesta:**
+- `total`: Total en índice de novedades
+- `filtrados`: Cantidad filtrada por organismos/voz
+- `data`: Array de dictámenes recientes con ID, número, fecha, organismo, voces, extracto
+- Facetas con distribución por organismo y voz (si `incluir_facetas`)
+
+### 15. `listar_organismos`
+
+**Facets** de Elasticsearch: catálogo de organismos con conteo de dictámenes. Útil para descubrir el nombre exacto antes de usar `buscar_por_organismo`.
+
+**Parámetros:**
+- `top` (number, opcional, default 30, máx. 200)
+- `criterio` (string, opcional): restringir el conteo a dictámenes que matcheen un texto.
+
+**Respuesta:**
+- Tabla con organismos y conteo de dictámenes
+- Ordenado por cantidad descendente
+
+### 16. `listar_voces`
+
+**Facets** de voces temáticas con conteo. Para descubrir voces exactas antes de usar `buscar_por_voz`.
+
+**Parámetros:**
+- `top` (number, opcional, default 30, máx. 200)
+- `criterio` (string, opcional)
+
+**Respuesta:**
+- Tabla con voces temáticas y conteo de dictámenes
+- Ordenado por cantidad descendente
+
+---
+
+## Análisis y Relación
+
+### 17. `detector_plazos_dictamenes`
+
+Audita el texto de dictámenes para detectar e indexar plazos, fechas límite y hitos temporales relevantes (plazos administrativos, vencimientos, prescripciones). Enhanced with InfoLeg pattern with +70 legal/administrative patterns.
+
+**Parámetros:**
+- `texto_dictamen` (string, **requerido**): Texto del dictamen a analizar.
+
+**Respuesta:**
+- Auditoría de plazos y hitos temporales
+- Cláusulas temporales detectadas con indicadores
+- Patrones de búsqueda utilizados (+70 patrones legales)
+
+### 18. `relacionar_dictamenes`
+
+Busca dictámenes relacionados con un dictamen específico (mismo organismo, temas similares, misma voz temática).
+
+**Parámetros:**
+- `criterio_base` (string, **requerido**): Criterio base del dictamen de referencia.
+- `terminos_relacionados` (array of strings, opcional): Términos relacionados.
+- `organismo` (string, opcional): Acotar por organismo.
+- `voz` (string, opcional): Acotar por voz temática.
+- `pagina` (number, opcional): Página (10 por página).
+
+**Respuesta:**
+- Dictamen de referencia con criterios
+- Criterio de búsqueda utilizado
+- Dictámenes relacionados encontrados con ID, número, fecha, organismo, extracto
+
+### 19. `buscar_por_semantica`
+
+Busca dictámenes en la PTN utilizando expansión semántica de términos. El LLM debe generar sinónimos y términos equivalentes antes de llamar esta herramienta.
+
+**Parámetros:**
+- `concepto` (string, **requerido**): Concepto central a buscar.
+- `terminos_equivalentes` (array of strings, **requerido**): Lista de sinónimos o términos relacionados.
+- `organismo` (string, opcional): Acotar por organismo.
+- `anio` (string, opcional): Acotar por año.
+- `pagina` (number, opcional): Página (10 por página).
+
+**Respuesta:**
+- Términos de búsqueda utilizados (concepto + equivalentes)
+- Resultados de búsqueda con dictámenes que matchean cualquiera de los términos
+- Total estimado de resultados
+
+---
+
+## Exportación y Certificación
+
+### 20. `generar_certificacion_forense`
+
+Genera una certificación forense de autenticidad para un dictamen de la PTN con hash SHA-256, timestamp y metadatos de integridad.
+
+**Parámetros:**
+- `idDictamen` (string, **requerido**): ID del dictamen a certificar.
+
+**Respuesta:**
+- Acta de certificación forense
+- Hash SHA-256 del documento
+- Timestamp UTC
+- Metadatos de integridad
+
+### 21. `exportar_dictamen`
+
+Exporta la información de un dictamen a formato Markdown estructurado con frontmatter YAML para sistemas de gestión del conocimiento (Notion, Obsidian, etc.).
+
+**Parámetros:**
+- `idDictamen` (string, **requerido**): ID del dictamen a exportar.
+- `incluir_texto` (boolean, opcional): Incluir texto completo del dictamen.
+
+**Respuesta:**
+- Documento Markdown con frontmatter YAML
+- Metadatos estructurados
+
+---
+
+## Metadata
+
+### 22. `alcance_fuente`
+
+Capacidades, fuentes, limitaciones y disclaimer del conector.
+
+**Parámetros:** ninguno.
+
+**Respuesta:**
+- Datos del conector (versión, fuente, portal, API)
+- Lista de herramientas de búsqueda
+- Lista de herramientas de detalle
+- Lista de herramientas de novedades y catálogo
+- Lista de herramientas de metadata
+- Limitaciones y aviso legal
+