Connect Claude, Cursor, Cline, and other MCP clients directly to a live Autodesk Civil 3D drawing.
Node.js MCP server + native Civil 3D plugin + workflow automation for grading, hydrology, plan production, QC, and data shortcuts.
Civil3D-MCP bridges AI assistants (Claude, Cline, Cursor, etc.) to a live, open Civil 3D drawing using the Model Context Protocol. Give Claude your design brief — it reads your drawing, runs calculations, and makes changes in real time.
AI Client ↔ civil3d-mcp (Node.js / stdio) ↔ HTTP :8765 ↔ Civil3D-MCP-Plugin.dll (inside Civil 3D)
This is the MCP server (TypeScript). You also need the Civil 3D .NET plugin — see Installation.
- Native workflow handlers now cover major QC, grading, hydrology, plan-production, and data-shortcut flows instead of relying only on client-side orchestration.
- Claude Code can now be registered with a single project-scoped command that installs dependencies, builds the Node server, and writes the repo
.mcp.jsonentry. - Repository-generated tool inventories live in
output_repo_tools, making it easier to audit what is already implemented versus what still belongs on the roadmap.
If you want the fastest path from clone to a working Claude + Civil 3D setup on Windows:
-
Clone and build the Node side:
git clone https://github.com/Sacred-G/Civil3D-mcp.git cd Civil3D-mcp npm install npm run build -
Build and
NETLOADthe Civil 3D plugin:dotnet build .\Civil3D-MCP-Plugin\Civil3DMcpPlugin.csproj -c Release
-
Register Claude Code for this repo:
npm run claude:add
-
Open Civil 3D, load the plugin, and start asking for real work:
- "Audit this drawing before design starts."
- "Create a grading surface from this feature line."
- "Delineate the watershed and estimate runoff."
- "Publish the plan/profile sheets to PDF."
- 180+ MCP tools covering the complete Civil 3D design workflow
- Native workflow execution for corridor QC, surface comparison, project startup, grading conversion, plan publish, data shortcuts, and hydrology pipelines
- Full road design pipeline — alignments, profiles, corridors, cross-sections, superelevation
- Surface analysis — elevation bands, slope distribution, aspect, watershed, cut/fill volumes
- Pipe & pressure network design, validation, and hydraulic analysis
- Plan production — sheet sets, Plan/Profile sheets, PDF export
- QC checks — alignment, profile, corridor, surface, pipe network, drawing standards
- Quantity takeoff — earthwork, corridor materials, pipe lengths, parcel areas, CSV export
- Cost estimation — pay items, material costs, construction estimates
- Hydrology — flow path tracing, watershed delineation, Rational Method runoff, time of concentration
- Grading — feature lines, grading groups, grading criteria, surface generation
- COGO/Survey — inverse, traverse, curve solve, survey figures, LandXML import
- Storm & Sanitary Analysis (SSA) integration and detention basin sizing
- Intersection design and corridor target mapping
- Sight distance calculations and AASHTO stopping sight distance checks
- Assembly/subassembly creation and editing
flowchart LR
Client["AI Client\n(Claude / Cline / Cursor)"] -->|"MCP stdio"| Server["civil3d-mcp\nNode.js MCP Server"]
Server -->|"POST :8765/execute"| Plugin
subgraph Civil3D ["Autodesk Civil 3D"]
Plugin["Civil3D-MCP-Plugin.dll\nHTTP Listener"]
Queue["ConcurrentQueue\n(thread-safe)"]
Idle["Application.Idle\n(main thread)"]
Router["CommandRouter"]
API["Civil 3D .NET API"]
Plugin --> Queue --> Idle --> Router --> API
end
Why
Application.Idle? Civil 3D (like Blender) requires all database operations on the main thread. The plugin queues incoming HTTP requests and drains the queue on the main thread's idle event — giving full, safe access to the Civil 3D .NET API.
| Component | Version |
|---|---|
| Node.js | 18+ |
| Civil 3D | 2023, 2024, 2025, or 2026 |
| .NET SDK | 8.0 |
| Civil 3D API refs | Local DLLs in C_References/ |
| Visual Studio | 2022 recommended |
git clone https://github.com/Sacred-G/Civil3D-mcp.git
cd Civil3D-mcp
npm install
npm run buildFrom the repo root on Windows, this project-scoped command adds the MCP server to Claude Code and creates the repo .mcp.json entry automatically:
claude mcp add --scope project --transport stdio civil3d-mcp -- powershell -NoProfile -ExecutionPolicy Bypass -File "$PWD\scripts\claude-bootstrap-and-run.ps1"The registered launcher will automatically install npm dependencies and build the Node server the first time Claude starts it.
If you want a wrapper that does the install, build, and claude mcp add step for you immediately, run:
npm run claude:addUseful variants:
npm run claude:add:user
npm run claude:print-addPrerequisites: Civil 3D 2023+, .NET 8 SDK, and local Civil 3D API assemblies copied into C_References/
dotnet build .\Civil3D-MCP-Plugin\Civil3DMcpPlugin.csproj -c Release
# Output: Civil3D-MCP-Plugin\bin\Release\net8.0-windows\Civil3DMcpPlugin.dllThe plugin project resolves Autodesk references from C_References. At minimum, make sure these local DLLs are present:
accoremgd.dll
AcDbMgd.dll
acmgd.dll
AecBaseMgd.dll
AeccDbMgd.dll
Load into Civil 3D:
| Method | Steps |
|---|---|
| Manual (NETLOAD) | Open Civil 3D → type NETLOAD → browse to Civil3D-MCP-Plugin.dll |
| Autoload (recommended) | Add registry key — see DEPLOYMENT.md |
Once loaded, three commands are available in the Civil 3D command line:
| Command | Description |
|---|---|
MCPSTART |
Start the HTTP server (auto-starts on load) |
MCPSTOP |
Stop the HTTP server |
MCPSTATUS |
Show server status and port |
Recommended for Claude Code
npm run claude:addThat command registers the bootstrap launcher in Claude Code and keeps the repo self-contained. Use npm run claude:print-add if you want to inspect the exact claude mcp add command without modifying config.
Claude Desktop — claude_desktop_config.json:
{
"mcpServers": {
"civil3d-mcp": {
"command": "node",
"args": ["C:/path/to/Civil3D-mcp/build/index.js"]
}
}
}Claude Code — add via CLI:
claude mcp add --scope project --transport stdio civil3d-mcp -- powershell -NoProfile -ExecutionPolicy Bypass -File "$PWD\scripts\claude-bootstrap-and-run.ps1"Restart your client. When you see the hammer icon, the MCP connection is live.
For Docker, npm publishing, environment variables, and alternate deployment paths see docs/DEPLOYMENT.md.
"What alignments are in this drawing and how long is each one?" →
civil3d_alignment→ returns names, station ranges, lengths
"Run a full QC check on the corridor and give me a report." →
civil3d_workflow_corridor_qc_report→ checks targets, regions, rebuild errors, exports report
"Trace the flow path from coordinate (5000, 3200) and estimate the peak runoff using the Rational Method." →
civil3d_hydrology_watershed_runoff_workflow→ delineates watershed, calculates Q=CiA
"Create a Plan/Profile sheet set for alignment 'Mainline' and export to PDF." →
civil3d_plan_profile_sheet_create→civil3d_workflow_plan_production_publish
"Size the storm drain network for a 10-year storm and check all pipe velocities." →
civil3d_pipe_network_size→civil3d_pipe_network_hydraulics
"Calculate cut/fill volumes between the existing ground and proposed surface." →
civil3d_surface_volume_calculate→civil3d_surface_volume_report
Drawing Info & Context (7 tools)
| Tool | Description |
|---|---|
get_drawing_info |
Retrieves basic information about the active Civil 3D drawing |
list_civil_object_types |
Lists major Civil 3D object types present in the current drawing |
get_selected_civil_objects_info |
Gets properties of currently selected Civil 3D objects |
civil3d_health |
Reports Civil 3D connection and plugin status |
civil3d_drawing |
Manages drawing state, document info, save/undo operations |
civil3d_job |
Checks status of long-running async operations or requests cancellation |
list_tool_capabilities |
Lists domain and capability metadata for the full MCP tool catalog |
Drawing Primitives (6 tools)
| Tool | Description |
|---|---|
create_cogo_point |
Creates a single COGO point |
create_line_segment |
Creates a simple line segment |
acad_create_polyline |
Creates an AutoCAD 2D polyline in model space |
acad_create_3dpolyline |
Creates an AutoCAD 3D polyline in model space |
acad_create_text |
Creates AutoCAD DBText in model space |
acad_create_mtext |
Creates AutoCAD MText in model space |
Alignment (10 tools)
| Tool | Description |
|---|---|
civil3d_alignment |
Reads alignments, converts stationing, create/delete |
civil3d_alignment_report |
Builds structured alignment geometry report |
civil3d_alignment_get_station_offset |
Returns station/offset of an XY point relative to an alignment |
civil3d_alignment_add_tangent |
Appends a fixed tangent entity to an alignment |
civil3d_alignment_add_curve |
Appends a fixed horizontal curve to an alignment |
civil3d_alignment_add_spiral |
Appends a spiral (transition curve) to an alignment |
civil3d_alignment_delete_entity |
Deletes a tangent/curve/spiral entity by index |
civil3d_alignment_offset_create |
Creates a new offset alignment at a constant distance |
civil3d_alignment_set_station_equation |
Adds a station equation to an alignment |
civil3d_alignment_widen_transition |
Creates a variable-offset widening/narrowing transition region |
Profile (10 tools)
| Tool | Description |
|---|---|
civil3d_profile |
Reads profiles, create/delete |
civil3d_profile_report |
Builds structured profile report with station/elevation sampling |
civil3d_profile_get_elevation |
Samples elevation and grade at a given station |
civil3d_profile_add_pvi |
Adds a PVI to a layout profile |
civil3d_profile_add_curve |
Adds a parabolic vertical curve at an existing PVI |
civil3d_profile_delete_pvi |
Deletes the PVI nearest to a specified station |
civil3d_profile_set_grade |
Sets the grade of a tangent entity |
civil3d_profile_check_k_values |
Validates K-values against AASHTO minimums for design speed |
civil3d_profile_view_create |
Creates a profile view at a specified insertion point |
civil3d_profile_view_band_set |
Applies a band set style to an existing profile view |
Superelevation (4 tools)
| Tool | Description |
|---|---|
civil3d_superelevation_get |
Retrieve superelevation design data for an alignment |
civil3d_superelevation_set |
Apply superelevation using AASHTO attainment method |
civil3d_superelevation_design_check |
Validate max superelevation rates and attainment lengths |
civil3d_superelevation_report |
Generate formatted superelevation report |
Surface (15 tools)
| Tool | Description |
|---|---|
civil3d_surface |
Reads surface data, create/delete |
civil3d_surface_edit |
Modifies surface data: points, breaklines, boundaries, contours |
civil3d_surface_statistics_get |
Comprehensive statistics: elevation range, area, point/triangle count |
civil3d_surface_contour_interval_set |
Set minor and major contour display intervals |
civil3d_surface_sample_elevations |
Sample elevations at grid points, discrete points, or transect |
civil3d_surface_analyze_elevation |
Elevation band distribution (area and percentage per band) |
civil3d_surface_analyze_slope |
Slope distribution (area and percentage per slope range) |
civil3d_surface_analyze_directions |
Aspect/facing direction breakdown by cardinal sectors |
civil3d_surface_volume_calculate |
Calculate cut/fill volumes between two surfaces |
civil3d_surface_volume_by_region |
Cut/fill volumes within a polygon region |
civil3d_surface_volume_report |
Formatted human-readable cut/fill volume report |
civil3d_surface_comparison_workflow |
Structured two-surface comparison with cut/fill volumes |
civil3d_surface_create_from_dem |
Create TIN surface from DEM file (.dem, .tif, .asc, .flt) |
civil3d_surface_watershed_add |
Add watershed analysis: drainage basins and flow paths |
civil3d_surface_drainage_workflow |
Surface drainage workflow: flow path, elevation sampling, runoff estimate |
Corridor (6 tools)
| Tool | Description |
|---|---|
civil3d_corridor |
Reads corridor data, rebuild, volume operations |
civil3d_corridor_summary |
Builds corridor summary with surfaces and volume analysis |
civil3d_corridor_target_mapping_get |
Retrieve subassembly target mappings for a corridor |
civil3d_corridor_target_mapping_set |
Set/update subassembly target mappings (surfaces, alignments, profiles) |
civil3d_corridor_region_add |
Add a new region to a corridor baseline |
civil3d_corridor_region_delete |
Delete a region from a corridor baseline |
Sections & Section Views (6 tools)
| Tool | Description |
|---|---|
civil3d_section |
Reads section data, sample line creation |
civil3d_section_view_create |
Create section views for a sample line group |
civil3d_section_view_list |
List section views in the drawing |
civil3d_section_view_update_style |
Update display/band set style on existing section views |
civil3d_section_view_group_create |
Create a multi-row grid layout of section views |
civil3d_section_view_export |
Export section data to CSV/text (offsets, elevations, materials) |
Intersection Design (3 tools)
| Tool | Description |
|---|---|
civil3d_intersection_list |
List all intersections in the drawing |
civil3d_intersection_create |
Create an intersection between two road alignments |
civil3d_intersection_get |
Get detailed properties of an intersection |
Grading & Feature Lines (14 tools)
| Tool | Description |
|---|---|
civil3d_grading |
Canonical grading domain tool for groups, gradings, criteria, and feature-line actions |
civil3d_feature_line |
Reads feature lines and exports them as 3D polylines |
civil3d_feature_line_create |
Create a new feature line from 3D points |
civil3d_grading_group_list |
List all grading groups in the drawing |
civil3d_grading_group_create |
Create a new grading group |
civil3d_grading_group_get |
Get detailed info about a grading group |
civil3d_grading_group_delete |
Delete a grading group and all its gradings |
civil3d_grading_group_volume |
Get cut/fill volume report for a grading group |
civil3d_grading_group_surface_create |
Create a surface from a grading group |
civil3d_grading_criteria_list |
List all available grading criteria sets |
civil3d_grading_list |
List all grading objects within a grading group |
civil3d_grading_create |
Create a new grading from a feature line |
civil3d_grading_get |
Get detailed properties of a grading object |
civil3d_grading_delete |
Delete a grading object by handle |
Points & Point Groups (6 tools)
| Tool | Description |
|---|---|
civil3d_point |
Reads, creates, imports, deletes COGO points and point groups |
civil3d_point_export |
Export COGO points to text/CSV (PNEZD, PENZ, XYZD, XYZ, CSV) |
civil3d_point_transform |
Transform points by translation, rotation, and/or scale |
civil3d_point_group_create |
Create a new point group with filter criteria |
civil3d_point_group_update |
Update filter criteria and description of a point group |
civil3d_point_group_delete |
Delete a point group (points are NOT deleted) |
COGO & Survey (9 tools)
| Tool | Description |
|---|---|
civil3d_cogo_inverse |
Calculate bearing and distance between two coordinate pairs |
civil3d_cogo_direction_distance |
Project a point from start coordinate given bearing and distance |
civil3d_cogo_curve_solve |
Solve a horizontal curve given any two curve elements |
civil3d_cogo_traverse |
Solve a traverse from start point through bearing/distance courses |
civil3d_coordinate_system |
Coordinate system info and coordinate transformations |
civil3d_survey_database_list |
List all survey databases |
civil3d_survey_database_create |
Create a new survey database |
civil3d_survey_figure_list |
List all survey figures |
civil3d_survey_figure_get |
Get 3D vertex data for a specific survey figure |
Pipe Networks — Gravity (3 tools)
| Tool | Description |
|---|---|
civil3d_pipe_catalog |
Lists available pipe parts lists and part names |
civil3d_pipe_network |
Reads pipe network data: networks, pipes, structures |
civil3d_pipe_network_edit |
Creates and modifies pipe networks, pipes, and structures |
Pressure Networks (15 tools)
| Tool | Description |
|---|---|
civil3d_pressure_network_list |
List all pressure networks |
civil3d_pressure_network_create |
Create a new pressure network |
civil3d_pressure_network_get_info |
Get detailed info about a pressure network |
civil3d_pressure_network_delete |
Delete a pressure network and all components |
civil3d_pressure_network_assign_parts_list |
Assign a parts list to a network |
civil3d_pressure_network_set_cover |
Set minimum cover depth for pipes in a network |
civil3d_pressure_network_validate |
Validate a network for cover violations and disconnections |
civil3d_pressure_network_export |
Export pressure network data as structured JSON |
civil3d_pressure_network_connect |
Connect two pressure networks by merging |
civil3d_pressure_pipe_add |
Add a pressure pipe segment |
civil3d_pressure_pipe_get_properties |
Get properties of a pressure pipe |
civil3d_pressure_pipe_resize |
Change pressure pipe size to a different catalog entry |
civil3d_pressure_fitting_add |
Add a pressure fitting (elbow, tee, reducer, cap) |
civil3d_pressure_fitting_get_properties |
Get properties of a pressure fitting |
civil3d_pressure_appurtenance_add |
Add a pressure appurtenance (valve, hydrant, meter) |
Plan Production / Sheets (12 tools)
| Tool | Description |
|---|---|
civil3d_sheet_set_list |
List all Plan Production sheet sets |
civil3d_sheet_set_create |
Create a new Plan Production sheet set |
civil3d_sheet_set_get_info |
Get detailed info about a sheet set |
civil3d_sheet_set_export |
Export all sheets to a multi-page PDF |
civil3d_sheet_set_title_block |
Set or update title block template on a sheet |
civil3d_sheet_add |
Add a new sheet to an existing sheet set |
civil3d_sheet_get_properties |
Get full properties of a specific sheet |
civil3d_sheet_publish_pdf |
Publish sheet layouts to a PDF file |
civil3d_sheet_view_create |
Create a viewport/view on a sheet layout |
civil3d_sheet_view_set_scale |
Update the scale of a viewport |
civil3d_plan_profile_sheet_create |
Create a Plan/Profile sheet for an alignment and profile |
civil3d_plan_profile_sheet_update_alignment |
Update alignment and/or profile on an existing sheet |
QC Checks (8 tools)
| Tool | Description |
|---|---|
civil3d_qc_check_alignment |
QC alignment: tangent lengths, curve radii, spirals, design-speed compliance |
civil3d_qc_check_profile |
QC profile: max grade, K-values, sight distance requirements |
civil3d_qc_check_corridor |
QC corridor: invalid regions, missing targets, assembly gaps, rebuild errors |
civil3d_qc_check_pipe_network |
QC pipe network: cover depth, slope, velocity, connectivity |
civil3d_qc_check_surface |
QC TIN surface: elevation spikes, flat triangles, crossing breaklines |
civil3d_qc_check_labels |
Check labels for missing labels and style standard violations |
civil3d_qc_check_drawing_standards |
Audit drawing: layer naming, lineweights, colors |
civil3d_qc_report_generate |
Run full QC pass and write consolidated report to disk |
Workflow Automation (14 tools)
| Tool | Description |
|---|---|
civil3d_workflow |
Canonical workflow tool for multi-step QC, grading, pipe-design, standards, and publishing |
civil3d_workflow_corridor_qc_report |
Run corridor QC and optionally generate a consolidated QC report |
civil3d_workflow_grading_surface_volume |
Calculate grading cut/fill volume between base and comparison surfaces |
civil3d_workflow_surface_comparison_report |
Run a structured surface comparison and follow it with a volume report |
civil3d_workflow_data_shortcut_publish_sync |
Publish a data shortcut and immediately synchronize it |
civil3d_workflow_data_shortcut_reference_sync |
Reference a project data shortcut and immediately synchronize it |
civil3d_workflow_project_startup |
Check Civil 3D health, inspect drawing readiness, and optionally create/save a startup drawing |
civil3d_workflow_project_reference_setup |
Reference one or more project data shortcuts, sync them, and optionally save |
civil3d_workflow_drawing_readiness_audit |
Check health, drawing state, selection context, and standards readiness in one audit |
civil3d_workflow_feature_line_to_grading |
Convert a feature line into grading and optionally create a grading surface |
civil3d_workflow_pipe_network_design |
Size a gravity pipe network and optionally run hydraulic analysis |
civil3d_workflow_plan_production_publish |
Publish a sheet set or explicit layout list to PDF output |
civil3d_workflow_qc_fix_and_verify |
Audit drawing standards, apply fixes, and verify the result |
civil3d_workflow_survey_import_adjust_figures |
Import survey LandXML, optionally adjust a network, and review resulting figures |
Quantity Takeoff (10 tools)
| Tool | Description |
|---|---|
civil3d_qty_surface_volume |
Cut/fill volumes between surfaces (with corridor or region scope) |
civil3d_qty_earthwork_summary |
Running earthwork cut/fill summary table |
civil3d_qty_corridor_volumes |
Subassembly material volumes by region for a corridor |
civil3d_qty_material_list_get |
Retrieve material list defined on a corridor |
civil3d_qty_pipe_network_lengths |
Total pipe lengths for a gravity pipe network |
civil3d_qty_pressure_network_lengths |
Total pipe lengths for a pressure network |
civil3d_qty_alignment_lengths |
Total length for one or more alignments |
civil3d_qty_parcel_areas |
Area, perimeter, and address data for parcels |
civil3d_qty_point_count_by_group |
Count COGO points per point group |
civil3d_qty_export_to_csv |
Export consolidated quantity takeoff report to CSV |
Hydrology (7 tools)
| Tool | Description |
|---|---|
civil3d_hydrology |
Canonical hydrology tool for surface drainage, catchments, Tc, SSA, and multi-step workflows |
civil3d_catchment |
Manages catchments and catchment groups, including properties, flow paths, and boundaries |
civil3d_time_of_concentration |
Calculates Tc using supported methods and generates hydrographs |
civil3d_stm |
Exports/imports STM files and opens Storm and Sanitary Analysis |
civil3d_hydrology_watershed_runoff_workflow |
Runs low-point or outlet-based watershed delineation through runoff estimation |
civil3d_hydrology_runoff_detention_workflow |
Runs runoff estimation through detention sizing and optional stage-storage output |
civil3d_hydrology_runoff_pipe_workflow |
Runs runoff estimation through gravity pipe HGL and hydraulic analysis |
Pipe Hydraulics (3 tools)
| Tool | Description |
|---|---|
civil3d_pipe_network_hgl |
Calculate Hydraulic Grade Line (HGL) for gravity pipe networks |
civil3d_pipe_network_hydraulics |
Perform full hydraulic capacity analysis on pipe networks |
civil3d_pipe_structure_properties |
Retrieve detailed properties of individual pipe structures |
Pipe Design Automation (2 tools)
| Tool | Description |
|---|---|
civil3d_pipe_network_size |
Size gravity-network pipes from Manning full-flow capacity with catalog part selection |
civil3d_pipe_profile_view_automation |
Automate gravity-pipe profile-view setup with EG profile creation |
Assembly Creation (3 tools)
| Tool | Description |
|---|---|
civil3d_assembly_create |
Create a new Civil 3D assembly at a specified model-space location |
civil3d_subassembly_create |
Add a subassembly from the Civil 3D catalog to an existing assembly |
civil3d_assembly_edit |
Inspect or modify an existing Civil 3D assembly (list, update, delete subassemblies) |
Sight Distance (2 tools)
| Tool | Description |
|---|---|
civil3d_sight_distance_calculate |
Calculate AASHTO stopping, passing, or decision sight distance for design speed |
civil3d_stopping_distance_check |
Check stopping sight distance compliance along an alignment at station intervals |
Detention & Stormwater (2 tools)
| Tool | Description |
|---|---|
civil3d_detention_basin_size_calculate |
Size a detention basin to reduce peak stormwater runoff |
civil3d_detention_stage_storage |
Generate stage-storage-discharge table for a detention basin surface |
Slope Analysis (2 tools)
| Tool | Description |
|---|---|
civil3d_slope_geometry_calculate |
Calculate daylight line coordinates and slope geometry for cut/fill sections |
civil3d_slope_stability_check |
Evaluate cut and fill slope stability along an alignment |
Cost Estimation (2 tools)
| Tool | Description |
|---|---|
civil3d_pay_items_export |
Extract Civil 3D quantities and export as structured pay item schedule to CSV/Excel |
civil3d_material_cost_estimate |
Generate construction cost estimate by combining quantities with unit prices |
Survey Processing (4 tools)
| Tool | Description |
|---|---|
civil3d_survey_observation_list |
List survey observations from a survey database |
civil3d_survey_network_adjust |
Adjust survey networks (least squares, compass, transit, crandall) |
civil3d_survey_figure_create |
Create survey figures from point numbers |
civil3d_survey_landxml_import |
Import survey data from LandXML files |
Data Shortcuts (4 tools)
| Tool | Description |
|---|---|
civil3d_data_shortcut_create |
Create data shortcuts for Civil 3D objects |
civil3d_data_shortcut_promote |
Promote data shortcut references to full editable objects |
civil3d_data_shortcut_reference |
Reference existing data shortcuts into the current drawing |
civil3d_data_shortcut_sync |
Synchronize outdated data shortcut references |
Parcel Editing (4 tools)
| Tool | Description |
|---|---|
civil3d_parcel_create |
Create parcels from polylines, feature lines, or vertex lists |
civil3d_parcel_edit |
Edit parcel properties (name, style, label style, description) |
civil3d_parcel_lot_line_adjust |
Adjust lot lines to achieve a target area |
civil3d_parcel_report |
Generate parcel reports with coordinate and unit settings |
Standards & Miscellaneous (7 tools)
| Tool | Description |
|---|---|
civil3d_standards_lookup |
Looks up Civil 3D standards, template governance, layer/style guidance, and labeling conventions |
civil3d_assembly |
Lists and inspects assemblies and subassemblies |
civil3d_label |
Manages labels on Civil 3D objects |
civil3d_style |
Lists and inspects Civil 3D styles |
civil3d_parcel |
Reads parcel and site data |
civil3d_data_shortcut |
Manages data shortcuts: listing, syncing, creating references |
civil3d_orchestrate |
Routes natural-language Civil 3D requests to the best tool |
| Civil 3D Version | Status | Notes |
|---|---|---|
| 2023 | Supported | Build the plugin against local Autodesk API DLLs in C_References/ |
| 2024 | Supported | Same Node server; compatibility is driven by the plugin reference set |
| 2025 | Supported | Recommended when matching the sample docs and existing workflows |
| 2026 | Supported with local refs | Copy the 2026 Civil 3D assemblies into C_References/ before building |
For startup-suite and autoload registry details, use the version-specific guidance in docs/DEPLOYMENT.md.
"Cannot connect to Civil 3D plugin"
- Civil 3D must be open with a drawing loaded
- Type
MCPSTATUSin Civil 3D — confirm the server shows as running on port 8765 - Check Windows Firewall is not blocking
localhost:8765
"No active document"
- Open a
.dwgfile in Civil 3D before making any tool calls
"Alignment/Surface not found"
- Names are case-insensitive but must otherwise match exactly
- Use the corresponding list tool first (e.g.
civil3d_alignment→listaction)
Plugin won't load
- Verify the DLL targets the correct Civil 3D version
- Ensure Civil 3D and Visual Studio are running as the same Windows user (no elevation mismatch)
- Check the DLL path passed to
NETLOADhas no spaces or special characters
| Doc | Description |
|---|---|
| DEPLOYMENT.md | Full deployment: Docker, npm, env vars, registry autoload |
| HYDROLOGY_GUIDE.md | Hydrology workflow deep-dive |
| tools.md | Extended tool parameter reference |
| ULTIMATE-CIVIL3D-MCP-PLAN-V3.md | Big-picture implementation plan and feature map |
| domain-tool-migration-roadmap.md | Native domain migration roadmap for tool/workflow parity |
| civil3d_dynamic_mcp_blueprint.md | Architecture blueprint for the dynamic MCP direction |
| CHANGELOG.md | Release history |
Pull requests are welcome. For major changes, open an issue first to discuss what you'd like to change.
- Fork the repository
- Create your feature branch (
git checkout -b feature/my-tool) - Commit your changes (
git commit -m 'Add civil3d_my_tool') - Push to the branch (
git push origin feature/my-tool) - Open a Pull Request
ISC — Steven Bouldin