Skip to main content
Glama

AI-Native Abaqus Automation -- MCP Server + 3D Viewer + Solver Doctor

English . Chinese


What is it?

ABAQUS MCP Pro connects your AI assistant directly to Abaqus/CAE over a TCP socket bridge. You describe the simulation task in natural language, and the AI executes it in real time - building geometry, assigning materials, submitting jobs, diagnosing errors, and visualizing results.

"Create a cantilever beam with a 10 kN tip load, mesh with C3D8R elements, and submit the job."

The AI handles every step through MCP tools, and the model updates live in your Abaqus window.


Related MCP server: COMSOL MCP Server

Engineering validation status

2026-10-28: 1.1.0rc2 is a local release candidate. Current-worktree acceptance passes on Windows with Abaqus 2026, including 10/10 fresh MCP stdio runs, real GUI CAE force-kill recovery, 410 Python tests, 57 frontend tests, the production viewer build, isolated wheel installation, a 124,138-node solid-contact solve, and a 1,000,001-node T3D2 solve and WebGL rendering run.

This is not public-release acceptance. Only Abaqus 2026 is installed and validated locally; other Abaqus versions remain environment-blocked. Remote CI has not run, and this source submission is not a tagged or packaged public release. The million-node gate covers a T3D2 line model and one Intel Iris Xe WebGL 2 environment, not million-node solid contact or cross-hardware GPU scaling. Contact area is a projected nodal estimate, and the demonstration materials are not engineering-calibrated. The bridge remains loopback-only, and noGUI is enabled only when explicitly selected.

See the current delivery report and machine-readable validation. The 2026-09-30 reports are retained as historical snapshots.

Quick Start

# 1. Install
cd viewer
npm ci
npm run build
cd ..
pip install -e .
abaqus-mcp-pro-setup

# 2. Ask MCP to connect. connect_abaqus launches CAE when it is not running.
#    If CAE is already open, click Plug-ins > ABAQUS MCP Pro > Start MCP Bridge.

# 3. Connect your AI client
codex mcp add abaqus-mcp-pro -- python -m abaqus_mcp_pro.server

# 4. Start talking to Abaqus
#    "Create a tensile bar model with steel properties..."

Highlights


Architecture

System Overview

+------------------+
|  AI Client       |  "Create a steel bracket..."
|  (Codex/Claude)  |
+--------+---------+
         | stdio (MCP)
         v
+------------------+
|  MCP Server      |  server.py - 139 tools, 13 prompts, 74 resources
|  (Python)        |
+--------+---------+
         | TCP :48152
         v
+------------------+
|  GUI Plugin      |  agent.py - runs inside Abaqus/CAE kernel
|  (inside Abaqus) |
+--------+---------+
         | Abaqus Python API
         v
+------------------+
|  Abaqus/CAE      |
|  Kernel          |
+------------------+

3D Viewer Pipeline

+----------+    export_to_vtk.py     +----------+    Three.js     +----------+
|  .odb    |  --------------------> |  .vtu    |  -------------> | Browser  |
|  (Abaqus)|  (element-nodal avg     |  (VTK    |  (vtuparser.js  |  Viewer  |
|          |   + invariant extract)  |   ASCII)  |   + viewer3d)  |  local   |
+----------+                        +----------+                 +----------+
       |                                  |
       |         +----------------+         |
       +-------->|  model.json    |<--------+
                 |  (metadata)    |
                 +----------------+

The exporter (Liujie-SYSU/odb2vtk based) runs inside Abaqus Python, extracts nodal-averaged field data and stress invariants, and writes standard VTK Unstructured Grid (.vtu) files. The browser viewer parses these files directly - no intermediate JSON conversion, no cloud upload.


Browser 3D Result Viewer

2026-10-13 VTU display update: boundary/feature edges are visible by default. Optional mesh edges follow exterior element perimeters without quad triangulation diagonals; shared internal solid faces are removed. Per-fragment scalar mapping offers 12-band, 24-band and continuous contours with an Engineering Spectrum palette. Cinematic tone mapping and the background grid are disabled. Edges follow deformation, body filtering and clipping. High-order cells remain corner-linearized; extrapolation/averaging semantics are unchanged and this is not full Abaqus/CAE postprocessing parity.

The agreed result-sharing direction is ODB → lightweight export → local preflight → optional Miaoda publication → share link. Keep local viewing available and reuse one viewer for local and hosted results. Generic preflight and cloud publication are planned work; the current per-result deployment is not yet a reusable MCP tool. See implementation status and roadmap.

1.1.0rc2 (verified 2026-10-28, local release candidate) defaults static results to the final frame and Mises, adds CPRESS/COPEN/CSHEAR/CSLIP with contact-pair identity, independent mesh-body visibility and contact-output surface filtering. Units are explicitly declared, never inferred. See current acceptance evidence and remaining gates.

Successful submit_job_no_gui(wait=True) calls automatically export and return viewer.url; submit_job(wait=True) does the same when its ODB is locally accessible. After a nonblocking job completes, call open_result_viewer(odb_path, unit_system). Use view_result=False to disable automatic export. Batch reference verification supports abaqus-mcp-pro-verify --run --viewer; solver acceptance and viewer status are recorded separately.

