ETABS MCP Server
The ETABS MCP Server bridges AI assistants to CSI ETABS structural engineering software, enabling full structural model creation, analysis, and design through a comprehensive set of tools:
Model Management: Create new models (blank or from templates), open, save, and close .edb files. Check connection status and set unit systems.
Geometry: Add point/joint, frame (beams, columns, braces), and area objects (slabs, walls); retrieve all objects; delete objects by name and type.
Stories & Grids: Define and retrieve building story layouts and Cartesian grid systems.
Properties: Define materials (steel, concrete, rebar, etc.), frame sections (I, Tee, Channel, Box, Pipe, Angle, etc.), area/shell sections, and rebar sizes.
Assignments: Assign frame/area sections, end releases, diaphragm constraints, and pier/spandrel labels to structural elements.
Stiffness Modifiers: Apply cracked-section modifiers using presets (ACI 318-19, IS 456:2000) or custom values to frames and areas, targeting individual objects, groups, or all elements at once.
Loads: Define load patterns, static/modal/response spectrum/nonlinear load cases, and load combinations. Assign point loads/moments, distributed frame loads, and uniform surface loads.
Analysis: Run the structural solver, check analysis case status, set active degrees of freedom, and delete results to unlock the model.
Results: Extract joint displacements, joint reactions, frame internal forces (P, V, T, M), and global base reactions.
Seismic (IS 1893:2016 / ASCE 7 / EC8): Define modal (Eigenvector/Ritz) and Response Spectrum Analysis cases; retrieve modal periods and mass participation (with IS 1893 90% mass rule check); compute IS 1893 scale factors; run full X+Y drift compliance reports with PASS/FAIL per storey per IS 1893 Cl. 7.11.1; get storey forces and overturning moments.
Design: Run steel and concrete frame design checks, set design codes (e.g., AISC 360-16, ACI 318-19), and retrieve design result summaries (e.g., PMM ratios).
Database Tables: List, read, write, and apply edits to any ETABS internal database table.
Selection & Grouping: Select objects in the ETABS UI, get currently selected objects, define named groups, and add/remove objects from groups.
Generic API Access: Call any of 1,300+ ETABS COM API methods directly via etabs_call_api for full extensibility beyond the built-in tools.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ETABS MCP Server Create a new steel frame model with 3 stories"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ETABS MCP Server
A Model Context Protocol (MCP) server that connects Large Language Models (LLMs) to CSI ETABS, a premier structural engineering software.
This server enables AI assistants (like Claude, Cursor, etc.) to:
Create, open, and save ETABS models
Define materials, sections, and structural geometry
Apply loads and assign properties
Run structural analysis and design checks
Extract analysis results and design summaries
Query and modify ETABS database tables
It uses the comtypes library in Python to interact directly with the ETABSv1 COM API, providing a seamless bridge between modern AI and legacy Windows COM applications.
Prerequisites
Windows OS (required for COM integration —
comtypesdoes not work on macOS/Linux)CSI ETABS installed and licensed (v19, v20, v21, or v22)
Python 3.10+
uv (recommended) or pip
Related MCP server: Qiao-MCP
Repository Layout
ETABS-mcp/
├── pyproject.toml # build config & entry point
├── README.md
├── etabs_mcp_config.json # runtime config (units, auto-connect, …)
├── src/
│ └── etabs_mcp/
│ ├── __init__.py
│ ├── server.py # FastMCP entry point (run via `etabs-mcp`)
│ ├── etabs_connection.py # COM singleton manager
│ ├── helpers.py # shared utils, units, response formatting
│ └── tools/
│ ├── __init__.py
│ ├── analysis.py
│ ├── assignments.py
│ ├── database_tables.py
│ ├── design.py
│ ├── generic_api.py
│ ├── loads.py
│ ├── model_control.py
│ ├── model_geometry.py
│ ├── properties.py
│ ├── results.py
│ ├── seismic.py # IS 1893 modal + RSA + drift
│ ├── selection.py
│ ├── stiffness_modifiers.py # ACI 318 + IS 456 cracked-section presets
│ └── stories_grids.pyInstallation
Clone the repo and install the package in editable mode:
git clone https://github.com/mdvaleed7/ETABS-mcp.git cd ETABS-mcp pip install -e .Or with
uv:uv pip install -e .Verify the entry point is registered:
etabs-mcp --help(The server itself only starts speaking MCP over stdio, so don't expect pretty output — just confirm the command exists.)
Configuration for MCP Clients
Claude Desktop
Add this to your claude_desktop_config.json (usually at
%APPDATA%\Claude\claude_desktop_config.json on Windows):
{
"mcpServers": {
"etabs": {
"command": "etabs-mcp",
"args": []
}
}
}If etabs-mcp is not on your PATH, use the full path to the script, e.g.:
{
"mcpServers": {
"etabs": {
"command": "python",
"args": ["-m", "etabs_mcp.server"]
}
}
}Make sure you run this Python from the same virtual environment where you installed the package.
Cursor
In Cursor settings → Features → MCP, add a new server:
Type:
commandName:
ETABSCommand:
etabs-mcp(or the full path to your venv's script)
Claude Code / other stdio MCP clients
claude mcp add etabs -- etabs-mcpTool Categories
The server exposes 69 tools grouped by domain:
Category | Tools | Key functions |
Model Control | 6 |
|
Geometry | 7 |
|
Stories & Grids | 4 | story/grid definition and retrieval |
Properties | 7 | materials, frame sections (I, tube, concrete), area sections, rebar |
Assignments | 6 | frame section, releases, area section, diaphragm, pier/spandrel labels |
Stiffness Modifiers | 3 | ACI 318-19 + IS 456:2000 cracked-section presets for beams/columns/walls/slabs |
Loads | 7 | patterns, cases (Linear/Modal/RSA/Nonlinear), combinations, point/frame/area loads |
Analysis | 4 | run solver, case status, active DOF, delete results |
Results | 5 | displacements, frame forces, reactions, base reactions |
🆕 Seismic | 7 | IS 1893:2016 modal + RSA + drift check (see below) |
Design | 4 | steel & concrete design, code setting, summary results |
Database Tables | 4 | full interactive access to ETABS tables |
Selection | 4 | select objects, groups, named selections |
Generic API | 1 |
|
🆕 Seismic Module — IS 1893:2016 / ASCE 7 / EC8
The new seismic.py module adds 7 tools for complete response spectrum workflow:
Tool | Purpose |
| Eigenvector/Ritz case; max modes, shift value |
| RSA case — CQC/SRSS, eccentricity, scale factors |
| Periods, frequencies, mass participation; auto-checks IS 1893 Cl. 7.7.5a 90% mass rule |
| Inter-storey drift ratios with IS 1893 Cl. 7.11.1 h/250 check |
| Storey shear and overturning moments per floor |
| Computes ETABS scale factor from Zone/I/R/soil; step-by-step workflow guide |
| Full X+Y direction drift compliance report with PASS/FAIL per storey |
IS 1893:2016 RSA workflow (6 steps):
1. etabs_set_is1893_seismic_params(zone="III", I=1.2, R=5.0) → get scale factor
2. Define IS 1893 spectrum function in ETABS (manually or via etabs_call_api)
3. etabs_define_modal_case("MODAL", max_modes=36)
4. etabs_run_analysis()
5. etabs_get_modal_results("MODAL") → verify ≥ 90% mass (Cl. 7.7.5a)
6. etabs_define_response_spectrum("EQX", scale_x=SF) + "EQY"
7. etabs_check_is1893_drift("EQX", "EQY") → PASS/FAIL reportStiffness Modifiers (ACI 318 presets)
The server ships with baked-in ACI 318-19 Table 6.6.3.1.1(a) cracked-section factors, so an LLM can apply them to a whole model in one tool call.
One-shot for all four categories — call etabs_apply_aci_stiffness_modifiers
with either explicit names or named ETABS groups per category:
// Apply ACI defaults to all members via groups
{
"beam_group": "BEAMS",
"column_group": "COLUMNS",
"wall_group": "WALLS",
"slab_group": "SLABS"
}Defaults applied:
Category | Preset | Modifiers |
Beams |
| I = 0.35 Ig, torsion = 0.20 |
Columns |
| I = 0.70 Ig, A = 0.70 Ag |
Walls |
| I = 0.70 Ig, A = 0.70 Ag (uncracked) |
Slabs |
| I = 0.25 Ig |
Granular tools for finer control:
etabs_assign_frame_stiffness_modifiers— apply to specific frames with any of the presetsaci_beam,aci_beam_conservative,aci_column,aci_column_conservative,aci_spandrel,aisc_beam,is456_beam,is456_column,is456_beam_seismic,is456_shear_wall— or pass individualarea / m2 / m3 / torsion / mass / weightvalues to override.etabs_assign_area_stiffness_modifiers— apply to specific areas with any of the presetsaci_wall,aci_wall_cracked,aci_slab,aci_slab_joist,aci_drop_panel,steel_deck,is456_wall,is456_wall_cracked,is456_slab,is456_flat_slab,is456_ribbed_slab— or override individualf11 / f22 / f12 / m11 / m22 / m12 / v13 / v23values.
Note on modifier ordering. Frame modifiers are passed to ETABS as
[Area, M2, M3, Torsion, M2_weight, M3_weight, Mass, Weight]and area modifiers as[F11, F22, F12, M11, M22, M12, V13, V23]. The Python tool exposes them as named parameters so you never transpose them by accident. If your ETABS version uses a different ordering, useetabs_call_apiwithinterface_path="FrameObj"andmethod_name="SetModifiers"to pass the raw array directly.
Architecture
This uses the FastMCP framework.
Communication with the LLM happens over stdio while communication with
ETABS happens via Windows COM (using comtypes).
The server attempts to automatically attach to a running instance of ETABS
when started. If it cannot, the LLM can trigger etabs_new_model to launch a
fresh instance in the background.
Troubleshooting
Symptom | Fix |
| Run |
| This is expected — the server only runs on Windows. |
ETABS won't auto-attach | Start ETABS manually, then call |
| Set |
License
MIT
Available Tools
69 toolsetabs_add_areaA
Add an area object (slab, wall, deck) defined by corner coordinates.
The coordinates should be ordered clockwise or counter-clockwise. Must have at least 3 points.
Args: x_coords: List of X coordinates for each corner. y_coords: List of Y coordinates for each corner. z_coords: List of Z coordinates for each corner. prop_name: Area section property name. Use "Default" for auto-assigned. name: Optional user-defined name for the area. csys: Coordinate system name (default "Global").
Returns: JSON with the assigned area name.
Inputs: x_coords (required), y_coords (required), z_coords (required), prop_name, +2 more. Returns: result
etabs_add_frameA
Add a frame object (beam, column, brace) between two points by coordinates.
Args: x1: X coordinate of start point. y1: Y coordinate of start point. z1: Z coordinate of start point. x2: X coordinate of end point. y2: Y coordinate of end point. z2: Z coordinate of end point. prop_name: Frame section property name. Use "Default" for auto-assigned. name: Optional user-defined name for the frame. csys: Coordinate system name (default "Global").
Returns: JSON with the assigned frame name.
Inputs: x1 (required), y1 (required), z1 (required), x2 (required), +5 more. Returns: result
etabs_add_pointA
Add a point (joint) object at the specified coordinates.
Args: x: X coordinate in current units. y: Y coordinate in current units. z: Z coordinate in current units. name: Optional user-defined name. ETABS assigns a default if blank. csys: Coordinate system name (default "Global").
Returns: JSON with the assigned point name.
Inputs: x (required), y (required), z (required), name, +1 more. Returns: result
etabs_add_to_groupAIdempotent
Add or remove an object from a group.
Args: name: Name of the object. group_name: Name of the group. object_type: "Point", "Frame", "Area", or "Link". remove: If True, removes the object from the group instead of adding.
Returns: Confirmation.
Inputs: name (required), group_name (required), object_type, remove. Returns: result
etabs_apply_aci_stiffness_modifiersAIdempotent
One-shot convenience: apply ACI 318 stiffness modifiers to beams, columns, walls, and slabs in a single tool call.
For each category, supply either an explicit *_names list OR a
named ETABS *_group. Any category with neither is skipped.
Defaults (ACI 318-19 Table 6.6.3.1.1(a)):
Beams → I = 0.35 Ig, torsion = 0.20
Columns → I = 0.70 Ig, A = 0.70 Ag
Walls → I = 0.70 Ig, A = 0.70 Ag (uncracked)
Slabs → I = 0.25 Ig
Example — apply to all members via groups: beam_group="BEAMS", column_group="COLUMNS", wall_group="WALLS", slab_group="SLABS"
Example — apply to specific objects: beam_names=["B1","B2"], column_names=["C1","C2","C3"], wall_names=["W1"], slab_names=["S1","S2"]
Args: beam_names / column_names / wall_names / slab_names: Explicit lists of object names per category. beam_group / column_group / wall_group / slab_group: Named ETABS groups to apply each preset to. beam_preset / column_preset / wall_preset / slab_preset: Override the default ACI preset for any category. (See etabs_assign_frame_stiffness_modifiers and etabs_assign_area_stiffness_modifiers for the full preset list.)
Returns: JSON summary: per-category count + preset, plus grand totals.
Inputs: beam_names, column_names, wall_names, slab_names, +8 more. Returns: result
etabs_apply_table_editsADestructive
Apply all pending database table edits to the model.
Returns: Confirmation.
Inputs: no named parameters. Returns: result
etabs_assign_area_loadAIdempotent
Assign a uniform surface load to an area object.
Args: name: Area object name. load_pattern: Name of the load pattern. value: Load value (force per area). dir: Load direction. 1=Local1, 2=Local2, 3=Local3, 4=X, 5=Y, 6=Z, 10=Gravity. replace: If True, replace existing loads. item_type: "Object", "Group", or "SelectedObjects".
Returns: Confirmation.
Inputs: name (required), load_pattern (required), value (required), dir, +2 more. Returns: result
etabs_assign_area_sectionAIdempotent
Assign an area/shell section property to an area object.
Args: name: Area object name, or group name if item_type is "Group". section_name: Name of the area section to assign. item_type: "Object", "Group", or "SelectedObjects".
Returns: Confirmation.
Inputs: name (required), section_name (required), item_type. Returns: result
etabs_assign_area_stiffness_modifiersAIdempotent
Apply cracked-section stiffness modifiers to one or more area objects (walls, slabs, decks).
Pick a target with names, group, or leave both blank for ALL areas.
Presets (ACI 318-19 Table 6.6.3.1.1(a)):
"aci_wall" I = 0.70 Ig, A = 0.70 Ag (uncracked)
"aci_wall_cracked" I = 0.35 Ig, A = 0.35 Ag
"aci_slab" I = 0.25 Ig (flat plate / two-way slab)
"aci_slab_joist" I = 0.50 Ig (slab with joists / ribs)
"aci_drop_panel" I = 0.50 Ig
"steel_deck" unmodified
Args: names: List of area object names. None → group, or all areas. group: Named ETABS group. preset: One of the preset names above (case-insensitive). f11, f22, f12: Membrane (in-plane) stiffness modifiers. m11, m22, m12: Bending (out-of-plane) stiffness modifiers. v13, v23: Transverse shear modifiers.
Returns: JSON with the modifier values applied and the number of areas updated.
Inputs: names, group, preset, f11, +7 more. Returns: result
etabs_assign_diaphragmAIdempotent
Assign a diaphragm constraint to an area or point object.
Args: name: Object name or group name. diaphragm_name: Name of the diaphragm to assign. item_type: "Object", "Group", or "SelectedObjects".
Returns: Confirmation.
Inputs: name (required), diaphragm_name (required), item_type. Returns: result
etabs_assign_frame_loadAIdempotent
Assign a uniform or trapezoidal distributed load to a frame object.
For uniform load, set w1 = w2, dist_1 = 0.0, dist_2 = 1.0.
Args: name: Frame object name. load_pattern: Name of the load pattern. w1: Start load value. w2: End load value. dir: Load direction. 1=Local1, 2=Local2, 3=Local3, 4=X, 5=Y, 6=Z, 10=Gravity. dist_1: Distance to start of load. dist_2: Distance to end of load. rel_dist: If True, distances are relative (0 to 1). If False, absolute. replace: If True, replace existing loads. item_type: "Object", "Group", or "SelectedObjects".
Returns: Confirmation.
Inputs: name (required), load_pattern (required), w1 (required), w2 (required), +6 more. Returns: result
etabs_assign_frame_releasesAIdempotent
Set end releases (moment releases / pins) for a frame object.
Each release list has 6 booleans for [P, V2, V3, T, M2, M3]:
True = released (free/pin), False = fixed. Common patterns:
Pin at start: [False, False, False, False, False, True]
Pin at both ends: set both start and end M3 to True.
Args: name: Frame object name. start_release: 6-element list of bools for I-end (start) releases [P, V2, V3, T, M2, M3]. end_release: 6-element list of bools for J-end (end) releases. item_type: "Object", "Group", or "SelectedObjects".
Returns: Confirmation.
Inputs: name (required), start_release, end_release, item_type. Returns: result
etabs_assign_frame_sectionAIdempotent
Assign a frame section property to a frame object.
Args: name: Frame object name, or group name if item_type is "Group". section_name: Name of the frame section to assign. item_type: "Object" (single object), "Group", or "SelectedObjects".
Returns: Confirmation.
Inputs: name (required), section_name (required), item_type. Returns: result
etabs_assign_frame_stiffness_modifiersAIdempotent
Apply cracked-section stiffness modifiers to one or more frame objects (beams, columns, braces).
Pick a target with either names (explicit list), group (named
ETABS group), or leave both blank to apply to ALL frames.
Pick a preset for ACI defaults, OR supply individual modifier
values. If both are given, individual values override the preset.
Presets (ACI 318-19 Table 6.6.3.1.1(a)):
"aci_beam" I = 0.35 Ig, torsion = 0.20
"aci_beam_conservative" I = 0.25 Ig, torsion = 0.10
"aci_column" I = 0.70 Ig, A = 0.70 Ag
"aci_column_conservative" I = 0.50 Ig
"aci_spandrel" I = 0.20 Ig (coupling beams)
"aisc_beam" unmodified (steel)
Args: names: List of frame object names (e.g. ["B1", "B2"]). None/empty → apply to group, or to all frames if group is also blank. group: Apply to all frames in this named ETABS group. preset: One of the preset names above (case-insensitive). area: Axial stiffness modifier (overrides preset). m2: Minor-axis bending modifier (overrides preset). m3: Major-axis bending modifier (overrides preset). torsion:Torsional stiffness modifier (overrides preset). mass: Mass modifier (default 1.0 if neither preset nor arg given). weight: Self-weight modifier (default 1.0).
Returns: JSON with the modifier values applied and the number of frames updated.
Inputs: names, group, preset, area, +5 more. Returns: result
etabs_assign_pier_labelBIdempotent
Assign a pier label to an area or line object (for wall piers).
Args: name: Object name. pier_name: Name of the pier label. item_type: "Object", "Group", or "SelectedObjects".
Returns: Confirmation.
Inputs: name (required), pier_name (required), item_type. Returns: result
etabs_assign_point_loadAIdempotent
Assign point loads/moments to a joint object.
Args: name: Point object name. load_pattern: Name of the load pattern. f1, f2, f3: Forces in 1, 2, 3 (X, Y, Z) directions. m1, m2, m3: Moments about 1, 2, 3 axes. replace: If True, replace existing loads; if False, add to them. item_type: "Object", "Group", or "SelectedObjects".
Returns: Confirmation.
Inputs: name (required), load_pattern (required), f1, f2, +6 more. Returns: result
etabs_assign_spandrel_labelCIdempotent
Assign a spandrel label to an area or line object (for wall spandrels).
Args: name: Object name. spandrel_name: Name of the spandrel label. item_type: "Object", "Group", or "SelectedObjects".
Returns: Confirmation.
Inputs: name (required), spandrel_name (required), item_type. Returns: result
etabs_call_apiA
Call ANY method in the ETABS API that isn't covered by other tools.
This is a powerful escape hatch to access all 1,300+ methods in the API.
Examples:
interface_path="FrameObj", method_name="GetLabelFromName", arguments=["F1", "", ""]
interface_path="Results.Setup", method_name="GetCaseSelectedForOutput", arguments=["DEAD", False]
interface_path="", method_name="GetModelFilename", arguments=[] (uses SapModel directly)
Args: interface_path: Dot-separated path to the interface relative to SapModel. Leave empty string to call methods directly on SapModel. method_name: Name of the method to call. arguments: List of arguments to pass to the method. COM 'ref' and 'out' parameters must still be provided (usually as dummy values or empty arrays).
Returns: JSON representation of the COM method's raw return tuple. Typically the first element is the return code (0 = success).
Inputs: interface_path (required), method_name (required), arguments. Returns: result
etabs_check_is1893_driftARead-onlyIdempotent
Run IS 1893:2016 Cl. 7.11.1 inter-storey drift compliance check.
Retrieves drifts for both seismic directions and classifies each storey as PASS/FAIL against the 0.004h limit (= h/250).
IS 1893:2016 Cl. 7.11.1: The storey drift in any storey due to the minimum specified design lateral force, with partial load factor of 1.0, shall not exceed 0.004 times the storey height (h/250).
Args: rsa_case_x: RSA load case name for X seismic (e.g. "EQX"). rsa_case_y: RSA load case name for Y seismic (e.g. "EQY"). story_heights_m: Optional dict of {story_name: height_m} to compute absolute drift in mm. If None, uses drift ratio only.
Returns: Tabulated compliance report with PASS/FAIL per storey per direction.
Inputs: rsa_case_x (required), rsa_case_y (required), story_heights_m. Returns: result
etabs_close_modelADestructiveIdempotent
Close the current ETABS model without exiting the application.
Args: save_first: If True, save the model before closing.
Returns: Success confirmation.
Inputs: save_first. Returns: result
etabs_define_area_sectionA
Define an area/shell section property (for slabs, walls, decks).
Args: name: Section name (e.g. "Slab8in", "Wall12in"). material: Material name (must be previously defined). section_type: "Shell-Thin", "Shell-Thick", "Membrane", "Plate-Thin", "Plate-Thick". thickness: Shell thickness in current units. shell_type: 1=Shell-Thin, 2=Shell-Thick, 3=Plate-Thin, 4=Plate-Thick, 5=Membrane, 6=Shell-Layered.
Returns: Confirmation with section details.
Inputs: name (required), material (required), section_type, thickness, +1 more. Returns: result
etabs_define_frame_sectionA
Define a frame section property (beam/column cross-section).
For Rectangular and Circular shapes, only depth and width are needed. For I, Tee, Channel shapes, provide flange and web dimensions.
Args: name: Section name (e.g. "W14X22", "C24x12", "Beam24x12"). material: Material name (must be previously defined). shape: Section shape — Rectangular, Circular, I, Tee, Channel, Box, Pipe, Angle. depth: Total depth (or diameter for circular). width: Total width (or diameter for Pipe). flange_width_top: Top flange width (for I, Tee, Channel). flange_thickness_top: Top flange thickness. web_thickness: Web thickness. flange_width_bot: Bottom flange width (for I). flange_thickness_bot: Bottom flange thickness (for I).
Returns: Confirmation with section details.
Inputs: name (required), material (required), shape, depth, +6 more. Returns: result
etabs_define_groupBIdempotent
Define a new group.
Args: group_name: Name of the group. color: Color for the group (-1 for auto). specified_for_selection: Whether group is available for selection. specified_for_section_cut: Whether group is available for section cuts. specified_for_steel_design: Whether group is available for steel design. specified_for_concrete_design: Whether group is available for concrete design.
Returns: Confirmation.
Inputs: group_name (required), color, specified_for_selection, specified_for_section_cut, +2 more. Returns: result
etabs_define_load_caseA
Define a new load case.
Args: name: Name of the load case. case_type: One of: "LinearStatic" — standard gravity/wind/static case "Modal" — Eigenvector modal case (use etabs_define_modal_case for full control) "ResponseSpectrum" — RSA case (use etabs_define_response_spectrum for full IS 1893 / ASCE 7 setup) "LinearHistory" — linear time history "NonlinearStatic" — pushover / nonlinear static modal_case: For ResponseSpectrum cases only — name of the modal case to source mode shapes from (default "MODAL").
Returns: Confirmation.
Inputs: name (required), case_type, modal_case. Returns: result
etabs_define_load_comboA
Define a new load combination.
Args: name: Name of the load combination. combo_type: 0=LinearAdd, 1=Envelope, 2=AbsoluteAdd, 3=SRSS, 4=RangeAdd. load_names: List of load case or pattern names to include. scale_factors: List of scale factors corresponding to load_names.
Returns: Confirmation.
Inputs: name (required), combo_type, load_names, scale_factors. Returns: result
etabs_define_load_patternA
Define a new load pattern (e.g. Dead, Live, Wind, Quake).
Args: name: Name of the load pattern. load_type: Type of load (Dead, Live, Wind, Quake, Snow, etc.). self_weight_multiplier: Self-weight multiplier (typically 1.0 for Dead, 0.0 for others).
Returns: Confirmation.
Inputs: name (required), load_type, self_weight_multiplier. Returns: result
etabs_define_materialA
Define a new material property.
Args: name: Name for the material (e.g. "4000Psi", "A992Fy50"). material_type: One of: Steel, Concrete, NoDesign, Aluminum, ColdFormed, Rebar, Tendon, Masonry. region: Design region (default "United States"). standard: Standard name (e.g. "ASTM A992" for steel, "ACI 318" for concrete). grade: Grade/class (e.g. "Grade 50", "f'c 4000 psi").
Returns: Confirmation of the material definition.
Inputs: name (required), material_type, region, standard, +1 more. Returns: result
etabs_define_modal_caseAIdempotent
Define a modal analysis load case (Eigenvector or Ritz).
IS 1893:2016 Cl. 7.7.5a requires at least enough modes to capture 90% of the total seismic mass in each principal direction. Recommended: set max_modes = 3 × number of storeys, minimum 12.
Args: case_name: Name for the modal load case (default "MODAL"). modal_type: "Eigenvector" or "Ritz" (Ritz is faster for RSA). max_modes: Maximum number of modes to compute. min_modes: Minimum modes required. shift_value: Frequency shift (rad²/s²) for eigenvalue extraction; 0.0 for typical buildings.
Returns: JSON confirmation with case name and parameters.
Inputs: case_name, modal_type, max_modes, min_modes, +1 more. Returns: result
etabs_define_rebarA
Define a rebar size.
Args: name: Rebar name (e.g. "#4", "#8", "T10"). area: Cross-sectional area in current units. diameter: Bar diameter in current units.
Returns: Confirmation of the rebar definition.
Inputs: name (required), area (required), diameter (required). Returns: result
etabs_define_response_spectrumAIdempotent
Define a multi-directional Response Spectrum Analysis (RSA) load case.
Per IS 1893:2016 Cl. 7.7.5:
Modal combination: CQC (preferred over SRSS for closely-spaced modes)
Directional combination: SRSS of X and Y
Accidental eccentricity: ±5% of floor plan dimension (ecc_ratio=0.05)
Per ASCE 7-22 Sec. 12.9.1: same rules apply.
The scale factors encode (Z/2R) × I × g for IS 1893 or (SD1 / R / Ie) × g for ASCE 7. Compute them before calling this tool or use etabs_set_is1893_seismic_params which calculates them automatically.
Args: case_name: Name for the RSA load case (e.g. "EQX", "RSX"). modal_case: Name of the modal case supplying mode shapes (default "MODAL"). direction_x: Apply spectrum in the global X direction. direction_y: Apply spectrum in the global Y direction. direction_z: Apply spectrum in the vertical Z direction. scale_x: Scale factor for X spectrum (Z·I·g / 2R for IS 1893). scale_y: Scale factor for Y spectrum. scale_z: Scale factor for Z spectrum (typically 0.5 × horizontal scale). modal_combo: Modal combination rule: "CQC" (recommended) or "SRSS". dir_combo: Directional combination: "SRSS" or "ABS". ecc_ratio: Accidental eccentricity ratio (default 0.05 = 5%). func_name_x: Name of the spectral function for X (must be pre-defined). func_name_y: Name of the spectral function for Y. func_name_z: Name of the spectral function for Z (empty = not used).
Returns: JSON confirmation with RSA case parameters.
Inputs: case_name (required), modal_case, direction_x, direction_y, +10 more. Returns: result
etabs_delete_objectADestructiveIdempotent
Delete a named object from the model.
Args: object_type: Type of object — "point", "frame", "area", or "link". name: Name of the object to delete.
Returns: Success confirmation.
Inputs: object_type (required), name (required). Returns: result
etabs_delete_resultsADestructiveIdempotent
Delete all analysis results, unlocking the model.
Returns: Confirmation.
Inputs: no named parameters. Returns: result
etabs_get_all_areasARead-onlyIdempotent
Get a list of all area objects in the model with connectivity and section info.
Returns: JSON array of areas, each with name, number of points, point names, section.
Inputs: no named parameters. Returns: result
etabs_get_all_framesARead-onlyIdempotent
Get a list of all frame objects in the model with connectivity and section info.
Returns: JSON array of frames, each with name, start point, end point, section name.
Inputs: no named parameters. Returns: result
etabs_get_all_pointsARead-onlyIdempotent
Get a list of all point/joint objects in the model with their coordinates.
Returns: JSON array of points, each with name, x, y, z coordinates.
Inputs: no named parameters. Returns: result
etabs_get_analysis_statusARead-onlyIdempotent
Get the status of all analysis cases.
Returns: JSON array of load cases and their status (e.g. "Finished", "Not Run").
Inputs: no named parameters. Returns: result
etabs_get_area_sectionsARead-onlyIdempotent
Get a list of all defined area/shell section properties.
Returns: JSON array of area section names.
Inputs: no named parameters. Returns: result
etabs_get_available_tablesARead-onlyIdempotent
Get a list of all available database tables in the ETABS model.
Returns: JSON array of table names. Use these names in get_table_data.
Inputs: no named parameters. Returns: result
etabs_get_base_reactionsARead-onlyIdempotent
Get global base reactions for the model.
Returns: JSON array of base reactions per load case.
Inputs: no named parameters. Returns: result
etabs_get_design_results_summaryARead-onlyIdempotent
Get a summary of design results for frames.
Args: design_type: "Steel" or "Concrete". name: Object or group name. Leave empty for all objects. item_type: "Object", "Group", or "SelectedObjects".
Returns: JSON array of design summary results (e.g., PMM ratio).
Inputs: design_type (required), name, item_type. Returns: result
etabs_get_frame_forcesARead-onlyIdempotent
Get frame internal forces (P, V2, V3, T, M2, M3).
Ensure analysis has been run and results are set up.
Args: name: Name of the frame or group. item_type: "Object", "Group", or "SelectedObjects".
Returns: JSON array of frame forces.
Inputs: name (required), item_type. Returns: result
etabs_get_frame_sectionsBRead-onlyIdempotent
Get a list of all defined frame section properties.
Returns: JSON array of section names.
Inputs: no named parameters. Returns: result
etabs_get_grid_systemsARead-onlyIdempotent
Get all grid system names defined in the model.
Returns: JSON array of grid system names.
Inputs: no named parameters. Returns: result
etabs_get_joint_displacementsARead-onlyIdempotent
Get joint displacements for a specified point or group.
Ensure analysis has been run and results are set up.
Args: name: Name of the point or group. item_type: "Object", "Group", or "SelectedObjects".
Returns: JSON array of displacements per load case/combo.
Inputs: name (required), item_type. Returns: result
etabs_get_joint_reactionsARead-onlyIdempotent
Get joint reactions (support forces) for a specified point or group.
Ensure analysis has been run and results are set up.
Args: name: Name of the point or group. item_type: "Object", "Group", or "SelectedObjects".
Returns: JSON array of reactions per load case/combo.
Inputs: name (required), item_type. Returns: result
etabs_get_load_patternsARead-onlyIdempotent
Get all defined load patterns in the model.
Returns: JSON array of load pattern names.
Inputs: no named parameters. Returns: result
etabs_get_materialsARead-onlyIdempotent
Get a list of all defined materials in the model.
Returns: JSON array of material names and types.
Inputs: no named parameters. Returns: result
etabs_get_modal_resultsARead-onlyIdempotent
Get modal analysis results: periods, frequencies, and mass participation ratios.
IS 1893:2016 Cl. 7.7.5a: The sum of modal masses considered shall be at least 90% of the total seismic mass. Verify the cumulative UX and UY columns against this criterion.
Args: modal_case: Name of the modal load case (default "MODAL").
Returns: JSON array of modes, each with: - mode_number, period_s, frequency_hz - mass_ratio_UX, mass_ratio_UY, mass_ratio_UZ (per-mode fractions) - cum_UX, cum_UY, cum_UZ (cumulative fractions) - mass_ratio_RX, mass_ratio_RY, mass_ratio_RZ (rotational)
Inputs: modal_case. Returns: result
etabs_get_selectedARead-onlyIdempotent
Get a list of currently selected objects.
Returns: JSON array of selected object names and types.
Inputs: no named parameters. Returns: result
etabs_get_statusARead-onlyIdempotent
Get the current ETABS connection status, model filename, and lock state.
Returns JSON with: connected (bool), model_file (str), model_is_locked (bool). Use this tool first to verify ETABS is running before calling other tools.
Inputs: no named parameters. Returns: result
etabs_get_storiesARead-onlyIdempotent
Get all story definitions in the model.
Returns: JSON array of stories with name, elevation, height, is_master, and similar_to.
Inputs: no named parameters. Returns: result
etabs_get_story_driftsARead-onlyIdempotent
Get inter-storey drift ratios and check IS 1893:2016 / ASCE 7-22 limits.
IS 1893:2016 Cl. 7.11.1: Maximum storey drift under seismic loads (with R = 1.0, i.e. on the Design Basis Earthquake forces) shall not exceed 0.004 × storey height (= h/250).
ASCE 7-22 Table 12.12-1: Δa / hsx (varies 0.010 to 0.025 by risk category and structure type).
Args: case_or_combo: Load case or combo name. Empty string = all selected cases. direction: "X", "Y", or "Both". check_is1893: If True, flag storeys exceeding IS 1893 Cl. 7.11.1 limit of 0.004 (= h/250).
Returns: JSON array of storeys, each with drift ratio and code-check result.
Inputs: case_or_combo, direction, check_is1893. Returns: result
etabs_get_story_forcesARead-onlyIdempotent
Get storey forces (shear, overturning moment, axial) for each floor.
Used to verify base shear distribution meets IS 1893:2016 Cl. 7.6.3 (parabolic distribution of seismic forces with height).
Args: case_or_combo: Load case or combo name. Empty = use currently selected.
Returns: JSON array of story forces including: - story, load_case - P (axial), VX, VY (storey shear), MX, MY (overturning moment), MZ
Inputs: case_or_combo. Returns: result
etabs_get_table_dataARead-onlyIdempotent
Get the contents of a specific database table.
Args: table_key: The internal key of the table (from get_available_tables). group_name: Optional group name to filter results (default "" means all).
Returns: JSON object containing table fields and row data.
Inputs: table_key (required), group_name. Returns: result
etabs_new_modelADestructive
Create a new ETABS model, optionally from a template.
Args: units: Unit system. One of: lb_in_F, lb_ft_F, kip_in_F, kip_ft_F, kN_mm_C, kN_m_C, kgf_mm_C, kgf_m_C, N_mm_C, N_m_C, Ton_mm_C, Ton_m_C, kN_cm_C, kgf_cm_C, N_cm_C, Ton_cm_C. template: Template type — "blank", "steel_deck", or "grid_only". num_stories: Number of stories (for templates). typical_story_height: Typical story height in current units. bottom_story_height: Bottom story height in current units. num_bays_x: Number of bays in X direction (for templates). num_bays_y: Number of bays in Y direction (for templates). bay_width_x: Bay width in X direction in current units. bay_width_y: Bay width in Y direction in current units.
Returns: Success confirmation with model info.
Inputs: units, template, num_stories, typical_story_height, +5 more. Returns: result
etabs_open_modelADestructiveIdempotent
Open an existing ETABS model (.edb) file.
Args: file_path: Full path to the .edb model file (e.g. "C:/Models/Building.edb").
Returns: Success confirmation.
Inputs: file_path (required). Returns: result
etabs_run_analysisADestructive
Run the structural analysis for all active load cases.
Note: The model must be saved (have a file path) before running analysis.
Returns: Confirmation of analysis completion.
Inputs: no named parameters. Returns: result
etabs_run_concrete_designADestructive
Run the concrete frame design check.
Returns: Confirmation.
Inputs: no named parameters. Returns: result
etabs_run_steel_designADestructive
Run the steel frame design check.
Returns: Confirmation.
Inputs: no named parameters. Returns: result
etabs_save_modelAIdempotent
Save the current ETABS model.
Args: file_path: Full path to save as (e.g. "C:/Models/Building.edb"). Leave empty to save to the current file.
Returns: Success confirmation with saved path.
Inputs: file_path. Returns: result
etabs_select_objectsAIdempotent
Select objects by name in the ETABS UI.
Args: name: Name of the object to select. object_type: "Point", "Frame", "Area", or "Link". clear_previous: If True, clears existing selection before selecting.
Returns: Confirmation.
Inputs: name (required), object_type, clear_previous. Returns: result
etabs_set_active_dofAIdempotent
Set the active degrees of freedom for the analysis (e.g. 3D, 2D X-Z).
For 3D space: all True. For 2D X-Z plane: u1=True, u3=True, r2=True, others False.
Args: u1, u2, u3: Active translations (X, Y, Z). r1, r2, r3: Active rotations (about X, Y, Z).
Returns: Confirmation.
Inputs: u1, u2, u3, r1, +2 more. Returns: result
etabs_set_design_codeAIdempotent
Set the design code for steel or concrete design.
Args: design_type: "Steel" or "Concrete". code_name: The exact string name of the code (e.g., "AISC 360-16", "ACI 318-19").
Returns: Confirmation.
Inputs: design_type (required), code_name (required). Returns: result
etabs_set_grid_systemA
Define or modify a Cartesian grid system.
Args: name: Name of the grid system. x_spacings: List of X-direction grid spacings (e.g. [6.0, 6.0, 6.0] for 3 bays). y_spacings: List of Y-direction grid spacings. x_grid_ids: Optional grid line IDs for X (default: A, B, C, ...). y_grid_ids: Optional grid line IDs for Y (default: 1, 2, 3, ...).
Returns: Confirmation with the grid system definition.
Inputs: name (required), x_spacings (required), y_spacings (required), x_grid_ids, +1 more. Returns: result
etabs_set_is1893_seismic_paramsAIdempotent
Compute and report IS 1893:2016 seismic scale factors for RSA cases.
Calculates the scale factor SF = (Z/2) × (I/R) × (g/Sa_g_at_T1) for use in etabs_define_response_spectrum.
The full equivalent static base shear: VB = Ah × W where Ah = (Z/2) × (Sa/g) × (I/R)
For response spectrum analysis the ETABS scale factor applied to the spectrum function is typically: g × I / R (when the spectrum function is already in units of Sa/g, i.e. normalized). ETABS multiplies the function value by scale_factor to get spectral acceleration in length/time² units.
Args: load_case_x: Name of RSA case in X direction (e.g. "EQX"). load_case_y: Name of RSA case in Y direction (e.g. "EQY"). zone: IS 1893 seismic zone "II", "III", "IV", or "V". importance_factor: I — importance factor (1.0 ordinary, 1.2 important, 1.5 critical). IS 1893:2016 Table 8. response_reduction: R — response reduction factor. IS 1893:2016 Table 9. Typical: OMRF=3.0, SMRF=5.0. soil_type: Site type "I" (hard), "II" (medium), "III" (soft). IS 1893:2016 Table 1. damping_ratio: Critical damping ratio (default 0.05 = 5%). IS 1893:2016 Cl. 6.4.6. structure_type: "RC_frame", "Steel_frame", "Shear_wall", "Composite". Used for informational note only. modal_case: Name of the modal case. apply_scale_to_rsa: If True, returns ready-to-use ETABS scale factor (in m/s² for SI kN_m models). Set False for kip_ft models.
Returns: JSON with zone factor Z, Ah, scale factors, and IS 1893 clause references.
Inputs: load_case_x (required), load_case_y (required), zone, importance_factor, +6 more. Returns: result
etabs_set_storiesADestructive
Define the building stories. Stories are listed from bottom to top.
Args: story_names: List of story names, bottom to top (e.g. ["Base", "Story1", "Story2"]). story_heights: List of story heights for each story (same length). bottom_elevation: Elevation of the base (default 0.0).
Returns: Confirmation with the story definitions.
Inputs: story_names (required), story_heights (required), bottom_elevation. Returns: result
etabs_set_table_dataA
Set data in a specific database table (for interactive editing).
Note: You must call etabs_apply_table_edits after setting data for it to take effect.
Args: table_key: The internal key of the table. fields: List of field keys (column names). data_rows: List of rows, where each row is a list of string values corresponding to the fields.
Returns: Confirmation.
Inputs: table_key (required), fields (required), data_rows (required). Returns: result
etabs_set_unitsAIdempotent
Set the active display units for the ETABS model.
Args: units: Unit system. One of: lb_in_F, lb_ft_F, kip_in_F, kip_ft_F, kN_mm_C, kN_m_C, kgf_mm_C, kgf_m_C, N_mm_C, N_m_C, Ton_mm_C, Ton_m_C, kN_cm_C, kgf_cm_C, N_cm_C, Ton_cm_C.
Returns: Confirmation of the unit change.
Inputs: units (required). Returns: result
etabs_setup_resultsAIdempotent
Configure which load cases/combos to include when extracting results.
MUST be called before getting displacements, forces, or reactions if you want to filter the results.
Args: case_names: List of load cases to select. combo_names: List of load combos to select.
Returns: Confirmation.
Inputs: case_names, combo_names. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 69 tools
Tools are generally distinct with clear descriptions, but the large number (69) and some similar prefixes (e.g., 'etabs_add_', 'etabs_assign_') may cause minor confusion. Overall, each tool has a well-defined purpose.
All tools follow a consistent 'etabs_verb_noun' snake_case pattern, making it predictable and easy for an agent to infer functionality from names.
69 tools is high for an MCP server, but the domain (ETABS structural engineering) is complex. The count is borderline heavy, though each tool addresses a specific aspect of modeling, analysis, or design.
The tool set covers the full cycle of structural analysis: geometry, materials, sections, loads, analysis, results, and design codes. Minor gaps (e.g., nonlinear analysis, link objects) but sufficient for typical building design.
Maintenance
Related MCP Connectors
Connects AI assistants to QCDatabase.AI for everyday construction quality-control work.
Structural FEM for AI agents: frames, plates, buckling, seismic and Eurocode checks, solved locally.
Build, check and report on MIDAS CIVIL NX bridge models and design tendons, with MIDAS IT plugins.
AI Hub for AEC — 50+ 3D formats, clash detection, ACC integration via Autodesk Platform Services.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables users to control CSI ETABS structural engineering software through Claude, allowing model creation, status checks, and engineering checks via COM automation.MIT
- AlicenseAqualityBmaintenanceEnables AI assistants to interact with bridge structural analysis software for modeling, construction stages, and code checking.1562 PyPI1Apache 2.0
- AlicenseNot gradedqualityBmaintenanceEnables AI coding assistants to directly control CSI ETABS for structural and seismic analysis, including model inspection, material/section definition, frame generation, solver execution, and result extraction through natural language.2MIT
- AlicenseBqualityCmaintenanceAn agentic MCP server for CSI ETABS v22+ that enables AI agents to model, load, analyze, design, and inspect building structures through 60 curated engineering tools and live .NET reflection of the full 1,293-method OAPI. Includes offscreen 3D rendering of deformed shapes and D/C ratios, interactive database table editing, and background analysis execution.7120Apache 2.0