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
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.
- iOS app: coming soon
- Web tools today: tools.blackmount.ai/construction
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.
- Blackmount Extension — Capture AI chats from ChatGPT, Claude, Gemini, and 10+ platforms
- tools.blackmount.ai — Free online calculators (construction, finance, trading, and more)
- app.blackmount.ai — The AI work vault
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file blackmount_construction_mcp-0.4.0.tar.gz.
File metadata
- Download URL: blackmount_construction_mcp-0.4.0.tar.gz
- Upload date:
- Size: 45.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1faf80a748ef9e90aa1d5327ca8b9c2b37fd36d409cfc4fb6619a0472859e49e
|
|
| MD5 |
272ed487747652909a159ee83758ab68
|
|
| BLAKE2b-256 |
41c50a41e13b21a09246f3b3bad79e1b007430162a17062ad73ab7552a2a468c
|
File details
Details for the file blackmount_construction_mcp-0.4.0-py3-none-any.whl.
File metadata
- Download URL: blackmount_construction_mcp-0.4.0-py3-none-any.whl
- Upload date:
- Size: 45.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b46a5af7c741d4ee812de3931ea90f8f20028f39fa550b59c5f4c80e86ce81f8
|
|
| MD5 |
a76475639d61b3b3716aae68b5945628
|
|
| BLAKE2b-256 |
c1ba3c5617a1afb243c7c01643cdda61d52094dd13ea427b5789f0f27b257ba8
|