tdmcp — TouchDesigner MCP server MCP Policy · 334 Tools

POLICY

How to control tdmcp — TouchDesigner MCP server

PolicyLayer is an MCP gateway — it sits between your AI agents and tdmcp — TouchDesigner MCP server, and nothing reaches the server without passing your rules. These are the rules we recommend:

Deny destructive operations

{
  "delete_td_node": {
    "deny_if": [
      {
        "conditions": [],
        "on_deny": "Blocked by default. Requires approval."
      }
    ]
  }
}

Destructive tools should never be available to autonomous agents without human approval.

Rate limit write operations

{
  "add_custom_parameters": {
    "limits": [
      {
        "counter": "add_custom_parameters_per_hour",
        "window": "hour",
        "max": 30,
        "scope": "grant"
      }
    ]
  }
}

Prevents bulk unintended modifications from agents caught in loops.

Cap read operations

{
  "analyze_project": {
    "limits": [
      {
        "counter": "analyze_project_per_minute",
        "window": "minute",
        "max": 60,
        "scope": "grant"
      }
    ]
  }
}

Controls API costs and prevents retry loops from exhausting upstream rate limits.

Create a free account and register tdmcp — TouchDesigner MCP server — nothing to install.
Add these rules — paste them, or build them visually. Tune the limits to your setup.
Point your MCP client (Claude, Cursor, anything) at your gateway URL.

ENFORCE POLICY ON TDMCP — TOUCHDESIGNER →

Instant setup, no code required.

FULL CATALOGUE

All 334 tdmcp — TouchDesigner MCP server tools

DESTRUCTIVE 4 tools

Destructive delete_td_node DESTRUCTIVE: permanently remove one node from the project by path (a COMP also takes its children with it); th Destructive manage_checkpoint Store / restore / list / delete a full snapshot of a sub-network — an Destructive refresh_asset_previews Capture fresh preview PNG assets from one or more live TOP nodes and write them to disk. Use it to regenerate Destructive repair_network Bounded, autonomous repair: scan cook errors under a subtree, classify each, and plan a safe fix, capped at ma

EXECUTE 54 tools

