yade-mcp
O.engines += [LLM()] # yet another engine.
yade-mcp connects AI agents to YADE, the open-source discrete element method engine, through the Model Context Protocol. The agent browses the YADE API, runs code in a live YADE session, launches long simulations as background tasks, and reads what you type at the YADE console.
Tools (7)
Two documentation tools (no bridge needed) and five execution tools (bridge required):
| Tool | Purpose | Bridge |
|---|---|---|
yade_browse_api |
Walk the YADE Python class tree | No |
yade_query_api |
BM25 keyword search across the API | No |
yade_execute_code |
Run Python in the live YADE process; returns synchronously | Yes |
yade_execute_task |
Submit a script as a long-running background task | Yes |
yade_check_task_status |
Inspect a running or finished task (output, status) | Yes |
yade_interrupt_task |
Stop a running task at an iteration boundary, or cancel a queued one | Yes |
yade_list_tasks |
List submitted tasks with metadata | Yes |
Example Prompts
- "Set up a triaxial compression test on a dense packing and plot deviatoric stress against axial strain"
- "Build an irregular particle as a level set body and drop it onto a plane"
- "The simulation is still running, check the unbalanced force without stopping it"
- "Look up how GlobalStiffnessTimeStepper picks the timestep, then add it to this model"
- "The command I just typed in the console raised an error, what went wrong?"
- "List what was run yesterday and summarize what each task produced"