ODB to VTU to Three.js. One command.

# Start the viewer server
python viewer/serve_viewer.py
# -> http://localhost:8080

Enter an ODB path, click Export from ODB, and inspect results instantly:

The ordinary startup URL opens an empty viewer without loading a sample or historical result. After export, ?task=<task ID> in the address bar identifies that exact result and preserves it on refresh. To open the result in another browser, append the server's startup #token=... fragment. Missing or failed results show an error without falling back to a sample. The top bar shows the source ODB path.

  • Rotate / pan / zoom with direct Trackball controls, no release inertia, synchronized pointer bounds on resize, and redraws only when the camera or display changes. Dragging does not trigger a probe click.

  • Navigation sensitivity - rotation and wheel/zoom sliders in Display Settings apply immediately and persist in this browser. Pointer and wheel samples are processed between render frames so fast input is retained.

  • Field coloring - S, U, PEEQ, RF, E, SDV with Engineering Spectrum by default and a matching legend

  • Total displacement - exporting U includes U_magnitude (U Magnitude), computed as sqrt(U1² + U2² + U3²) in the selected length unit. Re-export older results to add it; use U1/U2/U3 to inspect direction.

  • Deformed shape enabled by default, with configurable scale factor; feature edges are also enabled by default

  • Animation playback across all frames

  • Wireframe overlay toggle

  • Probe/pick - click any element to read field values

  • PBR rendering with RoomEnvironment for realistic lighting

  • Multi-frame support via .vtu per-frame export

  • Export caching - re-export only when ODB or parameters change

From Python (inside Abaqus):

from viewer.export.export_to_vtk import export_odb_to_vtk
export_odb_to_vtk("my_job.odb", output_dir="./vtk_out")
# Produces: model.json, frame_0000.vtu, frame_0001.vtu, ...

From MCP (via AI):

AI: "export_result_mesh for my_job.odb"
-> VTU files exported
-> load in viewer at http://localhost:8080

Export Format

File

Format

Description

model.json

JSON

Metadata: element types, field list, frame index, bounds

frame_NNNN.vtu

VTK XML ASCII

UnstructuredGrid: nodes, elements, cell types, nodal field data

The .vtu files are standard VTK XML format - they open in ParaView, PyVista, F3D, or any VTK-compatible viewer. No proprietary format lock-in.

Supported Element Types

3D Solid: C3D4, C3D5, C3D6, C3D8/R/I, C3D10/M, C3D15, C3D20/R/H Shell: S3/R, S4/R, S6, S8/R, S9, STRI3, STRI65 Membrane: M3D3, M3D4/R, M3D6, M3D8/R, M3D9 Beam/Truss: B21, B22, B31/H, B32/H, B33, T2D2/3, T3D2/H/3, R2D2, R3D3/4

Exported Field Variables

Symbol

Description

Invariants

S

Stress tensor

Mises, Tresca, Press, Inv3, MaxPrincipal, MidPrincipal, MinPrincipal

U

Displacement

Magnitude, U1, U2, U3

PEEQ

Equivalent plastic strain

-

RF

Reaction force

Magnitude, RF1, RF2, RF3

E

Strain tensor

6 components

SDV

Solution-dependent variables

Per-element SDV values


Tools Reference

Category

Tool

What it does

Bridge

connect_abaqus

Launch local CAE when absent, or request manual bridge start

ping

Connection health + session status

check_abaqus_connection

Human-readable status report

Code

run_python

Execute arbitrary Python in Abaqus kernel

execute_script

Compatibility wrapper (stdout text)

set_workdir

Change working directory

Model

get_model_info

Parts, materials, steps, loads, BCs

check_model_integrity

Validate model health and consistency

Job

list_jobs

All jobs and their status

submit_job

Submit and wait for completion

monitor_job_status

Tail .sta / .msg diagnostics

diagnose_job

Solver Doctor: 40+ error patterns

ODB

inspect_odb

Frames, variables, sections

get_odb_info

Compatibility wrapper

extract_kpis

ODB Lens: KPI extraction

export_result_mesh

Export ODB to JSON (legacy v1)

export_odb_to_vtk

Export ODB to VTU for 3D viewer (Liujie-SYSU/odb2vtk)

Doctor

check_silent_failures

Detect silent model issues (non-error but wrong)

converge_advice

Convergence advisor with ranked fix suggestions

Capsule

create_capsule

Save experiment state snapshot

list_capsules

List saved capsules

load_capsule

Load a saved capsule

delete_capsule

Delete a saved capsule

compare_capsules

Diff two capsules

Contract

check_physics_contracts

Validate physics contracts

Report

generate_report

Simulation report (Markdown)

Viewport

capture_viewport

Screenshot as base64

get_viewport_image

Compatibility wrapper

Plus 50+ extended tools for specific Abaqus operations: create_part_*, create_*material, createsection, createstep, createload (force, pressure, gravity, moment, heat flux, shell edge), createbc (displacement, velocity, acceleration, temperature, encastre, pinned, symmetry), create*_constraint (tie, coupling, rigid body, equation, MPC, embedded region), create_contact, create_surface, create_set, generate_mesh, seed_part, set_element_type create_instance, rotate_instance, translate_instance, create_reference_point ... and many more.


