diff --git a/optional-mcps/touchdesigner/manifest.yaml b/optional-mcps/touchdesigner/manifest.yaml
index 41297dabad9..ef5067bbd8f 100644
--- a/optional-mcps/touchdesigner/manifest.yaml
+++ b/optional-mcps/touchdesigner/manifest.yaml
@@ -70,7 +70,13 @@ tools:
 
 post_install: |
   This entry connects to the twozero plugin's MCP server, which runs INSIDE
-  TouchDesigner (2025.32280+). One-time setup in TD:
+  TouchDesigner (2025.32280+). TouchDesigner is Windows/macOS only — there is
+  no Linux build. On a Linux Hermes host, TD must run on another machine:
+  make twozero's port reachable from Hermes (it binds localhost, so forward
+  it on the TD machine) and edit the url in mcp_servers.touchdesigner to
+  point at that machine's IP.
+
+  One-time setup in TD:
 
     1. Download https://www.404zero.com/pisang/twozero.tox
     2. Drag twozero.tox into the TD network editor and click Install.
diff --git a/skills/creative/touchdesigner-mcp/SKILL.md b/skills/creative/touchdesigner-mcp/SKILL.md
index 57d09858d47..1d2623a351c 100644
--- a/skills/creative/touchdesigner-mcp/SKILL.md
+++ b/skills/creative/touchdesigner-mcp/SKILL.md
@@ -4,7 +4,7 @@ description: "Control a running TouchDesigner instance via twozero MCP — creat
 version: 1.2.0
 author: kshitijk4poor
 license: MIT
-platforms: [linux, macos, windows]
+platforms: [macos, windows]
 metadata:
   hermes:
     tags: [TouchDesigner, MCP, twozero, creative-coding, real-time-visuals, generative-art, audio-reactive, VJ, installation, GLSL]
@@ -28,7 +28,15 @@ metadata:
 Hermes Agent -> MCP (Streamable HTTP) -> twozero.tox (port 40404) -> TD Python
 ```
 
+**TouchDesigner runs on Windows and macOS only — there is no Linux build**, so
+the standard localhost workflow cannot work on Linux. (A Hermes host can still
+drive TD on ANOTHER machine by pointing the `mcp_servers.touchdesigner` url at
+that machine's IP, but TD itself must live on Windows/macOS and twozero binds
+localhost by default — the TD machine has to forward the port.)
+
 36 native tools. Free plugin (no payment/license — confirmed April 2026).
+TouchDesigner Non-Commercial is free too (requires a free derivative.ca
+account to activate).
 Context-aware (knows selected OP, current network).
 Hub health check: `GET http://localhost:40404/mcp` returns JSON with instance PID, project name, TD version.
 
diff --git a/website/docs/user-guide/skills/bundled/creative/creative-touchdesigner-mcp.md b/website/docs/user-guide/skills/bundled/creative/creative-touchdesigner-mcp.md
index 0d6fb70b0dd..3b0b60061a3 100644
--- a/website/docs/user-guide/skills/bundled/creative/creative-touchdesigner-mcp.md
+++ b/website/docs/user-guide/skills/bundled/creative/creative-touchdesigner-mcp.md
@@ -19,7 +19,7 @@ Control a running TouchDesigner instance via twozero MCP — create operators, s
 | Version | `1.2.0` |
 | Author | kshitijk4poor |
 | License | MIT |
-| Platforms | linux, macos, windows |
+| Platforms | macos, windows |
 | Tags | `TouchDesigner`, `MCP`, `twozero`, `creative-coding`, `real-time-visuals`, `generative-art`, `audio-reactive`, `VJ`, `installation`, `GLSL` |
 | Related skills | `native-mcp`, [`ascii-video`](/docs/user-guide/skills/bundled/creative/creative-ascii-video), [`manim-video`](/docs/user-guide/skills/bundled/creative/creative-manim-video), `hermes-video` |
 
@@ -45,7 +45,15 @@ The following is the complete skill definition that Hermes loads when this skill
 Hermes Agent -> MCP (Streamable HTTP) -> twozero.tox (port 40404) -> TD Python
 ```
 
+**TouchDesigner runs on Windows and macOS only — there is no Linux build**, so
+the standard localhost workflow cannot work on Linux. (A Hermes host can still
+drive TD on ANOTHER machine by pointing the `mcp_servers.touchdesigner` url at
+that machine's IP, but TD itself must live on Windows/macOS and twozero binds
+localhost by default — the TD machine has to forward the port.)
+
 36 native tools. Free plugin (no payment/license — confirmed April 2026).
+TouchDesigner Non-Commercial is free too (requires a free derivative.ca
+account to activate).
 Context-aware (knows selected OP, current network).
 Hub health check: `GET http://localhost:40404/mcp` returns JSON with instance PID, project name, TD version.