MCP server for calculating work hours, overtime, and gross pay — federal, California, Alaska, Colorado, and Nevada rules. Powered by hourledger.com.
Two tools with complete schemas and reasonable descriptions. calculate_work_hours has detailed parameter documentation and enum constraints (federal|california|alaska|colorado|nevada, rounding options). time_and_a_half is simpler but well-defined. Both tools lack output schema documentation, LLMs cannot predict response structure. Descriptions are adequate (194 - 250 chars, within baseline 34 - 392 range) but lack actionable context on when to use each tool vs. the other. No error handling guidance, no recovery paths for invalid inputs. Parameter descriptions are present but some lack format/range details (e.g., 'ISO date yyyy-mm-dd' is good; 'HH:mm, 24-hour' is good). Missing: output field documentation, error classification, and composition guidance.
Calculate regular/overtime/double-time hours and gross pay from clock in/out entries. Rulesets: federal (40h/week), california (8h/day 1.5x, 12h/day 2x, 7th-day rule), alaska (8h/day or 40h/week), colorado (12h/day or 40h/week), nevada (8h/day below $18.00/h, else weekly). Full calculators at https://hourledger.com
Calculate a time-and-a-half (1.5x) overtime rate and total overtime pay from an hourly rate and overtime hours. Interactive version: https://hourledger.com/time-and-a-half-calculator
Output schemas not documented. LLMs cannot predict response structure (fields, types, nesting). Both tools return JSON text blobs without schema declaration.
No error handling guidance. Invalid inputs (malformed dates, negative rates, overnight shifts) have no documented recovery paths. LLMs cannot self-correct.
Tool descriptions lack composition context. No guidance on when to use calculate_work_hours vs. time_and_a_half, or how they chain together.
calculate_work_hours parameter 'unpaidBreakMins' has default 0 but description does not explain the default behavior or when to override it.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 57 | 2026-07-28+ | v2 |
No idempotency guarantees documented. Agents may retry on ambiguous failures; unclear if repeated calls with same input produce identical results.