Installation

Prerequisites

Requirement

Version

Python

3.10+

Abaqus

2026 validated; other 2024+ versions targeted for future cross-version acceptance

AI Client

Codex, Claude Desktop, etc.

Install

cd viewer
npm ci
npm run build
cd ..
pip install -e .
abaqus-mcp-pro-setup          # Install GUI plugin into Abaqus

Viewer Dependencies

cd viewer
npm install                    # Three.js + Vite
cd ..
pip install fastapi uvicorn    # Viewer server (optional)

Environment Variables

Variable

Default

Description

ABAQUS_MCP_HOST

127.0.0.1

TCP host

ABAQUS_MCP_PORT

48152

TCP port

ABAQUS_MCP_TIMEOUT

60

Socket timeout (seconds)

ABAQUS_MCP_MAX_MESSAGE_BYTES

33554432

Max message size

ABAQUS_MCP_PLUGIN_DIR

~/abaqus_plugins

Plugin install directory

ABAQUS_MCP_HOME

auto-detect

File IPC working directory


Modes of Operation

# GUI mode (primary) - launch Abaqus/CAE, activate plugin

# noGUI mode (opt-in only) - use only when the user explicitly requests it
# Typically for a complete INP file that only needs solver execution
abaqus cae noGUI=scripts/start_abaqus_mcp_pro_agent.py

# File IPC fallback
abaqus cae noGUI=scripts/start_abaqus_mcp_pro_ipc.py

CLI Tools

abaqus-mcp-pro-check     # Check bridge connectivity
abaqus-mcp-pro-doctor    # Full system diagnostics
abaqus-mcp-pro-setup     # Install / update GUI plugin

Python API

from abaqus_mcp_pro.client import AbaqusBridgeClient

client = AbaqusBridgeClient(timeout=60)
result = client.execute(
    "from abaqus import mdb; result = list(mdb.models.keys())"
)
print(result["return_value"])  # ["Model-1", ...]

Project Structure

abaqus-mcp-pro/
+-- src/abaqus_mcp_pro/
|   +-- server.py                 # MCP stdio server
|   +-- tools.py                  # Core + extended MCP tools
|   +-- resources.py              # MCP resources
|   +-- prompts.py                # 13 MCP prompts
|   +-- skills.py                 # 74 skill resources
|   +-- transport.py              # Socket + file IPC
|   +-- solver_diagnosis.py       # Solver Doctor: 40+ patterns
|   +-- convergence_advisor.py    # Convergence fix suggestions
|   +-- silent_failures.py        # Silent failure detection
|   +-- odb_lens.py               # ODB Lens: KPI extraction
|   +-- capsule.py                # Experiment state tracking
|   +-- contracts.py              # Physics contracts
|   +-- report.py                 # Report generation
|   +-- abaqus_tools.py           # Core Abaqus wrappers
|   +-- abaqus_tools_extended.py  # Extended operation wrappers
|   +-- abaqus_docs.py            # Abaqus doc search
|   +-- agent.py                  # Abaqus-side TCP agent
|   +-- gui_plugin.py             # Abaqus/CAE GUI plugin
|   +-- file_ipc_plugin.py        # File IPC fallback
|   +-- client.py                 # TCP client
|   +-- protocol.py               # JSON protocol
|   +-- cli.py                    # CLI entry points
|   +-- pywinauto_tools.py        # Windows GUI automation
+-- viewer/
|   +-- serve_viewer.py           # One-click viewer server
|   +-- viewer_server.py          # legacy viewer launcher
|   +-- cache.py                  # Export cache manager
|   +-- package.json              # Vite + Three.js
|   +-- vite.config.js            # Vite build config
|   +-- index.html                # Viewer entry point
|   +-- src/
|   |   +-- main.js               # V2 viewer entry (Vite)
|   |   +-- viewer3d.js           # Three.js scene
|   |   +-- vtuparser.js          # VTU parser

|   |   +-- loader.js             # Model loading UI
|   |   +-- ui.js                 # UI controls
|   |   +-- odbexport.js          # ODB export trigger
|   |   +-- measure.js            # Measurement tools
|   |   +-- colormaps.js          # Colormaps
|   |   +-- style.css             # Viewer styles
|   +-- export/
|   |   +-- __init__.py
|   |   +-- export_to_vtk.py      # ODB -> VTU (Liujie-SYSU)
|   |   +-- _vtu_mcp_helper.py      # MCP tool template (VTU)
|   +-- dist/                     # Vite build output
|   +-- samples/                  # Sample VTU files
+-- scripts/                      # noGUI launchers
+-- examples/                     # End-to-end scripts
+-- tests/                        # Test suite
+-- docs/                         # MkDocs documentation
+-- dev/                          # Dev utilities
+-- skills/                       # AI skills knowledge base
+-- MechAgent/                    # MechAgent integration
+-- pyproject.toml
+-- CHANGELOG.md
+-- CONTRIBUTING.md
+-- README.md

Troubleshooting

Symptom

Fix

WinError 10061 connection refused

Start bridge: Plug-ins > ABAQUS MCP Pro > Start MCP Bridge

Connection timeout

Start plugin first, then MCP server

Module abaqusGui can only be used...

