An atomised index of TouchDesigner plus a live bridge, exposed to AI agents over MCP.
Three tools with complete input schemas and solid descriptions (avg 180 chars, within baseline 194). All parameters typed and described. Tool names follow verb_noun pattern (search_, get_). However, output schemas are undocumented, LLMs cannot plan downstream calls or extract structured data. No error handling guidance. No pagination support despite search tools that could return many results. Parameter descriptions lack format constraints (e.g., 'family' enum values stated in description but not formalized). Missing tool annotations (readOnlyHint, idempotentHint). Composition is sound, three distinct, single-purpose tools with clear separation.
Every parameter of an operator: exact names, defaults, menu options, ranges. Read this before creating or configuring an operator — it gives the names TouchDesigner actually accepts. Note that TouchDesigner's own documentation describes parameter *groups* (such as 't' for Translate) while the settable parameters are the members ('tx', 'ty', 'tz'); this returns the members. `page` filters to one parameter page.
Find TouchDesigner operators by what they do. Searches names, labels, summaries and full documentation. Use this first, in plain language ("blur an image", "read a MIDI device", "instance geometry"). `family` optionally narrows to TOP, CHOP, SOP, DAT, MAT, COMP or POP.
Search for parameters across all operators by name or description.
Output schemas undocumented. LLMs cannot infer what fields to expect from search results or operator schema responses, forcing unstructured parsing and risking context loss.
Search tools lack pagination. 'limit' parameter present but no 'offset'/'page' or 'next_cursor' support. Large result sets could exhaust context window.
Parameter 'family' in td_search_operators lists enum values in description ('TOP, CHOP, SOP, DAT, MAT, COMP, POP') but not formalized as JSON Schema enum. LLMs cannot validate against constraints.
No tool annotations (readOnlyHint, idempotentHint). All three tools are read-only and idempotent, marking them enables agent optimization and safety reasoning.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | B | 70 | 2026-07-28+ | v2 |
No error handling guidance. If a search returns no results or an operator type is invalid, LLMs receive no recovery hints (e.g., 'Try a broader query' or 'Call td_search_operators first').