Repository avatar
AI Tools
v0.1.0
active

jobsite-math

io.github.johnski9000/jobsite-math

Read-only US construction calculators: roof pitch, concrete, gravel, brick, paint, drywall, deck

Documentation

jobsite-math

Exact, tested calculators for the math US contractors do every day, in two packages:

PackageWhat it is
jobsite-mathZero-dependency TypeScript functions: roof pitch, hip roof, concrete, gravel, brick, mortar, paint, drywall, deck boards, markup, hourly rate.
jobsite-math-mcpA read-only MCP server exposing the same functions to Claude, Cursor and other AI assistants.
npm install jobsite-math
npx -y jobsite-math-mcp   # MCP server over stdio

US units throughout, with the unit in every field name. Product figures such as bag yield, paint coverage and gravel density are inputs, never hidden constants. Quantities round up to whole bags, sheets and boards. See packages/core for every formula and its limits.

Develop

npm install
npm test        # builds both packages, runs unit tests and an end-to-end stdio test

Node.js 22.18 or later for development (tests run TypeScript directly). The published packages need Node.js 20 or later.

Issues and pull requests are welcome, especially corrections from people who do this work on site.

License

MIT. Copyright (c) 2026 JW Digital Services Ltd. The same math runs the free browser calculators at contractorwebsiteshq.com/us/tools.

NPM
jobsite-math-mcp
Install Command
npm install jobsite-math-mcp