Metadata-Version: 2.5
Name: nomina-colombia
Version: 0.1.0
Summary: Servidor MCP con la calculadora laboral y de nómina de Colombia: liquidación, prestaciones, aportes, retención y horas extra.
Project-URL: Repository, https://github.com/jhosman-xx/nomina-colombia
Author: jhosman-xx
Keywords: claude,colombia,liquidacion,mcp,nomina,prestaciones
Classifier: Natural Language :: Spanish
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Office/Business :: Financial :: Accounting
Requires-Python: >=3.10
Requires-Dist: mcp<2,>=1.9
Description-Content-Type: text/markdown

# nomina-colombia

Servidor MCP que calcula liquidaciones, prestaciones, aportes, retención en la fuente
y horas extra según la ley laboral colombiana. Cada resultado incluye la fórmula,
el artículo de ley y una advertencia de que es orientativo (no es asesoría legal).

Trae los valores legales de 2025 y 2026 (SMMLV, auxilio de transporte, UVT) con la norma que los fija.

## Usarlo en Claude

Con [uv](https://docs.astral.sh/uv/) instalado no hace falta instalar nada más:

**Claude Code**

```bash
claude mcp add nomina-colombia -- uvx nomina-colombia
```

**Claude Desktop** (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "nomina-colombia": {
      "command": "uvx",
      "args": ["nomina-colombia"]
    }
  }
}
```

Sin uv: `pip install nomina-colombia` y usa el comando `nomina-colombia`.
Para servirlo por HTTP: `nomina-colombia --http`.

## Herramientas

| Tool | Qué calcula |
|------|-------------|
| `parametros_legales` | SMMLV, auxilio y UVT de un año, con la norma |
| `liquidacion_final` | Liquidación completa al terminar el contrato |
| `cesantias` | Cesantías e intereses de un periodo |
| `prima_servicios` | Prima de servicios del semestre |
| `vacaciones` | Días causados, pendientes y su valor |
| `indemnizacion_despido` | Despido sin justa causa (indefinido, fijo, obra/labor) |
| `aportes_seguridad_social` | Salud, pensión, FSP, ARL, caja, ICBF, SENA (PILA) |
| `costo_total_empleado` | Costo mensual real para el empleador |
| `retencion_fuente` | Retención mensual, procedimiento 1 |
| `horas_extra_recargos` | Extras y recargos con la reforma laboral (Ley 2466/2025) |

Todas las herramientas solo calculan: no guardan ni envían datos.

## Supuestos y límites

- Año comercial de 360 días (meses de 30).
- La liquidación asume cesantías consignadas hasta el 31-dic anterior y prima del semestre anterior pagada.
- ARL con tarifa mínima de cada clase de riesgo.
- Retención: procedimiento 1; no incluye la deducción de 72 UVT por dependiente.
- No cubre salario integral en detalle de indemnización ni pensión de la Ley 2381 de 2024.
