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
Install / Use
npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill oce-mcp-integrationInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of oce-mcp-integration
oce-mcp-integration scores 81/100 on our quality scale, 3570th of 4,716 Development & Engineering skills we index.
Its SKILL.md is 3.3 KB long, split into 6 sections with 1 code example: a solid amount of guidance for an agent.
It has 333 GitHub stars, a meaningful sign that others use it.
Maintenance, license and trust
- The repository was last updated about 3 months ago, so oce-mcp-integration is actively maintained.
- Our last check on 2026-11-08 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-26. Automated pattern scan on 2026-10-26. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
oce-mcp-integration compared with similar skills
All 4 of these similar skills score higher than oce-mcp-integration; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| oce-mcp-integration (this skill)by datadrivenconstruction | 81 | 333 | 3mo ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 118.9k | 11d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 113.3k | 12d ago | CLAUDE.md |
| hyperframesby heygen-com | 100 | 87.1k | today | CLAUDE.md |
| rufloby ruvnet | 100 | 82.1k | today | CLAUDE.md |
Frequently asked questions
- How do I install oce-mcp-integration?
- Run
npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill oce-mcp-integration. The install tabs above show the steps for each supported agent. - Which AI agents does oce-mcp-integration work with?
- It is written for Claude Code, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is oce-mcp-integration safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is oce-mcp-integration still maintained?
- The repository was last updated about 3 months ago, so oce-mcp-integration is actively maintained.
Skill content
View source on GitHubname: oce-mcp-integration description: "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."
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 |
Reference implementation (TypeScript, fast)
// mcp-server: FastMCP wrapper around the ERP's FastAPI backend
import { FastMCP } from "fastmcp";
const ERP = process.env.OPENESTIMATE_URL ?? "http://localhost:8000";
const server = new FastMCP({ name: "openconstructionerp" });
server.addTool({
name: "load_cost_base",
description: "Load a CWICR cost base (e.g. TR_NATIONAL, ZH_CHINA) into the ERP.",
parameters: { db_id: { type: "string", required: true } },
execute: async ({ db_id }) => {
const r = await fetch(`${ERP}/api/v1/costs/load-cwicr/${db_id}`, {
method: "POST",
headers: { Authorization: `Bearer ${process.env.ERP_TOKEN}` },
});
return await r.json();
},
});
server.addTool({
name: "search_cost_items",
description: "Search cost items in a region by keyword.",
parameters: { region: { type: "string" }, q: { type: "string" } },
execute: async ({ region, q }) => {
const r = await fetch(`${ERP}/api/v1/costs/?region=${region}&q=${encodeURIComponent(q)}&limit=20`,
{ headers: { Authorization: `Bearer ${process.env.ERP_TOKEN}` } });
return await r.json();
},
});
server.start({ transportType: "stdio" });
Auth & safety
- Reuse the ERP's JWT (register a service account; bootstrap admin only for setup).
- MCP tools must be idempotent and read-mostly:
load_cost_basereturnsalready_loadedon repeat. - Never expose raw credentials in tool descriptions; use env vars (
ERP_TOKEN). - Rate-limit write tools; the ERP already enforces
api_rate_limit(200/min default).
Best practices
- Start read-only (browse/search), add writes (BOQ create, link) after testing.
- Wrap long operations (BIM conversion) in a progress-tool pattern instead of blocking.
- Log every assistant action server-side (the platform's usage ledger pattern).
- Publish the MCP server to the assistant marketplace (Claude Code registry, Antigravity, OpenCode).
Related Skills
taste-skill
118.9kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
113.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
hyperframes
87.1kAI video you can actually edit. HyperFrames is a free, open-source AI video editor. Describe any video and get a real project you can change down to the frame.
ruflo
82.1k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