Use Plug-ins menu, not File > Run Script

Model not in GUI

abaqus-mcp-pro-check -> verify MainThread

Codex cant see tools

codex mcp list -> restart Codex

abaqus-mcp-pro-server not found

Reinstall or run abaqus-mcp-pro-doctor

Viewer shows blank page

cd viewer && npm install && npx vite build then restart


Credits


MIT License . View License

Made with for the CAE community

Project history and result comparisons (1.1.0rc2)

abaqus-mcp-pro-project history runs
abaqus-mcp-pro-project compare runs/<run-id> --output reports/scan

MCP tools: list_project_runs, compare_project_runs. Reports include JSON, CSV and standalone HTML. Units and KPI selectors must match to compare values; failed cases remain visible and cannot become baselines. The viewer ODB panel also provides authenticated export-task history and diagnostic log tails. See current rc2 delivery.

Available Tools

110 tools
assign_sectionC

Assign a section to a region.

Inputs: region_name (required), section_name (required), timeout, model_name. Returns: object

capture_viewportC

Capture an Abaqus viewport as base64 image data.

Inputs: timeout, image_format, viewport_name. Returns: object

check_abaqus_connectionC

Return a concise human-readable bridge status.

Inputs: timeout. Returns: result

check_model_integrityA

Quick model integrity check: mesh, constraints, contacts, volumes.

A fast subset of check_silent_failures focused on the most common silent failures. Runs the same checks but returns a compact format.

Use this after building a model and before submitting a job.

Args: model_name: Name of the model to check (default: first available model).

Returns: Compact text report of findings.

Inputs: timeout, model_name. Returns: result

check_physics_contractsA

Check physics contracts against KPI values from a capsule or direct JSON.

Validates that simulation results meet design requirements defined as contracts (range, threshold, exact, pct_change). Supports two modes:

  1. Direct mode: provide contracts_json and kpis_json directly.

  2. Capsule mode: provide contracts_json and capsule_id to load KPIs from a previously saved experiment capsule.

Args: contracts_json: JSON array of contract dicts. Each dict must have contract_id, kpi_name, contract_type. Optional: expected, tolerance, severity, description. kpis_json: JSON object mapping KPI names to values, e.g. {"max_stress": 345.6}. Required if capsule_id is empty. capsule_id: Load KPIs from this capsule instead of kpis_json.

Contract types: - range: value must be within [min, max] - threshold_gt: value must be greater than X - threshold_lt: value must be less than X - exact: value must equal X (within tolerance) - pct_change: change from baseline must be within X%

Returns: Markdown-formatted contract validation report.

Inputs: contracts_json (required), kpis_json, capsule_id. Returns: result

check_silent_failuresA

Run silent-failure checks on the current Abaqus model.

Detects 7 categories of model issues that Abaqus does not report as errors:

  1. Mesh integrity: parts with zero elements, unmeshable hex requests

  2. Constraint coverage: tie constraints that may silently drop nodes

  3. Volume/logic: cut operations that removed nothing, degenerate geometry

  4. Contact validity: contact pairs without adjacency

  5. Element quality: risky elements (C3D8R hourglass), hourglass-prone configs

  6. Job output: completed jobs with no ODB, meaningless exit codes

  7. Unconstrained parts: instances free to undergo rigid body motion

These checks measure the model you built, not just the answer it produced.

Args: model_name: Name of the model to check (default: first available model). workdir: Working directory for job output checks (default: current).

Returns: Structured Markdown report with pass/fail/warning findings.

Inputs: timeout, workdir, model_name. Returns: result

compare_capsulesC

Compare two experiment capsules and show differences.

Inputs: capsule_id_1 (required), capsule_id_2 (required). Returns: result

converge_adviceA

Get auto-fix suggestions for convergence problems diagnosed by the Solver Doctor.

Supports two modes:

  1. From diagnosis: pass the result of diagnose_job as diagnosis_result (JSON string). The advisor extracts error/warning patterns and returns ranked fix suggestions.

  2. Direct: pass comma-separated pattern_ids to get advice for specific patterns.

Each suggestion includes:

  • Priority (1 = try first, 5 = last resort)

  • Risk level (low/medium/high)

  • Code template for the fix (where applicable)

  • Description of what to do

Patterns supported: too_many_attempts, time_increment_too_small, maximum_increments_exceeded, negative_eigenvalues, rigid_body_motion, contact_overclosure, excessive_distortion, explicit_stable_time_too_small, zero_pivot, material_instability, excessive_pivot_ratio.

Args: diagnosis_result: JSON string from diagnose_job output. If provided, pattern_ids is ignored. pattern_ids: Comma-separated pattern IDs (e.g., "too_many_attempts,rigid_body_motion"). Only used if diagnosis_result is empty.

Returns: Markdown-formatted fix suggestions with priority and risk levels.

Inputs: timeout, pattern_ids, diagnosis_result. Returns: result

create_acceleration_bcC

Create an acceleration boundary condition.

Inputs: name (required), region_name (required), a1, a2, +4 more. Returns: object

create_beam_sectionC

Create a beam section.

Args: integration: "BEFORE_ANALYSIS" or "DURING_ANALYSIS"

