ABAQUS MCP Pro
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., "@ABAQUS MCP Pro Submit the cantilever job and extract max von Mises stress from ODB"
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.
AI-Native Abaqus Automation -- MCP Server + 3D Viewer + Solver Doctor
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:8080Enter 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 assqrt(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:8080Export 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 AbaqusViewer 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.pyCLI Tools
abaqus-mcp-pro-check # Check bridge connectivity
abaqus-mcp-pro-doctor # Full system diagnostics
abaqus-mcp-pro-setup # Install / update GUI pluginPython 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.mdTroubleshooting
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
Abaqus-Control-MCP - TCP socket bridge, AST diagnostics
CAE-Agent-Hub - High-level tools & architecture
abaqus-mcp - File-based IPC transport
Codex_MCP_Abaqus - noGUI mode & examples
Liujie-SYSU/odb2vtk - Element-nodal averaging, invariant extraction, VTK export
MechAgent - Multi-agent CAE collaboration framework
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/scanMCP 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 toolsassign_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:
Direct mode: provide contracts_json and kpis_json directly.
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:
Mesh integrity: parts with zero elements, unmeshable hex requests
Constraint coverage: tie constraints that may silently drop nodes
Volume/logic: cut operations that removed nothing, degenerate geometry
Contact validity: contact pairs without adjacency
Element quality: risky elements (C3D8R hourglass), hourglass-prone configs
Job output: completed jobs with no ODB, meaningless exit codes
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:
From diagnosis: pass the result of diagnose_job as diagnosis_result (JSON string). The advisor extracts error/warning patterns and returns ranked fix suggestions.
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:
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.
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
Scored across 110 tools
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.
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.
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.
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
Related MCP Connectors
Use AI models for chat, image, and video generation from Claude Code and other MCP hosts.
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Global CAD/BIM, industrial engineering (FEM, CFD) and property tools via one MCP endpoint.
Build and run AI workflows, agents, data tables and 1000+ API integrations from any MCP client.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables to interact with Abaqus FEA software through an MCP bridge, supporting connection checks, script execution, model queries, job submission, and simulation automation.3-
- AlicenseBqualityCmaintenanceEnables AI agents to automate COMSOL Multiphysics simulations, including model management, geometry building, physics configuration, meshing, solving, and results visualization through the MCP protocol.78MIT
- AlicenseNot gradedqualityDmaintenanceA secure local STDIO MCP server that lets OpenAI Codex automate Abaqus FEM workflows: create model scripts, submit jobs, monitor solver logs, and extract ODB results.1MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables controlling a live Abaqus/CAE session through natural language, allowing model inspection, job submission, ODB analysis, and viewport capture.1MIT