Touchdesigner MCP server
{
"mcpServers": {
"8beeeaaat-touchdesigner": {
"command": "npx",
"args": [
"-y",
"touchdesigner-mcp-server@latest"
]
}
}
}{
"mcpServers": {
"8beeeaaat-touchdesigner": {
"command": "npx",
"args": [
"-y",
"touchdesigner-mcp-server@latest"
]
}
}
}{
"mcpServers": {
"8beeeaaat-touchdesigner": {
"command": "npx",
"args": [
"-y",
"touchdesigner-mcp-server@latest"
]
}
}
}{
"servers": {
"8beeeaaat-touchdesigner": {
"command": "npx",
"args": [
"-y",
"touchdesigner-mcp-server@latest"
]
}
}
}{
"mcpServers": {
"8beeeaaat-touchdesigner": {
"command": "npx",
"args": [
"-y",
"touchdesigner-mcp-server@latest"
]
}
}
}file .mcp.json (in your project root)file claude_desktop_config.jsonfile ~/.cursor/mcp.jsonfile .vscode/mcp.jsonfile ~/.codeium/windsurf/mcp_config.jsoninstall npx -y touchdesigner-mcp-serverversion 1.2.0
What it does
This MCP server bridges AI agents to TouchDesigner projects through the WebServer DAT, allowing programmatic control of nodes, parameters, and execution of Python scripts. It is for developers and AI agents that need to automate or control TouchDesigner workflows.
- Create, modify, and delete nodes in a TouchDesigner project via AI agent commands.
- Query node properties, parameters, and project structure to understand the current state of a TouchDesigner network.
- Execute Python scripts and call node methods to automate TouchDesigner operations based on AI agent logic.
Tools this server exposes
| Tool | Does |
|---|---|
| create_td_node | Creates a new node in TouchDesigner. |
| delete_td_node | Deletes an existing node from TouchDesigner. |
| describe_td_tools | Generates a manifest of available TouchDesigner tools. |
| exec_node_method | Calls a Python method on a TouchDesigner node. |
| execute_python_script | Executes an arbitrary Python script in TouchDesigner. |
| get_td_class_details | Gets details of a TouchDesigner Python class or module. |
| get_td_classes | Gets a list of TouchDesigner Python classes. |
| get_td_info | Gets information about the TouchDesigner server environment. |
| get_td_module_help | Gets Python help() documentation for TouchDesigner modules or classes. |
| get_td_node_errors | Checks for errors on a node and its children. |
| get_td_node_parameters | Gets the parameters of a specific node. |
| get_td_nodes | Gets nodes under a parent path with optional filtering. |
| get_top_image | Captures the current output of a TOP node as an image. |
| update_td_node_parameters | Updates the parameters of a specific node. |
Before you enable it
An MCP server runs with whatever access you give it. Start with a development account rather than production, and check which tools the server exposes before you let an agent call them unattended.