# ITASCA MCP Server

Connects AI agents to ITASCA geomechanics software to query syntax manuals, run numerical simulations, and inspect running models.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 219
- Author: yusong652
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/yusong652/itasca-mcp
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/itasca-mcp-server

## What it does

This server bridges AI agents with ITASCA modeling software, including PFC, FLAC, 3DEC, MPoint, and MassFlow. It provides ten tools. Five tools handle documentation lookups across engine versions, covering commands and the Python API. These search tools operate independently. They do not require a running simulation engine.

The other five tools manage execution. They submit simulation jobs, read live REPL outputs, monitor progress, and interrupt tasks when needed. An installed ITASCA engine and a running bridge via `addon.py` are strictly required for any simulation step. Without this active bridge, code execution calls fail immediately.

The agent also tracks activity in the software GUI. It registers console commands, open plots, and executed data files, keeping model adjustments synchronized with user actions.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add itasca-mcp -- uvx itasca-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from itasca-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add itasca-mcp-server -- uvx itasca-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from itasca-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "itasca-mcp-server": {
            "command": "uvx",
            "args": [
                "itasca-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from itasca-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "itasca-mcp-server": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "itasca-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from itasca-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add itasca-mcp-server uvx itasca-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from itasca-mcp <command>

## When to use it
- search command syntax and Python API references across ITASCA versions
- inspect unbalanced forces and model state without stopping execution
- run slope stability or tunnel excavation models via chat
- generate contact force chain plots and stress-strain curves

## Example prompts
- Look up plot syntax in the documentation and render the contact force chains for the current model
- Model a tunnel excavation in 3DEC and report block displacements around the perimeter
- Check the current unbalanced force in the active simulation without interrupting it

## Similar
- [Zotero MCP](https://affpapa.org/en/nevibecode/mcp/zotero-mcp.md) — MCP server · ★ 5548
- [arxiv-mcp-server](https://affpapa.org/en/nevibecode/mcp/arxiv-mcp-server.md) — MCP server · ★ 3231
- [PaperBanana](https://affpapa.org/en/nevibecode/mcp/paperbanana.md) — MCP server · ★ 2417
- [MATLAB MCP Server](https://affpapa.org/en/nevibecode/mcp/matlab-mcp-server.md) — MCP server · ★ 1716
- [Hex Research](https://affpapa.org/en/nevibecode/mcp/hex-research.md) — MCP server · ★ 583
- [DocsAgent — Zotero, Obsidian & Apple Notes MCP Server](https://affpapa.org/en/nevibecode/mcp/docsagent-zotero-obsidian-apple-notes-mcp-server.md) — MCP server · ★ 578

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md