itasca-mcp
MCP server for ITASCA geomechanics: an agent searches PFC, FLAC, 3DEC, MPoint and MassFlow docs and runs simulations
- 228 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- The agent executes arbitrary code inside the simulation program and writes project files
- The bridge opens the running ITASCA program to an external client for the session
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/itasca-mcpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The agent executes arbitrary code inside the simulation program and writes project files
- The bridge opens the running ITASCA program to an external client for the session
This is third-party code. Review the repository files before installing.
What it does
itasca-mcp connects agents to ITASCA geomechanics simulation software: PFC (discrete elements), FLAC, 3DEC, MPoint and MassFlow. The agent browses documentation, runs calculations and executes code in conversation. Seven tools fall into two groups. Two documentation tools browse the command tree and search by keyword across commands, the Python API, FISH and the reference of the selected engine (`software` and `version` parameters) and need no bridge. Five execution tools provide an interactive REPL, task submission, progress monitoring, interruption and history, and need a running bridge. The `itasca_mcp_bridge` bridge starts inside the program's own IPython console with `itasca_mcp_bridge.start()` and checks PyPI for a newer version first. The REPL works alongside a running calculation, so you can, for example, look at the unbalanced force without stopping the task. The agent also sees what you do in the graphical interface: cells you run, commands you type, plots and data files you open.
Who it is for. Geotechnical engineers and researchers who model soil and rock in PFC, FLAC and 3DEC and want to run a calculation in conversation with an agent.
Good fit when
- A dense specimen is tested in biaxial compression and a stress–strain curve is plotted
- A slope is built in FLAC3D and its factor of safety is found
- A tunnel excavation in jointed rock is modeled in 3DEC and block displacements are checked
- The agent has to check the `plot` command syntax against the docs before drawing force chains
Not a fit when
- You have no ITASCA engine: the server attaches to an installed licensed program
- You need an ordinary Python library without the program's GUI: the bridge starts inside the program's own console
- The calculation runs on a cluster without a graphical environment: a running bridge in the console is needed
Example request
Build a 10 meter slope model in FLAC3D, find the factor of safety and show the displacement plot in the projectMCP
- Transport
- stdio
- Authentication
- not required
Limitations
You need an installed ITASCA engine (version 9.0 or newer is recommended, PFC 6.0 and 7.0, FLAC 7.0 and 3DEC 7.0 are also supported) and `uv`. Documentation covers PFC 6.0, 7.0 and 9.0, FLAC 7.0 and 9.0, 3DEC 7.0 and 9.0. After each engine launch the bridge is started again and the client config persists. The agent executes arbitrary code inside the program and writes project files, so such calculations should be limited to a working directory. The license is MIT and the MCP registry version is 0.2.5.
How to disable. Remove the itasca-mcp block from the client config (`claude mcp remove itasca-mcp`) and close the bridge by quitting the engine console. The package is fetched through `uvx` and leaves no separate files.
FAQ
How do I connect itasca-mcp to Claude Code?
Run `claude mcp add itasca-mcp -- uvx itasca-mcp`. For Codex there is `codex mcp add itasca-mcp -- uvx itasca-mcp` and for Gemini CLI `gemini mcp add itasca-mcp uvx itasca-mcp`.
What is the bridge and why is it needed?
The `addon.py` file is run inside the engine console: it opens the program to execution tools. Documentation works without the bridge, while the REPL, task submission and monitoring do not.
Can code run while a calculation is in progress?
Yes, the REPL works alongside a running task: you can check model state and intermediate results without stopping it. Long calculations have task submission, monitoring and interruption separately.
Which engine versions are supported?
Documentation covers PFC 6.0, 7.0 and 9.0, FLAC 7.0 and 9.0 plus 3DEC 7.0 and 9.0. Version 9.0 or newer is recommended.
Is an agent-started bridge necessary?
Not required: the agent can start the bridge itself through the engine's `console.exe`, or you start it by hand each session with `itasca_mcp_bridge.start()`.
Discussion
No questions or reviews yet.
Related
MCP serversFreeCAD MCP: an AI agent in parametric CAD
FreeCAD MCP (blwfish)
An MCP bridge between an agent and FreeCAD: 41 tools for parametric parts, CAM toolpaths, meshes and model diagnostics
An MCP server for IFC: an agent counts building elements, validates a model against IDS, finds clashes and edits properties
An MCP server with 98 tools drives CATIA V5 over COM: sketches, solid models, assemblies, measurements and STEP export.
An MCP server that indexes code with tree-sitter so an agent reads single symbols, not files, traces paths and weighs edits
A 1C external data processor with MCP and REST API: queries, metadata, event log and code execution without changing the configuration
An MCP server that graphs repository dependencies, writes docs from the graph and answers agent questions via codebase-qna
README in short
The text presents the server as a way for agents to work with ITASCA programs: documentation, running models and executing code in conversation, then lists seven tools and example prompts. Next come requirements, agentic and manual setup, starting the bridge, daily startup, features and links to the troubleshooting guide.