YADE MCP Server
Let an agent browse the YADE docs, run discrete element simulations and manage tasks
- Pricing
- Open source
- Platforms
- CLI, Linux
- Runs
- Locally
- Version
- 0.11.2
- Listing updated
- today
Similar MCP servers
About YADE MCP Server
YADE MCP Server is an open-source MCP server for engineering simulation. It runs locally on your machine and is started by your AI client.
YADE is an open-source discrete element method engine, and this server connects an agent to a live YADE session through a small bridge that you install into YADE's own Python. Two documentation tools work without it: one walks the Python class tree and one runs a BM25 keyword search across the API. The five execution tools need the bridge started in the YADE console.
Code runs in the session's own namespace, so state persists between calls, and it keeps working while a background task runs, which lets an agent read the unbalanced force without stopping a simulation. Long scripts are submitted as queued tasks that run one at a time and can be stopped at an iteration boundary. Task history persists across sessions, and lines you type at the YADE console reach the agent on its next call.
Prerequisites are YADE and uv, and the README warns the bridge must be installed with the interpreter YADE embeds, not a conda or venv one. The bridge listens on port 9002 by default and can bind to all interfaces inside a container. MIT licensed.
Install
Run in a terminal
claude mcp add yade-mcp -- uvx yade-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"yade-mcp": {
"command": "uvx",
"args": [
"yade-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"yade-mcp": {
"command": "uvx",
"args": [
"yade-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"yade-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"yade-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"yade-mcp": {
"command": "uvx",
"args": [
"yade-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"yade-mcp": {
"command": "uvx",
"args": [
"yade-mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (7)
Taken from the project documentation; the running server may differ.
- yade_browse_api
- Walk the YADE Python class tree.
- yade_query_api
- BM25 keyword search across the YADE API.
- yade_execute_code
- Run Python in the live YADE process and return synchronously.
- yade_execute_task
- Submit a script as a long-running background task.
- yade_check_task_status
- Inspect a running or finished task.
- yade_interrupt_task
- Stop a running task at an iteration boundary or cancel a queued one.
- yade_list_tasks
- List submitted tasks with metadata.
What it does
- API browsing
- Walk the YADE Python class tree without the bridge.
- API search
- BM25 keyword search across the API corpus.
- Live REPL
- Run Python in the running YADE process with persistent state.
- Background tasks
- Submit long scripts, queue them and interrupt at an iteration boundary.
- Task history
- Scripts, output and final states persist across sessions.
- Console input
- Lines typed at the YADE console reach the agent.
Good for
- Set up a triaxial compression test and plot stress against strain
- Build an irregular particle and drop it onto a plane
- Check a running simulation's unbalanced force
- Look up how a timestepper works before using it
- Review what was run yesterday and what it produced
Pricing
Open source
MIT licensed
YADE MCP Server FAQ
What do I need installed?
YADE, the uv launcher and an MCP-capable agent such as Claude Code, Codex CLI or Gemini CLI.
Do the docs tools need the bridge?
No, only the five execution tools do.
Where does the bridge listen?
On port 9002 by default; pass another port to start() and register a matching bridge URL.
What licence is it under?
MIT.
Is YADE MCP Server free?
Yes. YADE MCP Server is open source, so you can use and self-host it for free.
How do I add YADE MCP Server to Claude Code?
Run this command in your terminal: claude mcp add yade-mcp -- uvx yade-mcp
What are the best alternatives to YADE MCP Server?
The closest alternatives to YADE MCP Server are CAD2GIS, Petrolytx: decline curves and well economics, zumen-gate, Gradient Dynamics: thermal and CFD simulation and The Cable Code.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.