Execute apply_glsl_top_mapping Build a self-contained GLSL TOP network from a pre-translated mapping (fragment + uniforms + channels + contro Execute audio_fingerprint_to_visual Sample a few seconds of audio inside TouchDesigner, compute a 4-feature fingerprint (tempo, spectral centroid, Execute auto_repair_loop Driver: scan a subtree for cook errors, cluster them, route each cluster to the right fix (calls repair_networ Execute batch_operations Run an ordered list of create / connect / setParam operations in one call (fail-forward, per-operation warning Execute build_chop_chain Declarative Layer-2 builder for an ordered CHOP processing chain. Pass an Execute build_pop_chain Declarative Layer-2 builder for an ordered POP (Point OPerator) chain. Execute build_sop_geometry Declarative Layer-2 builder for an ordered SOP geometry chain. Pass an Execute connect_daydream_cloud Create a Daydream cloud-hosted StreamDiffusion bridge in TD. Execute control_timeline_transport Drive the TouchDesigner project timeline: play, pause, seek to a frame, jump to a named cue, or set playback r Execute create_ai_mirror Layer 1 COMBO: wires the canonical 2026 AI-mirror installation in one MCP call — camera (or synthetic / existi Execute create_body_bubbles Create a MediaPipe-ready interactive bubble installation over the live camera: a detected open palm emits soap Execute create_cue_sequencer Build a bar-quantized cue timeline: a Beat CHOP (on the global tempo) + a CHOP Execute DAT that, on each bar ( Execute create_depth_pop_field Build a depth-driven GPU POP scatter field: consumes a depth/mask TOP and uses Execute create_energy_structure [experimental] Build a song-structure (build / drop / breakdown) edge detector COMP with adaptive thresholds. Execute create_engine_comp Drop a TouchDesigner Engine COMP that loads an external .tox in a separate TD subprocess — Execute create_gpu_particle_field Build a high-count GPU particle / point field: position and velocity are simulated entirely on the GPU in two Execute create_growth_system Build an L-system / vine-growth generator: a Script SOP iterates a context-free rewriting grammar from Execute create_interactive_projection_mapping Build a synthetic-safe interactive projection mapping rig for a USB webcam plus projector: camera/synthetic/ex Execute create_led_mapper Pixel-map a source TOP onto an LED fixture layout and send per-pixel colors out as DMX over Art-Net/sACN. Resi Execute create_llm_chain Stand up a prompt → response LLM chain inside TouchDesigner as a self-contained baseCOMP. Execute create_panic Build a live-performance safety control — the Execute create_particle_flock Build a boids-style GPU particle flock: position and velocity are simulated entirely on the GPU in two RGBA32f Execute create_phrase_locked_cue_engine Build a DJ/VJ phrase-quantized cue-lock engine. Any incoming pulse CHOP (Button, MIDI In, OSC In, composeCueLi Execute create_sdf_field Build a programmable signed-distance-field (SDF) raymarcher in TouchDesigner as a self-contained GLSL TOP. Com Execute create_set_navigator Build a hands-light stage navigator (the QLab model) for stepping through an ordered scene/cue list: Next / Pr Execute create_setlist_runner Layer-1 wall-clock setlist player for rehearsed VJ shows. Pass Execute create_shader_park Compile Shader Park JavaScript sculpture code with shader-park-core and instantiate it as a self-contained Tou Execute create_show_failover Build a live-show watchdog: a Switch TOP (blend=1 cross-dissolve) between a primary source TOP (NDI/camera/Spo Execute create_sidechain_pump EXPERIMENTAL — One-call Execute create_simulation Build a GPU simulation: Execute create_text_crawl Build a multi-line animated text crawl / ticker / credits roll / typewriter reveal inside a self-contained bas Execute create_visual_system Create a complete visual system from a natural-language description. Classifies intent (audio-reactive, partic Execute detect_pitch EXPERIMENTAL monophonic pitch tracker. Estimates the dominant musical pitch of live audio and exposes pitch_hz Execute drive_streamdiffusion Wraps the community StreamDiffusionTD.tox (by dotsimulate) into a one-shot Layer 1 setup: locate the .tox via Execute elicit_missing_args Use the schema + LLM to propose values for a tool call Execute enhance_build Run score_build, ask the configured LLM for up to N allowlisted tool calls that would raise the weakest sub-sc Execute exec_node_method Escape hatch — invoke an arbitrary Python method on a node (operator). Prefer structured tools where one exist Execute execute_python_script Escape hatch — run an arbitrary Python script inside the TouchDesigner process. Prefer the structured tools (f Execute image_to_particles Turn any image (a file path or an existing TOP) into a GPU particle field: each particle Execute import_shadertoy Build a GLSL TOP from a Shadertoy URL, ID, or pasted source. Wires iChannels (defaulting to noise placeholders Execute install_library_package Install a local package folder, zip, tox, or manifest into a local tdmcp package directory. Execute moodboard_to_system Ingest 1..6 moodboard images and build a matching generative system in TouchDesigner. Uses the vision-capable Execute optimize_performance Scan a network for cook-time bottlenecks and (optionally) fix them. By default it reports the slowest nodes wi Execute rebuild_network Reconstruct a live network inside a COMP from a serialize_network spec — the REBUILD half of a git-diffable ro Execute reload_bridge Hot-reload the bridge Execute run_macro_script Replay a Execute set_perform_mode Toggle perform mode — the one switch the artist flips before going live. Execute setup_body_tracking One-shot body tracking from a webcam: loads the free mediapipe-touchdesigner ENGINE (install it first with Execute setup_face_tracking One-shot face-landmark tracking from a webcam: loads the MediaPipe ENGINE (install first with Execute setup_hand_tracking One-shot MediaPipe hand tracking from a webcam: loads the mediapipe-touchdesigner ENGINE (install with Execute setup_segmentation One-shot selfie segmentation via the MediaPipe TouchDesigner engine (install with Execute setup_tdableton Wire up an Ableton Live bridge inside a tdmcp-managed container. Auto mode probes Execute tutorial_companion_pack Build a teaching/selling companion for a network: snapshot the COMP Execute vault_repo_sync Read-mostly git wrapper for the configured Obsidian vault directory.

WRITE 205 tools

Write add_custom_parameters Append a custom-parameter page (knobs, sliders, toggles, menus, pulses, RGB, XYZ) to a COMP so a generated net Write animate_parameter Drive one or more node parameters over time with an LFO (sine/triangle/ramp/square/pulse/random). Creates an L Write apply_lut Apply a colour Look-Up Table (LUT) to an existing TOP inside a self-contained Write apply_post_processing Chain post-processing effects (bloom, glitch, rgb_split, vignette, etc.) onto an existing TOP, applied in the Write apply_recipe Instantiate a built-in recipe by id (from list_recipes) inside a COMP — a tested, ready-made network you can b Write arrange_network Tidy an existing network: reposition a COMP Write attach_docs_as_assets Copy documentation files into a package and register them in its manifest Write author_script_operator Scaffold a Script CHOP/DAT/SOP/TOP with a ready-to-edit onCook(scriptOp) stub and optional custom parameters. Write auto_tag_library_asset Inspect a captured library asset (a vault recipe/component note, or a live TD COMP) and emit a suggested tag s Write bind_audio_reactive Make a whole COMP react to the music in one call — the core VJ move. Point Write bind_to_channel Drive one or more node parameters from a CHOP channel by expression — the link that makes a visual react. Poin Write bind_vault_text CREATE a Text DAT in TouchDesigner whose Write capture_to_vault Captures a preview still from a TOP and appends it to a dated gallery note in the Obsidian vault, building a v Write collect_project_assets Scan a COMP subtree for every external file dependency (movie/image file pars, fonts, LUTs, externaltox links) Write component_changelog_trail Maintains an append-only per-component revision history as a JSONL trail Write compose_cue_list Turn a natural-language show description into a validated cue list (SetlistSchema, scenes[] variant). Uses the Write connect_comfyui Bridge a running ComfyUI server: drops the TDComfyUI .tox if installed, otherwise builds a stock webclientDAT Write connect_nodes Wire one node Write create_3d_audio_reactive Build a 3D scene that reacts to sound — the 3D counterpart of create_audio_reactive (use that for a 2D spectru Write create_3d_scene Build a renderable 3D scene: a Geometry COMP holding the chosen primitive (sphere/box/grid), a Camera, a Light Write create_ascii_render Turn any TOP into a character-grid ASCII render: quantise input luminance into a (W/cell × H/cell) grid, then Write create_audio_glsl_uniforms Writes CHOP-reference expressions onto the seq.vec uniform slots of an existing glslTOP, so named channels (lo Write create_audio_reactive Build an audio analysis chain (spectrum + level + optional beat) and a spectrum visual driven by it. Creates a Write create_auto_montage Point at a folder and build a self-running clip montage: scans the folder for clips/stills, builds one Movie F Write create_automation_lane Build a per-parameter automation lane that records a live parameter sweep into a circular buffer over N bars, Write create_autopilot Build a beat-driven auto-VJ: a Beat CHOP + a CHOP Execute DAT that, every N beats, either randomizes a target Write create_band_router Split an audio signal into EQ bands and route each band to its own target parameter(s) — the musician-friendly Write create_beat_grid_sequencer Build a programmable step-grid sequencer driven by a Beat CHOP on the global TD tempo: a Table DAT holds the p Write create_blob_reactive Build a blob-position-tracking chain that drives parameters from the POSITIONS of multiple objects/hands in a Write create_body_reactive Build a body-reactive visual driven by full-body pose tracking: glowing marks that follow the 33 landmarks (he Write create_capture_loop Build a bidirectional inter-app video bridge to another program (Resolume, OBS, MadMapper, a game engine…) in Write create_chop_recorder Build a CHOP recorder/player container that captures a source CHOP Write create_chroma_reactive [experimental] Builds a 12-channel pitch-class chroma vector (chroma_0..chroma_11) from an audio bus via FFT b Write create_chrome_blobs Builds a liquid-chrome / Y2K metaball generator: an animated Noise TOP (or external source) is blurred, thresh Write create_clip_launcher Build an Ableton-style clip launcher: a grid panel (Container COMP) of clip buttons, one per named cue (from m Write create_color_grade Build a colour-grading / LUT finishing stage over a source — the Write create_color_wheels Classic colour-grading wheels — three tinted Level TOPs run in series for shadows (lift, gamma-biased), midton Write create_container Create one empty COMP under parent_path to hold a visual system, then tile it into the parent Write create_control_panel Expose live controls on a COMP: append custom parameters (sliders, toggles, menus, RGB, pulse) and bind them t Write create_control_surface Build a playable performance panel (a Container COMP of visual widgets) for live use, beyond the parameter dia Write create_cubemap_dome Render a true cube-map dome master — the higher-fidelity follow-up to create_dome_output (which only warps a f Write create_data_reactive Wire arbitrary external data (weather, follower count, sensor readings, OSC values) onto a COMP Write create_data_source Ingest live external data onto a binding-ready channel/table — the input counterpart to create_data_visualizat Write create_data_source_http_ws Advanced live-data ingest for HTTP polling and WebSocket streams — the richer-transport sibling of create_data Write create_data_visualization Build a data-driven visualization: a data source feeds a CHOP that drives a chart TOP. Creates a new baseCOMP Write create_datamosh Build a datamosh (broken-codec / time-echo / ghost-trail) visual effect network in one call. Three modes: Write create_decks Build a DJ-style VJ mixer. Without decks[], it preserves the legacy A/B Cross TOP mixer with GainA/GainB contr Write create_depth_displacement Push a flat plane into real 3D relief by a depth/luminance map: a subdivided grid whose vertices are offset al Write create_depth_from_2d Wraps TDDepthAnything v2 (community TOX by IntentDev) to convert any 2D image/video TOP into a depth map TOP u Write create_depth_silhouette Extract a silhouette / body mask from a depth or video source — a person Write create_displacement_warp Build a displacement-warp stage over a source — the Write create_dither Build a retro dither effect: ordered Bayer (2×2/4×4/8×8), checker, noise, or single-pass error-diffusion — qua Write create_dmx_fixture_pipeline Build a DMX/Art-Net (or sACN) output chain from a fixture list. For each fixture (rgb, rgbw, par64, movingHead Write create_dome_output Remap a source TOP (treated as an equirectangular / panoramic master) into a square single-output dome master Write create_envelope_follower EXPERIMENTAL — Build a reactive signal-shaping chain (attack/release envelope + threshold gate or sidechain du Write create_euclidean_sequencer Build a Euclidean rhythm sequencer: given Write create_external_io Bridge TouchDesigner to the outside world: OSC/MIDI input (a control surface — bind incoming channels straight Write create_facade_mapping Build a multi-projector architectural facade rig: one source TOP fanned into N per-projector Write create_feedback_network Build a feedback-based visual system: a seed feeds a loop that is transformed (blur/displace/etc.) and fed bac Write create_feedback_tunnel Build a parameterized infinite-zoom/rotate feedback tunnel: a seed TOP is composited with its own fed-back, zo Write create_flow_abstraction Build a two-pass Kyprianidis-style flow abstraction: an edge-tangent-flow (ETF) bilateral smoother followed by Write create_fluid_sim Build a real-time 2D fluid/ink/dye simulation (stable-fluids style: semi-Lagrangian advection + Jacobi pressur Write create_gaussian_splat_scene Drops the community TDGS .tox by Anglerfish-graphics into a fresh baseCOMP, loads a Write create_generative_art Create an evolving generative visual. Creates a new baseCOMP under Write create_generative_audio SYNTHESIZE audio — generate sound rather than react to it. Builds an audio synthesis chain ending on a Null CH Write create_glitch Build a glitch / corrupted-signal visual: RGB channel split, noise-driven blocky/slice displacement and horizo Write create_glsl_material Create a GLSL MAT under parent_path for custom-shaded geometry. The pixel/vertex/(optional) geometry shader so Write create_glsl_shader Create a GLSL TOP under parent_path that renders a custom fragment shader (and optional vertex shader). The sh Write create_halftone Build a print/comic print-look effect: halftone dots, CMYK colour separation, ordered dithering, or posterized Write create_hand_ableton_mapper Build a MediaPipe-hands to TDAbleton TDA_Mapper performance control network. It outputs map1=left pinch, map2= Write create_hand_gesture_bus Build a stable MediaPipe-hands gesture bus for palm holograms, lasers, audio controls, and other hand-reactive Write create_hand_hologram Build a palm-anchored hologram visual driven by create_hand_gesture_bus. Defaults to a synthetic previewable h Write create_histogram_scope Build a luminance (and optional per-channel RGB) histogram video scope for any TOP. Computes the histogram on Write create_jfa_voronoi Instantiate a self-contained Jump-Flooding-Algorithm Voronoi generator (stained-glass / cell pattern) as GLSL Write create_kaleidoscope Wrap a source in a kaleidoscope / radial-mirror symmetry effect — a signature VJ look. Folds the image into N Write create_keyer Composite a keyed performer, logo, or any source over a background visual — the green-screen / chroma-key / ma Write create_keyframe_animation Animate parameters along a keyframed curve synced to the timeline — structured motion beyond animate_parameter Write create_kinect_wall_harp Build a synthetic-safe Kinect v2 / FreenectTD projected wall harp in an isolated Base COMP. The network can cr Write create_kinetic_text Build a self-contained animated / kinetic typography layer — a word or line that flashes, pulses, or slides, t Write create_layer_mixer Build a VJ-style layer mixer: combine source TOPs into one output. Creates a new baseCOMP under Write create_layer_stack Build a VJ-style N-layer compositor: stack 2–8 source TOPs and composite them bottom-up, each layer with its o Write create_live_source Build a self-contained source COMP that ingests an external feed — screen grab, NDI, Syphon/Spout, camera, or Write create_look_bank A playable snapshot row: store N named Write create_macro Add one macro knob (a 0–1 custom parameter) to a COMP that drives many parameters at once, each remapped into Write create_media_bin Point at a folder on the TouchDesigner machine and build a clip BIN inside a new bin COMP: it scans the folder Write create_mesh_warp Map a source TOP onto a curved or irregular surface via a deformable textured grid — the curved-surface upgrad Write create_midi_map HARDWARE-GATED SCAFFOLD. Build a MIDI controller preset for a supported device Write create_midi_note_reactive Build a MIDI note → per-note trigger/velocity chain that exposes bindable channels Write create_modulators Build a bank of N BPM-synced LFOs in one self-contained container — each an oscillator (sine/triangle/saw/squa Write create_motion_reactive Build a video-analysis chain that exposes ready-to-bind reactive channels — overall brightness plus frame-to-f Write create_multi_output Fan a master TOP across N projectors/displays: each output is a cropped slice (horizontal or vertical) resized Write create_node_chain Create multiple nodes and (optionally) connect them in sequence. Returns all created paths; on failure it stop Write create_npr_filter Apply a non-photorealistic painterly filter to an existing TOP. A generalized Kuwahara (sector-based local var Write create_optical_flow Build a CPU motion-energy field from a video source (cheap drop-in for displacement / particle chains; NOT a r Write create_palette Generate a reusable colour palette + gradient other tools can bind to. In Write create_particle_system Build a CPU particle system: an emitter SOP feeds a Particle SOP inside a Geometry COMP, rendered with a camer Write create_pbr_scene Build a physically-based 3D scene: a Geometry COMP holding the chosen primitive (sphere/torus/box) shaded by a Write create_phone_gesture Stream a phone Write create_phone_remote Serve a mobile-friendly web panel from a Web Server DAT so you can control a COMP Write create_pixel_sort Build a glitch-art pixel-sort effect that sorts pixels along rows or columns within Write create_point_cloud Render a point cloud from a depth/luminance map (or a synthetic source): scatter a resolution×resolution grid Write create_pop_field Build a GPU point field using TouchDesigner Write create_pop_geometry Procedural Op Pattern (POP) geometry generator: build a SOP chain inside a Geometry COMP — primitive (box/sphe Write create_pop_growth Build a POP-native reaction-diffusion / growth system inside a fresh baseCOMP. Write create_pop_lines_pointcloud Plexus-style line-web visual built on the POP family. A POP point cloud Write create_pop_particle_system Build a complete POP particle simulation (particle_pop → feedback_pop → Write create_pose_controlnet_driver Render a canonical OpenPose-colored stick figure TOP (per-limb RGB lines + per-joint colored discs on a black Write create_pose_reactive Body-pose binder parallel to bind_audio_reactive: take the 33-sample MediaPipe pose CHOP produced by setup_bod Write create_pose_skeleton Render a live stick-figure skeleton from full-body pose tracking — the classic MediaPipe body-tracking look: g Write create_pose_tracking Set up full-body pose tracking — the foundation for body-reactive visuals (the camera/skeleton counterpart to Write create_preset_morph Target-agnostic preset morph engine: snapshot any OP Write create_prob_sequencer Build a Markov-chain step sequencer. On each beat boundary the COMP transitions from the current state to a ne Write create_projection_mapping Wrap a source TOP in a Corner Pin warp for projection mapping: drag the four corner handles to line the image Write create_python_script Create one DAT under parent_path preloaded with your Python Write create_raymarch_scene Instantiate a self-contained GLSL TOP raymarcher (volumetric / signed-distance-field) — the 3D complement to c Write create_reaction_diffusion Build a Gray-Scott reaction-diffusion GPU simulation as a ready-to-use visual system. Write create_replicator Wire a Replicator COMP that clones a template COMP once per row of a Table DAT — TouchDesigner Write create_safety_blackout_chain Build a live-show safety primitive at the very end of the master output chain: deterministic fade-to-black ove Write create_scene_timeline Build a scrubbable show timeline: a single Timer-CHOP playhead drives ordered scenes that recall cues on a tar Write create_scheduler Build a Timer-CHOP scheduler COMP: one or more named timers (seconds or beats), each with an optional ordered Write create_shader_lib Instantiate a curated, ready-to-run full-screen GLSL shader (tunnel, raymarch_sphere, fractal, metaballs, plas Write create_shared_memory_bridge Create a Shared Memory In/Out TOP/CHOP for zero-copy IPC with another app on the same host (Notch, Unity, Unre Write create_slit_scan Build a slit-scan visual system: each row (or column) of the output samples a different past frame from a Cach Write create_spectrum Build an FFT audio-spectrum analyzer that exposes N separate, ready-to-bind frequency-bin channels (band0..ban Write create_stage_dashboard Serve one unified live-performance cockpit from a Web Server DAT — a single responsive web page (phone + lapto Write create_stipple_pointcloud Density-weighted particle scatter rendered as discrete points — a stippled / halftone-engraving Write create_strange_attractor Build a strange-attractor deferred geometry generator: a Script CHOP integrates a chosen ODE system (Lorenz / Write create_strobe Build a beat-syncable strobe / flash layer — a full-frame colour flash that pulses hard on/off, the signature Write create_td_node Create a single bare operator (node) inside a parent COMP — nothing is wired or laid out. Validates the operat Write create_tempo_sync Create a tempo clock (Beat CHOP driven by TouchDesigner Write create_test_pattern Generate a projector calibration / alignment source — a standalone test-pattern network Write create_text_3d Build a self-contained 3D text scene: a Text SOP generates the glyph outlines, an Extrude SOP gives them depth Write create_text_overlay Composite styled STATIC text over a visual (or on its own transparent background) — a Text TOP with font size, Write create_time_echo EXPERIMENTAL — Apply a per-pixel time effect to a source TOP: echo trails, slit-scan, or per-pixel time displa Write create_transient_reactive Layer-1 audio splitter: differences a fast and a slow envelope follower to expose two normalized 0..1 channels Write create_transition Build a parameterized A→B transition over a single 0–1 Progress knob — the executable core of VJ cutting. Crea Write create_two_way_surface Build a bidirectional OSC or MIDI control surface that drives TouchDesigner params from a controller AND echoe Write create_vector_lines Build a pulse-driven image-to-vector-lines system: capture a still frame from a synthetic, camera, file, or ex Write create_video_player Build a movie/clip player inside a new Write create_video_scopes Build a broadcast-style video engineering monitor with multiple scope panels: waveform (luma trace), RGB parad Write create_video_synth Instantiate an analog video-synthesizer pattern (lissajous oscillator curve, moving interference fringes, or C Write create_vintage_lens Drape a vintage analog-film aesthetic over any TOP in one call. Chains barrel/pincushion lens distortion → chr Write create_voxel_stack Isometric voxel-stack renderer driven by any TOP. Builds a single instanced Geometry COMP Write create_waveform Build a time-domain audio waveform / oscilloscope — the actual audio signal scrolling left-to-right as a movin Write create_xy_pad Build a draggable 2D (XY) gesture pad — a Container COMP whose pointer drag drives an x/y CHOP of normalized c Write curated_collection_pack Bundles a curated, hand-picked set of vault assets (recipes, components, looks, raw Write disconnect_nodes Remove one or more input wires from a node in TouchDesigner. By default removes every incoming wire into to_pa Write duplicate_network Copy a node or whole COMP (and all its contents) to a new node, placed in the source Write edit_dat_content Surgically replace a substring inside a Text or Table DAT Write export_look_tox Save a COMP as a Write export_palette_component Save a COMP as a .tox into TouchDesigner Write export_recipe_bundle Write selected recipes to a portable JSON bundle on disk. Use it to hand recipes to another machine or to CI; Write export_setlist_to_vault Serialize the current cues stored on a COMP (manage_cue snapshots, keyed Write export_sop_to_svg Walk a SOP Write extend_data_source_fabric Adds extra transports to the data-source fabric beyond create_data_source: Write generate_library_index Write one Markdown contact-sheet note of the whole vault library — recipes, shaders, presets, components, and Write generative_classics_pack Curated technique pack of canonical generative looks (feedback tunnel, audio spectrum, noise landscape, Write import_isf_shader Import an ISF (.fs) shader into TouchDesigner as a GLSL TOP with auto-generated controls. Accepts raw source, Write import_model Import a 3D model file (.obj/.fbx/.usd) and render it to a TOP: a File In SOP reading Write import_recipe_bundle Import recipes from a portable JSON bundle into a recipe directory. The inverse of export_recipe_bundle: each Write import_recipe_from_url Fetch, validate, and import a recipe or recipe-bundle JSON from an HTTPS URL into a local recipes directory (h Write learn_control EXPERIMENTAL two-step Write local_marketplace_index Scan a local package directory and write an index of installable tdmcp packages. Use it to make a folder of co Write log_performance READ a snapshot of a TD network (node/connection counts plus any errors) and, optionally, a preview image of a Write macro_recorder Record the sequence of MCP tool calls to a portable JSON macro file. Actions: start | stop | list | load. Repl Write make_portable_tox Save a COMP as a .tox package, write a tdmcp-component manifest beside it, and by default include a README.md Write manage_annotation Self-document a network: create a titled annotation box, set an op Write manage_component Build a reusable component library by moving COMPs to/from .tox files on disk. Two actions: Write manage_component_storage CRUD operations on a COMP operator Write manage_cue Live-performance scene system: store / recall / morph / list / delete named cues (snapshots of a COMP Write manage_packages Search, list, inspect, doctor, dry-run install, stage, and uninstall manifest-driven TouchDesigner community p Write manage_presets Store, recall, list, or delete named snapshots of a COMP Write merge_vaults Merge the contents of a source Obsidian vault into a target vault (defaulting to TDMCP_VAULT_PATH). Write morph_pack Export an existing create_preset_morph container Write multipass_3d_depth Build a renderable 3D scene with depth cues that read on stage: a Geometry COMP holding the chosen primitive ( Write post_passes_3d Compose a chain of 3D-aware post-processing passes (SSAO, SSR, DOF, motion blur) inside a new baseCOMP. Each p Write project_documentation_site Compose a one-folder handoff/portfolio documentation PACKAGE for a network: a README.md (title, node count, pe Write provenance_stamp Writes a Write publish_recipe_bundle Write a local, versioned recipe-bundle publish artifact: the recipe bundle JSON, a tdmcp-recipe-publish manife Write randomize_controls Randomize a COMP Write record_movie Record a TOP to a movie file (.mov/.mp4) via a Movie File Out TOP — for exporting a clip or a loop, where rend Write render_output Save a TOP to an image file at its native, full resolution (PNG/JPG/EXR/TIFF by extension) — for exporting a f Write save_component_to_vault Save a live TouchDesigner COMP as a reusable .tox component file inside the Obsidian vault (at <folder>/<name> Write save_recipe_to_vault Capture an existing COMP Write scaffold_extension Give a COMP a Python extension class: create a Text DAT holding the class (with optional method stubs), wire i Write scaffold_genre Create a genre-flavored starting network under parent_path — beyond scaffold_show Write scaffold_recipe_template Write a minimal but valid recipe JSON template to disk as a starting point for a new recipe. Use it to bootstr Write scaffold_show Create a starting skeleton for a live show: a new container under parent_path with a Write scaffold_tool_generator Meta DX tool: scaffolds a new tdmcp tool file (xSchema + xImpl + registerX) and a matching offline msw unit te Write scaffold_vault Populate the configured Obsidian vault with a starter layout and worked examples (a README plus example recipe Write set_dat_content Overwrite a Text or Table DAT Write set_parameter_expression Set one or more parameters on a node to an expression, bind expression, or constant value without needing the Write set_parameters_batch Update parameters on multiple nodes in a single batch request. Each update reports its own success; a failure Write setup_mediapipe_plugin Drop the torinmb mediapipe-touchdesigner ENGINE in one shot and enable any combination of face, hand, body, an Write setup_output Route a finished TOP to an output destination: a display window, NDI stream, Syphon/Spout, a recording, or Tou Write style_memory READ or UPDATE the long-lived Memory/style.md note in the configured Obsidian vault — the artist Write swap_operator Change an operator Write sync_external_clock Lock the project tempo to a live source so beat-synced visuals follow the music. Write sync_presets_vault Bridge a COMP Write sync_timecode Wire an external SMPTE/MTC/LTC/OSC timecode source into the TouchDesigner timeline. Creates the input op + Mat Write tag_and_search_library Faceted browse + tag editing over a vault library (Recipes/ + Components/ markdown notes). Write update_td_node_parameters Modify an existing node by setting one or more of its parameters to constant values. The update is strict (not Write variant_pack Generate N perturbed variants around an anchor parameter look and write the whole pack to the Obsidian vault a Write version_library_asset Apply a SemVer patch/minor/major bump to a vault recipe or component note, recording the change Write write_agent_guide Emit a project-local CLAUDE.md / AGENTS.md seeded with tdmcp operator conventions and

READ 71 tools

Read analyze_project Diagnose a network for cleanup: report likely-dead operators (zero wired outputs, unreferenced, not displayed) Read apply_creative_card Read a Creative RAG card by id, pick one of its Read apply_shader_from_vault READ a shader note from the Obsidian vault (a Read browse_library Browse built-in/vault recipes and optional local component packages. Read-only discovery step before instantia Read browse_vault_library Read-only: list the vault Read caption_top Read-only: render a TOP Read checksum_and_verify_pack Compute or verify SHA-256 checksums for tdmcp artifacts (.tox, .recipe.json, bundles). Read compact_graph_digest Read-only: compress a TD subtree into a structured digest under max_tokens (default 500). Read compare_operator_docs Read-only: compare two TouchDesigner operator types from the embedded offline knowledge base, including overvi Read compare_td_nodes Read-only: diff the parameters of two nodes, returning only the values that differ (by default). Returns {type Read component_link_health Probe live COMPs in the running project for externaltox paths and report missing or broken linked component fi Read copilot_vision Capture a TOP as a preview image and ask the configured multimodal LLM a question about it. Returns Read detect_onsets Build a transient/onset detector that flags kick/snare/hi-hat hits in live audio and exposes a per-band pulse Read detect_tempo EXPERIMENTAL automatic tempo (BPM) detection WITHOUT manual tapping. Detects beat onsets in live audio (kick b Read diagnose_hardware_environment Read-only: check whether TouchDesigner is reachable, whether display/projector topology matches expectations, Read diagnose_tdableton_mapper Inspect a TouchDesigner TDAbleton mapper COMP and its source CHOP. Reports common Read diff_library_assets Offline deep diff of two saved library assets on disk (recipe JSONs, component Read diff_snapshots Compare two network snapshots (from snapshot_td_graph) and return a readable diff: which nodes were added or r Read document_network Document an EXISTING network: read its nodes and connections and return a readable map — counts by operator fa Read draft_recipe_from_operator_chain Read-only: convert an ordered TouchDesigner operator chain into a RecipeSchema draft without writing files or Read draft_recipe_from_technique Read-only: convert an embedded TouchDesigner technique with GLSL source into a RecipeSchema draft without writ Read draft_recipe_from_tutorial Read-only: extract a conservative operator chain from an embedded TouchDesigner tutorial and draft a RecipeSch Read export_network_to_vault READ an existing TD network Read extract_audio_features Build an audio-analysis chain that exposes ready-to-bind reactive channels — overall level plus bass/mid/trebl Read extract_palette Sample dominant colors from a TOP by capturing its preview PNG and running deterministic k-means on the decode Read find_td_nodes Read-only: search a network for nodes by name pattern and/or operator type, recursively by default. Returns {c Read generate_from_moodboard READ a moodboard note (frontmatter Read generate_readme Produce a Markdown project document for any COMP or project: family/type counts, custom-parameter table, input Read get_bridge_logs Read-only: collect recent cook errors and warnings from the running TouchDesigner project for debugging. Walks Read get_inline_preview Read-only one-shot inspection of a TOP: small base64 thumbnail (default 256² JPEG) + parent error sweep (BFS u Read get_module_help Read-only: human-readable Markdown help (description, members, method signatures) for a TouchDesigner Python c Read get_node_state_runtime Read-only: inspect a single operator Read get_operator_workflow_guide Read-only: return an embedded TouchDesigner operator workflow guide with common inputs, outputs, examples, and Read get_preview Capture a TOP node Read get_td_class_details Read-only: full STRUCTURED documentation for one TouchDesigner Python class (members + methods) from the embed Read get_td_classes Read-only: list TouchDesigner Python API class names from the embedded knowledge base (works offline, never to Read get_td_node_errors Read-only: check one node (or, with recursive:true, its whole sub-network) for cook/compile errors and warning Read get_td_node_flags Read-only: report each node Read get_td_node_parameters Read-only: read the current parameters (and inputs/outputs) of one node. Returns {path, type, name, parameters Read get_td_nodes Read-only: list the DIRECT child nodes of one COMP. Defaults to a compact summary (count + type breakdown + sa Read get_td_performance Read-only: report cook times under a network (recursively by default, slowest node first) and warn about nodes Read get_td_topology Read-only: return the nodes AND the connections (wiring) under a network root, flagging obvious structural iss Read get_technique_detail Read-only: inspect embedded TouchDesigner technique packs and individual techniques, with optional code snippe Read get_tutorial Read-only: list embedded TouchDesigner tutorials, search tutorial metadata/content, or retrieve one tutorial b Read import_setlist READ a setlist note (frontmatter Read inspect_component_manifest Read and validate a tdmcp component/library manifest from a package folder or file. Read-only: use it to check Read inspect_gpu_and_displays Read-only: returns the host GPU info (name, driver, VRAM), attached monitor topology (resolution, refresh rate Read inspect_op_extensions_storage Read-only: inspect what a COMP exposes — its Python storage dict (keys + values), its extension class descript Read learn_conventions Walks a TouchDesigner subtree under Read learn_from_my_corpus Offline companion to Read library_lineage_graph Read-only, offline tool that scans the vault library (Recipes, Shaders, Presets, Components, Setlists), extrac Read lint_recipe_library Offline semantic linter for recipes/.json. Checks schema, id/filename match, duplicate node names, unknown ope Read list_recipes List the built-in recipe library — ready-made network templates (feedback tunnel, particle galaxy, reaction-di Read load_session_profile Reads ~/.tdmcp/session-profile.json (or a custom path) and returns a unified JSON Read plan_td_version_migration Read-only: plan a TouchDesigner stable-version migration from offline release highlights plus operator and Pyt Read plan_visual Turn a natural-language description of a visual you WANT into a build plan (which tool/recipe and nodes) — a d Read profile_cook_cost Read-only: sample cook times over a window (N samples × intervalMs) and rank hotspot nodes by p95 cook time. U Read read_parameter_modes Read-only: for each parameter of a node, report its mode (CONSTANT / EXPRESSION / EXPORT / BIND), its evaluate Read recall_similar_work Read-only vault search: rank past memory notes by similarity to a new visual goal so the agent can reuse prior Read scaffold_recipe_from_network Inverse of apply_recipe: walk a COMP Read score_build Read-only: score a built network 0–100 on a fixed rubric (palette/motion/complexity/errors/perf) and return pe Read search_operators Search the embedded operator knowledge base (629 operators) by keyword, exact name, tag/keyword, category, sub Read search_python_api Read-only: search TouchDesigner Python API classes, methods and members from the embedded offline knowledge ba Read search_touchdesigner_knowledge Read-only: search the embedded TouchDesigner knowledge router across operators, operator workflows, examples, Read serialize_network Read-only: serialize a COMP Read snapshot_td_graph Read-only: capture a compact, serializable snapshot of a network — nodes, connections, structural issues, and Read suggest_operator_chain Read-only: suggest a small ordered TouchDesigner operator chain for a creative or technical goal from offline Read summarize_td_errors Read-only: collect errors across a network and cluster them by message, type, or parent container, with the wo Read validate_library_asset Check that a local library asset exists on disk and is referenced by an optional manifest. Read-only pre-fligh Read validate_operator_chain Read-only: validate an ordered TouchDesigner operator chain against embedded operator docs, documented connect Read watch_node Read-only: sample one TouchDesigner operator over a short interval and return runtime state, readable paramete

EXPLORE

Related servers

Other MCP servers with similar tools — same risk classification, starter policies for each.

FAQ

Questions about tdmcp — TouchDesigner MCP server

Can an AI agent delete data through the tdmcp — TouchDesigner MCP server MCP server? +

Yes. The tdmcp — TouchDesigner MCP server server exposes 4 destructive tools including delete_td_node, manage_checkpoint, refresh_asset_previews. These permanently remove resources with no undo. PolicyLayer blocks destructive tools by default so they never reach the upstream server.

How do I prevent bulk modifications through tdmcp — TouchDesigner MCP server? +

The tdmcp — TouchDesigner MCP server server has 205 write tools including add_custom_parameters, animate_parameter, apply_lut. Set a rate limit in your policy -- for example, 10 calls per hour prevents an agent from making more than 10 modifications per hour. PolicyLayer enforces this at the gateway, before calls reach tdmcp — TouchDesigner MCP server.

How many tools does the tdmcp — TouchDesigner MCP server MCP server expose? +

334 tools across 4 categories: Destructive, Execute, Read, Write. 71 are read-only. 263 can modify, create, or delete data.

How do I enforce a policy on tdmcp — TouchDesigner MCP server? +

Register the tdmcp — TouchDesigner MCP server MCP server in PolicyLayer, apply the suggested rules above (adjust the limits to your use case), and point your AI client at the PolicyLayer proxy URL instead of the server directly. Your agents keep the same tools; PolicyLayer evaluates every call against policy before it executes. Nothing to install, live in minutes.

tdmcp — TouchDesigner MCP server

What tdmcp — TouchDesigner MCP server exposes to your agents

The most dangerous tdmcp — TouchDesigner MCP server tools

How to control tdmcp — TouchDesigner MCP server

All 334 tdmcp — TouchDesigner MCP server tools

Related servers

Questions about tdmcp — TouchDesigner MCP server

Enforce policy on every tdmcp — TouchDesigner MCP server tool call.