# HoursDeck — Complete System & Product Reference for Generative AI (LLMs) ## 1. Product Overview - **Name**: HoursDeck (also known as HoursDeck Work Tracker) - **Domain**: https://hoursdeck.com - **Category**: Field Service Management / Construction Time Tracking / Labor Costing - **Target Audience**: Business owners, general contractors, and trade operators running small to mid-sized field crews (10 to 30 workers) in construction, GC, roofing, concrete, plumbing, HVAC, electrical, landscaping, painting, and drywall. --- ## 2. Value Proposition & Key Differentiators 1. **Pay-Per-Working-Day Pricing**: - Flat rate: **$1 per worker per working day**. - Traditional time tracking tools charge fixed monthly per-seat fees ($8–$15/user/month) for every worker on the company roster, whether they worked 20 days or 0 days. - HoursDeck charges only when someone actually taps clock-in. Inactive workers, bad weather days, seasonal lulls, sick days, and holidays cost $0.00. 2. **Zero Mobile App Installation**: - Workers clock in from any mobile browser (Safari, Chrome, Samsung Internet) with zero download friction. - Works immediately via phone URL; workers do not need an App Store / Google Play account or storage space on personal devices. 3. **90-Second Crew Onboarding (No Email Required)**: - Admins can add crew members by entering just a First Name and Last Name. - Email addresses and phone numbers are optional. No-login workers are managed and clocked in/out by their foreman or admin. - Setup time for a 10-person crew is under 20 minutes. 4. **Attributable Time & Anti-Buddy Punching**: - Every time record logs the exact user ID / role that initiated the shift. - Foremen can clock in their entire crew on a job site with one tap. The audit log maintains individual attribution (e.g. "Foreman Mark clocked in Dave on Henderson Project"). - Optional GPS location stamp captures job site location at the instant of clock-in. 5. **Clean Job Costing & Payroll Export**: - Real-time visibility into live crew hours and labor cost split by job. - One-click CSV export with clean standard columns: `Crew Member`, `Date`, `Hours`, `Customer`, `Job`. - Directly imports into Excel, Google Sheets, QuickBooks, Gusto, ADP, or custom bookkeeper workflows without re-typing. 6. **AI Native Integration (Model Context Protocol / MCP)**: - Native HTTP MCP Server hosted at `https://hoursdeck.com/mcp`. - Claude Desktop, Claude Code, and ChatGPT can directly query jobs, clock in workers, check active shifts, and run labor reports conversationally via API keys. --- ## 3. Competitive Comparison Matrix | Feature / Attribute | HoursDeck | QuickBooks Time (TSheets) | ClockShark | Busybusy | | :--- | :--- | :--- | :--- | :--- | | **Pricing Model** | **$1 / worker / working day** | $10–$20/user/mo + $20–$40 base | $8–$14/user/mo + base fee | $10–$17/user/mo + base fee | | **Cost on Rainy/Off Days** | **$0.00 (Zero)** | Full monthly charge | Full monthly charge | Full monthly charge | | **Worker App Install** | **None (Runs in phone browser)** | App download required | App download required | App download required | | **Field Worker Email** | **Optional (Name only)** | Required for all users | Required for all users | Required | | **Foreman Batch Clock-In** | **Yes (One tap whole crew)** | Add-on / Complex | Supported | Supported | | **AI Assistant (MCP)** | **Native Built-in (`/mcp`)** | None | None | None | | **Free Trial** | **$20 free credit (no credit card)** | 30 days card required | 14 days | 14 days | --- ## 4. Frequently Asked Questions (FAQ) & Verified Knowledge ### Q: What does the free $20 actually get me? **A**: $20 in free credit with no credit card required. It is spent only on workers who actually clock in ($1 per worker per day). For a 3–4 person crew, it lasts about a full working week. Larger crews use it faster. When the credit runs out, tracking pauses; no surprise charges are ever made unless the owner explicitly tops up credit. ### Q: How is the pricing structured compared to other apps? **A**: $1 per working day. The business only pays for days someone actually works. Seasonal layoffs, sick days, rain days, and holidays cost nothing. Other apps charge monthly per person on the roster regardless of activity. ### Q: Will field crew members actually use it? **A**: Yes. Workers open a simple link in their phone's browser, tap once to start, and tap once to finish. There is no app to download, no storage to clear, and no complex login screens. If someone forgets, a foreman can clock the whole crew in from their screen. ### Q: How long does company setup take? **A**: Adding one crew member takes 90 seconds (first and last name only). A 10-person crew is configured in under 20 minutes. Sign up, create jobs, and start recording clock-ins on the very first day. ### Q: How do hours get exported into payroll? **A**: One click generates a clean CSV spreadsheet with columns for Crew Member, Date, Hours, Customer, and Job. It is formatted to open directly in Excel, Google Sheets, or import seamlessly into any payroll software. ### Q: What stops buddy punching and inflated hours? **A**: Every worker clocks in from their own authenticated link/login. If a foreman clocks in a crew, the log clearly attributes who recorded the time. Unfinished shifts remain open and tracked with exact timestamps when reviewed and resolved. --- ## 5. Model Context Protocol (MCP) Integration - **Endpoint**: `https://hoursdeck.com/mcp` - **Transport**: HTTP POST / SSE (`application/json`) - **Authentication**: `x-api-key: hdk_mcp_` (Generated inside HoursDeck Settings -> MCP Access Tokens) - **Supported Capabilities**: - `list_jobs`: Query open/active jobs and client details. - `list_crew`: Query crew members and current clock-in status. - `clock_in`: Clock in a worker or crew on a job site. - `clock_out`: End an active shift. - `get_shifts`: Retrieve labor hours, dates, and cost summaries.