RoofMeasure MCP

RoofMeasure MCP

Free EagleView-style satellite roof measurements plus modular Xactimate-styleestimating, packaged as an MCP server and CLI for any LLM or agent.

What it measures (from Google Solar API 3D elevation data):

• Total roof area (sq ft and squares), with and without waste (0-32% waste table, squares rounded up to 1/3 SQ)
• Facet count, per-facet area, pitch, and slope direction
• Predominant pitch and areas-per-pitch table
• Ridges, hips, valleys, rakes, and eaves lengths (slope-corrected)
• Drip edge (eaves + rakes), steep-slope area split for labor surcharges
• Suggested waste factor from roof complexity

What it generates:

• EagleView-style measurement report (Markdown)
• Xactimate-style insurance estimate (.docx) with line items, material salestax, per-structure summaries, tax recap, and grand total. Fully modular:company name/logo, estimator, homeowner, claim info, pricing rules, taxrate, waste %, component counts, and O&P toggle are all configurable.

Setup

1. Get a free Google Cloud API key with the Geocoding API and SolarAPI enabled (console.cloud.google.com).The $200/month free credit covers roughly 1,000 roof lookups.

2. Install:

   pip install git+https://github.com/thegimmieapp/roofmeasureMCP.git
   # or from a local clone:
   pip install -e .
   

3. Set your key:

   export GOOGLE_MAPS_API_KEY="your_key_here"
   

Use as an MCP server (Claude Desktop, Claude Code, Cursor, etc.)

Add to your MCP config (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "roofmeasure": {
      "command": "roofmeasure-mcp",
      "env": {
        "GOOGLE_MAPS_API_KEY": "your_key_here",
        "ROOFMEASURE_OUT_DIR": "/path/for/reports",
        "ROOFMEASURE_LOGO": "/path/to/company_logo.png"
      }
    }
  }
}

Claude Code: claude mcp add roofmeasure -e GOOGLE_MAPS_API_KEY=your_key -- roofmeasure-mcp

Tools

The estimate tool enforces contractor intake: if homeowner name or date ofloss are missing it returns needs_info so the agent asks the user beforegenerating.

Use from the command line

roofmeasure measure "3708 Ebony Hollow Pass, Austin, TX 78739"
roofmeasure report  "3708 Ebony Hollow Pass, Austin, TX 78739" -o report.md
roofmeasure estimate "3708 Ebony Hollow Pass, Austin, TX 78739"   # prompts for homeowner, date of loss, claim #

How it works

1. Geocodes the address, pulls Google Solar API buildingInsights anddataLayers (0.1 m/px digital surface model + roof mask GeoTIFFs).
2. Segments the DSM into planar facets (region growing on slope + aspect).
3. Classifies every facet boundary: shared boundaries become ridges, hips, orvalleys (by relative elevation and facing); perimeter boundaries becomeeaves or rakes (by edge direction vs the facet's downslope direction).Sloped edge lengths are slope-corrected in 3D.
4. If high-resolution DSM data is not available for an address, it falls backto roof-segment statistics and clearly flags edge lengths as ESTIMATED.

Accuracy notes

This tool is free and uses the best publicly available elevation data. It isstrong on areas, pitch, and squares; edge classification is measured from theDSM but can be affected by tree cover, imagery age, and resolution. It doesnot carry an accuracy guarantee - field verify before ordering material, asyou would with any measurement report.

Estimating defaults (all overridable)

• Architectural laminated shingles + synthetic 30# felt only
• 1:1 replacement of existing components
• ~$550/SQ blended target across core roofing components (shingle unit price back-solved)
• Steep-roof labor surcharges at 8/12-9/12 and 10/12+ tiers from the measured pitch table
• Material sales tax applied to the material fraction of each line item
• Overhead & Profit OFF by default (include_op: true to add 10/10)

MIT license.