execute_python
Run Python in a persistent Blender session to script modeling, inspect scenes, render, and return JSON-serializable results with full bpy access.
Instructions
Queue arbitrary Python in persistent Blender. Full bpy and remote OS access.
Assign a JSON-serializable value to result. Variables are per call; bpy scene state persists. Successful calls save a checkpoint by default. A timeout or running-job cancellation restarts Blender and loses unsaved changes.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"session_id": "<session_id>",
"code": "<code>"
},
"name": "execute_python"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| code | Yes | ||
| checkpoint | No | ||
| session_id | Yes | ||
| timeout_seconds | No |