TakeoffMetric Construction Calculators MCP server

takeoffmetric-mcp

A Model Context Protocol server (stdio) that runs the construction calculators of TakeoffMetric (https://takeoffmetric.com/) from an MCP client. It ships 15 calculators, a tool that lists them, and a search over a table of estimating constants in which every row names its published source.

The calculators are not re-implemented here. The site's TypeScript engine is bundled unchanged into vendor/engine.mjs, and the test suite checks that each tool returns what the engine source computes.

Install

Requires Node.js 20 or later.

npx -y takeoffmetric-mcp

Claude Desktop (claudedesktopconfig.json):

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

Claude Code:

claude mcp add takeoffmetric -- npx -y takeoffmetric-mcp

Tools

Two more tools complete the server:

• list_calculators: tool name, title, page URL, one-line description and input keys of each calculator.
• search_constants: rows of the constants table matched by a substring (query) and/or a category, 50 rows at most per call.

Inputs

Each calculator's input schema is generated at start-up from the engine's own input list, so keys, bounds, options and defaults are the ones of the matching form on the site.

• Every input is optional. A key you leave out takes the engine default, as an untouched form field does.
• system is "imperial" (default) or "metric". It sets the unit the numbers are typed in and the defaults.
• A length is a number in the unit named in its description, or a string that carries its unit, such as "20 ft 6 in".
• An unknown key or an out-of-range value returns isError: true with one message per field. Nothing is computed from a clamped value.

Output

Shortened. The full README is on GitHub.