Skip to main content

Construction estimating as code. MCP server with 48 tools for materials, labor, cost, structural, permits, plumbing, electrical, HVAC, and estimate generation. Replaces SaaS estimating tools for AI agents and contractors.

Project description

Blackmount Construction MCP

PyPI version License: MIT Python 3.10+

The unified construction MCP for developers — all trades in one server.

48 tools spanning materials, labor, cost, structural, permits, plumbing, electrical, HVAC, and estimate generation. One pip install for the whole jobsite.

Built by Blackmount AI. Free web versions at tools.blackmount.ai.

Install

pip install blackmount-construction-mcp

Or with uv:

uvx blackmount-construction-mcp

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "construction": {
      "command": "uvx",
      "args": ["blackmount-construction-mcp"]
    }
  }
}

Or if installed via pip:

{
  "mcpServers": {
    "construction": {
      "command": "blackmount-construction-mcp"
    }
  }
}

Example Prompts

Once connected, ask Claude things like:

"How much concrete do I need for a 24×36 slab, 4 inches thick?"

"Size the panel for a 2400 sqft house with electric range, electric dryer, and central AC."

"What's the simplified Manual J heat load for a 1800 sqft home in climate zone 5?"

"Estimate the labor hours and cost for installing 1200 sqft of drywall with a 2-person crew."

"Generate an HTML estimate for a kitchen remodel: $8,500 cabinets, 35 sqft of quartz at $75/sqft, 8.25% tax."

The agent picks the right tool, runs the calculation, and replies with structured numbers — no spreadsheets.

Tool Categories (48 total)

Module Tools What it covers
Materials 10 Concrete, rebar, lumber, drywall, paint, roofing, tile, insulation, brick
Labor 4 Hours for 28 task types, cost with overtime, crew scheduling, productivity
Cost 7 Material costing, markup, overhead, profit margin, change orders, budgets
Structural 7 Beam loads, joist spacing, footings, snow/wind loads, concrete mix, rebar
Permits 4 Fee estimates, inspection checklists, zoning setbacks, occupancy (IBC)
Plumbing 5 Pipe sizing (IPC), water heater sizing, drain slope, fixture units, cost
Electrical 5 Load calc (NEC 220), wire gauge, circuit sizing, panel capacity, cost
HVAC 4 Manual J simplified, duct sizing, equipment sizing, system cost
Estimates 2 Plain-text and HTML formatted estimate documents

Structural and Manual J calculators are planning-grade, not for final engineering design. Consult a licensed engineer for stamped drawings.

All Tools

Materials (10)

Tool Description
calculate_concrete_volume Cubic yards for slabs/footings
calculate_concrete_bags Bag count (60/80/90 lb)
calculate_rebar_quantity Linear feet of rebar for slabs
calculate_lumber_board_feet Board feet calculation
calculate_drywall_sheets Sheet count with waste factor
calculate_paint_gallons Gallons for multi-coat coverage
calculate_roofing_squares Squares and bundles
calculate_tile_quantity Tile count with waste
calculate_insulation_batts Batt count
calculate_brick_count Bricks + mortar bags

Labor (4)

Tool Description
estimate_labor_hours Hours for 28 task types by skill level
calculate_labor_cost Cost with overtime
calculate_crew_days Working days for crew
calculate_productivity_rate Actual vs standard productivity

Cost (7)

Tool Description
estimate_material_cost Total from line items
calculate_markup Contractor markup
calculate_overhead Overhead allocation
calculate_profit_margin Margin analysis
calculate_change_order Change order pricing
calculate_cost_per_sqft Per-sqft with benchmarks
create_project_budget Full budget breakdown

Structural (7)

Tool Description
calculate_beam_load Allowable beam load (SPF, DF, SYP, HF)
calculate_joist_spacing Recommended spacing
calculate_footing_size Foundation footing width
calculate_snow_load Roof snow load (ASCE 7)
calculate_wind_load Wind pressure by height
get_concrete_mix_ratio Mix ratio for target PSI
calculate_rebar_development_length Development length (ACI 318)

Permits & Compliance (4)

Tool Description
estimate_permit_fee Fee estimate by jurisdiction
get_inspection_checklist Required inspections
check_setbacks Zoning setback analysis
calculate_occupancy_load Max occupancy (IBC)

Plumbing (5)

Tool Description
calculate_pipe_sizing Pipe diameter from fixture units (IPC)
calculate_water_heater_sizing Tank size + recovery rate
calculate_drain_slope Min slope per IPC code
calculate_fixture_count Total fixture units for residential
estimate_plumbing_cost Full cost: materials + labor + permits

Electrical (5)

Tool Description
calculate_electrical_load Total load + panel size (NEC 220)
calculate_wire_gauge AWG by ampacity + voltage drop
calculate_circuit_sizing Breaker size with 80% rule
check_panel_capacity Can panel handle new circuits?
estimate_electrical_cost Full cost: materials + labor + permits

