TouchDesigner MCP Server
A powerful Model Context Protocol (MCP) server that brings comprehensive TouchDesigner operator documentation, Python API references, and tutorials directly to your AI coding assistant.
Power your agent
पब्लिशर का इंस्टॉल। PlugMCP एंडपॉइंट नहीं।
Host a copy with our keys and logs.
रजिस्ट्री में अभी कोई पैकेज्ड रिलीज़ नहीं है। रिपॉज़िटरी का README देखें.
रिमोट URL या आपकी मशीन पर कमांड? दोनों इंस्टॉल में क्या अंतर है
PlugMCP पर चलाएँ
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
लॉन्चपब्लिशर से
A powerful Model Context Protocol (MCP) server that brings comprehensive TouchDesigner operator documentation, Python API references, and tutorials directly to your AI coding assistant.
TouchDesigner Documentation MCP Server v2.6.1 - FIXED Python API tools! Features 629 operators + 14 tutorials + 69 Python API classes with working get_python_api & search_python_api tools. Zero-configuration setup for VS Code/Codium.
I personally use it with VS Code/Codium and the Roo Code Extension alongside my favorite LLMs like Claude Opus and GPT-5. While the server should theoretically work with other applications like Docker or Claude Desktop, I haven't thoroughly tested those integrations yet.
The Story So Far: The catalyst for this project was simple -- A few months ago I decided I wanted an AI tool that could develop visuals in TouchDesigner for me. I've been making some basic things in TD for awhile but it has one of the steepest learning curves of any creative software I've ever used. How nice would it be just to ask an LLM "Please make a 720p, animated in realtime, constantly evolving, reaction diffusion simulation in TouchDesigner." and then just have it spit one out? Super duper nice is the answer in my opinion.
Like every project I undertake where I know very little, I thought it would be pretty straight forward! LOL! When I started I had no idea just how much time and tokens I would end up sinking into this one. And I still have a ways to go before I consider it complete with full integration into TouchDesigner itself and very little margin of error.
However as far as querying information about operators and their parameters goes -- it works pretty darn well! The major challenge I face with getting any LLM to use this tool effectively for developing networks with real complexity is that the models tend to forget to use the MCP server and fall back on their outdated trained knowledge of much older TouchDesigner versions. If anyone has suggestions on how to overcome this particular wrinkle, I'd absolutely love to hear your feedback!
Right now, I'm focused on ensuring the server returns useful and accurate Python API information. Here's my workflow: I describe the network I want to create -- for example, a reaction diffusion visualization -- and then ask the AI to write a Python script that generates the network inside TouchDesigner using the textport. Once that's complete, I get an 'exec' command that lets me copy and paste just one line into the textport, and voila -- a network is generated!
My ultimate dream, however, is full integration directly into TouchDesigner itself. I experimented with a web server and WebSocket approach, which sort of worked, but since the LLMs I was testing weren't generating correct Python code and kept hallucinating information while not utilizing the MCP server to its fullest potential, I've temporarily shelved this part of the project. Once it's working reliably and generating solid visualizations or networks, then full integration will be the final step!
Current with TouchDesigner 2025 (latest official build 2025.32820, bundled Python 3.11.10) and the 2025.30000 experimental series (Python 3.11.10). POPs (Point Operators) are the flagship new operator family in the 2025 release — the first new operator family in over a decade.
npm install -g @bottobot/td-mcp
npm install @bottobot/td-mcp
Install the MCP server globally:
npm install -g @bottobot/td-mcp
Configure Claude/MCP in VS Code: Add the server to your MCP settings configuration file:
{
"td-mcp": {
"command": "npx",
"args": ["@bottobot/td-mcp"]
}
}
Start using TouchDesigner tools in your conversations with Claude!
# If installed globally
td-mcp
# If installed locally
npx @bottobot/td-mcp
Get comprehensive details about a specific TouchDesigner operator including all parameters, tips, and code examples.
Example: "Get detailed information about the Noise CHOP operator"
Example: "Get the Engine COMP documentation for TD 2022"
Search for operators using contextual analysis and relevance ranking.
Example: "Search for audio processing operators in the CHOP category"
Example: "Find operators added in TD 2022"
List available TouchDesigner operators with optional category filtering.
Example: "List all TOP operators"
Compare two operators side by side -- parameters, categories, shared/unique features.
Example: "Compare Blur TOP with Luma Blur TOP"
Get Python code examples, expressions, and usage patterns for a specific operator.
Example: "Get Python examples for Movie File In TOP"
Get workflow suggestions for what operators commonly follow the current operator.
Example: "What operators typically follow a Movie File In TOP?"
Access detailed TouchDesigner tutorial content with full sections, code, and links.
Example: "Get the 'Write a GLSL TOP' tutorial"
List all available TouchDesigner tutorials with optional filtering.
Example: "List all available tutorials"
Search through tutorial content by keyword, topic, or content.
Example: "Search tutorials for GLSL shader examples"
Get documentation for a TouchDesigner Python class including members and methods.
Example: "Get Python documentation for the CHOP class"
Example: "Get Python API for the App class as of TD 2021"
Search across TouchDesigner Python classes, methods, and members.
Example: "Search Python API for audio methods"
Example: "Find Python API methods available in TD 2020"
List all available Python API classes grouped by category.
Example: "List all Python API classes in the Operator category"
Get detailed information about a specific TouchDesigner stable release: which Python version it bundles, new operators introduced, key features, Python API additions, and breaking changes.
Example: "What Python version does TouchDesigner 2025 use?"
Example: "What operators were added in TouchDesigner 2025?"
List all supported TD versions (099, 2019, 2020, 2021, 2022, 2023, 2025) with a quick-reference table showing the bundled Python version and support status for each release, plus the full Python version timeline.
Example: "List all supported TouchDesigner versions"
Example: "Show the Python version timeline for TouchDesigner"
Browse a curated library of advanced TouchDesigner techniques by category. Returns descriptions, difficulty ratings, version requirements, operator chains, uniform tables, and full working code snippets.
Example: "Show me GLSL raymarching techniques in TouchDesigner"
Example: "Get GPU compute techniques using numpy"
Available Categories:
Full-text search across all 7 experimental technique categories. Results ranked by weighted field scoring (name, tags, description, notes, code).
Example: "Search experimental techniques for reaction diffusion"
Example: "Find GPU instancing examples in the experimental library"
Retrieve a specific named GLSL pattern with complete, paste-ready shader code. Covers 16
named patterns across raymarching, reaction-diffusion, feedback, procedural noise, cellular
automata, and GPU particle simulation. Also provides three reusable GLSL utility libraries.
Use pattern: "list" to enumerate all available patterns.
Example: "Get the raymarching GLSL pattern"
Example: "List all available GLSL patterns"
Example: "Get the reaction diffusion shader pattern"
Get a wiring guide for a specific operator: what operators typically connect upstream as inputs and downstream as outputs, with exact port numbers, rationale, and workflow pattern names. Covers 20+ common operators across all families.
Example: "What connects to and from a Render TOP?"
Example: "Show me the typical connections for a Noise CHOP"
Return a complete, ready-to-use network template for a common TouchDesigner use case.
Each template includes an operator list, a port-level connection table, parameter settings,
and a ready-to-paste Python script that builds the network. Use template: "list" to see
all available templates.
Available Templates:
Example: "Give me a network template for audio-reactive visuals"
Example: "List all available network templates"
TouchDesigner ships two parallel release tracks: stable releases (the official line went 099 → 2019 → 2020 → 2021 → 2022 → 2023 → 2025; there was never an official TD 2024) and experimental/beta build series with unreleased features. These tools give you full access to the experimental track.
Get detailed information about a specific experimental TD build series or the latest experimental series.
Example: "What new features are in the latest experimental TouchDesigner build?"
Example: "Get breaking changes for experimental series 2025.30000"
List recent experimental TD build series grouped by feature area (rendering, Python API, operators, UI, networking).
Example: "List experimental TD builds with rendering changes"
Example: "Which experimental build series introduced POPs?"
Tracked Experimental Series:
Both series are sourced from the live Derivative release notes (provenance recorded in
wiki/data/versions/experimental-builds.json). The 2025.30000 series led into the official
2025 release; the 2021 experimental build first moved TouchDesigner to Vulkan, which became
the default in the 2022 release.
The server includes documentation for 214 Python API classes with 1,674+ methods covering:
The TD-MCP server is built with:
td-mcp/
├── index.js # Main MCP server entry point (21 tools)
├── tools/ # MCP tool implementations (21 tools)
│ ├── get_operator.js # Full operator documentation
│ ├── search_operators.js # Operator search with ranking
│ ├── suggest_workflow.js # Workflow chain suggestions
│ ├── list_operators.js # List/filter operators
│ ├── get_tutorial.js # Tutorial content access
│ ├── list_tutorials.js # Tutorial listing
│ ├── search_tutorials.js # Tutorial content search
│ ├── get_python_api.js # Python class documentation
│ ├── search_python_api.js # Python API search
│ ├── list_python_classes.js # Python class browsing
│ ├── get_operator_examples.js # Code examples per operator
│ ├── compare_operators.js # Side-by-side comparison
│ ├── get_version_info.js # Stable version details
│ ├── list_versions.js # All stable versions
│ ├── get_experimental_techniques.js # Advanced technique library
│ ├── search_experimental.js # Search techniques
│ ├── get_glsl_pattern.js # Named GLSL shader patterns
│ ├── get_operator_connections.js # Operator wiring guide
│ ├── get_network_template.js # Full network templates
│ ├── get_experimental_build.js # Experimental build series details
│ └── list_experimental_builds.js # List experimental series by area
├── wiki/ # Documentation system
│ ├── data/
│ │ ├── processed/ # 661 operator JSON files
│ │ ├── tutorials/ # 14 tutorial JSON files
│ │ ├── python-api/ # 214 Python class JSON files
│ │ ├── experimental/ # 7 advanced technique JSON files
│ │ └── versions/ # Version compatibility data
│ │ ├── version-manifest.json
│ │ ├── operator-compatibility.json
│ │ ├── python-api-compatibility.json
│ │ ├── release-highlights.json
│ │ └── experimental-builds.json # Experimental track data
│ ├── utils/
│ │ └── version-filter.js # Version utilities + experimental support
│ ├── operator-data-manager.js # Core documentation engine
│ └── operator-data-python-api.js # Python API data manager
├── data/
│ └── patterns.json # 32 workflow patterns + transitions
├── scripts/ # Data maintenance scripts
│ ├── clean-operator-data.js # Clean parameter descriptions
│ └── enrich-top-operators.js # Add tips/examples to operators
└── package.json
node --versionnpm install -g @bottobot/td-mcpparameter_search to search within parameter namesNoise CHOP not just Noisesearch_operators first to find the exact namelist_operators with a category filter to browse available operatorsget_operator before generating codeTo contribute or modify the server:
# Clone the repository
git clone https://github.com/bottobot/touchdesigner-mcp-server.git
# Install dependencies
cd touchdesigner-mcp-server
npm install
# Run the server locally
node index.js
# Validate syntax
node --check index.js
# Clean operator data (removes HTML dumps from parameter descriptions)
node scripts/clean-operator-data.js
# Enrich top operators with tips and examples
node scripts/enrich-top-operators.js
tools/ following the existing pattern (export schema and handler)index.jsOperator data lives in wiki/data/processed/ as JSON files. Each file follows the schema with fields: id, name, displayName, category, subcategory, description, parameters, tips, warnings, pythonExamples, codeExamples, and version.
MIT License - See LICENSE file for details.
Current Version: 3.0.0 Operators: 661 (CHOP 170, TOP 147, SOP 113, POP 102, DAT 75, COMP 41, MAT 13) Tutorials: 14 Python API Classes: 214 MCP Tools: 21 Workflow Patterns: 32 TouchDesigner Currency: 2025 official (build 2025.32820, Python 3.11.10) + 2025.30000 experimental Last Updated: June 2026
TouchDesigner Documentation MCP Server v2.6.1 - FIXED Python API tools! Features 629 operators + 14 tutorials + 69 Python API classes with working get_python_api & search_python_api tools. Zero-config
ओवरव्यू
TouchDesigner Documentation MCP Server v2.6.1 - FIXED Python API tools! Features 629 operators + 14 tutorials + 69 Python API classes with working get_python_api & search_python_api tools. Zero-configuration setup for VS Code/Codium.
टूल
अभी टूल सूची नहीं है। रिमोट सर्वर को पहले हेल्थ चेक के बाद सूची मिलती है।
FAQ
इस पेज पर Cursor, Claude Desktop, Claude Code या VS Code के लिए stdio कॉन्फ़िग कॉपी करें। यह पब्लिशर का इंस्टॉल इस्तेमाल करता है, PlugMCP प्रॉक्सी नहीं।
इस रिकॉर्ड में कोई ज़रूरी एनवायरनमेंट वेरिएबल दर्ज नहीं है।
Touchdesigner stdio पर लोकल चलता है।
पिछली जाँच 2026-10-27 को हुई। TouchDesigner Documentation MCP Server v2.6.1 - FIXED Python API tools! Features 629 operators + 14 tutorials + 69 Python API classes with working get_python_api & search_python_api tools. Zero-configuration setup for VS Code/Codium.