Tool

Actions

Description

civil3d_health

health, health_verbose (plugin version, build date, drawing name, open document count)

Check plugin connectivity

civil3d_object

get_properties (curated safe field set for Surface/TinSurface — full reflection hangs there, confirmed in live testing), list_by_type, resolve_location (rejects Surface handles in reference_object mode — no meaningful anchor point), set_style_name, delete_entity, ensure_layer, list_layers, set_layer, move_entity, copy_entity, rotate_entity, get_entity_bounds

Generic reflection-based introspection for any object type, plus resolve_location (coordinates / interactive mouse click / relative to a reference object) to place anything anywhere, plus set_style_name — the generic style engine, works on any object or already-created label with a writable StyleName — the "escape valve" primitives that reduce the need for domain-specific commands. The entity-generic primitives (delete/ensure_layer/list_layers/set_layer/move/copy/rotate/get_bounds) close the test/cleanup loop — before these, there was no way to undo test objects without entering Civil3D manually

civil3d_drawing

info, settings, save, undo, redo, list_object_types, get_selected

Drawing operations

civil3d_surface

list, get, get_elevation, get_statistics, create, delete, add_points, add_breakline (real only for breaklineType="standard"), add_boundary, compute_volume, get_area_elevation_table, compute_contour_volume, close_contours_against_boundary (auto-picks the non-self-intersecting tramo for irregular/hairpin boundaries), delete_points, list_triangles, get_triangle_at_point, paste_surface, get_build_options, extract_contours (planned), get_operations (planned), delete_boundary (planned), set_build_options (planned), add_contour_data (planned), swap_edge (planned), minimize_flat_triangles (planned), minimize_convex_triangles (planned), delete_breakline (planned), delete_operation (planned)

Surface management

civil3d_alignment

list, get, create, delete, station_to_point, point_to_station, list_superelevation_curves, list_superelevation_critical_stations, list_design_speeds

Alignment operations

civil3d_profile

list, get, get_elevation, create_from_surface, create_layout (no label set yet), list_entities, delete, create_tangent (planned), create_parabola (planned)

Profile management

civil3d_profile_view

create, list, get, delete, get_bands

Profile views (graphic display of a profile)

civil3d_corridor

list, get, rebuild, get_surfaces, create_surface_from_corridor_surface, list_baselines, list_baseline_regions, add_baseline_region, get_targets, get_feature_lines, compute_volumes (planned, combine surface actions instead)

Corridor operations (no .NET API for intersections/roundabouts — COM/UI only)

civil3d_sample_line

create_group, list_groups, create_line, list_lines, delete_group, create_section_view_group, list_section_views, delete_section_view, list_mass_haul_lines, report_quantities, create_mass_haul_line (planned), list_material_lists (planned)

Sample lines, section views, mass haul, quantity takeoff

civil3d_sheet_production

list_view_frames, list_view_frame_groups, get_view_frame_group, list_match_lines, list_sheet_sets, get_sheet_set_info, add_sheet, get_sheet_properties, set_sheet_title_block, update_plan_profile_sheet_alignment, create_sheet_view, set_sheet_view_scale

View frames/match lines/view frame groups are read-only (creating them is not exposed by the .NET API, confirmed Autodesk limitation); sheet SET management (add/get/title-block/scale) is a separate, real, higher-level Sheet Set Manager abstraction — the set itself must already exist

civil3d_pipe

list_networks, get_network, list_pipes, get_pipe, list_structures, get_structure, list_parts_lists, list_parts, get_part, get_rule_set, get_overridden_rules, resize_pipe, hgl_calculate, hydraulic_analysis, structure_properties, create_network (planned), add_pipe (planned), add_structure (planned), check_interference (planned)

Gravity pipe networks. list_parts_lists/list_parts/get_part enumerate the parts catalog (families+sizes, filterable by pipe/structure domain) without needing a network to exist yet

civil3d_pressure_pipe

list_networks, get_network, list_parts_lists, list_parts, get_part, create_network, delete_network, assign_parts_list, export, add_pipe, get_pipe_properties, add_fitting, get_fitting_properties, add_appurtenance, set_cover (planned), validate (planned), connect_networks (planned), resize_pipe (planned)

Pressure pipe networks — separate object model from gravity networks. list_parts_lists/list_parts/get_part accept partsListName directly (no network needed) or networkName to resolve the catalog already assigned

civil3d_settings

list_settings_tree, set_feature_setting

Toolspace Settings tree (feature/command settings — separate from object styles and from drawing unit/zone settings). Resolves the real settings type per objectType at runtime, not compile time — an unresolvable objectType returns a clear error rather than partial data

civil3d_point

list (optionally by group), get, create, delete, list_groups, create_group, delete_group, import (PNEZD/PENZD text), export (PNEZD/PENZD text), description_keys (planned)

COGO points

civil3d_data_shortcut

get_project_id, associate_project, promote_reference, create_reference (planned)

Data shortcuts (shared references between drawings)

civil3d_survey

list_figure_styles (confirmed to hang 120s in live testing without a diagnosed cause — see CLAUDE.md), list_networks (planned), list_figures (planned)

Survey data (read-only)

civil3d_import_export

