# bim-agent

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-green.svg)](https://modelcontextprotocol.io/)

> **One-click BIM audits through AI.**
> Instead of running 3 separate tools manually, ask one question and get a complete report — statistics, validation, and quantities in a single response.

---

## For Architects & Engineers

### What does this do?

Normally, auditing an IFC model requires 3 steps: get statistics, run validation, extract quantities. bim-agent chains them together:

> "Audit this IFC model"

One question. One answer. Complete report.

### What workflows are available?

| Workflow | What it does |
|----------|-------------|
| Quick Audit | Stats → Validation → Quantities in one go |
| Full QC | Stats → Full validation → Spaces list |
| Quantity Takeoff | Concrete → Walls → Doors & Windows separately |
| Version Diff | Compare two IFC versions |
| Digital Twin Check | Assess if model is ready for Speckle sync |

### How to install

Same as ifcopenshell-mcp:

```
git clone https://github.com/Daviidro/bim-agent.git
cd bim-agent
uv sync
```

Add to Claude Desktop config:
```json
{
  "mcpServers": {
    "bim-agent": {
      "command": "uv",
      "args": ["run", "bim-agent"]
    }
  }
}
```

### Is this safe?

Same guarantees as ifcopenshell-mcp: 100% local, no cloud, MIT license. Requires ifcopenshell-mcp installed alongside it.

---

## For Developers

### Tools

| Tool | Description |
|------|-------------|
| `list_bim_workflows` | List all available BIM workflow playbooks |
| `get_workflow_plan` | Get ordered execution steps for a workflow |
| `get_workflow_prompt` | Get final prompt template for report generation |
| `run_quick_audit_guide` | Self-contained step-by-step audit guide |
| `execute_quick_audit` | Run full audit: stats + validation + quantities |
| `execute_full_qc` | Run full QC: stats + all checks + spaces |
| `execute_quantity_takeoff` | Multi-category quantity extraction |

### Ecosystem
- [ifcopenshell-mcp](https://github.com/Daviidro/ifcopenshell-mcp) — Talk to IFC models
- [speckle-mcp](https://github.com/Daviidro/speckle-mcp) — AEC interoperability
- [awesome-aec-mcp](https://github.com/Daviidro/awesome-aec-mcp) — Curated MCP list

## License

MIT