Substance 3D Painter adapter for the DCC Model Context Protocol ecosystem
Single tool 'apply_smart_material' has a reasonable description (67 chars) and basic parameter documentation, but critical gaps undermine quality. Input schema is visible with two parameters (resource_url required, layer_name optional), both with descriptions. However, output schema is completely undocumented, the skill returns structured data (resource_url, layer_name, layer_uid) but the tool definition provides no schema documentation for downstream LLM reasoning. Error handling is present but generic ('Unable to apply Painter smart material' with exception text). No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite WRITE risk classification. Parameter descriptions lack format/constraint details (e.g., what format is resource_url? What constitutes a valid smart material resource?). Tool name 'apply_smart_material' is verb-noun and clear, but the single-tool server offers no composition or chaining patterns.
Apply an existing Painter smart material to the active texture set.
Output schema completely undocumented. Tool returns structured data (resource_url, layer_name, layer_uid) but MCP tool definition provides no schema documentation. LLMs cannot plan downstream operations or extract returned fields reliably.
Parameter descriptions lack actionable constraints. 'resource_url' description does not specify format (URL scheme? file path? resource ID?). 'layer_name' lacks length/character constraints. LLMs cannot validate inputs before calling.
No tool annotations despite WRITE risk classification. Tool modifies Painter state (inserts smart material layer) but lacks destructiveHint annotation. Agents cannot reason about side effects or plan confirmations.
Error messages are generic and non-actionable. 'Unable to apply Painter smart material' + exception text does not guide LLM recovery. No distinction between retryable errors (network, temporary state) vs user-fixable (invalid resource_url) vs fatal (no project open).
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 47 | <=2025-11-25 | v2 |
Tool description (67 chars) is minimal and lacks WHEN/WHY context. Does not explain prerequisites (project must be open, texture set must be active), when to call this vs alternatives, or what 'smart material' means to an LLM unfamiliar with Substance Painter.