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.

Related MCP server: AEAT MCP Server

🚀 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:

{
  "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:

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