Skip to main content
Glama
ETABS MCP Server

ETABS MCP Server

by mdvaleed7

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 — comtypes does 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.py

Installation

  1. 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 .
  2. 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: command

  • Name: ETABS

  • Command: etabs-mcp (or the full path to your venv's script)

Claude Code / other stdio MCP clients

claude mcp add etabs -- etabs-mcp

Tool Categories

The server exposes 69 tools grouped by domain:

Category

Tools

Key functions

Model Control

6

etabs_get_status, etabs_new_model, etabs_open_model, etabs_save_model, etabs_close_model, etabs_set_units

Geometry

7

etabs_add_point, etabs_add_frame, etabs_add_area, etabs_get_all_*, etabs_delete_object

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

etabs_call_api — escape hatch for all 1,300+ ETABS methods


🆕 Seismic Module — IS 1893:2016 / ASCE 7 / EC8

The new seismic.py module adds 7 tools for complete response spectrum workflow:

Tool

Purpose

etabs_define_modal_case

Eigenvector/Ritz case; max modes, shift value

etabs_define_response_spectrum

RSA case — CQC/SRSS, eccentricity, scale factors

etabs_get_modal_results

Periods, frequencies, mass participation; auto-checks IS 1893 Cl. 7.7.5a 90% mass rule

etabs_get_story_drifts

Inter-storey drift ratios with IS 1893 Cl. 7.11.1 h/250 check

etabs_get_story_forces

Storey shear and overturning moments per floor

etabs_set_is1893_seismic_params

Computes ETABS scale factor from Zone/I/R/soil; step-by-step workflow guide

etabs_check_is1893_drift

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 report

Stiffness 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

aci_beam

I = 0.35 Ig, torsion = 0.20

Columns

aci_column

I = 0.70 Ig, A = 0.70 Ag

Walls

aci_wall

I = 0.70 Ig, A = 0.70 Ag (uncracked)

Slabs

aci_slab

I = 0.25 Ig

Granular tools for finer control:

  • etabs_assign_frame_stiffness_modifiers — apply to specific frames with any of the presets aci_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 individual area / m2 / m3 / torsion / mass / weight values to override.

  • etabs_assign_area_stiffness_modifiers — apply to specific areas with any of the presets aci_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 individual f11 / f22 / f12 / m11 / m22 / m12 / v13 / v23 values.

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, use etabs_call_api with interface_path="FrameObj" and method_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

ModuleNotFoundError: No module named 'etabs_mcp'

Run pip install -e . from the repo root (where pyproject.toml lives).

comtypes import error on macOS/Linux

This is expected — the server only runs on Windows.

ETABS won't auto-attach

Start ETABS manually, then call etabs_get_status.

ConnectionError: Cannot launch ETABS

Set etabs_executable_path in etabs_mcp_config.json to the full path of ETABS.exe.

License

MIT

Available Tools

69 tools
etabs_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_groupA
Idempotent

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_modifiersA
Idempotent

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_editsA
Destructive

Apply all pending database table edits to the model.

Returns: Confirmation.

Inputs: no named parameters. Returns: result

etabs_assign_area_loadA
Idempotent

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_sectionA
Idempotent

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_modifiersA
Idempotent

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_diaphragmA
Idempotent

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_loadA
Idempotent

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_releasesA
Idempotent

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_sectionA
Idempotent

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_modifiersA
Idempotent

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_labelB
Idempotent

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_loadA
Idempotent

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_labelC
Idempotent

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_driftA
Read-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_modelA
DestructiveIdempotent

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_groupB
Idempotent

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_caseA
Idempotent

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_spectrumA
Idempotent

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_objectA
DestructiveIdempotent

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_resultsA
DestructiveIdempotent

Delete all analysis results, unlocking the model.

Returns: Confirmation.

Inputs: no named parameters. Returns: result

etabs_get_all_areasA
Read-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_framesA
Read-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_pointsA
Read-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_statusA
Read-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_sectionsA
Read-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_tablesA
Read-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_reactionsA
Read-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_summaryA
Read-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_forcesA
Read-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_sectionsB
Read-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_systemsA
Read-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_displacementsA
Read-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_reactionsA
Read-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_patternsA
Read-onlyIdempotent

Get all defined load patterns in the model.

Returns: JSON array of load pattern names.

Inputs: no named parameters. Returns: result

etabs_get_materialsA
Read-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_resultsA
Read-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_selectedA
Read-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_statusA
Read-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_storiesA
Read-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_driftsA
Read-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_forcesA
Read-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_dataA
Read-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_modelA
Destructive

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_modelA
DestructiveIdempotent

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_analysisA
Destructive

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_designA
Destructive

Run the concrete frame design check.

Returns: Confirmation.

Inputs: no named parameters. Returns: result

etabs_run_steel_designA
Destructive

Run the steel frame design check.

Returns: Confirmation.

Inputs: no named parameters. Returns: result

etabs_save_modelA
Idempotent

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_objectsA
Idempotent

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_dofA
Idempotent

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_codeA
Idempotent

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_paramsA
Idempotent

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_storiesA
Destructive

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_unitsA
Idempotent

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_resultsA
Idempotent

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

    A3.7/5.0

    Scored across 69 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    All tools follow a consistent 'etabs_verb_noun' snake_case pattern, making it predictable and easy for an agent to infer functionality from names.

    Tool Count3/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables users to control CSI ETABS structural engineering software through Claude, allowing model creation, status checks, and engineering checks via COM automation.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI assistants to interact with bridge structural analysis software for modeling, construction stages, and code checking.
      15
      62 PyPI
      1
      Apache 2.0
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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.
      2
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      An 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.
      71
      20
      Apache 2.0