Inputs: name (required), material_name (required), timeout, model_name, +2 more. Returns: object

create_body_forceB

Create a body force (force per unit volume) on the entire model.

Inputs: name (required), direction (required), magnitude (required), step_name (required), +2 more. Returns: object

create_body_heat_fluxC

Create a body heat flux (heat generation per unit volume).

Inputs: name (required), magnitude (required), step_name (required), timeout, +1 more. Returns: object

create_buckle_stepC

Create a Linear Buckle step.

Inputs: name (required), timeout, num_modes, model_name, +2 more. Returns: object

create_capsuleA

Capture current Abaqus session state into an experiment capsule.

Saves model info, job status, output file inventory, and Abaqus version for reproducibility and later comparison.

Args: capsule_id: Unique identifier for this capsule (e.g. "baseline_v1"). notes: Optional description of this run.

Inputs: capsule_id (required), notes, timeout. Returns: result

create_concentrated_forceB

Create a concentrated force on a vertex or reference point.

Inputs: name (required), force (required), step_name (required), region_name (required), +2 more. Returns: object

create_connector_displacement_bcC

Create a connector displacement BC.

Inputs: name (required), region_name (required), u1, u2, +4 more. Returns: object

create_connector_forceC

Create a connector force on a connector/wire set.

Inputs: name (required), force (required), step_name (required), region_name (required), +2 more. Returns: object

create_contact_propertyC

Create a contact interaction property.

Inputs: name (required), timeout, model_name, friction_coefficient. Returns: object

create_coupled_temp_disp_stepC

Create a Coupled Temperature-Displacement step.

Inputs: name (required), max_inc, min_inc, timeout, +5 more. Returns: object

create_coupling_constraintC

Create a coupling constraint between a reference point and a surface.

Args: coupling_type: "KINEMATIC", "DISTRIBUTING", or "STRUCTURAL"

Inputs: name (required), surface_name (required), control_point (required), u1, +8 more. Returns: object

create_damage_initiationC

Add ductile damage initiation to a material.

Inputs: material_name (required), fracture_strain (required), timeout, model_name, +2 more. Returns: object

create_displacement_bcC

Create a displacement BC.

Inputs: name (required), region_name (required), u1, u2, +4 more. Returns: object

create_dynamic_implicit_stepC

Create a Dynamic Implicit step.

Inputs: name (required), nlgeom, max_inc, min_inc, +6 more. Returns: object

create_elastic_materialC

Create a linear elastic material in Abaqus.

Inputs: name (required), poisson_ratio (required), youngs_modulus (required), density, +2 more. Returns: object

create_embedded_regionC

Create an embedded region constraint (e.g., reinforcement in concrete).

Inputs: name (required), host_region (required), embedded_region (required), timeout, +1 more. Returns: object

create_encastre_bcC

Create an encastre (fully fixed) BC.

Inputs: name (required), region_name (required), timeout, step_name, +1 more. Returns: object

create_equation_constraintC

Create a linear equation constraint.

Args: terms: list of (coefficient, set_name, dof) tuples. e.g., [(1.0, "Set-1", 1), (-1.0, "Set-2", 1)] for u1(Set-1) = u1(Set-2)

Inputs: name (required), terms (required), timeout, model_name. Returns: object

create_explicit_stepC

Create an Explicit Dynamics step.

Inputs: name (required), nlgeom, timeout, model_name, +3 more. Returns: object

create_field_output_requestB

Create a field output request for a specific step.

Args: variables: list of variable names, e.g. ["S", "E", "U", "RF"] frequency: output frequency (every N increments)

Inputs: name, timeout, frequency, step_name, +2 more. Returns: object

create_general_contactC

Create a general contact (all-inclusive) interaction.

Inputs: name (required), interaction_property (required), timeout, step_name, +1 more. Returns: object

create_general_contact_expC

Create a general contact for explicit analysis.

Inputs: name (required), interaction_property (required), timeout, step_name, +1 more. Returns: object

create_gravity_loadC

Create a gravity load.

Inputs: name (required), direction (required), magnitude (required), step_name (required), +2 more. Returns: object

create_heat_flux_loadC

Create a surface heat flux load.

Inputs: name (required), magnitude (required), step_name (required), region_name (required), +2 more. Returns: object

create_heat_transfer_stepC

Create a Heat Transfer step.

Inputs: name (required), max_inc, min_inc, timeout, +5 more. Returns: object

create_history_output_requestC

Create a history output request.

Args: variables: list of variable names region_name: set name for the region (empty = whole model) frequency: output frequency (every N increments)

Inputs: name, timeout, frequency, step_name, +3 more. Returns: object

create_hyperelastic_materialC

Create a hyperelastic (Mooney-Rivlin) material.

Inputs: c10 (required), name (required), d1, c01, +3 more. Returns: object

create_instanceC

Create an instance of a part in the assembly.

Inputs: part_name (required), timeout, model_name, instance_name. Returns: object

create_line_loadC

Create a line load (force per unit length) on an edge set.

Inputs: name (required), direction (required), magnitude (required), step_name (required), +3 more. Returns: object

create_modal_stepC

Create a Frequency (modal) analysis step.

Inputs: name (required), timeout, num_modes, model_name, +2 more. Returns: object

