Skip to main content
Glama
civil-qto-mcp

civil-qto-mcp

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

No arguments

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

civil-qto-mcp: Deterministic Civil Engineering Quantity Take-Off (DXF) & BoQ Audit (XLSX/XLSM) Server.

MANDATORY 3-STEP HUMAN-IN-THE-LOOP (HITL) WORKFLOW:

  1. DISCOVERY & CAD HYGIENE: Always call inspect_civil_dxf FIRST on any DXF drawing. Never guess layer names or drawing units.

  2. HUMAN CONFIRMATION: Present the discovered layers (with sample texts and block names), the detected coordinate system (e.g., Hungarian EOV HD72 vs. local coordinates), the recommended unit_scale_to_meter (1.0 for m, 0.01 for cm, 0.001 for mm), and any CAD health warnings to the engineer for confirmation.

  3. DETERMINISTIC QTO & BOQ CROSS-CHECK: Once confirmed, call measure_linear_and_area_features, extract_utility_network_and_levels, inspect_and_audit_boq_xlsx, and compare_qto_with_boq. Never perform mental arithmetic when comparing quantities or auditing totals.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
inspect_civil_dxfA
[STEP 1 of HITL Workflow] Inspect a civil engineering DXF drawing before any measurement.

Returns:
- Modelspace vs. Paperspace entity counts and 3D bounding box
- 3-factor CRS & Drawing Unit estimation (auto-detects Hungarian EOV HD72 metric coordinates,
  checks $INSUNITS header mismatches, and analyzes median text heights)
- Per-layer entity type breakdown, closed/open/nearly-closed polyline counts, HATCH counts,
  distinct INSERT block names, block ATTRIB tag names, and cleaned sample texts
- CAD Hygiene Warnings (Civil 3D proxy objects, external XREFs, 3D 'Flying Z' elevation jumps,
  nearly-closed polylines, and duplicate segments)

After calling this tool, present the layer mapping and `recommended_unit_scale_to_meter`
to the user for confirmation before calling `measure_linear_and_area_features` or
`extract_utility_network_and_levels`.
measure_linear_and_area_featuresA
[STEP 3A of HITL Workflow] Deterministically measure linear lengths (m) and net surface areas (m2).

Engineering guarantees:
- Enforces 2D horizontal projection (Z=0) so 3D 'Flying Z' vertices never distort lengths
- Analytical circular arc (`bulge`) length calculation + sagitta-bounded spline/ellipse discretization
- 1D topological deduplication of exact and partially overlapping lines
- 2D Shapely boolean `.difference()` for island subtraction (guaranteed immunity against
  double-deduction even when HATCH entities already contain internal hole loops)
extract_utility_network_and_levelsB
[STEP 3B of HITL Workflow] Extract utility manholes/gullies, levels, pipe segments, and DIN 4124 / EN 1610 trench earthworks.

Priority order for manhole data extraction:
1. `INSERT` block attributes (`insert.attribs` / `ATTRIB` tags for ID, Cover/Rim level, Invert level, DN)
2. Leader-aware spatial matching (`LEADER` / pointer line arrow tips pointing to manholes)
3. `STRtree` spatial proximity matching within `search_radius_m` (supporting HU, DE, and EN callout syntax)
inspect_and_audit_boq_xlsxA
[STEP 3C of HITL Workflow] Safely parse and mathematically audit an Excel (.xlsx / .xlsm) Bill of Quantities.

Safety & Auditing Features:
- Strictly skips `hidden` and `veryHidden` worksheets (listing them in `skipped_hidden_sheets`)
- Strictly skips hidden rows (`row_dimensions[r].hidden`)
- Automatically detects Single-Price and Hungarian TERC Split (Material + Labor) column layouts
- Audits 100% of rows on selected visible sheets for `MATH_MISMATCH`, `HARDCODED_TOTAL`,
  `SUM_RANGE_GAP`, `SHARED_FORMULA_RISK`, `ZERO_QUANTITY`, and `ZERO_UNIT_PRICE`
  (even when `keyword_filter` or `limit` paginates the returned `items` list)
compare_qto_with_boqA
[STEP 3D of HITL Workflow] Deterministically cross-check CAD QTO measurements against Excel BoQ items.

