hourledger-mcp

Cálculo de horas trabalhadas, horas extras e remuneração bruta com conjuntos de regras testados para as leis federal dos EUA, Califórnia, Alasca, Colorado e Nevada.

GitHub
2
Experimente este MCPPatrocinado

Documentação

hourledger-mcp

Um servidor MCP que calcula horas de trabalho, horas extras e pagamento bruto — utilizando o mesmo motor de regras testado que alimenta o HourLedger, um conjunto de calculadoras gratuitas de horas de trabalho sem necessidade de cadastro.

Ferramentas

calculate_work_hours

Recebe registros de entrada/saída (com pausas não remuneradas), uma taxa horária e um conjunto de regras; retorna a divisão por dia e o total de horas regulares / horas extras / horas em dobro, além do pagamento bruto.

Conjuntos de regras suportados, cada um coberto pela suíte de testes automatizados:

Conjunto de regrasRegra
federal1,5× acima de 40 h/semana (FLSA)
california1,5× acima de 8 h/dia, 2× acima de 12 h/dia, regra do 7º dia, sem acúmulo (Código do Trabalho §510)
alaska1,5× acima de 8 h/dia ou 40 h/semana (AS 23.10.060)
colorado1,5× acima de 12 h/dia ou 40 h/semana (Ordem COMPS)
nevadaregra diária de 8 h apenas abaixo de 1,5× o salário mínimo — aplicada automaticamente a partir da taxa (NRS 608.018)

Lida com turnos noturnos, políticas de arredondamento por registro (exato / 5 min / 15 min / 0,1 h) e dia de início da semana de trabalho configurável.

time_and_a_half

Cálculo rápido da taxa de 1,5× e do pagamento de horas extras a partir de uma taxa e horas extras.

Configuração

Claude Desktop / Claude Code

{
  "mcpServers": {
    "hourledger": {
      "command": "npx",
      "args": ["-y", "hourledger-mcp"]
    }
  }
}

Ou com Claude Code: claude mcp add hourledger -- npx -y hourledger-mcp

Exemplo

"Quanto eu ganho esta semana? Trabalhei de segunda a quinta, das 7h às 17h, a US$ 19/hora em Nevada."

O modelo chama calculate_work_hours com os quatro registros de 10 horas e recebe a resposta correta para Nevada (US$ 19 ≥ corte de US$ 18 → apenas regra semanal → 40 horas regulares, sem horas extras), com detalhes dia a dia.

Calculadoras interativas

Prefere uma interface? Cada conjunto de regras tem uma calculadora gratuita, sem cadastro, em hourledger.com:

Aviso legal

Informações gerais, não são aconselhamento jurídico ou de folha de pagamento. Isenções e regras locais variam — verifique pagamentos contestados com a agência trabalhista do seu estado ou um profissional qualificado.

Desenvolvimento

O motor de regras de pagamento (src/engine.ts + seus 27 testes) é espelhado do projeto do site HourLedger, onde as mudanças de regras chegam primeiro. npm test executa a suíte completa; prepublishOnly exige testes + build antes de qualquer publicação.

Licença

MIT