create_moment_loadC

Create a moment load on a vertex or reference point.

Inputs: name (required), moment (required), step_name (required), region_name (required), +2 more. Returns: object

create_mpc_constraintC

Create an MPC constraint.

Args: mpc_type: "BEAM", "LINK", "PIN", "TIE", "ELBOW", "SLIDER", "PLANAR", "REVOLUTE", "UNIVERSAL", "WELD"

Inputs: name (required), mpc_type (required), surface_name (required), control_point (required), +2 more. Returns: object

create_multiple_viewportsB

Create multiple viewports for side-by-side comparison.

Args: layout: "2x2", "3x1", "1x3", "2x1", "1x2"

Inputs: layout, timeout. Returns: object

create_part_beamC

Create a 3D wire (beam) part.

Inputs: name (required), length (required), point1, point2, +2 more. Returns: object

create_part_cubeB

Create a 3D deformable cube/box part.

Inputs: name (required), depth (required), width (required), height (required), +2 more. Returns: object

create_part_cylinderB

Create a 3D deformable cylinder.

Inputs: name (required), height (required), radius (required), timeout, +1 more. Returns: object

create_part_plateB

Create a 3D shell (planar) part.

Inputs: name (required), width (required), height (required), timeout, +1 more. Returns: object

create_part_sphereC

Create a 3D sphere part.

Inputs: name (required), radius (required), timeout, model_name. Returns: object

create_periodic_amplitudeC

Create a periodic (Fourier series) amplitude.

Inputs: name (required), frequency (required), start_time (required), max_amplitude (required), +3 more. Returns: object

create_pinned_bcB

Create a pinned BC (U1=U2=U3=0, rotations free).

Inputs: name (required), region_name (required), timeout, step_name, +1 more. Returns: object

create_plastic_materialB

Create an elasto-plastic material with isotropic hardening.

Inputs: name (required), yield_stress (required), poisson_ratio (required), youngs_modulus (required), +4 more. Returns: object

create_pressure_loadC

Create a pressure load.

Inputs: name (required), pressure (required), step_name (required), region_name (required), +2 more. Returns: object

create_reference_pointC

Create a reference point in the assembly.

Inputs: point (required), timeout, model_name. Returns: object

create_rigid_body_constraintC

Create a rigid body constraint.

Args: body_type: "BODY" or "PIN" (pin constrains only translational DOFs)

Inputs: name (required), region_name (required), timeout, body_type, +2 more. Returns: object

create_set_by_edgesB

Create a set from edges of an instance.

Inputs: set_name (required), edge_indices (required), instance_name (required), timeout, +1 more. Returns: object

create_set_by_faceC

Create a set from faces of an instance.

Inputs: set_name (required), face_indices (required), instance_name (required), timeout, +1 more. Returns: object

create_set_by_verticesC

Create a set from vertices of an instance.

Inputs: set_name (required), instance_name (required), vertex_indices (required), timeout, +1 more. Returns: object

create_shell_edge_loadC

Create a shell edge load (force per unit length).

Inputs: name (required), direction (required), magnitude (required), step_name (required), +3 more. Returns: object

create_shell_sectionC

Create a homogeneous shell section.

Inputs: name (required), thickness (required), material_name (required), timeout, +1 more. Returns: object

create_smooth_step_amplitudeC

Create a smooth step amplitude.

Inputs: data (required), name (required), timeout, model_name. Returns: object

create_solid_sectionB

Create a homogeneous solid section.

Inputs: name (required), material_name (required), timeout, model_name. Returns: object

create_specific_heatB

Add specific heat to an existing material.

Inputs: material_name (required), specific_heat (required), timeout, model_name. Returns: object

create_static_riks_stepC

Create a Static Riks step (for post-buckling analysis).

Inputs: name (required), nlgeom, timeout, model_name, +6 more. Returns: object

create_static_stepC

Create a Static, General step.

Inputs: name (required), nlgeom, max_inc, min_inc, +6 more. Returns: object

create_surfaceB

Create a surface from faces of an instance.

Inputs: face_indices (required), surface_name (required), instance_name (required), timeout, +1 more. Returns: object

create_surface_by_edgesB

Create a surface from edges of an instance (for shell/beam).

Inputs: edge_indices (required), surface_name (required), instance_name (required), timeout, +1 more. Returns: object

create_surface_to_surface_contactC

Create a surface-to-surface contact interaction.

Inputs: name (required), slave_surface (required), master_surface (required), interaction_property (required), +3 more. Returns: object

create_surface_to_surface_contact_expB

Create a surface-to-surface contact interaction for explicit analysis.

Inputs: name (required), slave_surface (required), master_surface (required), interaction_property (required), +3 more. Returns: object

create_symmetry_bcC

Create a symmetry boundary condition.

Args: symmetry_type: "XSYMM", "YSYMM", "ZSYMM", "XASYMM", "YASYMM", "ZASYMM"

Inputs: name (required), region_name (required), timeout, step_name, +2 more. Returns: object

create_tabular_amplitudeC

Create a tabular amplitude.

Args: data: list of (time/frequency, amplitude) tuples smooth: "SOLVER_DEFAULT", "STEP", "LINEAR", "SMOOTH"

