# Asistente de Gestión Laboral & Seguridad Social (Servidor MCP)

> **Conector Model Context Protocol (MCP) especializado en la operativa diaria de despachos profesionales, asesorías y departamentos de recursos humanos: NOMINASOL, Sistema RED, SILTRA, FDI/FIE, Boletines de Noticias RED (BNR), Órdenes de Cotización, Delt@, Contrat@ y Certific@2.**

---

## 🏛️ Áreas y Herramientas Integradas

### 💻 1. Asistente y Procedimientos en NOMINASOL (Delsol)
- `consultar_nominasol`: Guía paso a paso y rutas de menús en NOMINASOL para:
  - Cálculo masivo de nóminas de toda la empresa o cartera en bloque (*Solapa Procesos > Nóminas > Cálculo*).
  - Carga e importación masiva de incidencias y variables mensuales desde hojas de cálculo.
  - Mecanización de bajas por IT (contingencias comunes y profesionales) y exportación del fichero FDI para SILTRA.
  - Generación de Ficheros de Bases de SILTRA (L00 ordinaria, L03 atrasos de convenio, L90 complementarias).
  - Emisión mensual del Fichero CRA (Conceptos Retributivos Abonados, art. 147 LGSS).
  - Generación de Ficheros de Afiliación (AFI) para altas previas, bajas y variaciones de contrato/CTP en Sistema RED.
  - Configuración de Convenios Colectivos, actualización de tablas salariales y cálculo de atrasos retroactivos.
  - Cálculo de finiquitos, vacaciones devengadas no disfrutadas y certificados de empresa.
- `calcular_jornada_laboral`: Conversión matemática de jornadas:
  - De horas anuales de convenio a horas semanales o diarias promedio.
  - Cálculo automático del **Coeficiente de Tiempo Parcial (CTP)** para el fichero AFI de Sistema RED y Contrat@.
- `comprobar_salario_y_alerta_smi`: Unificación de salario base + pluses fijos de convenio + pagas extras:
  - Comparación matemática contra el **Salario Mínimo Interprofesional (SMI)** vigente.
  - Alerta de infracción de la Inspección de Trabajo y cálculo exacto del **"Complemento a SMI"** mensual a abonar.
- `guiar_pagas_extras_nominasol`: Pautas para fijar los períodos de devengo (semestral vs anual) y el prorrateo en NOMINASOL para evitar errores en finiquitos o liquidaciones de SILTRA.
- `consultar_irpf_modelos_laborales`: Modelos Tributarios Laborales en NOMINASOL (Modelo 111 trimestral y Modelo 190 anual), resolución de descuadres con el acumulado de nóminas, claves de percepción (Claves A, B, E y rentas exentas Clave L en dietas e indemnizaciones) y regularización de tipos mediante el algoritmo de la AEAT.

### ⚡ 2. SILTRA, Fichero CRA, FIE y Sistema de Liquidación Directa (SLD)
- `procesar_fichero_fie`: Parser inteligente del Fichero FIE de la Seguridad Social. Pega el texto descargado de SILTRA y extrae una tabla limpia con las bajas médicas (PB), confirmaciones (PC), altas (PA) y modificaciones (MD) para volcarlas en NOMINASOL.
- `analizar_respuestas_siltra`: Analizador automático de respuestas de SILTRA (.MSJ o XML de bases). Detecta qué trabajadores tienen error (R9582, R9502, etc.), los tramos en conflicto y la solución en NOMINASOL.
- `decodificar_error_siltra`: Motor de diagnóstico oficial de códigos de error de SILTRA / TGSS (R9582, R9502, R9503, R9632, R9580, R9528, R9663, R9518).
- `consultar_mapeo_cra`: Buscador y clasificador oficial del Fichero CRA (art. 147 LGSS) para saber qué código poner a cualquier plus (transporte, kilometraje a 0,26 €/km, dietas, vestuario, etc.), si cotiza al 100% y qué casillas marcar en NOMINASOL.
- `guiar_fdi_it_siltra`: Preparación y validación de datos económicos de IT (fichero FDI) en SILTRA conforme al **RD 1060/2022**.
- `interpretar_fichero_fie`: Estructura, códigos de registro y circuito diario de control telemático de IT.

