Public API

Roof Takeoff API and MCP

Calculates a complete roof takeoff from actual final measurements or plan-view measurements adjusted for roof pitch. Accessible to humans via the builder UI, to AI agents via GET calculation URL, REST API, and MCP tools - all using the same shared calculation engine. The human builder, REST API, result page, and MCP tools all use the same calculation engine.

Endpoints

  • GET /api/public/roof-takeoff/schema - View
  • POST /api/public/roof-takeoff/calculate - POST JSON body, returns JSON result
  • GET /api/public/roof-takeoff/openapi - View
  • GET /free-roofing-takeoff-builder/calculate - server-rendered HTML result. Full documentation and examples
  • POST https://quote-core.com/mcp - MCP server for AI tools

Example request

{
  "mode": "plan",
  "units": "metric",
  "pitchDegrees": 25,
  "area": 126,
  "hips": [
    5,
    5,
    5,
    5
  ],
  "ridges": [
    8
  ],
  "valleys": [
    4,
    4
  ],
  "spouting": [
    18
  ]
}

Use actual for final roof measurements. Use plan when dimensions are plan-view measurements requiring pitch adjustment. Results are estimates and depend on supplied measurements and any published catalogue pricing.

MCP tools

  • get_roof_takeoff_schema
  • calculate_roof_takeoff
  • get_calculation_result