Inputs: data (required), name (required), smooth, timeout, +1 more. Returns: object

create_temperature_bcC

Create a temperature boundary condition.

Inputs: name (required), magnitude (required), region_name (required), timeout, +2 more. Returns: object

create_thermal_conductivityC

Add thermal conductivity to an existing material.

Inputs: conductivity (required), material_name (required), timeout, model_name. Returns: object

create_thermal_expansionB

Add thermal expansion to an existing material.

Inputs: material_name (required), expansion_coefficient (required), timeout, model_name, +1 more. Returns: object

create_tieC

Create a tie constraint.

Inputs: name (required), slave_surface (required), master_surface (required), timeout, +1 more. Returns: object

create_velocity_bcC

Create a velocity boundary condition.

Inputs: name (required), region_name (required), v1, v2, +4 more. Returns: object

create_viscoelastic_materialC

Create a viscoelastic material with Prony series.

Args: relaxation_data: list of (g_i, k_i, tau_i) Prony series terms

Inputs: name (required), poisson_ratio (required), youngs_modulus (required), relaxation_data (required), +3 more. Returns: object

delete_capsuleB

Delete a saved experiment capsule.

Inputs: capsule_id (required). Returns: result

diagnose_jobA

Run a comprehensive solver-log diagnosis on a job's output files.

Scans .sta, .msg, .dat, .log files for 40+ known error/warning patterns across 14 categories: license, convergence, model setup, contact, material, resources, environment, ODB, syntax, explicit, output, scripting, mesh, and general.

Returns a structured Markdown diagnostic panel with severity markers, source file references, and actionable fix suggestions.

Inputs: job_name (required), timeout, workdir. Returns: result

execute_scriptC

Compatibility wrapper around run_python that returns stdout/text.

Inputs: script (required), timeout. Returns: result

extract_kpisB

Extract KPIs from an ODB file using declarative queries.

queries is a JSON array of query objects, each with:

  • query_id (str): unique identifier for this KPI

  • field (str): field output name, e.g. "S", "U", "RF", "PEEQ", "NT"

  • component (str, optional): e.g. "Mises", "U1", "S11", "RF2"

  • invariant (str, optional): e.g. "Mises", "MaxPrincipal", "Tresca"

  • step (str, optional): step name, default first step

  • frame (str, optional): "last", "first", or frame index, default "last"

  • aggregation (str, optional): max, min, sum, avg, range, abs_max, default "max"

  • region (str, optional): node/element set name, default ALL

Example queries JSON: [ {"query_id": "max_stress", "field": "S", "invariant": "Mises", "aggregation": "max"}, {"query_id": "max_disp", "field": "U", "component": "Magnitude", "aggregation": "max"}, {"query_id": "rf_sum", "field": "RF", "component": "RF2", "aggregation": "sum", "region": "FIXED_END"} ]

Returns a structured Markdown KPI report.

Inputs: queries (required), odb_path (required), timeout. Returns: result

find_edge_by_coordinateA

Find the edge index of an instance closest to the given coordinate.

Inputs: coordinate (required), instance_name (required), timeout, tolerance, +1 more. Returns: object

find_face_by_coordinateC

Find the face index of an instance closest to the given coordinate.

Inputs: coordinate (required), instance_name (required), timeout, tolerance, +1 more. Returns: object

generate_meshC

Generate mesh for the whole model.

Inputs: timeout, model_name. Returns: object

generate_reportA

Generate a comprehensive simulation report in Markdown format.

Combines capsule snapshot, KPI lens results, physics contracts validation, solver diagnosis, and silent failure detection into a single structured report. Supports two modes:

  1. Full mode: provide capsule_id (and optionally contracts_json). The report will include model info, job status, KPIs, solver diagnosis, and contract validation from the capsule.

  2. Quick mode: provide contracts_json and kpis_json directly (uses check_physics_contracts internally).

Args: capsule_id: Load data from this capsule. If provided, the report includes model info, job status, KPIs, and diagnosis from the capsule. contracts_json: JSON array of contract dicts to validate against capsule KPIs. Only used when capsule_id is provided. report_title: Title for the report. output_path: If provided, save the report to this file path. Otherwise, return the report as text. include_silent_failures: If True, run silent-failure checks on the model and include the results in the report.

Returns: The generated report as Markdown text, or a confirmation message if output_path is provided.

Inputs: timeout, capsule_id, output_path, report_title, +2 more. Returns: result

get_field_output_summaryC

Get summary of field outputs in an ODB.

Inputs: odb_path (required), timeout. Returns: object

get_history_outputC

Get history output data from an ODB.

Inputs: odb_path (required), timeout, variable, step_name. Returns: object

get_model_infoC

Get parts, materials, steps, loads, BCs, interactions, jobs, and viewports.

Inputs: timeout. Returns: result

get_node_coordinatesC

Get the coordinates of a specific node.

Inputs: node_label (required), instance_name (required), timeout, model_name. Returns: object

get_odb_infoC

Compatibility wrapper for inspect_odb returning formatted JSON.

Inputs: odb_path (required), timeout. Returns: result

get_viewport_imageC

Compatibility wrapper returning a data URI for the requested viewport.

Inputs: timeout, image_format, viewport_name. Returns: result