### 📜 3. Seguridad Social y Bonificaciones a la Contratación
- `consultar_bonificaciones_laborales`: Catálogo de incentivos y bonificaciones mensuales a la contratación laboral vigentes (**RDL 1/2023**): sustitución por nacimiento (366 €/mes), jóvenes garantía juvenil (275 €/mes), mayores de 45 años desempleados de larga duración (110-128 €/mes), discapacidad y mantenimiento de empleo durante 3 años.
- `consultar_boletin_red`: Buscador de instrucciones operativas en los **Boletines de Noticias RED (BNR)** de la TGSS.
- `consultar_orden_cotizacion`: Bases mínimas y máximas por grupos (1 al 11), topes legales y recargo por contratos cortos (<30 días, art. 151 LGSS).
- `calcular_cuotas_cotizacion`: Simulador y desglose exacto de cuotas empresariales y del trabajador (contingencias comunes, desempleo, FOGASA, formación profesional, MEI y cuota de solidaridad).

### 🚨 4. Partes de Accidente de Trabajo (Delt@ y CoNal)
- `guia_delta_conal`: Plazos legales estrictos ante la Autoridad Laboral (5 días hábiles vs. 24 horas para accidentes graves o fallecimiento) y relación mensual sin baja.

### 📄 5. SEPE: Contratos, Certificados y Vencimientos
- `calcular_vencimientos_laborales`: Control de prórrogas y límites de temporalidad (máx. 6 meses / 1 año), fecha límite de preaviso de 15 días e indemnizaciones legales.
- `consultar_contrata_sepe`: Códigos de contrato oficiales (100, 200, 300 fijos discontinuos, 402, 420...) y causas habilitantes de temporalidad.
- `consultar_certifica2_sepe`: Claves de causa de cese en certificados de empresa (01 a 20) con verificación de **Situación Legal de Desempleo y derecho a paro**.

### ⏰ 6. Calendario de Obligaciones, Plazos Legales y Alertas Sancionadoras (LISOS)
- `consultar_plazos_y_alertas_laborales`:
  - **Cálculo exacto del dies ad quem**: Calcula la fecha límite legal a partir de un hecho causante con cómputo diferenciado:
    - *Previo estricto*: Altas en Seguridad Social (antes de las 23:59 h del día anterior; el mismo día es fuera de plazo).
    - *Días naturales*: Bajas y variaciones de datos AFI (3 días naturales).
    - *Días hábiles*: Datos económicos de IT en fichero FDI de SILTRA (3 días hábiles desde recepción de FIE), comunicación de contratos en Contrat@ (10 días hábiles), partes Delt@ con baja (5 días hábiles).
    - *Urgencia 24 horas*: Accidentes muy graves, mortales o múltiples en Delt@ (24 horas continuadas).
    - *Preaviso 15 días*: Extinción de contratos de duración superior a 1 año (art. 49.1.c ET).
    - *Procesal laboral*: Papeleta de conciliación (SMAC) por despido (20 días hábiles caducidad, art. 59.3 ET).
  - **Alertas y Régimen Sancionador LISOS**: Identificación del precepto legal y sanciones económicas de la Inspección de Trabajo (ej. art. 22.2 LISOS por alta fuera de plazo: de 3.750 € a 12.000 € por trabajador).
  - **Calendario Mensual de la Asesoría**: Hitos críticos del mes (1 al 12): ventanas de confirmación de SILTRA (cargo en cuenta bancaria vs pago electrónico), presentación de Modelos 111 y 190 de la AEAT, relación mensual de accidentes sin baja y remisión mensual del fichero CRA.

### ⚖️ 7. Embargos de Nómina y Sueldos (Art. 607 LEC)
- `calcular_embargo_nomina_lec`:
  - Cálculo estricto de la escala progresiva del **Art. 607 de la Ley de Enjuiciamiento Civil**:
    - Primer tramo (hasta 1 SMI): Inembargable.
    - Siguientes tramos: 30%, 50%, 60%, 75% y 90% para el exceso de 5 SMI.
  - Regla especial en meses con paga extraordinaria (**STS 20/10/2022**: límite inembargable de 2 SMI).
  - Reducción de porcentajes del 10% al 15% por cargas familiares (Art. 607.4 LEC).
  - Guía de mecanización en NOMINASOL como deducción sin alterar bases de cotización ni IRPF.

