td_get_hints
Read-onlyIdempotent
Retrieve concise, source-cited hints for a topic, op type, or intent to resolve TouchDesigner problems.
Instructions
Return concise, source-cited hints for a topic, op_type, or intent.
Sources include hint packs shipped under src/td_mcp/hints/packs/
(skill pitfalls, canonical recipes), with future expansion to live
knowledge-store essays. Every hint cites its source.
The response shape:
{
"topic": ...,
"op_type": ...,
"confidence": 0.87,
"hints": [
{"id": ..., "priority": "critical|useful|context", "rule": ...,
"source": "tdpilot-core §11", "source_kind": "skill_pitfall"},
...
],
"next_tools": ["td_get_param_help", "td_screenshot"],
"hint_pack_version": "v1.6.0-1",
"available_topics": [...],
"available_op_types": [...]
}
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| topic | No | Topic name. Allowed values evolve with the shipped hint corpus; current topics are returned in every response under ``available_topics``. Examples: 'feedback', 'glsl', 'render_pipeline', 'audio_reactive', 'extensions'. | |
| intent | No | Free-text description of what you're about to do. Used to score ``intent_match`` clauses on individual hints (e.g. intent='set up trail decay' bumps the level.opacity hint). | |
| op_type | No | OP type to get type-specific hints (e.g., 'glslTOP', 'feedbackTOP', 'geometryCOMP'). Combines additively with ``topic`` when both are set. | |
| surface | No | Optional response-surface filter (v1.6.2). Allowed values: 'create_node', 'set_params', 'exec', 'errors', 'plan', 'preview', 'query', 'inspect', 'screenshot'. Surface-restricted hints (those declaring ``when.surface``) only fire when the requested surface matches; hints without a surface clause fire from any surface. Auto-injection from each tool wrapper passes the tool's natural surface automatically; explicit callers pass it here to narrow results. | |
| max_hints | No | Cap on returned hints. Critical-priority hints win ties. | |
| node_path | No | Optional: path of node about to be modified. Reserved for future hints that compute against live node state. | |
| error_text | No | Optional: error/warning text to match against ``error_match`` clauses. Mirrors what auto-injection does after a failed td_get_errors call. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |