hourledger-mcp
Cálculo de horas trabajadas, horas extra y salario bruto con conjuntos de reglas probados para las leyes federales de EE. UU., California, Alaska, Colorado y Nevada.
Documentación
hourledger-mcp
Un servidor MCP que calcula horas de trabajo, horas extra y salario bruto — que envuelve el mismo motor de reglas probado que impulsa HourLedger, un conjunto de calculadoras gratuitas de horas de trabajo sin registro.
Herramientas
calculate_work_hours
Toma entradas de entrada/salida (con pausas no remuneradas), una tarifa por hora y un conjunto de reglas; devuelve el desglose por día y total de horas regulares / horas extra / doble tiempo más el salario bruto.
Conjuntos de reglas compatibles, cada uno cubierto por la suite de pruebas automatizadas:
| Conjunto de reglas | Regla |
|---|---|
federal | 1.5× después de 40 h/semana (FLSA) |
california | 1.5× después de 8 h/día, 2× después de 12 h/día, regla del séptimo día, sin piramidación (Código Laboral §510) |
alaska | 1.5× después de 8 h/día o 40 h/semana (AS 23.10.060) |
colorado | 1.5× después de 12 h/día o 40 h/semana (Orden COMPS) |
nevada | regla diaria de 8 h solo por debajo de 1.5× el salario mínimo — aplicada automáticamente desde la tarifa (NRS 608.018) |
Maneja turnos nocturnos, políticas de redondeo por entrada (exacto / 5 min / 15 min / 0.1 h) y día de inicio de la semana laboral configurable.
time_and_a_half
Cálculo rápido de tarifa 1.5× y pago de horas extra a partir de una tarifa y horas extra.
Configuración
Claude Desktop / Claude Code
{
"mcpServers": {
"hourledger": {
"command": "npx",
"args": ["-y", "hourledger-mcp"]
}
}
}
O con Claude Code: claude mcp add hourledger -- npx -y hourledger-mcp
Ejemplo
"¿Cuánto gano esta semana? Trabajé de lunes a jueves de 7am a 5pm a $19/hora en Nevada."
El modelo llama a calculate_work_hours con las cuatro entradas de 10 horas y obtiene la respuesta correcta para Nevada ($19 ≥ $18 de corte → solo regla semanal → 40 horas regulares, sin horas extra), con detalle día por día.
Calculadoras interactivas
¿Prefieres una interfaz? Cada conjunto de reglas tiene una calculadora gratuita sin registro en hourledger.com:
- Horas de trabajo y horas extra · Horas extra · Tiempo y medio
- California · Alaska · Colorado · Nevada
- Incorpora una calculadora en tu propio sitio
Aviso legal
Información general, no es asesoramiento legal ni de nómina. Las exenciones y las reglas locales varían — verifica pagos en disputa con tu agencia laboral estatal o un profesional calificado.
Desarrollo
El motor de reglas de pago (src/engine.ts + sus 27 pruebas) se refleja desde el proyecto del sitio HourLedger, donde los cambios de reglas llegan primero. npm test ejecuta la suite completa; prepublishOnly aplica pruebas + compilación antes de cualquier publicación.
Licencia
MIT