### 📑 8. Atrasos de Convenio y Liquidaciones Complementarias L03
- `guiar_atrasos_convenio_l03`:
  - Cálculo de la fecha límite reglamentaria para el ingreso sin recargo de cuotas: **último día del mes siguiente a la publicación en el Boletín Oficial (BOE o BOP)** conforme al art. 56.1.c) del Reglamento General de Recaudación (RD 1415/2004).
  - Advertencia de recargos de la TGSS (10%, 20% y 35%) por ingreso extemporáneo.
  - Guía operativa en NOMINASOL para calcular nóminas de atrasos por diferencias y generar el fichero de bases L03 para SILTRA.

### 📋 9. Obligaciones Laborales Formales de Empresa y Notificaciones Telemáticas
- `consultar_obligaciones_laborales_empresa`:
  - **Protocolo de Acoso Laboral y Sexual**: Obligatorio para todas las empresas desde 1 trabajador (LO 3/2007, Ley 15/2022). Multas de 7.501 € a 225.018 €.
  - **Registro Retributivo y Brecha Salarial**: Obligatorio para el 100% de empresas con plantilla (Art. 28 ET y RD 902/2020).
  - **Plan de Igualdad y Auditoría Retributiva**: Obligatorio a partir de 50 trabajadores con inscripción en REGCON.
  - **Buzón Telemático DEHú / SEDESS**: Plazo legal improrrogable de **10 días naturales** para la apertura de notificaciones antes de surtir plenos efectos por rechazo tácito.
  - **Modelo 145 y Retención Inicial de IRPF**: Regla del tipo mínimo del 2% obligatorio en contratos temporales inferiores a 1 año (Art. 86.2 RIRPF).

### 🔔 10. Agenda de Vencimientos, Alertas a Slack y Sincronización con Notion
- `guardar_recordatorio_vencimiento`: Registra vencimientos en la base de datos local del despacho (`data/agenda_vencimientos.json`) con cálculo de aviso previo automático.
- `listar_recordatorios_pendientes`: Consulta interactiva en el chat con semáforos de urgencia (🔴 URGENTE / VENCIDO, 🟡 PRÓXIMO, 🟢 EN PLAZO).
- `marcar_recordatorio_completado`: Cierre de tareas gestionadas.
- `notificar_alertas_slack`: Envío directo de informes de alertas a canales de **Slack** mediante Incoming Webhooks con formato enriquecido.
- `sincronizar_con_notion`: Creación automática de tarjetas/filas en bases de datos de tareas de **Notion** vía API oficial.
- `configurar_integraciones_agenda`: Configuración persistente de URLs de Webhook y tokens de integración.

---

## 🚀 Configuración en Claude Desktop

Edita tu archivo de configuración:
`~/Library/Application Support/Claude/claude_desktop_config.json`

Puedes tener activos conjuntamente los tres servidores del despacho:

```json
{
  "mcpServers": {
    "jurisprudenciator-local": {
      "command": "python3",
      "args": [
        "/Users/noelia/Documents/CONECTORES Y PLUGINS/jurisprudencia-mcp/local_server.py",
        "--stdio"
      ]
    },
    "despacho-suite-local": {
      "command": "python3",
      "args": [
        "/Users/noelia/Documents/CONECTORES Y PLUGINS/despacho-suite-mcp/local_server.py",
        "--stdio"
      ]
    },
    "gestion-laboral-local": {
      "command": "/Users/noelia/Documents/CONECTORES Y PLUGINS/gestion-laboral-mcp/venv/bin/python3",
      "args": [
        "/Users/noelia/Documents/CONECTORES Y PLUGINS/gestion-laboral-mcp/local_server.py",
        "--stdio"
      ]
    }
  }
}
```

---

## 🧪 Pruebas Unitarias

Para verificar el correcto funcionamiento de todas las herramientas:

```bash
cd "/Users/noelia/Documents/CONECTORES Y PLUGINS/gestion-laboral-mcp"
venv/bin/python3 tests/test_laboral.py
```