get_xy_dataC

Extract XY data from an ODB.

Args: node_label: node label for history-based extraction element_label: element label for element-based extraction frame_index: -1 for last frame

Inputs: odb_path (required), timeout, variable, component, +4 more. Returns: object

inspect_odbB

Open an ODB read-only and return metadata about steps, frames, and outputs.

Inputs: odb_path (required), timeout. Returns: object

list_capsulesA

List all saved experiment capsules.

Inputs: no named parameters. Returns: result

list_elementsB

List elements in an instance with their type and connectivity.

Inputs: instance_name (required), timeout, model_name. Returns: object

list_jobsB

List all Abaqus jobs in the current CAE session.

Inputs: timeout. Returns: result

list_materialsB

List all materials in the specified model.

Inputs: timeout, model_name. Returns: object

list_nodesC

List nodes in an instance.

Inputs: instance_name (required), timeout, model_name. Returns: object

load_capsuleB

Load a saved experiment capsule by ID.

Inputs: capsule_id (required). Returns: result

monitor_job_statusB

Inspect job objects and tail .sta/.msg diagnostics. Set diagnose=True for full solver-log analysis.

Inputs: timeout, diagnose, job_name. Returns: object

pingB

Check whether the Abaqus-side socket bridge is reachable.

Inputs: timeout. Returns: object

rotate_instanceB

Rotate an instance around an axis by a given angle (degrees).

Inputs: angle (required), axis_point (required), instance_name (required), axis_direction (required), +2 more. Returns: object

run_pythonB

Execute Python code in the active Abaqus/CAE kernel.

Single-line expressions are evaluated and returned. Multi-line scripts are executed; set a variable named result to return structured data.

Inputs: code (required), timeout. Returns: object

seed_partC

Seed a part with a global element size.

Inputs: size (required), part_name (required), timeout, model_name, +2 more. Returns: object

set_element_typeC

Set the element type for a part.

Args: elem_type: e.g., "C3D8R", "C3D8", "C3D10", "CPS4R", "CPE4R", "S4R", "B31"

Inputs: part_name (required), timeout, elem_type, model_name. Returns: object

set_mesh_controlC

Set mesh control algorithm for a part.

Args: algorithm: "MEDIAL_AXIS", "ADVANCING_FRONT", or "SWEEP"

Inputs: part_name (required), timeout, algorithm, model_name. Returns: object

set_viewport_annotationsA

Set viewport annotations (title, legend, etc.).

Args: title: Title text for the viewport subtitle: Subtitle text legend: Show/hide legend

Inputs: title, legend, timeout, subtitle. Returns: object

set_viewport_displayB

Set the viewport display type and variable.

Args: plot_type: "contour", "symbol", "material", "undeformed" variable: Field output variable (e.g., "S", "U", "RF") component: Component (e.g., "Mises", "U1", "S11") deformation_scale: Deformation scale factor (None = auto)

Inputs: timeout, variable, component, plot_type, +1 more. Returns: object

set_viewport_viewC

Set the camera view in the viewport.

Args: view_type: "iso", "front", "back", "top", "bottom", "left", "right"

Inputs: timeout, view_type. Returns: object

set_workdirC

Change the current Abaqus working directory.

Inputs: path (required), timeout. Returns: object

submit_jobA

Submit an existing Abaqus job and wait for completion.

Inputs: job_name (required), timeout. Returns: result

translate_instanceC

Translate an instance in the assembly.

Inputs: vector (required), instance_name (required), timeout, model_name. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.6/5.0

    Scored across 110 tools

    Disambiguation2/5

    The set contains explicit wrappers/duplicates such as run_python/execute_script, inspect_odb/get_odb_info, and capture_viewport/get_viewport_image, plus overlapping tools like check_silent_failures/check_model_integrity and monitor_job_status/diagnose_job. Even with good individual descriptions, an agent will struggle to tell which tool is the intended one.

    Naming Consistency4/5

    Tool names are overwhelmingly snake_case and follow a consistent verb_noun pattern such as create_*, list_*, get_*, set_*, and check_*. Minor deviations like the bare 'ping', compatibility wrapper names, and _exp suffixes keep this from being a perfect 5.

    Tool Count1/5

    110 tools is far beyond the calibrated extreme-mismatch threshold of 50+. The surface includes several near-duplicate and subset tools that should be merged, making the overall tool count excessive for effective agent selection.

    Completeness3/5

    The workflow coverage is broad: parts, materials, meshes, steps, loads, BCs, contacts, job submission, diagnosis, ODB extraction, and reporting are all present. However, nearly every create_* entity lacks corresponding update/delete tools, so iterative correction requires the generic run_python escape hatch rather than a complete structured lifecycle.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables to interact with Abaqus FEA software through an MCP bridge, supporting connection checks, script execution, model queries, job submission, and simulation automation.
      3
      -
    • A
      license
      B
      quality
      C
      maintenance
      Enables AI agents to automate COMSOL Multiphysics simulations, including model management, geometry building, physics configuration, meshing, solving, and results visualization through the MCP protocol.
      78
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that enables controlling a live Abaqus/CAE session through natural language, allowing model inspection, job submission, ODB analysis, and viewport capture.
      1
      MIT