clearwage-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
ClearWage WH-347 (OMB 1235-0008 · Mandatory Oct 1, 2026)
Deterministic U.S. DOL Revised Form WH-347 Certified Payroll Compliance Auditor, DBRA/CWHSSA Overtime Calculator & Pixel-Aligned Official PDF Compiler (Browser + CLI + MCP Server).
Why ClearWage WH-347 Exists
On September 30, 2026, legacy pre-2025 Form WH-347 templates officially expired. Beginning October 1, 2026, federal Contracting Officers, municipal sponsors, and prime contractors mandate the Revised January 2025 Form WH-347 (OMB Control No. 1235-0008, Exp. 01/31/2028).
Two acute pain points hit subcontractors, bookkeepers, and AI accounting agents immediately:
The official DOL
wh347.pdfhas zero interactive AcroForm fields — it is a flat792 × 612pt vector graphic.Nine new statutory traps trigger progress-payment holdbacks, including the mandatory SAM.gov Wage Determination No. header, strict separation of Col 6A (base cash rate excluding cash fringes), Col 6B (weekly bona fide plan credit
$), and Col 6C (weekly cash-in-lieu$), Split-Classification Col 1A Entry No. deduplication of Cols 7B/8/9, Page 2 Box 4"N/A"rule, and Page 26-Plan × 8-WorkerHourly Credit Matrix.
Related MCP server: FastMCP Runtime MCP
Live Browser App (100% Local — Zero Payroll Data Leaves Your Device)
👉 Launch Free Validator & Official DOL PDF Compiler: https://zchryst.github.io/clearwage-wh347/
26-Rule Deterministic Statutory Audit (
WH347-001throughWH347-026) with29 CFR Parts 3 & 5and40 U.S.C. § 3702 (CWHSSA)citations, exact back-wage restitution math, and$32/dayCWHSSA liquidated damages alerts.Pixel-Exact Official DOL PDF Generation in-browser (
pdf-lib) or via Python (pymupdf), including automatic Page 3 Copeland Act (29 CFR § 3.5) Itemized Deductions & Continuation Addenda.Free 5-Worker Macro-Free Starter
.xlsx& 50-Worker Pro Contractor Excel Suite ($79) (runs on Windows Excel, Mac Excel, Excel Web & Google Sheets with zero blocked.xlsmVBA macros).
Python CLI Quickstart
pip install git+https://github.com/zchryst/clearwage-wh347.git
# 1. Run the 26-rule statutory audit on the built-in 6-trap rejection sample:
clearwage audit demo-traps
# 2. Audit a clean multi-classification + registered apprentice payroll:
clearwage audit demo-clean
# 3. Compile a pixel-aligned 3-page Official DOL WH-347 PDF packet:
clearwage render-pdf demo-clean -o WH347_Signed_Packet.pdf
# 4. Audit & compile your own JSON payroll export:
clearwage audit my_payroll_week4.json
clearwage render-pdf my_payroll_week4.json -o WH347_Week4.pdfModel Context Protocol (MCP) Server for Claude, Cursor & Bookkeeping Agents
LLMs hallucinate Davis-Bacon half-time overtime premiums (29 CFR § 5.32) and cannot natively overlay flat government PDFs. Connect clearwage-mcp to give any MCP-compatible agent cent-exact certified payroll tools:
Tools Exposed
Tool Name | Description |
| Exact |
| Runs all 26 deterministic compliance checks ( |
| Audits and compiles a pixel-aligned Revised Jan-2025 Form WH-347 PDF (with multi-page continuation & Copeland Act addenda) onto the official DOL vector layout. |
claude_desktop_config.json / .cursor/mcp.json
{
"mcpServers": {
"clearwage-wh347": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/zchryst/clearwage-wh347.git",
"clearwage-mcp"
]
}
}
}Statutory Rule Coverage (WH347-001 – WH347-026)
WH347-001–WH347-006: Prime/Subcontractor role, sequential payroll numbering, mandatory SAM.gov Wage Determination No., County/State location, Certifying Official Name/Title, and new Page 2 Phone/Email blocks.WH347-007–WH347-010:29 CFR § 5.5(a)(3)(ii)9-digit SSN privacy blocker, split-classification sharedCol 1AWorker Entry No. invariant, and single-row Col 7B/8/9 rollup.WH347-011–WH347-013&WH347-020: Journeyworker (J) vs. Registered Apprentice (RA) progression validation, OA/SAA Page 2 Box 4 registration verification, mandatory"N/A"rule when 0 apprentices worked, and on-siteRA:Jratio enforcement.WH347-014–WH347-019: Col 6A cash-fringe contamination blocker, SF-1444 unlisted classification check, prevailing ST + fringe shortfall restitution,29 CFR § 5.32DBRA/FLSA overtime floor, and CWHSSA>40weekly hour cross-classification check ($32/dayliquidated damages).WH347-021–WH347-026: Unfunded plan prior written DOL approval (29 CFR § 5.28), Col 7B vs. Col 7A reconciliation, Copeland Anti-Kickback Act (29 CFR §§ 3.5–3.6) deduction itemization, Col 9 Net Pay tie-out, and automatic Addendum generation.
Disclaimer
ClearWage WH-347 provides deterministic calculation and document-compilation software implementing published U.S. Department of Labor Wage and Hour Division instructions (OMB Control No. 1235-0008, 29 CFR Parts 3 & 5, 40 U.S.C. §§ 3141–3148, 40 U.S.C. §§ 3701–3708). It does not constitute legal advice and is not affiliated with or endorsed by the U.S. Department of Labor.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Read-only Davis-Bacon wage determination lookup, crew pay checks, fringe 6B, WH-347 payroll drafts.
50-State DOT bid tabulations, Davis-Bacon WH-347 wages, CSI shredder & BABA/DBE MCP server.
MCP server giving AI agents one-connection access to labor & financial-compliance data: DOL Form 550
# TrueCalci Precision Compute Engine Deterministic statutory, financial, and engineering computational tools for AI agents, developers, and autonomous workflows over the Model Context Protocol (MCP). ### Capabilities (25 Verified Engines): - **Specialist FinOps:** Remote Contractor vs. W-2 Parity, S-Corp Reasonable Compensation (IRS Rev. Rul. 74-44), Solo 401(k) Shelter, Cross-Border FX Drag, Billable Capacity Floor. - **Global & Cross-Border Tax:** US Form 2555 FEIE Nomad Stacking, B2B Foreign
Related MCP Servers
- AlicenseAqualityCmaintenanceMCP server that calculates work hours, overtime, and gross pay from clock in/out entries with support for federal, California, Alaska, Colorado, and Nevada overtime rules.259 npm2MIT
- FlicenseNot gradedqualityDmaintenancePaid remote MCP for hosted MCP server providing structured receipts, usage logs, and audit-ready evidence for agent and CI workflows.-
- FlicenseAqualityAmaintenanceEnables AI agents to perform deterministic date, time, timezone, holiday, and business-day arithmetic through MCP, including elapsed-time and calendar-aware operations that skip weekends and supported official holidays.1-
- AlicenseAqualityBmaintenanceEnables LLM agents to perform precise decimal-only calculations across tax, payroll, finance, statistics, engineering, and other domains, returning calculation traces and verifiable receipts. It supports batched and pipelined tool calls with policy-aware, date-sensitive computations.28645 PyPI8MIT