import_landxml (planned — confirmed impossible via .NET API), export_surface_to_landxml (planned), export_to_shapefile (planned)

LandXML / GIS import-export — use civil3d_point import/export for plain-text points instead

civil3d_parcel

list_sites, list, get, delete, create (planned)

Parcels

civil3d_assembly

list, get, delete, list_subassemblies, get_subassembly_parameters, set_subassembly_parameter, create (planned)

Corridor assemblies

civil3d_grading

list_feature_lines, get_feature_line, delete_feature_line, create_feature_line (planned), list_groups (planned), get_group (planned), delete_group (planned), create_group (planned)

Grading feature lines (groups pending real API access)

civil3d_geometry

create_line, create_polyline, create_3d_polyline, create_text, create_mtext (all 5 auto-create the target layer if missing instead of throwing eKeyNotFound), offset_lines_to_boundary (returns a warning field when 0 lines were created, e.g. no intersections found)

Basic AutoCAD geometry

civil3d_blocks

list_block_definitions, count_blocks_by_name (optionally scoped to a layout), get_block_attributes (per-instance tag/value pairs), list_blocks_by_layer, get_block_insertion_points, list_dynamic_block_states (only meaningful for actual dynamic blocks)

Plan-reading: exact block/symbol inventory read straight from the drawing database (bloques, atributos, layers) — no geometry interpretation

civil3d_label

extract_text_entities (DBText/MText, optionally by layer), extract_leader_annotations (Leader/MLeader with attached text), extract_dimensions (Dimension entities, optionally by layer), match_text_to_nearby_geometry (pure post-processing — no plugin call, pairs already-extracted text with the closest already-extracted geometry within a radius)

Plan-reading: labels, leaders, and dimensions — complements civil3d_blocks with the annotations around the symbols

civil3d_legend

read_legend_table (raw rows of a Table entity — one by handle or every table found), build_symbol_dictionary, compare_legend_vs_drawing, export_symbol_library, import_symbol_library, train_symbol_signature (upserts a geometric signature into a local JSON library), load_office_standard (reads a combined dictionary/categoryMap/signatures JSON) — all but read_legend_table are pure post-processing/local JSON, no plugin call

Plan-reading: learns a drawing's own symbol→meaning dictionary from its legend table instead of assuming a fixed office standard; also hosts the local signature-library persistence used by civil3d_shape_detection

civil3d_shape_detection

detect_parallel_line_pairs (Line pairs at constant perpendicular distance, optionally by layer), group_entities_by_proximity (clusters loose entities within a radius via transitive adjacency), get_entity_extended_data (XDATA grouped by registered application), classify_geometry_by_signature (pure post-processing — no plugin call — scores an entity-type group against a signature catalog by Jaccard similarity)

Plan-reading: hand-drawn symbols with no block — probabilistic, not exact, leans on layer name and geometric signature

civil3d_plan_vision

rasterize_pdf_page, extract_legend_templates (OCRs an already-cropped legend image once and auto-builds a named symbol-template library — no active drawing, no plugin call), train_symbol_template, detect_symbols_cv (multi-scale + multi-rotation template matching with non-max suppression), ocr_extract_labels, calibrate_scale_from_dimension (pure TS math, no Python)

Plan-reading: PDFs/scanned images with no live Civil3D drawing at all — the only tool that never talks to the plugin. Classical OpenCV computer vision (confidence-level, not exact); requires Python 3.10+ and Tesseract OCR installed separately, see plan-vision/README.md

civil3d_quantity

count_by_category (groups block counts by a symbol→category mapping), generate_quantity_report (exports a BOQ table to .xlsx)

Plan-reading: turns block counts into budget-ready numbers. Pure post-processing — does not call the plugin and does not require an active drawing

Variable

Default

Description

CIVIL3D_HOST

localhost

Civil 3D plugin host

CIVIL3D_PORT

8080

Civil 3D plugin port

CIVIL3D_CONNECT_TIMEOUT

5000

Connection timeout (ms)

CIVIL3D_COMMAND_TIMEOUT

120000

Command execution timeout (ms)

LOG_LEVEL

info

Log level (debug, info, warn, error)

PLAN_VISION_PYTHON

python

Path to the Python interpreter used for civil3d_plan_vision

PLAN_VISION_TIMEOUT

120000

civil3d_plan_vision subprocess timeout (ms)

Command

Description

C3DMCPSTART

Start the TCP listener

C3DMCPSTOP

Stop the TCP listener

C3DMCPSTATUS

Check listener status

EPANETIMPORT

Bulk-create a pressure network (network + pipes + fittings + appurtenances) from a local JSON file, bypassing MCP entirely — for networks too large for per-item approved MCP calls (300+ pipes). Prompts for a file path; reuses the exact same creation code as civil3d_pressure_pipe's create_network/add_pipe/add_fitting/add_appurtenance, in one Transaction. Reports per-item success/failure without aborting the batch; writes a <file>_errors.txt alongside the input file if anything failed. JSON shape: {networkName, partsList, pipes: [{start:{x,y,z}, end:{x,y,z}, partName}], fittings: [{position:{x,y,z}, partName}], appurtenances: [{position:{x,y,z}, partName}]}.