TouchDesigner Plugin for Hermes Agent

Hermes plugin from Nous Research that drives TouchDesigner through the twozero MCP server

What TouchDesigner Plugin does

The package follows the Agent Plugins v1 format and ships two things. An mcp.json registers the twozero MCP server entry, named td, for every session while the plugin is enabled, so no mcp_servers edits in config.yaml are needed. A skills/touchdesigner-mcp folder holds the workflow skill with critical rules, discovery steps, more than 20 reference files covering operators, GLSL, audio-reactive work, instancing and pitfalls, and a scripts/setup.sh health check.

twozero is a free plugin from 404.zero that embeds an MCP server inside the running TouchDesigner process, served over Streamable HTTP on 127.0.0.1:40404. The manifest name is kept short as td so every tool name stays at or under 60 characters, below the 64-character function-name cap on OpenAI-compatible and Bedrock formats. All 36 twozero tools register. The README warns that td_execute_python runs arbitrary Python inside TouchDesigner with no sandbox, and the hub is localhost-only and unauthenticated. Desktop input tools and admin tools are documented as opt-in.

Key features

Registers the twozero MCP server automatically while the plugin is enabled
Bundles the touchdesigner-mcp skill with 20+ reference files
All 36 twozero tools available to the agent
scripts/setup.sh health check and a curl test of the local endpoint
Input-automation and admin tools marked opt-in in the skill

When to use it

Building and editing TouchDesigner networks by describing them to the agent
Writing GLSL or audio-reactive setups with guidance from the bundled references
Moving from the older bundled touchdesigner-mcp skill to the plugin

Who it is for: TouchDesigner users who want Hermes Agent to build and modify live projects.

How it fits with Hermes Agent

It is a plugin for Hermes Agent published under the NousResearch organization, installed from the Hermes plugin catalog by name.

How to install TouchDesigner Plugin

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

hermes plugins install touchdesigner
hermes plugins enable td

Requirements: TouchDesigner 2025.32280 or newer on Windows or macOS, with twozero.tox installed and the MCP auto start setting turned on

FAQ

What is TouchDesigner Plugin?

TouchDesigner Plugin is a Hermes Agent plugin that connects the agent to a running TouchDesigner session through the twozero MCP server. It also includes a workflow skill for TouchDesigner.

Does TouchDesigner Plugin work with Hermes Agent?

Yes, it is a Hermes Agent plugin installed with hermes plugins install touchdesigner and enabled as td. Start TouchDesigner first, then open a new Hermes session.

What do I need to run TouchDesigner Plugin?

You need TouchDesigner 2025.32280 or newer on Windows or macOS, and the free twozero.tox plugin installed with MCP auto start set to yes. The MCP endpoint listens locally on port 40404.