HVAC (4)

Tool Description
calculate_heat_load Simplified Manual J (BTU, tonnage, CFM)
calculate_duct_sizing Duct diameter for given CFM
calculate_equipment_sizing AC tonnage + furnace BTU by climate zone
estimate_hvac_cost System install cost by type

Estimate Documents (2)

Tool Description
create_text_estimate Formatted plain-text estimate
create_html_estimate Professional HTML estimate (inputs HTML-escaped)

Use as a Python Library

Each module is also importable for non-MCP use:

from blackmount_construction_mcp import materials, electrical, hvac, plumbing, pdf_estimate

# Concrete for a 20×30 slab, 4 inches thick
materials.concrete_volume(20, 30, 4)
# {'cubic_feet': 200.0, 'cubic_yards': 7.41, 'order_yards': 8.25, ...}

# Electrical load calc for a 2000 sqft house
electrical.electrical_load_calc(2000, 15, ["electric_range", "electric_dryer", "central_ac"])
# {'total_load_va': ..., 'recommended_panel_amps': 100, ...}

# Generate an HTML estimate (user inputs are HTML-escaped)
pdf_estimate.generate_estimate_html(
    project_name="Kitchen Remodel",
    client_name="Jane Smith",
    line_items=[
        {"description": "Cabinets", "quantity": 1, "unit": "set", "unit_price": 8500},
        {"description": "Quartz countertop", "quantity": 35, "unit": "sqft", "unit_price": 75},
    ],
    tax_rate=8.25,
)

Want these tools in your browser?

All calculators are available as free web tools at tools.blackmount.ai/construction.

Construction Pro (coming soon) will add: branded estimate PDFs, multi-project workspace, saved estimates, and contractor markup presets. Pricing →

On the job site?

Blackmount Field (iOS, coming soon) brings these calculators into a contractor's mobile workflow:

  • Quick estimates from a phone
  • Change orders with photo proof and GPS
  • Client e-signatures + share links
  • Branded PDF output
  • Project memory across visits

This MCP package is the underlying calculation engine. Blackmount Field is the contractor app on top of it.

Part of the Blackmount Ecosystem

This MCP server is part of Blackmount — the AI work vault that captures your AI conversations, meetings, and browser data into private project memory.

More MCP Servers by Blackmount

Package Focus Install
blackmount-construction-mcp All-trades construction (this package) pip install blackmount-construction-mcp
blackmount-mcp Browser memory + page intelligence pip install blackmount-mcp
blackmount-nlp-mcp NLP + text analysis pip install blackmount-nlp-mcp
blackmount-electrical-mcp Deeper electrical engineering (coming soon)
blackmount-hvac-mcp Deeper HVAC engineering (coming soon)
blackmount-engcalc-mcp General engineering calc (coming soon)

Comparison

ProEst Buildertrend Blackmount Construction MCP
Price $389/mo $99/mo Free (MIT)
AI-native (MCP) No No Yes
Use from code No No Yes
Self-hosted No No Yes
Offline capable No No Yes

This is a calculation engine that plugs into any AI assistant, script, or application via the Model Context Protocol. Not a SaaS dashboard.

Development

git clone https://github.com/BlackMount-ai/blackmount-construction-mcp.git
cd blackmount-construction-mcp
python -m venv .venv && source .venv/bin/activate
pip install -e .
pip install pytest
pytest tests/ -v

License

MIT License. See LICENSE.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

blackmount_construction_mcp-0.4.1.tar.gz (45.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

blackmount_construction_mcp-0.4.1-py3-none-any.whl (45.6 kB view details)

Uploaded Python 3

File details

Details for the file blackmount_construction_mcp-0.4.1.tar.gz.

File metadata

File hashes

Hashes for blackmount_construction_mcp-0.4.1.tar.gz
Algorithm Hash digest
SHA256 2d24830a56422cd8f73656cc42dc8136b9b44f0da7fd2d3f9380ae2326f1e845
MD5 1d9ab631000cf1e2d62b533ad0563e5f
BLAKE2b-256 3538efebf347868c16be15a98f4e5ca3bcc1289c985e86ff6175fc485ea380d2

See more details on using hashes here.

File details

Details for the file blackmount_construction_mcp-0.4.1-py3-none-any.whl.

File metadata

File hashes

Hashes for blackmount_construction_mcp-0.4.1-py3-none-any.whl
Algorithm Hash digest
SHA256 b536e0b6f1b9b8957f44b8d95db8dcf4662954f7f2ffebe4166188a7939e64b3
MD5 7a9aeb628d0d67256ff5d10571cf84ec
BLAKE2b-256 0853d2dd45aec5ceb7716c4b3fca6557d6320d2d63a1a2dc0706a06d990b2227

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page