Agent skill · datadrivenconstruction
oce-mcp-integration
Connect OpenConstructionERP to AI coding assistants via MCP (Model Context Protocol): expose costs, BOQ, BIM and catalog endpoints as MCP tools so Claude Code / Antigravity / OpenCode can drive the platform. Use when wiring an assistant to the ERP.
What it needs
About 2k tokens when loaded.
What this skill does
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 --- --- --- listcostbases GET /api/v1/costs/base-catalog families, variants, positions, loaded badge loadcostbase POST /api/v1/costs/load-cwicr/{dbid} idempotent, returns imported/skipped searchcostitems GET /api/v1/costs/?region=...&q=... SQL path, works without Qdrant getcostitem GET /api/v1/costs/{id} full components[] + classification categorytree GET /api/v1/costs/category-tree/?region=... browsing suggestforelement POST /api/v1/costs/suggest-for-element BIM element → cost ranking createboq / validateboq POST /api/v1/boqs, /boqs/{id}/validate/ estimating importcatalog POST /api/v1/catalog/import/{region} resource catalog Reference implementation (TypeScript, fast) Auth & safety Reuse the ERP's JWT (register a service account; bootstrap admin only for setup). MCP tools must be idempotent and read-mostly: loadcostbase returns alreadyloaded on repeat. Never expose raw credentials in tool descriptions; use env vars (ERPTOKEN). Rate-limit write tools; the ERP already enforces apiratelimit (200/min default). Best practices 1. Start read-only (browse/search), add writes (BOQ create, link) after testing. 2. Wrap long operations (BIM conversion) in a progress-tool pattern instead of blocking. 3. Log every assistant action server-side (the platform's usage ledger pattern). 4. Publish the MCP server to the assistant marketplace (Claude Code registry, Antigravity, OpenCode).
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills datadrivenconstruction/oce-mcp-integration