Metadata-Version: 2.4
Name: blackmount-construction-mcp
Version: 0.4.1
Summary: 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-URL: Homepage, https://blackmount.ai
Project-URL: Web Tools, https://tools.blackmount.ai
Project-URL: Chrome Extension, https://chromewebstore.google.com/detail/fpchhlhegjjjkfnhcdgfjcbinhhmfccc
Project-URL: Repository, https://github.com/BlackMount-ai/blackmount-construction-mcp
Project-URL: Issues, https://github.com/BlackMount-ai/blackmount-construction-mcp/issues
Author-email: "Dr. Mehrdad Shirangi" <mehrdad@blackmount.ai>
License-Expression: MIT
License-File: LICENSE
Keywords: building,construction,construction-calculator,contractor,cost-estimation,electrical,estimating,hvac,labor,materials,mcp,model-context-protocol,permits,plumbing,structural
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: mcp[cli]>=1.0.0
Description-Content-Type: text/markdown

<!-- mcp-name: io.github.BlackMount-ai/blackmount-construction-mcp -->
# Blackmount Construction MCP

[![PyPI version](https://img.shields.io/pypi/v/blackmount-construction-mcp.svg)](https://pypi.org/project/blackmount-construction-mcp/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)

**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](https://blackmount.ai). Free web versions at [tools.blackmount.ai](https://tools.blackmount.ai).

## Install

```bash
pip install blackmount-construction-mcp
```

Or with [uv](https://docs.astral.sh/uv/):

```bash
uvx blackmount-construction-mcp
```

## Claude Desktop Configuration

Add to your `claude_desktop_config.json`:

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

Or if installed via pip:

```json
{
  "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:

```python
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](https://tools.blackmount.ai/construction/).

**Construction Pro** (coming soon) will add: branded estimate PDFs, multi-project workspace, saved estimates, and contractor markup presets. [Pricing →](https://tools.blackmount.ai/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](https://tools.blackmount.ai/construction/)

## Part of the Blackmount Ecosystem

This MCP server is part of [Blackmount](https://blackmount.ai) — the AI work vault that captures your AI conversations, meetings, and browser data into private project memory.

- **[Blackmount Extension](https://chromewebstore.google.com/detail/fpchhlhegjjjkfnhcdgfjcbinhhmfccc)** — Capture AI chats from ChatGPT, Claude, Gemini, and 10+ platforms
- **[tools.blackmount.ai](https://tools.blackmount.ai)** — Free online calculators (construction, finance, trading, and more)
- **[app.blackmount.ai](https://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](https://pypi.org/project/blackmount-mcp/) | Browser memory + page intelligence | `pip install blackmount-mcp` |
| [blackmount-nlp-mcp](https://pypi.org/project/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](https://modelcontextprotocol.io/). Not a SaaS dashboard.

## Development

```bash
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](LICENSE).
