vensim-ple-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
vensim-ple-mcp
An MCP server that lets Claude (or any MCP client) build, inspect, and simulate Vensim system dynamics models, built for Vensim PLE on macOS.
Vensim PLE has no scripting interface, DLL, or batch mode. This server works on the .mdl text file directly and runs simulations through PySD, so an assistant can answer questions like "what happens to peak adoption if word of mouth doubles?" without Vensim DSS. PLE stays the place you open the model, run Check Model and Units Check, and present it.
Tools
Tool | What it does |
| Constants with their current values, other variables, time settings |
| Simulate with optional constant overrides; returns per-variable summaries (initial, final, min/max and when) and a downsampled series; can save full results to CSV |
| Run once per value of one constant and compare outcomes |
| Write a |
| Read equations, diagram objects, arrows, and views |
| Static audit: diagram overlaps, crossing links, variables missing from the diagram |
| SVG preview drawn from the model's own diagram records |
| Open the model in the installed Vensim app |
| Detect the local Vensim edition and what it supports |
| Batch script for Vensim DSS only |
Overrides apply to one run only; the .mdl file is never modified by simulation. PySD translations are cached in ~/.cache/vensim-ple-mcp (override with VENSIM_PLE_MCP_CACHE), so no extra files appear next to your model.
Related MCP server: axiomize mcp
Setup
Requires Python 3.10+ and uv.
git clone https://github.com/YamKabakov/vensim-ple-mcp.git
cd vensim-ple-mcp
uv sync
uv run python -m unittest discover testsAdd it to Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"vensim": {
"command": "uv",
"args": ["--directory", "/absolute/path/to/vensim-ple-mcp", "run", "vensim-ple-mcp-server"]
}
}
}Or Claude Code: claude mcp add vensim -- uv --directory /absolute/path/to/vensim-ple-mcp run vensim-ple-mcp-server
Command line
uv run vensim-ple-mcp params examples/bass_diffusion.mdl
uv run vensim-ple-mcp run examples/bass_diffusion.mdl --set "Word of Mouth Strength=0.5" --var Adopters --csv out.csv
uv run vensim-ple-mcp sweep examples/bass_diffusion.mdl "Word of Mouth Strength" 0.2 0.38 0.6 --var "Adoption Rate"
uv run vensim-ple-mcp generate examples/bass_diffusion.json -o examples/bass_diffusion.mdl
uv run vensim-ple-mcp render examples/bass_diffusion.mdl -o examples/bass_diffusion.svgLimits
Simulation covers what PySD supports, which is most standard Vensim functions; see the PySD docs for exceptions. Vensim remains the authority on Model Check and Units Check.
The JSON spec supports stocks, flows, auxiliaries, and constants. No lookups, subscripts, or multiple views yet.
There is no tool yet for editing an existing model in place.
Roadmap
Equation-level checks: undefined references, arrows that don't match equations, basic unit consistency
Feedback loop detection with reinforcing/balancing labels
Editing existing models while preserving the diagram (
set_equation,add_variable,rename)Lookups and multiple views in the spec
Credits
Built on Cybing521/vensim-mcp (MIT), which provides the .mdl generator, diagram layout, parser, SVG renderer, and native Vensim handoff. This project adds PySD simulation, parameter sweeps, and a PLE-focused workflow.
Vensim is a product of Ventana Systems, Inc. This project is not affiliated with Ventana and does not include Vensim.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Governed data discovery, exact queries, decisions, simulations, and runtime utilities over MCP.
Manage SysML2 projects; check, evaluate, verify, query, document and diagram models.
Create and evaluate versioned decision models with reproducible results and declared assumptions.
SysML v2 systems engineering: generate, verify, simulate and export system models from text.
Related MCP Servers
- AlicenseAqualityDmaintenanceConverts structured system dynamics specifications into Vensim .mdl files with layout, SVG preview, static audit, and native Vensim integration. It can be used as an MCP server or from the command line.7MIT
- AlicenseNot gradedqualityBmaintenanceEnables agents to build, validate, calibrate, and export versioned scientific models with mandatory units, dimensional and numerical checks, and uncertainty analysis over stdio. Models can be simulated and exported to portable formats such as SBML, CellML, and Modelica.59 npm9MIT
- AlicenseBqualityCmaintenanceEnables AI assistants and clients to control and automate FlexSim simulations via MCP tools for model operations, execution, node data access, FlexScript evaluation, results export, and batch what-if experiments.731MIT
- AlicenseBqualityBmaintenanceEnables users to create, validate, view, and export system stock-and-flow maps from a versioned JSON model through MCP-capable hosts over local stdio or hosted Streamable HTTP. Supports causal-loop and nested-level mapping while keeping submitted model content with the caller and requiring no LLM provider key.512 npmGPL 3.0