oce-mcp-integration
Installation
SKILL.md
MCP Integration for OpenConstructionERP
Why MCP
MCP (Model Context Protocol) is the 2026 standard for giving AI assistants tools. Wrapping OpenConstructionERP's REST API in an MCP server turns the assistant from a chat partner into an operator: it can load a cost base, search items, build a BOQ and read validation results itself.
What to expose (start with these)
| MCP tool | Underlying API | Notes |
|---|---|---|
list_cost_bases |
GET /api/v1/costs/base-catalog |
families, variants, positions, loaded badge |
load_cost_base |
POST /api/v1/costs/load-cwicr/{db_id} |
idempotent, returns imported/skipped |
search_cost_items |
GET /api/v1/costs/?region=...&q=... |
SQL path, works without Qdrant |
get_cost_item |
GET /api/v1/costs/{id} |
full components[] + classification |
category_tree |
GET /api/v1/costs/category-tree/?region=... |
browsing |
suggest_for_element |
POST /api/v1/costs/suggest-for-element |
BIM element → cost ranking |
create_boq / validate_boq |
POST /api/v1/boqs, /boqs/{id}/validate/ |
estimating |
import_catalog |
POST /api/v1/catalog/import/{region} |
resource catalog |