Automatically normalizes construction unit synonyms and scale factors:
- Length: `m` == `fm` == `lm` == `folyóméter`, `km` == `1000 m`, `cm` == `0.01 m`, `mm` == `0.001 m`
- Area: `m2` == `m²` == `nm` == `sqm`, `ha` == `10,000 m2`
- Volume: `m3` == `m³` == `lm3` == `bm3` == `tm3` == `cum`
- Count: `pcs` == `db` == `darab` == `akna` == `klt` == `készlet` == `nr` == `ea`
convert_dwg_to_dxfA
[v0.2 Tool 6] Convert a single .dwg file or an entire folder of .dwg files into .dxf format.
Note: `inspect_civil_dxf`, `measure_linear_and_area_features`, and `extract_utility_network_and_levels`
also accept `.dwg` paths directly via transparent background caching.
optimize_precast_manhole_elementsB
[v0.2 Tool 7] Decompose manholes and road gullies into optimal precast concrete elements
(base AFE, cone ASZ or shallow flat slab AFT, shaft rings AGY 100/75/50/25 cm, adjustment rings SZB 60/10, 60/8, 60/6 cm,
and D400 covers/grates) and generate a consolidated manufacturer RFQ Bill of Materials (BOM).
calculate_pavement_layer_quantitiesA
[v0.2 Tool 8] Calculate structural layer quantities (m2, m3, metric tons) for road and paving works,
accounting for lateral step-out widening beyond curb lines, compaction multipliers (e.g., CKT-4 x1.20),
and cutting/overlap waste.
convert_vector_pdf_to_dxfA
[v0.3 Tool 9] Convert a vector PDF civil engineering plan into a layered DXF drawing via AutoCAD
Core Console (`_-PDFIMPORT`) and automatically calibrate `recommended_scale_factor_to_meters`
from reference dimensions, explicit scale denominator, or title-block scale text ('M=1:250').
extract_longitudinal_profile_dataB
[v0.3 Tool 10] Analyze a utility longitudinal profile (hossz-szelvény) to compute trench excavation,
machine vs. hand excavation split at utility crossings, two-sided shoring area, and shallow-cover
(<1.00 m) C12/15 concrete encasement volumes.
apply_boq_modifications_and_pricingB
[v0.3 Tool 11] Safely write unit prices (with optional markup_factor), red-bold quantity modifications,
supplemental K-tételek, and '-'/'+' kiv. észrevétel pairs into an Excel BoQ workbook while updating
SUM ranges, XML `<v>` cached values, and stripping `xl/calcChain.xml`.
export_qto_visual_overlayB
[v0.3 Tool 12] Export an interactive HTML and SVG visual verification map showing all measured
polygons, deducted islands, linear features, and point nodes labeled with their IDs and m2/m quantities.
audit_technological_completenessA
[v0.4 Tool 13] Audit a BoQ workbook against 6 civil engineering technological completeness chains
(asphalt, block paving, gravity sewers, pressure water lines, RC foundations, industrial slabs)
and generate ready-to-insert `BoQSupplementalItemInput` (K-tétel) payloads for omitted items.
calculate_foundation_and_slab_qtoB
[v0.4 Tool 14] Calculate the full structural and earthwork quantity chain for foundations, plinths,
and industrial floor slabs: structural concrete (m3), blinding concrete with lateral overhang (m3),
lateral formwork (m2), rebar/fiber tonnage (t), DIN 4124 prismoidal excavation (m3), plinth XPS (m2),
and saw-cut contraction joints (m).
match_prices_and_generate_rfqB
[v0.4 Tool 15] Match BoQ items against regional unit-price databases (Tier 1 own regional DB,
Tier 2 supplier catalogs, Tier 3 built-in benchmarks), flag transport-sensitive items, produce
ready-to-apply `BoQRowPricingInput` payloads, and group materials into 6 supplier RFQ packages.
calculate_tin_earthwork_volumesB
[v0.5 Tool 16] Compute 3D Delaunay TIN surface earthwork volumes (topsoil stripping, cut, fill,
and net earth balance) between existing terrain and designed subgrade level directly from
CAD spot-elevation layers or 3D point clouds (without Civil 3D).
compare_drawing_and_boq_revisionsB
[v0.5 Tool 17] Compare Old vs. New (or Design vs. As-Built) CAD drawings and/or BoQ Excel workbooks,
calculating spatial area additions/removals (`New - Old` and `Old - New`), linear/point deltas,
row-level BoQ diffs, and ready-to-apply variation order (`kiv. észrevétel` / `K-tétel`) payloads.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.7/5.0

Scored across 17 tools

Disambiguation4/5

Most tools have clearly distinct scopes, especially around CAD inspection, measurement, conversion, and BoQ handling. There is some potential overlap among the multiple calculation tools and among BoQ audit/pricing tools, but the detailed descriptions and explicit workflow steps mostly resolve those boundaries.

Naming Consistency5/5

All tool names use snake_case and are predominantly verb-led with a clear object or action phrase. The pattern is highly predictable across the entire set.

Tool Count4/5

The 17 tools cover a complex civil QTO and BoQ workflow, and each appears to serve a specialized role. The count is slightly heavy but reasonable for the breadth of the domain.

Completeness4/5

The surface covers inspection, conversion, measurement, utility extraction, BoQ auditing, comparison, pricing, modification, and visualization. Minor gaps may exist around creating a BoQ from scratch or non-vector PDF handling, but core workflows are well covered.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues