blendops 0.0.0-stage → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (485) hide show
  1. package/CHANGELOG.md +74 -0
  2. package/LICENSE +21 -0
  3. package/README.md +208 -2
  4. package/bin/blendops.mjs +4 -0
  5. package/bundles/claude-desktop-manual/BLENDOPS_SINGLE_FILE.md +78 -0
  6. package/bundles/claude-desktop-manual/IMPORT_STEPS.md +43 -0
  7. package/bundles/claude-desktop-manual/INSTALL_REPORT_TEMPLATE.md +13 -0
  8. package/bundles/claude-desktop-manual/README.md +70 -0
  9. package/bundles/claude-desktop-manual/SKILL.md +62 -0
  10. package/bundles/claude-desktop-manual/manifest.json +278 -0
  11. package/bundles/claude-desktop-manual/references/evidence-rules.md +13 -0
  12. package/bundles/claude-desktop-manual/references/install-boundary.md +13 -0
  13. package/bundles/claude-desktop-manual/references/laws/evidence-before-done.md +14 -0
  14. package/bundles/claude-desktop-manual/references/laws/no-arbitrary-python-interface.md +12 -0
  15. package/bundles/claude-desktop-manual/references/laws/non-blender-user-language.md +13 -0
  16. package/bundles/claude-desktop-manual/references/laws/official-runtime-only.md +20 -0
  17. package/bundles/claude-desktop-manual/references/packs/product-hero-v0.md +30 -0
  18. package/bundles/claude-desktop-manual/references/runtime-stacks.md +13 -0
  19. package/bundles/claude-desktop-manual/references/skill-map.md +36 -0
  20. package/bundles/claude-desktop-manual/references/skills/acceptance-criteria-builder.md +69 -0
  21. package/bundles/claude-desktop-manual/references/skills/asset-discovery.md +73 -0
  22. package/bundles/claude-desktop-manual/references/skills/asset-fallback-strategy.md +66 -0
  23. package/bundles/claude-desktop-manual/references/skills/asset-library-plan.md +69 -0
  24. package/bundles/claude-desktop-manual/references/skills/asset-license-checker.md +69 -0
  25. package/bundles/claude-desktop-manual/references/skills/asset-style-check.md +69 -0
  26. package/bundles/claude-desktop-manual/references/skills/blender-brainstorming.md +62 -0
  27. package/bundles/claude-desktop-manual/references/skills/blender-recipe-decomposer.md +66 -0
  28. package/bundles/claude-desktop-manual/references/skills/blender-troubleshooting.md +78 -0
  29. package/bundles/claude-desktop-manual/references/skills/blendops-help.md +82 -0
  30. package/bundles/claude-desktop-manual/references/skills/bridge-conflicts.md +68 -0
  31. package/bundles/claude-desktop-manual/references/skills/camera-composition.md +65 -0
  32. package/bundles/claude-desktop-manual/references/skills/character-portrait.md +68 -0
  33. package/bundles/claude-desktop-manual/references/skills/cli-appendix-job-outline.md +62 -0
  34. package/bundles/claude-desktop-manual/references/skills/color-management-decision.md +68 -0
  35. package/bundles/claude-desktop-manual/references/skills/composition-quality-checker.md +71 -0
  36. package/bundles/claude-desktop-manual/references/skills/cycles-vs-eevee-decision.md +65 -0
  37. package/bundles/claude-desktop-manual/references/skills/done-criteria.md +70 -0
  38. package/bundles/claude-desktop-manual/references/skills/environment-shot.md +65 -0
  39. package/bundles/claude-desktop-manual/references/skills/glb-animation-handoff.md +69 -0
  40. package/bundles/claude-desktop-manual/references/skills/glb-web-handoff.md +68 -0
  41. package/bundles/claude-desktop-manual/references/skills/intent-to-3d-brief-writer.md +68 -0
  42. package/bundles/claude-desktop-manual/references/skills/interior-scene.md +73 -0
  43. package/bundles/claude-desktop-manual/references/skills/lighting-material-plan.md +65 -0
  44. package/bundles/claude-desktop-manual/references/skills/lighting-quality-checker.md +70 -0
  45. package/bundles/claude-desktop-manual/references/skills/material-quality-checker.md +71 -0
  46. package/bundles/claude-desktop-manual/references/skills/mobile-glb-budget.md +73 -0
  47. package/bundles/claude-desktop-manual/references/skills/output-format-decision.md +63 -0
  48. package/bundles/claude-desktop-manual/references/skills/pack-prerequisite-checker.md +74 -0
  49. package/bundles/claude-desktop-manual/references/skills/path-one-host-outline.md +66 -0
  50. package/bundles/claude-desktop-manual/references/skills/plain-language-response.md +70 -0
  51. package/bundles/claude-desktop-manual/references/skills/polycount-budget-checker.md +71 -0
  52. package/bundles/claude-desktop-manual/references/skills/pre-handoff-verification.md +76 -0
  53. package/bundles/claude-desktop-manual/references/skills/preview-report.md +62 -0
  54. package/bundles/claude-desktop-manual/references/skills/product-grid-scene-planner.md +72 -0
  55. package/bundles/claude-desktop-manual/references/skills/product-hero-scene-planner.md +68 -0
  56. package/bundles/claude-desktop-manual/references/skills/r3f-component-plan.md +66 -0
  57. package/bundles/claude-desktop-manual/references/skills/recipe-fit-assessor.md +75 -0
  58. package/bundles/claude-desktop-manual/references/skills/render-export-evidence.md +70 -0
  59. package/bundles/claude-desktop-manual/references/skills/resolution-aspect-decision.md +65 -0
  60. package/bundles/claude-desktop-manual/references/skills/runtime-attempt-report.md +67 -0
  61. package/bundles/claude-desktop-manual/references/skills/runtime-path-picker.md +67 -0
  62. package/bundles/claude-desktop-manual/references/skills/runtime-readiness.md +63 -0
  63. package/bundles/claude-desktop-manual/references/skills/runtime-setup.md +63 -0
  64. package/bundles/claude-desktop-manual/references/skills/scene-readiness.md +65 -0
  65. package/bundles/claude-desktop-manual/references/skills/scope-guard.md +62 -0
  66. package/bundles/claude-desktop-manual/references/skills/stage-gates.md +91 -0
  67. package/bundles/claude-desktop-manual/references/skills/workflow-stage-router.md +67 -0
  68. package/bundles/generic-project-local/BLENDOPS.md +71 -0
  69. package/bundles/generic-project-local/INSTALL_REPORT_TEMPLATE.md +52 -0
  70. package/bundles/generic-project-local/README.md +73 -0
  71. package/bundles/generic-project-local/ROLLBACK.md +66 -0
  72. package/bundles/generic-project-local/manifest.json +66 -0
  73. package/bundles/skill-package/README.md +54 -0
  74. package/bundles/skill-package/blendops/LICENSE.txt +21 -0
  75. package/bundles/skill-package/blendops/SKILL.md +50 -0
  76. package/bundles/skill-package/blendops/agents/README.md +61 -0
  77. package/bundles/skill-package/blendops/agents/openai.yaml +4 -0
  78. package/bundles/skill-package/blendops/references/evidence-rules.md +17 -0
  79. package/bundles/skill-package/blendops/references/install-boundary.md +13 -0
  80. package/bundles/skill-package/blendops/references/law-evidence-before-done.md +12 -0
  81. package/bundles/skill-package/blendops/references/law-no-arbitrary-python-interface.md +7 -0
  82. package/bundles/skill-package/blendops/references/law-non-blender-user-language.md +8 -0
  83. package/bundles/skill-package/blendops/references/law-official-runtime-only.md +9 -0
  84. package/bundles/skill-package/blendops/references/pack-product-hero-v0.md +21 -0
  85. package/bundles/skill-package/blendops/references/runtime-stacks.md +13 -0
  86. package/bundles/skill-package/blendops/references/skill-acceptance-criteria-builder.md +51 -0
  87. package/bundles/skill-package/blendops/references/skill-asset-discovery.md +54 -0
  88. package/bundles/skill-package/blendops/references/skill-asset-fallback-strategy.md +48 -0
  89. package/bundles/skill-package/blendops/references/skill-asset-library-plan.md +51 -0
  90. package/bundles/skill-package/blendops/references/skill-asset-license-checker.md +51 -0
  91. package/bundles/skill-package/blendops/references/skill-asset-style-check.md +52 -0
  92. package/bundles/skill-package/blendops/references/skill-blender-brainstorming.md +43 -0
  93. package/bundles/skill-package/blendops/references/skill-blender-recipe-decomposer.md +48 -0
  94. package/bundles/skill-package/blendops/references/skill-blender-troubleshooting.md +59 -0
  95. package/bundles/skill-package/blendops/references/skill-blendops-help.md +62 -0
  96. package/bundles/skill-package/blendops/references/skill-bridge-conflicts.md +48 -0
  97. package/bundles/skill-package/blendops/references/skill-camera-composition.md +48 -0
  98. package/bundles/skill-package/blendops/references/skill-character-portrait.md +50 -0
  99. package/bundles/skill-package/blendops/references/skill-cli-appendix-job-outline.md +44 -0
  100. package/bundles/skill-package/blendops/references/skill-color-management-decision.md +50 -0
  101. package/bundles/skill-package/blendops/references/skill-composition-quality-checker.md +53 -0
  102. package/bundles/skill-package/blendops/references/skill-cycles-vs-eevee-decision.md +47 -0
  103. package/bundles/skill-package/blendops/references/skill-done-criteria.md +53 -0
  104. package/bundles/skill-package/blendops/references/skill-environment-shot.md +47 -0
  105. package/bundles/skill-package/blendops/references/skill-glb-animation-handoff.md +51 -0
  106. package/bundles/skill-package/blendops/references/skill-glb-web-handoff.md +51 -0
  107. package/bundles/skill-package/blendops/references/skill-intent-to-3d-brief-writer.md +50 -0
  108. package/bundles/skill-package/blendops/references/skill-interior-scene.md +54 -0
  109. package/bundles/skill-package/blendops/references/skill-lighting-material-plan.md +48 -0
  110. package/bundles/skill-package/blendops/references/skill-lighting-quality-checker.md +52 -0
  111. package/bundles/skill-package/blendops/references/skill-map.md +32 -0
  112. package/bundles/skill-package/blendops/references/skill-material-quality-checker.md +53 -0
  113. package/bundles/skill-package/blendops/references/skill-mobile-glb-budget.md +55 -0
  114. package/bundles/skill-package/blendops/references/skill-output-format-decision.md +46 -0
  115. package/bundles/skill-package/blendops/references/skill-pack-prerequisite-checker.md +56 -0
  116. package/bundles/skill-package/blendops/references/skill-path-one-host-outline.md +48 -0
  117. package/bundles/skill-package/blendops/references/skill-plain-language-response.md +53 -0
  118. package/bundles/skill-package/blendops/references/skill-polycount-budget-checker.md +53 -0
  119. package/bundles/skill-package/blendops/references/skill-pre-handoff-verification.md +57 -0
  120. package/bundles/skill-package/blendops/references/skill-preview-report.md +45 -0
  121. package/bundles/skill-package/blendops/references/skill-product-grid-scene-planner.md +54 -0
  122. package/bundles/skill-package/blendops/references/skill-product-hero-scene-planner.md +51 -0
  123. package/bundles/skill-package/blendops/references/skill-r3f-component-plan.md +48 -0
  124. package/bundles/skill-package/blendops/references/skill-recipe-fit-assessor.md +57 -0
  125. package/bundles/skill-package/blendops/references/skill-render-export-evidence.md +51 -0
  126. package/bundles/skill-package/blendops/references/skill-resolution-aspect-decision.md +48 -0
  127. package/bundles/skill-package/blendops/references/skill-runtime-attempt-report.md +49 -0
  128. package/bundles/skill-package/blendops/references/skill-runtime-path-picker.md +49 -0
  129. package/bundles/skill-package/blendops/references/skill-runtime-readiness.md +45 -0
  130. package/bundles/skill-package/blendops/references/skill-runtime-setup.md +45 -0
  131. package/bundles/skill-package/blendops/references/skill-scene-readiness.md +48 -0
  132. package/bundles/skill-package/blendops/references/skill-scope-guard.md +44 -0
  133. package/bundles/skill-package/blendops/references/skill-stage-gates.md +73 -0
  134. package/bundles/skill-package/blendops/references/skill-workflow-stage-router.md +49 -0
  135. package/docs/README.md +276 -0
  136. package/docs/examples/glb-web-handoff/README.md +174 -0
  137. package/docs/examples/glb-web-handoff/r3f-glb-viewer.tsx +320 -0
  138. package/docs/examples/glb-web-handoff/threejs-glb-viewer.mjs +709 -0
  139. package/docs/knowledge-and-recipe-catalog.md +236 -0
  140. package/docs/recipes/README.md +27 -0
  141. package/docs/recipes/cyberpunk-shoe-hero.md +97 -0
  142. package/docs/workflows/README.md +14 -0
  143. package/docs/workflows/full-non-blender-user-workflow.md +210 -0
  144. package/docs/workflows/product-hero-workflow.md +92 -0
  145. package/laws/README.md +32 -0
  146. package/laws/evidence-before-done.md +37 -0
  147. package/laws/no-arbitrary-python-interface.md +32 -0
  148. package/laws/non-blender-user-language.md +32 -0
  149. package/laws/official-runtime-only.md +78 -0
  150. package/package.json +103 -4
  151. package/packs/README.md +11 -0
  152. package/packs/product-hero-v0/PACK.md +114 -0
  153. package/registry/catalog-index.json +21344 -0
  154. package/registry/compatibility-matrix.json +533 -0
  155. package/registry/contract-context-fields.json +391 -0
  156. package/registry/knowledge-catalog.json +4648 -0
  157. package/registry/knowledge-sources.json +438 -0
  158. package/registry/recipe-catalog.json +2565 -0
  159. package/registry/runtime-capability-policy.json +525 -0
  160. package/registry/runtime-operations.json +4468 -0
  161. package/registry/skills.json +10231 -0
  162. package/registry/workflow-graph.json +7390 -0
  163. package/schemas/adapter-compatibility-matrix.schema.json +166 -0
  164. package/schemas/contract-context-fields.schema.json +147 -0
  165. package/schemas/execution-plan.schema.json +325 -0
  166. package/schemas/glb-web-handoff-manifest.schema.json +744 -0
  167. package/schemas/knowledge-record.schema.json +460 -0
  168. package/schemas/knowledge-source-registry.schema.json +268 -0
  169. package/schemas/operation-execution-ledger.schema.json +348 -0
  170. package/schemas/recipe-record.schema.json +469 -0
  171. package/schemas/runtime-capability-policy.schema.json +184 -0
  172. package/schemas/runtime-evidence-packet.schema.json +211 -0
  173. package/schemas/runtime-operations.schema.json +535 -0
  174. package/schemas/runtime-qualification-report.schema.json +540 -0
  175. package/schemas/runtime-session.schema.json +350 -0
  176. package/schemas/scene-spec.schema.json +624 -0
  177. package/schemas/skill-contract.schema.json +402 -0
  178. package/schemas/skill-eval.schema.json +509 -0
  179. package/scripts/build-knowledge-catalog.mjs +2376 -0
  180. package/scripts/compile-scene-plan.mjs +1945 -0
  181. package/scripts/export-claude-skills.mjs +634 -0
  182. package/scripts/generate-glb-handoff-report.mjs +2376 -0
  183. package/scripts/inspect-glb.mjs +1627 -0
  184. package/scripts/install-skills.mjs +5443 -0
  185. package/scripts/runtime-orchestrator.mjs +7713 -0
  186. package/scripts/validate-capability-policy.mjs +531 -0
  187. package/scripts/validate-evidence-packet.mjs +256 -0
  188. package/skills/README.md +315 -0
  189. package/skills/_template/SKILL.md +296 -0
  190. package/skills/acceptance-criteria-builder/EVAL.md +25 -0
  191. package/skills/acceptance-criteria-builder/SKILL.md +257 -0
  192. package/skills/acceptance-criteria-builder/contract.json +205 -0
  193. package/skills/acceptance-criteria-builder/references/brief-to-criteria-mapper.md +22 -0
  194. package/skills/acceptance-criteria-builder/references/checklist-patterns.md +22 -0
  195. package/skills/acceptance-criteria-builder/references/evidence-hook-rules.md +19 -0
  196. package/skills/asset-discovery/EVAL.md +81 -0
  197. package/skills/asset-discovery/SKILL.md +252 -0
  198. package/skills/asset-discovery/contract.json +291 -0
  199. package/skills/asset-discovery/references/asset-strategy-decision-tree.md +40 -0
  200. package/skills/asset-discovery/references/budget-reconciliation-patterns.md +54 -0
  201. package/skills/asset-discovery/references/license-confidence-table.md +41 -0
  202. package/skills/asset-fallback-strategy/EVAL.md +34 -0
  203. package/skills/asset-fallback-strategy/SKILL.md +248 -0
  204. package/skills/asset-fallback-strategy/contract.json +190 -0
  205. package/skills/asset-fallback-strategy/references/drop-with-caveat-rules.md +36 -0
  206. package/skills/asset-fallback-strategy/references/fallback-option-types.md +55 -0
  207. package/skills/asset-fallback-strategy/references/scoring-rubric.md +61 -0
  208. package/skills/asset-library-plan/EVAL.md +28 -0
  209. package/skills/asset-library-plan/SKILL.md +263 -0
  210. package/skills/asset-library-plan/contract.json +177 -0
  211. package/skills/asset-library-plan/references/folder-structure-rules.md +63 -0
  212. package/skills/asset-library-plan/references/metadata-schema.md +62 -0
  213. package/skills/asset-library-plan/references/naming-rules.md +51 -0
  214. package/skills/asset-license-checker/EVAL.md +33 -0
  215. package/skills/asset-license-checker/SKILL.md +245 -0
  216. package/skills/asset-license-checker/contract.json +172 -0
  217. package/skills/asset-license-checker/references/attribution-rendering-patterns.md +48 -0
  218. package/skills/asset-license-checker/references/common-license-mapping.md +39 -0
  219. package/skills/asset-license-checker/references/license-source-rules.md +38 -0
  220. package/skills/asset-style-check/EVAL.md +26 -0
  221. package/skills/asset-style-check/SKILL.md +238 -0
  222. package/skills/asset-style-check/contract.json +251 -0
  223. package/skills/asset-style-check/references/drift-classification.md +40 -0
  224. package/skills/asset-style-check/references/intentional-mixed-style.md +39 -0
  225. package/skills/asset-style-check/references/style-axes.md +46 -0
  226. package/skills/blender-brainstorming/EVAL.md +79 -0
  227. package/skills/blender-brainstorming/SKILL.md +228 -0
  228. package/skills/blender-brainstorming/contract.json +115 -0
  229. package/skills/blender-brainstorming/references/alternative-scoping-templates.md +43 -0
  230. package/skills/blender-brainstorming/references/clarification-patterns.md +29 -0
  231. package/skills/blender-brainstorming/references/intent-summary-style-guide.md +25 -0
  232. package/skills/blender-recipe-decomposer/EVAL.md +35 -0
  233. package/skills/blender-recipe-decomposer/SKILL.md +258 -0
  234. package/skills/blender-recipe-decomposer/contract.json +152 -0
  235. package/skills/blender-recipe-decomposer/references/dependency-patterns.md +53 -0
  236. package/skills/blender-recipe-decomposer/references/recipe-grouping-rules.md +58 -0
  237. package/skills/blender-recipe-decomposer/references/recipe-naming-rules.md +44 -0
  238. package/skills/blender-troubleshooting/EVAL.md +78 -0
  239. package/skills/blender-troubleshooting/SKILL.md +263 -0
  240. package/skills/blender-troubleshooting/contract.json +352 -0
  241. package/skills/blender-troubleshooting/references/common-symptom-playbooks.md +51 -0
  242. package/skills/blender-troubleshooting/references/divergence-routing-table.md +23 -0
  243. package/skills/blender-troubleshooting/references/four-phase-template.md +51 -0
  244. package/skills/blendops-help/EVAL.md +67 -0
  245. package/skills/blendops-help/SKILL.md +312 -0
  246. package/skills/blendops-help/contract.json +229 -0
  247. package/skills/blendops-help/references/lifecycle-phases.md +91 -0
  248. package/skills/blendops-help/references/quick-start-prompts.md +65 -0
  249. package/skills/blendops-help/references/routing-decision-tree.md +57 -0
  250. package/skills/bridge-conflicts/EVAL.md +83 -0
  251. package/skills/bridge-conflicts/SKILL.md +246 -0
  252. package/skills/bridge-conflicts/contract.json +145 -0
  253. package/skills/bridge-conflicts/references/bridge-state-matrix-template.md +82 -0
  254. package/skills/bridge-conflicts/references/conflict-playbooks.md +99 -0
  255. package/skills/bridge-conflicts/references/do-not-reminders.md +42 -0
  256. package/skills/camera-composition/EVAL.md +32 -0
  257. package/skills/camera-composition/SKILL.md +196 -0
  258. package/skills/camera-composition/contract.json +180 -0
  259. package/skills/camera-composition/references/camera-presets.md +30 -0
  260. package/skills/camera-composition/references/camera-rubric.md +24 -0
  261. package/skills/camera-composition/references/hero-composition-patterns.md +24 -0
  262. package/skills/camera-composition/references/web-layout-negative-space.md +25 -0
  263. package/skills/character-portrait/EVAL.md +42 -0
  264. package/skills/character-portrait/SKILL.md +245 -0
  265. package/skills/character-portrait/contract.json +205 -0
  266. package/skills/character-portrait/references/portrait-framing-rules.md +39 -0
  267. package/skills/character-portrait/references/portrait-lighting-patterns.md +50 -0
  268. package/skills/character-portrait/references/style-consistency-rules.md +41 -0
  269. package/skills/cli-appendix-job-outline/EVAL.md +26 -0
  270. package/skills/cli-appendix-job-outline/SKILL.md +252 -0
  271. package/skills/cli-appendix-job-outline/contract.json +147 -0
  272. package/skills/cli-appendix-job-outline/references/flag-order-reminders.md +16 -0
  273. package/skills/cli-appendix-job-outline/references/job-type-matrix.md +13 -0
  274. package/skills/cli-appendix-job-outline/references/stateless-limitations.md +12 -0
  275. package/skills/color-management-decision/EVAL.md +28 -0
  276. package/skills/color-management-decision/SKILL.md +254 -0
  277. package/skills/color-management-decision/contract.json +162 -0
  278. package/skills/color-management-decision/references/look-comparison.md +44 -0
  279. package/skills/color-management-decision/references/per-channel-rules.md +49 -0
  280. package/skills/color-management-decision/references/pipeline-mapping.md +47 -0
  281. package/skills/composition-quality-checker/EVAL.md +38 -0
  282. package/skills/composition-quality-checker/SKILL.md +260 -0
  283. package/skills/composition-quality-checker/contract.json +221 -0
  284. package/skills/composition-quality-checker/references/aspect-ratio-rules.md +37 -0
  285. package/skills/composition-quality-checker/references/composition-rules.md +58 -0
  286. package/skills/composition-quality-checker/references/headroom-leadroom-rules.md +46 -0
  287. package/skills/cycles-vs-eevee-decision/EVAL.md +26 -0
  288. package/skills/cycles-vs-eevee-decision/SKILL.md +249 -0
  289. package/skills/cycles-vs-eevee-decision/contract.json +142 -0
  290. package/skills/cycles-vs-eevee-decision/references/engine-feature-matrix.md +39 -0
  291. package/skills/cycles-vs-eevee-decision/references/gpu-device-rules.md +51 -0
  292. package/skills/cycles-vs-eevee-decision/references/samples-by-quality.md +53 -0
  293. package/skills/done-criteria/EVAL.md +33 -0
  294. package/skills/done-criteria/SKILL.md +225 -0
  295. package/skills/done-criteria/contract.json +199 -0
  296. package/skills/done-criteria/references/done-vs-perfect.md +56 -0
  297. package/skills/done-criteria/references/out-of-scope-patterns.md +50 -0
  298. package/skills/done-criteria/references/stop-condition-templates.md +39 -0
  299. package/skills/environment-shot/EVAL.md +44 -0
  300. package/skills/environment-shot/SKILL.md +237 -0
  301. package/skills/environment-shot/contract.json +162 -0
  302. package/skills/environment-shot/references/depth-layering-rules.md +49 -0
  303. package/skills/environment-shot/references/time-and-weather-rules.md +35 -0
  304. package/skills/environment-shot/references/wide-shot-camera-rules.md +51 -0
  305. package/skills/glb-animation-handoff/EVAL.md +39 -0
  306. package/skills/glb-animation-handoff/SKILL.md +271 -0
  307. package/skills/glb-animation-handoff/contract.json +247 -0
  308. package/skills/glb-animation-handoff/references/animation-types.md +36 -0
  309. package/skills/glb-animation-handoff/references/transition-rules.md +55 -0
  310. package/skills/glb-animation-handoff/references/web-stack-caveats.md +40 -0
  311. package/skills/glb-web-handoff/EVAL.md +33 -0
  312. package/skills/glb-web-handoff/SKILL.md +212 -0
  313. package/skills/glb-web-handoff/contract.json +171 -0
  314. package/skills/glb-web-handoff/references/artifact-status-language.md +26 -0
  315. package/skills/glb-web-handoff/references/glb-handoff-checklist.md +30 -0
  316. package/skills/glb-web-handoff/references/performance-caveats.md +26 -0
  317. package/skills/glb-web-handoff/references/threejs-r3f-handoff.md +28 -0
  318. package/skills/intent-to-3d-brief-writer/EVAL.md +82 -0
  319. package/skills/intent-to-3d-brief-writer/SKILL.md +238 -0
  320. package/skills/intent-to-3d-brief-writer/contract.json +195 -0
  321. package/skills/intent-to-3d-brief-writer/references/acceptance-criteria-patterns.md +46 -0
  322. package/skills/intent-to-3d-brief-writer/references/eight-slot-template.md +123 -0
  323. package/skills/intent-to-3d-brief-writer/references/mixed-audience-handling.md +39 -0
  324. package/skills/interior-scene/EVAL.md +44 -0
  325. package/skills/interior-scene/SKILL.md +261 -0
  326. package/skills/interior-scene/contract.json +277 -0
  327. package/skills/interior-scene/references/furniture-layout-rules.md +51 -0
  328. package/skills/interior-scene/references/interior-architecture-rules.md +47 -0
  329. package/skills/interior-scene/references/interior-camera-rules.md +47 -0
  330. package/skills/lighting-material-plan/EVAL.md +32 -0
  331. package/skills/lighting-material-plan/SKILL.md +194 -0
  332. package/skills/lighting-material-plan/contract.json +213 -0
  333. package/skills/lighting-material-plan/references/cyberpunk-lookdev.md +22 -0
  334. package/skills/lighting-material-plan/references/lighting-patterns.md +30 -0
  335. package/skills/lighting-material-plan/references/material-portability.md +25 -0
  336. package/skills/lighting-material-plan/references/reflective-floor-pattern.md +22 -0
  337. package/skills/lighting-material-plan/references/web-material-simplification.md +23 -0
  338. package/skills/lighting-quality-checker/EVAL.md +41 -0
  339. package/skills/lighting-quality-checker/SKILL.md +247 -0
  340. package/skills/lighting-quality-checker/contract.json +187 -0
  341. package/skills/lighting-quality-checker/references/hdri-balance-rules.md +48 -0
  342. package/skills/lighting-quality-checker/references/intensity-ranges.md +73 -0
  343. package/skills/lighting-quality-checker/references/shadow-softness-rules.md +38 -0
  344. package/skills/material-quality-checker/EVAL.md +40 -0
  345. package/skills/material-quality-checker/SKILL.md +261 -0
  346. package/skills/material-quality-checker/contract.json +244 -0
  347. package/skills/material-quality-checker/references/consumer-stack-rules.md +62 -0
  348. package/skills/material-quality-checker/references/pbr-sanity-rules.md +78 -0
  349. package/skills/material-quality-checker/references/texture-budget-rules.md +48 -0
  350. package/skills/mobile-glb-budget/EVAL.md +40 -0
  351. package/skills/mobile-glb-budget/SKILL.md +264 -0
  352. package/skills/mobile-glb-budget/contract.json +309 -0
  353. package/skills/mobile-glb-budget/references/budget-tiers.md +30 -0
  354. package/skills/mobile-glb-budget/references/degradation-plan.md +34 -0
  355. package/skills/mobile-glb-budget/references/violation-rules.md +43 -0
  356. package/skills/output-format-decision/EVAL.md +27 -0
  357. package/skills/output-format-decision/SKILL.md +222 -0
  358. package/skills/output-format-decision/contract.json +179 -0
  359. package/skills/output-format-decision/references/bit-depth-rules.md +56 -0
  360. package/skills/output-format-decision/references/compression-tradeoffs.md +62 -0
  361. package/skills/output-format-decision/references/format-decision-matrix.md +34 -0
  362. package/skills/pack-prerequisite-checker/EVAL.md +26 -0
  363. package/skills/pack-prerequisite-checker/SKILL.md +272 -0
  364. package/skills/pack-prerequisite-checker/contract.json +214 -0
  365. package/skills/pack-prerequisite-checker/references/blocked-start-playbook.md +21 -0
  366. package/skills/pack-prerequisite-checker/references/pack-readiness-template.md +38 -0
  367. package/skills/pack-prerequisite-checker/references/prerequisite-matrix.md +20 -0
  368. package/skills/path-one-host-outline/EVAL.md +26 -0
  369. package/skills/path-one-host-outline/SKILL.md +251 -0
  370. package/skills/path-one-host-outline/contract.json +167 -0
  371. package/skills/path-one-host-outline/references/connector-vs-manual-matrix.md +21 -0
  372. package/skills/path-one-host-outline/references/host-checklist-template.md +35 -0
  373. package/skills/path-one-host-outline/references/lab-addon-reminders.md +12 -0
  374. package/skills/plain-language-response/EVAL.md +33 -0
  375. package/skills/plain-language-response/SKILL.md +194 -0
  376. package/skills/plain-language-response/contract.json +242 -0
  377. package/skills/plain-language-response/references/caveat-language.md +25 -0
  378. package/skills/plain-language-response/references/plain-language-patterns.md +30 -0
  379. package/skills/plain-language-response/references/stakeholder-friendly-examples.md +30 -0
  380. package/skills/plain-language-response/references/status-summary-templates.md +50 -0
  381. package/skills/polycount-budget-checker/EVAL.md +40 -0
  382. package/skills/polycount-budget-checker/SKILL.md +251 -0
  383. package/skills/polycount-budget-checker/contract.json +196 -0
  384. package/skills/polycount-budget-checker/references/instance-counting-rules.md +39 -0
  385. package/skills/polycount-budget-checker/references/per-mesh-rules.md +43 -0
  386. package/skills/polycount-budget-checker/references/topology-hints.md +56 -0
  387. package/skills/pre-handoff-verification/EVAL.md +84 -0
  388. package/skills/pre-handoff-verification/SKILL.md +252 -0
  389. package/skills/pre-handoff-verification/contract.json +295 -0
  390. package/skills/pre-handoff-verification/references/downgrade-rules.md +39 -0
  391. package/skills/pre-handoff-verification/references/seven-point-checklist.md +46 -0
  392. package/skills/pre-handoff-verification/references/text-only-mode-handling.md +36 -0
  393. package/skills/preview-report/EVAL.md +39 -0
  394. package/skills/preview-report/SKILL.md +254 -0
  395. package/skills/preview-report/contract.json +141 -0
  396. package/skills/preview-report/references/handoff-recipients.md +41 -0
  397. package/skills/preview-report/references/report-schema.md +60 -0
  398. package/skills/preview-report/references/truth-label-rules.md +36 -0
  399. package/skills/product-grid-scene-planner/EVAL.md +42 -0
  400. package/skills/product-grid-scene-planner/SKILL.md +246 -0
  401. package/skills/product-grid-scene-planner/contract.json +257 -0
  402. package/skills/product-grid-scene-planner/references/grid-consistency-rules.md +53 -0
  403. package/skills/product-grid-scene-planner/references/grid-layout-rules.md +42 -0
  404. package/skills/product-grid-scene-planner/references/grid-output-naming-rules.md +52 -0
  405. package/skills/product-hero-scene-planner/EVAL.md +33 -0
  406. package/skills/product-hero-scene-planner/SKILL.md +227 -0
  407. package/skills/product-hero-scene-planner/contract.json +228 -0
  408. package/skills/product-hero-scene-planner/references/clarification-patterns.md +24 -0
  409. package/skills/product-hero-scene-planner/references/cyberpunk-shoe-example.md +28 -0
  410. package/skills/product-hero-scene-planner/references/product-hero-playbooks.md +22 -0
  411. package/skills/product-hero-scene-planner/references/scene-plan-schema.md +35 -0
  412. package/skills/r3f-component-plan/EVAL.md +43 -0
  413. package/skills/r3f-component-plan/SKILL.md +290 -0
  414. package/skills/r3f-component-plan/contract.json +171 -0
  415. package/skills/r3f-component-plan/references/component-shape-patterns.md +54 -0
  416. package/skills/r3f-component-plan/references/suspense-placement-rules.md +50 -0
  417. package/skills/r3f-component-plan/references/usegltf-caching-rules.md +53 -0
  418. package/skills/recipe-fit-assessor/EVAL.md +28 -0
  419. package/skills/recipe-fit-assessor/SKILL.md +266 -0
  420. package/skills/recipe-fit-assessor/contract.json +220 -0
  421. package/skills/recipe-fit-assessor/references/recipe-catalog.md +30 -0
  422. package/skills/recipe-fit-assessor/references/scope-gap-rules.md +27 -0
  423. package/skills/recipe-fit-assessor/references/workflow-recommendation-template.md +34 -0
  424. package/skills/render-export-evidence/EVAL.md +86 -0
  425. package/skills/render-export-evidence/SKILL.md +339 -0
  426. package/skills/render-export-evidence/contract.json +206 -0
  427. package/skills/render-export-evidence/references/attempted-vs-failed-rubric.md +75 -0
  428. package/skills/render-export-evidence/references/evidence-record-templates.md +143 -0
  429. package/skills/render-export-evidence/references/truth-label-decision-tree.md +57 -0
  430. package/skills/resolution-aspect-decision/EVAL.md +26 -0
  431. package/skills/resolution-aspect-decision/SKILL.md +246 -0
  432. package/skills/resolution-aspect-decision/contract.json +160 -0
  433. package/skills/resolution-aspect-decision/references/aspect-defaults.md +41 -0
  434. package/skills/resolution-aspect-decision/references/print-vs-screen-rules.md +58 -0
  435. package/skills/resolution-aspect-decision/references/resolution-defaults.md +64 -0
  436. package/skills/runtime-attempt-report/EVAL.md +26 -0
  437. package/skills/runtime-attempt-report/SKILL.md +268 -0
  438. package/skills/runtime-attempt-report/contract.json +176 -0
  439. package/skills/runtime-attempt-report/references/attempt-record-template.md +49 -0
  440. package/skills/runtime-attempt-report/references/triage-next-steps.md +15 -0
  441. package/skills/runtime-attempt-report/references/truth-label-blocks.md +27 -0
  442. package/skills/runtime-path-picker/EVAL.md +26 -0
  443. package/skills/runtime-path-picker/SKILL.md +268 -0
  444. package/skills/runtime-path-picker/contract.json +191 -0
  445. package/skills/runtime-path-picker/references/anti-patterns.md +14 -0
  446. package/skills/runtime-path-picker/references/decision-tree.md +29 -0
  447. package/skills/runtime-path-picker/references/path-constraints-table.md +18 -0
  448. package/skills/runtime-readiness/EVAL.md +33 -0
  449. package/skills/runtime-readiness/SKILL.md +218 -0
  450. package/skills/runtime-readiness/contract.json +190 -0
  451. package/skills/runtime-readiness/references/blocker-report-template.md +28 -0
  452. package/skills/runtime-readiness/references/evidence-examples.md +23 -0
  453. package/skills/runtime-readiness/references/readiness-matrix.md +46 -0
  454. package/skills/runtime-setup/EVAL.md +33 -0
  455. package/skills/runtime-setup/SKILL.md +209 -0
  456. package/skills/runtime-setup/contract.json +171 -0
  457. package/skills/runtime-setup/references/runtime-option-decision-tree.md +28 -0
  458. package/skills/runtime-setup/references/setup-summary-template.md +33 -0
  459. package/skills/runtime-setup/references/source-confidence-labels.md +23 -0
  460. package/skills/scene-readiness/EVAL.md +33 -0
  461. package/skills/scene-readiness/SKILL.md +195 -0
  462. package/skills/scene-readiness/contract.json +198 -0
  463. package/skills/scene-readiness/references/blocker-catalog.md +24 -0
  464. package/skills/scene-readiness/references/not-run-handling.md +22 -0
  465. package/skills/scene-readiness/references/quality-rubric.md +23 -0
  466. package/skills/scene-readiness/references/verdict-language.md +22 -0
  467. package/skills/scope-guard/EVAL.md +33 -0
  468. package/skills/scope-guard/SKILL.md +222 -0
  469. package/skills/scope-guard/contract.json +171 -0
  470. package/skills/scope-guard/references/options-language-template.md +51 -0
  471. package/skills/scope-guard/references/recurring-creep-patterns.md +55 -0
  472. package/skills/scope-guard/references/scope-addition-classification.md +55 -0
  473. package/skills/stage-gates/EVAL.md +40 -0
  474. package/skills/stage-gates/SKILL.md +257 -0
  475. package/skills/stage-gates/contract.json +490 -0
  476. package/skills/stage-gates/references/failed-gate-handling.md +42 -0
  477. package/skills/stage-gates/references/gate-template.md +46 -0
  478. package/skills/stage-gates/references/stage-decomposition-patterns.md +55 -0
  479. package/skills/workflow-stage-router/EVAL.md +25 -0
  480. package/skills/workflow-stage-router/SKILL.md +259 -0
  481. package/skills/workflow-stage-router/contract.json +150 -0
  482. package/skills/workflow-stage-router/references/milestone-model.md +20 -0
  483. package/skills/workflow-stage-router/references/routing-decision-tree.md +32 -0
  484. package/skills/workflow-stage-router/references/stage-handoff-template.md +37 -0
  485. package/skills.sh.json +102 -0
@@ -0,0 +1,4468 @@
1
+ {
2
+ "$schema": "../schemas/runtime-operations.schema.json",
3
+ "schema_version": "1.0.0",
4
+ "registry_id": "blendops.runtime-operations",
5
+ "title": "BlendOps Canonical Typed Runtime Operations Registry",
6
+ "governance_summary": {
7
+ "external_runtime_ownership": "BlendOps does not own or ship a Blender runtime, MCP server, or Blender add-on. External runtimes (Path 1 Official Blender Lab MCP 5.1+ and Path 2 Community mcp-for-blender 3.0+) own Blender execution; BlendOps governs typed operation planning, capability preflight, pre-mutation .blend checkpoints, independent readback, and truthful evidence.",
8
+ "capability_tier_distinction": "Every BlendOps skill operates at capabilityTier = L0 (planning/validation content layer), while governedRuntimeCeiling (L0-L3) bounds the maximum external runtime operation tier that skill may authorize.",
9
+ "default_runtime_status": "Not Run",
10
+ "default_artifact_status": "Not Produced",
11
+ "user_facing_python_allowed": false
12
+ },
13
+ "blocked_arbitrary_interfaces": [
14
+ {
15
+ "interface_id": "raw_python_or_bpy_eval",
16
+ "tier": "L3",
17
+ "status": "blocked_in_user_facing_registry",
18
+ "governing_law": "laws/no-arbitrary-python-interface.md",
19
+ "reason": "Unrestricted Python or raw bpy code passthrough (including raw user-facing execute_blender_code prompts) is prohibited as a BlendOps operation."
20
+ },
21
+ {
22
+ "interface_id": "arbitrary_shell_or_cli_command",
23
+ "tier": "L3",
24
+ "status": "blocked_in_user_facing_registry",
25
+ "governing_law": "laws/no-arbitrary-python-interface.md",
26
+ "reason": "Arbitrary shell commands and unvalidated CLI flags cannot be invoked through the typed runtime operation surface."
27
+ },
28
+ {
29
+ "interface_id": "unbounded_scene_destruction_or_file_delete",
30
+ "tier": "L3",
31
+ "status": "blocked_in_user_facing_registry",
32
+ "governing_law": "laws/evidence-before-done.md",
33
+ "reason": "Destructive multi-object deletion, arbitrary filesystem writes outside allowlisted directories, and unbacked scene resets are blocked."
34
+ }
35
+ ],
36
+ "operations": [
37
+ {
38
+ "operation_id": "op.inspect.runtime-session-info",
39
+ "display_name": "Inspect Runtime & Add-on Session Info",
40
+ "purpose": "Read active Blender file path status, add-on readiness, and session bridge metadata without modifying the scene.",
41
+ "category": "inspection",
42
+ "supported_runtime_paths": [
43
+ "path-1-host-a",
44
+ "path-1-host-b",
45
+ "path-2-community"
46
+ ],
47
+ "runtime_tool_mappings": {
48
+ "path-1-host-a": {
49
+ "primary_tool": "get_blendfile_summary_path_info",
50
+ "readback_tools": [
51
+ "get_blendfile_summary_path_info"
52
+ ],
53
+ "parameter_adapter": "lab_mcp_empty_params",
54
+ "mutation_transport_note": "Read-only Lab MCP path info inspection via Anthropic Connector host.",
55
+ "upstream_mcp_tool_name": "get_blendfile_summary_path_info",
56
+ "tool_schema_fingerprint": "c5083618ec6414ddb0ecc190f759a06330fbfe81f7b95e9ffc04fa169040b60b",
57
+ "upstream_qualification_status": "qualified_read_only",
58
+ "requires_bounded_governed_extension": false,
59
+ "rollback_strategy": "none_read_only",
60
+ "qualification_evidence": "Verified against real upstream Blender Lab MCP (blmcp) v1.0.2 tool get_blendfile_summary_path_info (https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_blendfile_summary_path_info.py)."
61
+ },
62
+ "path-1-host-b": {
63
+ "primary_tool": "get_blendfile_summary_path_info",
64
+ "readback_tools": [
65
+ "get_blendfile_summary_path_info"
66
+ ],
67
+ "parameter_adapter": "lab_mcp_empty_params",
68
+ "mutation_transport_note": "Read-only Lab MCP path info inspection via manual MCP host.",
69
+ "upstream_mcp_tool_name": "get_blendfile_summary_path_info",
70
+ "tool_schema_fingerprint": "c5083618ec6414ddb0ecc190f759a06330fbfe81f7b95e9ffc04fa169040b60b",
71
+ "upstream_qualification_status": "qualified_read_only",
72
+ "requires_bounded_governed_extension": false,
73
+ "rollback_strategy": "none_read_only",
74
+ "qualification_evidence": "Verified against real upstream Blender Lab MCP (blmcp) v1.0.2 tool get_blendfile_summary_path_info (https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_blendfile_summary_path_info.py)."
75
+ },
76
+ "path-2-community": {
77
+ "primary_tool": "get_addon_status",
78
+ "secondary_tools": [
79
+ "get_scene_info"
80
+ ],
81
+ "readback_tools": [
82
+ "get_addon_status"
83
+ ],
84
+ "parameter_adapter": "community_mcp_empty_params",
85
+ "mutation_transport_note": "Read-only community mcp-for-blender add-on status inspection.",
86
+ "upstream_mcp_tool_name": "get_addon_status",
87
+ "tool_schema_fingerprint": "e0a491a9f51fc8126dc51beb503a6bb12b2145811f9e2ec8e870eaa4926f9489",
88
+ "upstream_qualification_status": "qualified_read_only",
89
+ "requires_bounded_governed_extension": false,
90
+ "rollback_strategy": "none_read_only",
91
+ "qualification_evidence": "Verified against real upstream MCP for Blender (ahujasid/mcp-for-blender) v2.2.7 tool get_addon_status (https://github.com/ahujasid/blender-mcp/blob/main/src/blender_mcp/server.py#L451)."
92
+ }
93
+ },
94
+ "input_schema": {
95
+ "type": "object",
96
+ "additionalProperties": false,
97
+ "required": [],
98
+ "properties": {
99
+ "include_bridge_diagnostics": {
100
+ "type": "boolean"
101
+ }
102
+ }
103
+ },
104
+ "output_schema": {
105
+ "type": "object",
106
+ "required": [
107
+ "filepath",
108
+ "saved",
109
+ "dirty"
110
+ ],
111
+ "properties": {
112
+ "filepath": {
113
+ "type": [
114
+ "string",
115
+ "null"
116
+ ]
117
+ },
118
+ "saved": {
119
+ "type": "boolean"
120
+ },
121
+ "dirty": {
122
+ "type": "boolean"
123
+ },
124
+ "addon_status": {
125
+ "type": "string"
126
+ }
127
+ }
128
+ },
129
+ "required_capability_tier": "L0",
130
+ "required_governed_runtime_ceiling": "L0",
131
+ "governing_skills": [
132
+ "runtime-readiness",
133
+ "runtime-path-picker"
134
+ ],
135
+ "side_effect_classification": "none",
136
+ "behavior": "read_only",
137
+ "idempotency": "idempotent_read",
138
+ "required_preconditions": [
139
+ {
140
+ "check_id": "pre.runtime_connected",
141
+ "description": "External MCP runtime session must be connected and single-bridge verified.",
142
+ "blocking": true
143
+ }
144
+ ],
145
+ "required_postconditions": [
146
+ {
147
+ "check_id": "post.session_info_returned",
148
+ "description": "Response includes saved/dirty state and filepath without mutating the scene.",
149
+ "verification_method": "read_only_response_schema"
150
+ }
151
+ ],
152
+ "backup_requirement": "none",
153
+ "approval_requirement": "none",
154
+ "asset_license_requirement": "none",
155
+ "version_constraints": {
156
+ "path_1_min_blender": "5.1.0",
157
+ "path_2_min_blender": "3.0.0"
158
+ },
159
+ "timeout_and_retry_policy": {
160
+ "timeout_ms": 5000,
161
+ "max_retries": 1,
162
+ "retry_on_timeout": true,
163
+ "ambiguous_timeout_behavior": "halt_and_inspect_no_blind_retry"
164
+ },
165
+ "evidence_requirements": {
166
+ "required_packet_type": "runtime-smoke",
167
+ "requires_independent_readback": false,
168
+ "requires_checkpoint_hash": false
169
+ },
170
+ "user_facing_python_allowed": false,
171
+ "known_limitations": [
172
+ "Path 1 get_blendfile_summary_path_info does not always include the exact blender --version string unless queried from session metadata."
173
+ ]
174
+ },
175
+ {
176
+ "operation_id": "op.inspect.blendfile-summary",
177
+ "display_name": "Inspect Blender File & Datablock Summary",
178
+ "purpose": "Inspect the active .blend file path, saved state, and datablock counts (scenes, objects, meshes, materials, cameras, lights).",
179
+ "category": "inspection",
180
+ "supported_runtime_paths": [
181
+ "path-1-host-a",
182
+ "path-1-host-b",
183
+ "path-2-community"
184
+ ],
185
+ "runtime_tool_mappings": {
186
+ "path-1-host-a": {
187
+ "primary_tool": "get_blendfile_summary_datablocks",
188
+ "secondary_tools": [
189
+ "get_blendfile_summary_path_info"
190
+ ],
191
+ "readback_tools": [
192
+ "get_blendfile_summary_datablocks"
193
+ ],
194
+ "parameter_adapter": "lab_mcp_datablocks_summary",
195
+ "mutation_transport_note": "Read-only Lab MCP datablock summary.",
196
+ "upstream_mcp_tool_name": "get_blendfile_summary_datablocks",
197
+ "tool_schema_fingerprint": "2b831a66bd41ba97d47055f4b5b51ce8b7387fbe7b2f2c294d251d4b8d658c73",
198
+ "upstream_qualification_status": "qualified_read_only",
199
+ "requires_bounded_governed_extension": false,
200
+ "rollback_strategy": "none_read_only",
201
+ "qualification_evidence": "Verified against real upstream Blender Lab MCP (blmcp) v1.0.2 tool get_blendfile_summary_datablocks (https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_blendfile_summary_datablocks.py)."
202
+ },
203
+ "path-1-host-b": {
204
+ "primary_tool": "get_blendfile_summary_datablocks",
205
+ "secondary_tools": [
206
+ "get_blendfile_summary_path_info"
207
+ ],
208
+ "readback_tools": [
209
+ "get_blendfile_summary_datablocks"
210
+ ],
211
+ "parameter_adapter": "lab_mcp_datablocks_summary",
212
+ "mutation_transport_note": "Read-only Lab MCP datablock summary.",
213
+ "upstream_mcp_tool_name": "get_blendfile_summary_datablocks",
214
+ "tool_schema_fingerprint": "2b831a66bd41ba97d47055f4b5b51ce8b7387fbe7b2f2c294d251d4b8d658c73",
215
+ "upstream_qualification_status": "qualified_read_only",
216
+ "requires_bounded_governed_extension": false,
217
+ "rollback_strategy": "none_read_only",
218
+ "qualification_evidence": "Verified against real upstream Blender Lab MCP (blmcp) v1.0.2 tool get_blendfile_summary_datablocks (https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_blendfile_summary_datablocks.py)."
219
+ },
220
+ "path-2-community": {
221
+ "primary_tool": "get_scene_info",
222
+ "readback_tools": [
223
+ "get_scene_info"
224
+ ],
225
+ "parameter_adapter": "community_mcp_scene_info",
226
+ "mutation_transport_note": "Read-only community mcp-for-blender scene summary.",
227
+ "upstream_mcp_tool_name": "get_scene_info",
228
+ "tool_schema_fingerprint": "caa384b8584c6d54ebfd6194ab612e0eaa3e6a54fa8bacdc5134b03cf7963566",
229
+ "upstream_qualification_status": "qualified_read_only",
230
+ "requires_bounded_governed_extension": false,
231
+ "rollback_strategy": "none_read_only",
232
+ "qualification_evidence": "Verified against real upstream MCP for Blender (ahujasid/mcp-for-blender) v2.2.7 tool get_scene_info (https://github.com/ahujasid/blender-mcp/blob/main/src/blender_mcp/server.py#L607)."
233
+ }
234
+ },
235
+ "input_schema": {
236
+ "type": "object",
237
+ "additionalProperties": false,
238
+ "required": [],
239
+ "properties": {
240
+ "include_datablock_counts": {
241
+ "type": "boolean"
242
+ }
243
+ }
244
+ },
245
+ "output_schema": {
246
+ "type": "object",
247
+ "required": [
248
+ "scene_name",
249
+ "datablock_counts"
250
+ ],
251
+ "properties": {
252
+ "filepath": {
253
+ "type": [
254
+ "string",
255
+ "null"
256
+ ]
257
+ },
258
+ "saved": {
259
+ "type": "boolean"
260
+ },
261
+ "scene_name": {
262
+ "type": "string"
263
+ },
264
+ "datablock_counts": {
265
+ "type": "object"
266
+ }
267
+ }
268
+ },
269
+ "required_capability_tier": "L0",
270
+ "required_governed_runtime_ceiling": "L0",
271
+ "governing_skills": [
272
+ "scene-readiness",
273
+ "runtime-readiness"
274
+ ],
275
+ "side_effect_classification": "none",
276
+ "behavior": "read_only",
277
+ "idempotency": "idempotent_read",
278
+ "required_preconditions": [
279
+ {
280
+ "check_id": "pre.runtime_connected",
281
+ "description": "External MCP runtime session must be connected.",
282
+ "blocking": true
283
+ }
284
+ ],
285
+ "required_postconditions": [
286
+ {
287
+ "check_id": "post.datablock_summary_valid",
288
+ "description": "Datablock counts and active scene name are returned without scene modification.",
289
+ "verification_method": "read_only_response_schema"
290
+ }
291
+ ],
292
+ "backup_requirement": "none",
293
+ "approval_requirement": "none",
294
+ "asset_license_requirement": "none",
295
+ "version_constraints": {
296
+ "path_1_min_blender": "5.1.0",
297
+ "path_2_min_blender": "3.0.0"
298
+ },
299
+ "timeout_and_retry_policy": {
300
+ "timeout_ms": 5000,
301
+ "max_retries": 1,
302
+ "retry_on_timeout": true,
303
+ "ambiguous_timeout_behavior": "halt_and_inspect_no_blind_retry"
304
+ },
305
+ "evidence_requirements": {
306
+ "required_packet_type": "runtime-smoke",
307
+ "requires_independent_readback": false,
308
+ "requires_checkpoint_hash": false
309
+ },
310
+ "user_facing_python_allowed": false,
311
+ "known_limitations": [
312
+ "Path 2 get_scene_info summarizes active scene objects rather than global unused datablocks."
313
+ ]
314
+ },
315
+ {
316
+ "operation_id": "op.inspect.scene-summary",
317
+ "display_name": "Inspect Active Scene Summary",
318
+ "purpose": "Inspect active scene name, render engine, world lighting state, and active object.",
319
+ "category": "inspection",
320
+ "supported_runtime_paths": [
321
+ "path-1-host-a",
322
+ "path-1-host-b",
323
+ "path-2-community"
324
+ ],
325
+ "runtime_tool_mappings": {
326
+ "path-1-host-a": {
327
+ "primary_tool": "get_blendfile_summary_datablocks",
328
+ "readback_tools": [
329
+ "get_blendfile_summary_datablocks"
330
+ ],
331
+ "parameter_adapter": "lab_mcp_scene_summary",
332
+ "mutation_transport_note": "Read-only Lab MCP scene summary.",
333
+ "upstream_mcp_tool_name": "get_blendfile_summary_datablocks",
334
+ "tool_schema_fingerprint": "2b831a66bd41ba97d47055f4b5b51ce8b7387fbe7b2f2c294d251d4b8d658c73",
335
+ "upstream_qualification_status": "qualified_read_only",
336
+ "requires_bounded_governed_extension": false,
337
+ "rollback_strategy": "none_read_only",
338
+ "qualification_evidence": "Verified against real upstream Blender Lab MCP (blmcp) v1.0.2 tool get_blendfile_summary_datablocks (https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_blendfile_summary_datablocks.py)."
339
+ },
340
+ "path-1-host-b": {
341
+ "primary_tool": "get_blendfile_summary_datablocks",
342
+ "readback_tools": [
343
+ "get_blendfile_summary_datablocks"
344
+ ],
345
+ "parameter_adapter": "lab_mcp_scene_summary",
346
+ "mutation_transport_note": "Read-only Lab MCP scene summary.",
347
+ "upstream_mcp_tool_name": "get_blendfile_summary_datablocks",
348
+ "tool_schema_fingerprint": "2b831a66bd41ba97d47055f4b5b51ce8b7387fbe7b2f2c294d251d4b8d658c73",
349
+ "upstream_qualification_status": "qualified_read_only",
350
+ "requires_bounded_governed_extension": false,
351
+ "rollback_strategy": "none_read_only",
352
+ "qualification_evidence": "Verified against real upstream Blender Lab MCP (blmcp) v1.0.2 tool get_blendfile_summary_datablocks (https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_blendfile_summary_datablocks.py)."
353
+ },
354
+ "path-2-community": {
355
+ "primary_tool": "get_scene_info",
356
+ "readback_tools": [
357
+ "get_scene_info"
358
+ ],
359
+ "parameter_adapter": "community_mcp_scene_info",
360
+ "mutation_transport_note": "Read-only community get_scene_info call.",
361
+ "upstream_mcp_tool_name": "get_scene_info",
362
+ "tool_schema_fingerprint": "caa384b8584c6d54ebfd6194ab612e0eaa3e6a54fa8bacdc5134b03cf7963566",
363
+ "upstream_qualification_status": "qualified_read_only",
364
+ "requires_bounded_governed_extension": false,
365
+ "rollback_strategy": "none_read_only",
366
+ "qualification_evidence": "Verified against real upstream MCP for Blender (ahujasid/mcp-for-blender) v2.2.7 tool get_scene_info (https://github.com/ahujasid/blender-mcp/blob/main/src/blender_mcp/server.py#L607)."
367
+ }
368
+ },
369
+ "input_schema": {
370
+ "type": "object",
371
+ "additionalProperties": false,
372
+ "required": [],
373
+ "properties": {
374
+ "scene_name": {
375
+ "type": "string",
376
+ "minLength": 1
377
+ }
378
+ }
379
+ },
380
+ "output_schema": {
381
+ "type": "object",
382
+ "required": [
383
+ "scene_name",
384
+ "render_engine",
385
+ "object_count"
386
+ ],
387
+ "properties": {
388
+ "scene_name": {
389
+ "type": "string"
390
+ },
391
+ "render_engine": {
392
+ "type": "string"
393
+ },
394
+ "object_count": {
395
+ "type": "integer",
396
+ "minimum": 0
397
+ },
398
+ "active_object": {
399
+ "type": [
400
+ "string",
401
+ "null"
402
+ ]
403
+ }
404
+ }
405
+ },
406
+ "required_capability_tier": "L0",
407
+ "required_governed_runtime_ceiling": "L0",
408
+ "governing_skills": [
409
+ "scene-readiness",
410
+ "product-hero-scene-planner"
411
+ ],
412
+ "side_effect_classification": "none",
413
+ "behavior": "read_only",
414
+ "idempotency": "idempotent_read",
415
+ "required_preconditions": [
416
+ {
417
+ "check_id": "pre.runtime_connected",
418
+ "description": "External MCP runtime session must be connected.",
419
+ "blocking": true
420
+ }
421
+ ],
422
+ "required_postconditions": [
423
+ {
424
+ "check_id": "post.scene_summary_returned",
425
+ "description": "Scene name, render engine, and object count are present.",
426
+ "verification_method": "read_only_response_schema"
427
+ }
428
+ ],
429
+ "backup_requirement": "none",
430
+ "approval_requirement": "none",
431
+ "asset_license_requirement": "none",
432
+ "version_constraints": {
433
+ "path_1_min_blender": "5.1.0",
434
+ "path_2_min_blender": "3.0.0"
435
+ },
436
+ "timeout_and_retry_policy": {
437
+ "timeout_ms": 5000,
438
+ "max_retries": 1,
439
+ "retry_on_timeout": true,
440
+ "ambiguous_timeout_behavior": "halt_and_inspect_no_blind_retry"
441
+ },
442
+ "evidence_requirements": {
443
+ "required_packet_type": "runtime-smoke",
444
+ "requires_independent_readback": false,
445
+ "requires_checkpoint_hash": false
446
+ },
447
+ "user_facing_python_allowed": false,
448
+ "known_limitations": [
449
+ "Read-only summary does not evaluate geometry modifier stacks."
450
+ ]
451
+ },
452
+ {
453
+ "operation_id": "op.inspect.object-list",
454
+ "display_name": "List & Inspect Scene Objects",
455
+ "purpose": "Retrieve the list of objects in the active scene with their types, visibility, and world transforms.",
456
+ "category": "inspection",
457
+ "supported_runtime_paths": [
458
+ "path-1-host-a",
459
+ "path-1-host-b",
460
+ "path-2-community"
461
+ ],
462
+ "runtime_tool_mappings": {
463
+ "path-1-host-a": {
464
+ "primary_tool": "get_objects_summary",
465
+ "readback_tools": [
466
+ "get_objects_summary"
467
+ ],
468
+ "parameter_adapter": "lab_mcp_objects_summary",
469
+ "mutation_transport_note": "Read-only Lab MCP get_objects_summary call.",
470
+ "upstream_mcp_tool_name": "get_objects_summary",
471
+ "tool_schema_fingerprint": "19105e512c7b198ac0a0cbf9f2b9f64d07258a4a97370a78c7b637379b33944f",
472
+ "upstream_qualification_status": "qualified_read_only",
473
+ "requires_bounded_governed_extension": false,
474
+ "rollback_strategy": "none_read_only",
475
+ "qualification_evidence": "Verified against real upstream Blender Lab MCP (blmcp) v1.0.2 tool get_objects_summary (https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_objects_summary.py)."
476
+ },
477
+ "path-1-host-b": {
478
+ "primary_tool": "get_objects_summary",
479
+ "readback_tools": [
480
+ "get_objects_summary"
481
+ ],
482
+ "parameter_adapter": "lab_mcp_objects_summary",
483
+ "mutation_transport_note": "Read-only Lab MCP get_objects_summary call.",
484
+ "upstream_mcp_tool_name": "get_objects_summary",
485
+ "tool_schema_fingerprint": "19105e512c7b198ac0a0cbf9f2b9f64d07258a4a97370a78c7b637379b33944f",
486
+ "upstream_qualification_status": "qualified_read_only",
487
+ "requires_bounded_governed_extension": false,
488
+ "rollback_strategy": "none_read_only",
489
+ "qualification_evidence": "Verified against real upstream Blender Lab MCP (blmcp) v1.0.2 tool get_objects_summary (https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_objects_summary.py)."
490
+ },
491
+ "path-2-community": {
492
+ "primary_tool": "get_scene_info",
493
+ "secondary_tools": [
494
+ "get_object_info"
495
+ ],
496
+ "readback_tools": [
497
+ "get_scene_info"
498
+ ],
499
+ "parameter_adapter": "community_mcp_objects_from_scene",
500
+ "mutation_transport_note": "Read-only community get_scene_info / get_object_info inspection.",
501
+ "upstream_mcp_tool_name": "get_scene_info",
502
+ "tool_schema_fingerprint": "caa384b8584c6d54ebfd6194ab612e0eaa3e6a54fa8bacdc5134b03cf7963566",
503
+ "upstream_qualification_status": "qualified_read_only",
504
+ "requires_bounded_governed_extension": false,
505
+ "rollback_strategy": "none_read_only",
506
+ "qualification_evidence": "Verified against real upstream MCP for Blender (ahujasid/mcp-for-blender) v2.2.7 tool get_scene_info (https://github.com/ahujasid/blender-mcp/blob/main/src/blender_mcp/server.py#L607)."
507
+ }
508
+ },
509
+ "input_schema": {
510
+ "type": "object",
511
+ "additionalProperties": false,
512
+ "required": [],
513
+ "properties": {
514
+ "filter_type": {
515
+ "type": "string",
516
+ "enum": [
517
+ "ALL",
518
+ "MESH",
519
+ "CAMERA",
520
+ "LIGHT",
521
+ "ARMATURE",
522
+ "EMPTY"
523
+ ]
524
+ }
525
+ }
526
+ },
527
+ "output_schema": {
528
+ "type": "object",
529
+ "required": [
530
+ "objects"
531
+ ],
532
+ "properties": {
533
+ "objects": {
534
+ "type": "array",
535
+ "items": {
536
+ "type": "object",
537
+ "required": [
538
+ "name",
539
+ "type",
540
+ "visible"
541
+ ],
542
+ "properties": {
543
+ "name": {
544
+ "type": "string"
545
+ },
546
+ "type": {
547
+ "type": "string"
548
+ },
549
+ "visible": {
550
+ "type": "boolean"
551
+ },
552
+ "location": {
553
+ "type": "array"
554
+ },
555
+ "rotation_euler": {
556
+ "type": "array"
557
+ },
558
+ "scale": {
559
+ "type": "array"
560
+ }
561
+ }
562
+ }
563
+ }
564
+ }
565
+ },
566
+ "required_capability_tier": "L0",
567
+ "required_governed_runtime_ceiling": "L0",
568
+ "governing_skills": [
569
+ "scene-readiness",
570
+ "composition-quality-checker"
571
+ ],
572
+ "side_effect_classification": "none",
573
+ "behavior": "read_only",
574
+ "idempotency": "idempotent_read",
575
+ "required_preconditions": [
576
+ {
577
+ "check_id": "pre.runtime_connected",
578
+ "description": "External MCP runtime session must be connected.",
579
+ "blocking": true
580
+ }
581
+ ],
582
+ "required_postconditions": [
583
+ {
584
+ "check_id": "post.object_inventory_returned",
585
+ "description": "Array of scene objects with name, type, and visibility is returned.",
586
+ "verification_method": "read_only_response_schema"
587
+ }
588
+ ],
589
+ "backup_requirement": "none",
590
+ "approval_requirement": "none",
591
+ "asset_license_requirement": "none",
592
+ "version_constraints": {
593
+ "path_1_min_blender": "5.1.0",
594
+ "path_2_min_blender": "3.0.0"
595
+ },
596
+ "timeout_and_retry_policy": {
597
+ "timeout_ms": 5000,
598
+ "max_retries": 1,
599
+ "retry_on_timeout": true,
600
+ "ambiguous_timeout_behavior": "halt_and_inspect_no_blind_retry"
601
+ },
602
+ "evidence_requirements": {
603
+ "required_packet_type": "runtime-smoke",
604
+ "requires_independent_readback": false,
605
+ "requires_checkpoint_hash": false
606
+ },
607
+ "user_facing_python_allowed": false,
608
+ "known_limitations": [
609
+ "Does not create or rename missing objects; reports exact scene inventory."
610
+ ]
611
+ },
612
+ {
613
+ "operation_id": "op.inspect.mesh-topology-stats",
614
+ "display_name": "Inspect Mesh & Topology Statistics",
615
+ "purpose": "Inspect triangle, vertex, face, and UV map counts for target mesh objects against platform budgets.",
616
+ "category": "inspection",
617
+ "supported_runtime_paths": [
618
+ "path-1-host-a",
619
+ "path-1-host-b",
620
+ "path-2-community"
621
+ ],
622
+ "runtime_tool_mappings": {
623
+ "path-1-host-a": {
624
+ "primary_tool": "get_objects_summary",
625
+ "readback_tools": [
626
+ "get_objects_summary"
627
+ ],
628
+ "parameter_adapter": "lab_mcp_mesh_stats",
629
+ "mutation_transport_note": "Read-only Lab MCP object/mesh summary inspection.",
630
+ "upstream_mcp_tool_name": "get_objects_summary",
631
+ "tool_schema_fingerprint": "19105e512c7b198ac0a0cbf9f2b9f64d07258a4a97370a78c7b637379b33944f",
632
+ "upstream_qualification_status": "qualified_read_only",
633
+ "requires_bounded_governed_extension": false,
634
+ "rollback_strategy": "none_read_only",
635
+ "qualification_evidence": "Verified against real upstream Blender Lab MCP (blmcp) v1.0.2 tool get_objects_summary (https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_objects_summary.py)."
636
+ },
637
+ "path-1-host-b": {
638
+ "primary_tool": "get_objects_summary",
639
+ "readback_tools": [
640
+ "get_objects_summary"
641
+ ],
642
+ "parameter_adapter": "lab_mcp_mesh_stats",
643
+ "mutation_transport_note": "Read-only Lab MCP object/mesh summary inspection.",
644
+ "upstream_mcp_tool_name": "get_objects_summary",
645
+ "tool_schema_fingerprint": "19105e512c7b198ac0a0cbf9f2b9f64d07258a4a97370a78c7b637379b33944f",
646
+ "upstream_qualification_status": "qualified_read_only",
647
+ "requires_bounded_governed_extension": false,
648
+ "rollback_strategy": "none_read_only",
649
+ "qualification_evidence": "Verified against real upstream Blender Lab MCP (blmcp) v1.0.2 tool get_objects_summary (https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_objects_summary.py)."
650
+ },
651
+ "path-2-community": {
652
+ "primary_tool": "get_object_info",
653
+ "readback_tools": [
654
+ "get_object_info"
655
+ ],
656
+ "parameter_adapter": "community_mcp_object_info",
657
+ "mutation_transport_note": "Read-only community get_object_info inspection.",
658
+ "upstream_mcp_tool_name": "get_object_info",
659
+ "tool_schema_fingerprint": "d0a91f92c0d4558c8eebc2f50a30d35363f6e9c480dc1635e1684492a3d6195f",
660
+ "upstream_qualification_status": "qualified_read_only",
661
+ "requires_bounded_governed_extension": false,
662
+ "rollback_strategy": "none_read_only",
663
+ "qualification_evidence": "Verified against real upstream MCP for Blender (ahujasid/mcp-for-blender) v2.2.7 tool get_object_info (https://github.com/ahujasid/blender-mcp/blob/main/src/blender_mcp/server.py#L2083)."
664
+ }
665
+ },
666
+ "input_schema": {
667
+ "type": "object",
668
+ "additionalProperties": false,
669
+ "required": [
670
+ "object_name"
671
+ ],
672
+ "properties": {
673
+ "object_name": {
674
+ "type": "string",
675
+ "minLength": 1,
676
+ "maxLength": 128
677
+ }
678
+ }
679
+ },
680
+ "output_schema": {
681
+ "type": "object",
682
+ "required": [
683
+ "object_name",
684
+ "triangles",
685
+ "vertices"
686
+ ],
687
+ "properties": {
688
+ "object_name": {
689
+ "type": "string"
690
+ },
691
+ "triangles": {
692
+ "type": "integer",
693
+ "minimum": 0
694
+ },
695
+ "vertices": {
696
+ "type": "integer",
697
+ "minimum": 0
698
+ },
699
+ "uv_layers": {
700
+ "type": "integer",
701
+ "minimum": 0
702
+ }
703
+ }
704
+ },
705
+ "required_capability_tier": "L0",
706
+ "required_governed_runtime_ceiling": "L0",
707
+ "governing_skills": [
708
+ "polycount-budget-checker",
709
+ "mobile-glb-budget"
710
+ ],
711
+ "side_effect_classification": "none",
712
+ "behavior": "read_only",
713
+ "idempotency": "idempotent_read",
714
+ "required_preconditions": [
715
+ {
716
+ "check_id": "pre.target_mesh_exists",
717
+ "description": "Target mesh object must exist in the scene.",
718
+ "blocking": true
719
+ }
720
+ ],
721
+ "required_postconditions": [
722
+ {
723
+ "check_id": "post.topology_metrics_returned",
724
+ "description": "Triangle and vertex counts are returned as non-negative integers.",
725
+ "verification_method": "read_only_response_schema"
726
+ }
727
+ ],
728
+ "backup_requirement": "none",
729
+ "approval_requirement": "none",
730
+ "asset_license_requirement": "none",
731
+ "version_constraints": {
732
+ "path_1_min_blender": "5.1.0",
733
+ "path_2_min_blender": "3.0.0"
734
+ },
735
+ "timeout_and_retry_policy": {
736
+ "timeout_ms": 5000,
737
+ "max_retries": 1,
738
+ "retry_on_timeout": true,
739
+ "ambiguous_timeout_behavior": "halt_and_inspect_no_blind_retry"
740
+ },
741
+ "evidence_requirements": {
742
+ "required_packet_type": "preview-check",
743
+ "requires_independent_readback": false,
744
+ "requires_checkpoint_hash": false
745
+ },
746
+ "user_facing_python_allowed": false,
747
+ "known_limitations": [
748
+ "Reports evaluated or base mesh counts depending on upstream tool detail payload."
749
+ ]
750
+ },
751
+ {
752
+ "operation_id": "op.inspect.material-slots",
753
+ "display_name": "Inspect Material Slots & Principled BSDF Parameters",
754
+ "purpose": "Inspect assigned material slots and Principled BSDF roughness/metallic/base_color parameters on an object.",
755
+ "category": "inspection",
756
+ "supported_runtime_paths": [
757
+ "path-1-host-a",
758
+ "path-1-host-b",
759
+ "path-2-community"
760
+ ],
761
+ "runtime_tool_mappings": {
762
+ "path-1-host-a": {
763
+ "primary_tool": "get_blendfile_summary_datablocks",
764
+ "secondary_tools": [
765
+ "get_objects_summary"
766
+ ],
767
+ "readback_tools": [
768
+ "get_blendfile_summary_datablocks"
769
+ ],
770
+ "parameter_adapter": "lab_mcp_material_inspection",
771
+ "mutation_transport_note": "Read-only Lab MCP material datablock inspection.",
772
+ "upstream_mcp_tool_name": "get_blendfile_summary_datablocks",
773
+ "tool_schema_fingerprint": "2b831a66bd41ba97d47055f4b5b51ce8b7387fbe7b2f2c294d251d4b8d658c73",
774
+ "upstream_qualification_status": "qualified_read_only",
775
+ "requires_bounded_governed_extension": false,
776
+ "rollback_strategy": "none_read_only",
777
+ "qualification_evidence": "Verified against real upstream Blender Lab MCP (blmcp) v1.0.2 tool get_blendfile_summary_datablocks (https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_blendfile_summary_datablocks.py)."
778
+ },
779
+ "path-1-host-b": {
780
+ "primary_tool": "get_blendfile_summary_datablocks",
781
+ "secondary_tools": [
782
+ "get_objects_summary"
783
+ ],
784
+ "readback_tools": [
785
+ "get_blendfile_summary_datablocks"
786
+ ],
787
+ "parameter_adapter": "lab_mcp_material_inspection",
788
+ "mutation_transport_note": "Read-only Lab MCP material datablock inspection.",
789
+ "upstream_mcp_tool_name": "get_blendfile_summary_datablocks",
790
+ "tool_schema_fingerprint": "2b831a66bd41ba97d47055f4b5b51ce8b7387fbe7b2f2c294d251d4b8d658c73",
791
+ "upstream_qualification_status": "qualified_read_only",
792
+ "requires_bounded_governed_extension": false,
793
+ "rollback_strategy": "none_read_only",
794
+ "qualification_evidence": "Verified against real upstream Blender Lab MCP (blmcp) v1.0.2 tool get_blendfile_summary_datablocks (https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_blendfile_summary_datablocks.py)."
795
+ },
796
+ "path-2-community": {
797
+ "primary_tool": "get_object_info",
798
+ "readback_tools": [
799
+ "get_object_info"
800
+ ],
801
+ "parameter_adapter": "community_mcp_material_inspection",
802
+ "mutation_transport_note": "Read-only community get_object_info material slot inspection.",
803
+ "upstream_mcp_tool_name": "get_object_info",
804
+ "tool_schema_fingerprint": "d0a91f92c0d4558c8eebc2f50a30d35363f6e9c480dc1635e1684492a3d6195f",
805
+ "upstream_qualification_status": "qualified_read_only",
806
+ "requires_bounded_governed_extension": false,
807
+ "rollback_strategy": "none_read_only",
808
+ "qualification_evidence": "Verified against real upstream MCP for Blender (ahujasid/mcp-for-blender) v2.2.7 tool get_object_info (https://github.com/ahujasid/blender-mcp/blob/main/src/blender_mcp/server.py#L2083)."
809
+ }
810
+ },
811
+ "input_schema": {
812
+ "type": "object",
813
+ "additionalProperties": false,
814
+ "required": [
815
+ "object_name"
816
+ ],
817
+ "properties": {
818
+ "object_name": {
819
+ "type": "string",
820
+ "minLength": 1,
821
+ "maxLength": 128
822
+ }
823
+ }
824
+ },
825
+ "output_schema": {
826
+ "type": "object",
827
+ "required": [
828
+ "object_name",
829
+ "materials"
830
+ ],
831
+ "properties": {
832
+ "object_name": {
833
+ "type": "string"
834
+ },
835
+ "materials": {
836
+ "type": "array",
837
+ "items": {
838
+ "type": "object",
839
+ "required": [
840
+ "name"
841
+ ],
842
+ "properties": {
843
+ "name": {
844
+ "type": "string"
845
+ },
846
+ "base_color_rgba": {
847
+ "type": "array"
848
+ },
849
+ "metallic": {
850
+ "type": "number"
851
+ },
852
+ "roughness": {
853
+ "type": "number"
854
+ }
855
+ }
856
+ }
857
+ }
858
+ }
859
+ },
860
+ "required_capability_tier": "L0",
861
+ "required_governed_runtime_ceiling": "L0",
862
+ "governing_skills": [
863
+ "material-quality-checker",
864
+ "lighting-material-plan"
865
+ ],
866
+ "side_effect_classification": "none",
867
+ "behavior": "read_only",
868
+ "idempotency": "idempotent_read",
869
+ "required_preconditions": [
870
+ {
871
+ "check_id": "pre.target_object_exists",
872
+ "description": "Target object must exist in the active scene.",
873
+ "blocking": true
874
+ }
875
+ ],
876
+ "required_postconditions": [
877
+ {
878
+ "check_id": "post.material_slots_returned",
879
+ "description": "Material slot list is returned without mutating shader nodes.",
880
+ "verification_method": "read_only_response_schema"
881
+ }
882
+ ],
883
+ "backup_requirement": "none",
884
+ "approval_requirement": "none",
885
+ "asset_license_requirement": "none",
886
+ "version_constraints": {
887
+ "path_1_min_blender": "5.1.0",
888
+ "path_2_min_blender": "3.0.0"
889
+ },
890
+ "timeout_and_retry_policy": {
891
+ "timeout_ms": 5000,
892
+ "max_retries": 1,
893
+ "retry_on_timeout": true,
894
+ "ambiguous_timeout_behavior": "halt_and_inspect_no_blind_retry"
895
+ },
896
+ "evidence_requirements": {
897
+ "required_packet_type": "preview-check",
898
+ "requires_independent_readback": false,
899
+ "requires_checkpoint_hash": false
900
+ },
901
+ "user_facing_python_allowed": false,
902
+ "known_limitations": [
903
+ "Custom procedural node groups are summarized by top-level slot name."
904
+ ]
905
+ },
906
+ {
907
+ "operation_id": "op.inspect.camera-and-lighting",
908
+ "display_name": "Inspect Camera & Lighting Rig State",
909
+ "purpose": "Inspect active camera transform, focal length, DOF settings, and scene light energy/color/transform parameters.",
910
+ "category": "inspection",
911
+ "supported_runtime_paths": [
912
+ "path-1-host-a",
913
+ "path-1-host-b",
914
+ "path-2-community"
915
+ ],
916
+ "runtime_tool_mappings": {
917
+ "path-1-host-a": {
918
+ "primary_tool": "get_objects_summary",
919
+ "readback_tools": [
920
+ "get_objects_summary"
921
+ ],
922
+ "parameter_adapter": "lab_mcp_camera_light_summary",
923
+ "mutation_transport_note": "Read-only Lab MCP camera and lighting inspection.",
924
+ "upstream_mcp_tool_name": "get_objects_summary",
925
+ "tool_schema_fingerprint": "19105e512c7b198ac0a0cbf9f2b9f64d07258a4a97370a78c7b637379b33944f",
926
+ "upstream_qualification_status": "qualified_read_only",
927
+ "requires_bounded_governed_extension": false,
928
+ "rollback_strategy": "none_read_only",
929
+ "qualification_evidence": "Verified against real upstream Blender Lab MCP (blmcp) v1.0.2 tool get_objects_summary (https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_objects_summary.py)."
930
+ },
931
+ "path-1-host-b": {
932
+ "primary_tool": "get_objects_summary",
933
+ "readback_tools": [
934
+ "get_objects_summary"
935
+ ],
936
+ "parameter_adapter": "lab_mcp_camera_light_summary",
937
+ "mutation_transport_note": "Read-only Lab MCP camera and lighting inspection.",
938
+ "upstream_mcp_tool_name": "get_objects_summary",
939
+ "tool_schema_fingerprint": "19105e512c7b198ac0a0cbf9f2b9f64d07258a4a97370a78c7b637379b33944f",
940
+ "upstream_qualification_status": "qualified_read_only",
941
+ "requires_bounded_governed_extension": false,
942
+ "rollback_strategy": "none_read_only",
943
+ "qualification_evidence": "Verified against real upstream Blender Lab MCP (blmcp) v1.0.2 tool get_objects_summary (https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_objects_summary.py)."
944
+ },
945
+ "path-2-community": {
946
+ "primary_tool": "get_scene_info",
947
+ "secondary_tools": [
948
+ "get_object_info"
949
+ ],
950
+ "readback_tools": [
951
+ "get_scene_info",
952
+ "get_object_info"
953
+ ],
954
+ "parameter_adapter": "community_mcp_camera_light_summary",
955
+ "mutation_transport_note": "Read-only community camera and light inspection.",
956
+ "upstream_mcp_tool_name": "get_scene_info",
957
+ "tool_schema_fingerprint": "caa384b8584c6d54ebfd6194ab612e0eaa3e6a54fa8bacdc5134b03cf7963566",
958
+ "upstream_qualification_status": "qualified_read_only",
959
+ "requires_bounded_governed_extension": false,
960
+ "rollback_strategy": "none_read_only",
961
+ "qualification_evidence": "Verified against real upstream MCP for Blender (ahujasid/mcp-for-blender) v2.2.7 tool get_scene_info (https://github.com/ahujasid/blender-mcp/blob/main/src/blender_mcp/server.py#L607)."
962
+ }
963
+ },
964
+ "input_schema": {
965
+ "type": "object",
966
+ "additionalProperties": false,
967
+ "required": [],
968
+ "properties": {
969
+ "camera_name": {
970
+ "type": "string",
971
+ "minLength": 1
972
+ },
973
+ "light_names": {
974
+ "type": "array",
975
+ "items": {
976
+ "type": "string",
977
+ "minLength": 1
978
+ }
979
+ }
980
+ }
981
+ },
982
+ "output_schema": {
983
+ "type": "object",
984
+ "required": [
985
+ "cameras",
986
+ "lights"
987
+ ],
988
+ "properties": {
989
+ "cameras": {
990
+ "type": "array"
991
+ },
992
+ "lights": {
993
+ "type": "array"
994
+ }
995
+ }
996
+ },
997
+ "required_capability_tier": "L0",
998
+ "required_governed_runtime_ceiling": "L0",
999
+ "governing_skills": [
1000
+ "camera-composition",
1001
+ "lighting-quality-checker",
1002
+ "composition-quality-checker"
1003
+ ],
1004
+ "side_effect_classification": "none",
1005
+ "behavior": "read_only",
1006
+ "idempotency": "idempotent_read",
1007
+ "required_preconditions": [
1008
+ {
1009
+ "check_id": "pre.runtime_connected",
1010
+ "description": "External MCP runtime session must be connected.",
1011
+ "blocking": true
1012
+ }
1013
+ ],
1014
+ "required_postconditions": [
1015
+ {
1016
+ "check_id": "post.camera_and_lights_returned",
1017
+ "description": "Camera and light state arrays are returned without mutating the scene.",
1018
+ "verification_method": "read_only_response_schema"
1019
+ }
1020
+ ],
1021
+ "backup_requirement": "none",
1022
+ "approval_requirement": "none",
1023
+ "asset_license_requirement": "none",
1024
+ "version_constraints": {
1025
+ "path_1_min_blender": "5.1.0",
1026
+ "path_2_min_blender": "3.0.0"
1027
+ },
1028
+ "timeout_and_retry_policy": {
1029
+ "timeout_ms": 5000,
1030
+ "max_retries": 1,
1031
+ "retry_on_timeout": true,
1032
+ "ambiguous_timeout_behavior": "halt_and_inspect_no_blind_retry"
1033
+ },
1034
+ "evidence_requirements": {
1035
+ "required_packet_type": "preview-check",
1036
+ "requires_independent_readback": false,
1037
+ "requires_checkpoint_hash": false
1038
+ },
1039
+ "user_facing_python_allowed": false,
1040
+ "known_limitations": [
1041
+ "Reports existing cameras and lights only; does not synthesize missing rigs."
1042
+ ]
1043
+ },
1044
+ {
1045
+ "operation_id": "op.inspect.render-settings",
1046
+ "display_name": "Inspect Render Engine, Resolution & Color Management",
1047
+ "purpose": "Inspect active render engine (CYCLES or BLENDER_EEVEE), output resolution, sample budget, and AgX/Filmic view transform.",
1048
+ "category": "inspection",
1049
+ "supported_runtime_paths": [
1050
+ "path-1-host-a",
1051
+ "path-1-host-b",
1052
+ "path-2-community"
1053
+ ],
1054
+ "runtime_tool_mappings": {
1055
+ "path-1-host-a": {
1056
+ "primary_tool": "get_blendfile_summary_datablocks",
1057
+ "readback_tools": [
1058
+ "get_blendfile_summary_datablocks"
1059
+ ],
1060
+ "parameter_adapter": "lab_mcp_render_settings",
1061
+ "mutation_transport_note": "Read-only Lab MCP render settings inspection.",
1062
+ "upstream_mcp_tool_name": "get_blendfile_summary_datablocks",
1063
+ "tool_schema_fingerprint": "2b831a66bd41ba97d47055f4b5b51ce8b7387fbe7b2f2c294d251d4b8d658c73",
1064
+ "upstream_qualification_status": "qualified_read_only",
1065
+ "requires_bounded_governed_extension": false,
1066
+ "rollback_strategy": "none_read_only",
1067
+ "qualification_evidence": "Verified against real upstream Blender Lab MCP (blmcp) v1.0.2 tool get_blendfile_summary_datablocks (https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_blendfile_summary_datablocks.py)."
1068
+ },
1069
+ "path-1-host-b": {
1070
+ "primary_tool": "get_blendfile_summary_datablocks",
1071
+ "readback_tools": [
1072
+ "get_blendfile_summary_datablocks"
1073
+ ],
1074
+ "parameter_adapter": "lab_mcp_render_settings",
1075
+ "mutation_transport_note": "Read-only Lab MCP render settings inspection.",
1076
+ "upstream_mcp_tool_name": "get_blendfile_summary_datablocks",
1077
+ "tool_schema_fingerprint": "2b831a66bd41ba97d47055f4b5b51ce8b7387fbe7b2f2c294d251d4b8d658c73",
1078
+ "upstream_qualification_status": "qualified_read_only",
1079
+ "requires_bounded_governed_extension": false,
1080
+ "rollback_strategy": "none_read_only",
1081
+ "qualification_evidence": "Verified against real upstream Blender Lab MCP (blmcp) v1.0.2 tool get_blendfile_summary_datablocks (https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_blendfile_summary_datablocks.py)."
1082
+ },
1083
+ "path-2-community": {
1084
+ "primary_tool": "get_scene_info",
1085
+ "readback_tools": [
1086
+ "get_scene_info"
1087
+ ],
1088
+ "parameter_adapter": "community_mcp_render_settings",
1089
+ "mutation_transport_note": "Read-only community render settings inspection.",
1090
+ "upstream_mcp_tool_name": "get_scene_info",
1091
+ "tool_schema_fingerprint": "caa384b8584c6d54ebfd6194ab612e0eaa3e6a54fa8bacdc5134b03cf7963566",
1092
+ "upstream_qualification_status": "qualified_read_only",
1093
+ "requires_bounded_governed_extension": false,
1094
+ "rollback_strategy": "none_read_only",
1095
+ "qualification_evidence": "Verified against real upstream MCP for Blender (ahujasid/mcp-for-blender) v2.2.7 tool get_scene_info (https://github.com/ahujasid/blender-mcp/blob/main/src/blender_mcp/server.py#L607)."
1096
+ }
1097
+ },
1098
+ "input_schema": {
1099
+ "type": "object",
1100
+ "additionalProperties": false,
1101
+ "required": [],
1102
+ "properties": {
1103
+ "scene_name": {
1104
+ "type": "string"
1105
+ }
1106
+ }
1107
+ },
1108
+ "output_schema": {
1109
+ "type": "object",
1110
+ "required": [
1111
+ "render_engine",
1112
+ "resolution_x",
1113
+ "resolution_y",
1114
+ "view_transform"
1115
+ ],
1116
+ "properties": {
1117
+ "render_engine": {
1118
+ "type": "string"
1119
+ },
1120
+ "resolution_x": {
1121
+ "type": "integer"
1122
+ },
1123
+ "resolution_y": {
1124
+ "type": "integer"
1125
+ },
1126
+ "view_transform": {
1127
+ "type": "string"
1128
+ }
1129
+ }
1130
+ },
1131
+ "required_capability_tier": "L0",
1132
+ "required_governed_runtime_ceiling": "L0",
1133
+ "governing_skills": [
1134
+ "cycles-vs-eevee-decision",
1135
+ "resolution-aspect-decision",
1136
+ "color-management-decision"
1137
+ ],
1138
+ "side_effect_classification": "none",
1139
+ "behavior": "read_only",
1140
+ "idempotency": "idempotent_read",
1141
+ "required_preconditions": [
1142
+ {
1143
+ "check_id": "pre.runtime_connected",
1144
+ "description": "External MCP runtime session must be connected.",
1145
+ "blocking": true
1146
+ }
1147
+ ],
1148
+ "required_postconditions": [
1149
+ {
1150
+ "check_id": "post.render_settings_returned",
1151
+ "description": "Render engine, resolution, and view transform are returned.",
1152
+ "verification_method": "read_only_response_schema"
1153
+ }
1154
+ ],
1155
+ "backup_requirement": "none",
1156
+ "approval_requirement": "none",
1157
+ "asset_license_requirement": "none",
1158
+ "version_constraints": {
1159
+ "path_1_min_blender": "5.1.0",
1160
+ "path_2_min_blender": "3.0.0"
1161
+ },
1162
+ "timeout_and_retry_policy": {
1163
+ "timeout_ms": 5000,
1164
+ "max_retries": 1,
1165
+ "retry_on_timeout": true,
1166
+ "ambiguous_timeout_behavior": "halt_and_inspect_no_blind_retry"
1167
+ },
1168
+ "evidence_requirements": {
1169
+ "required_packet_type": "preview-check",
1170
+ "requires_independent_readback": false,
1171
+ "requires_checkpoint_hash": false
1172
+ },
1173
+ "user_facing_python_allowed": false,
1174
+ "known_limitations": [
1175
+ "Eevee identifier is BLENDER_EEVEE on Blender 5.x and BLENDER_EEVEE_NEXT on Blender 4.2-4.x."
1176
+ ]
1177
+ },
1178
+ {
1179
+ "operation_id": "op.inspect.scene-hierarchy",
1180
+ "display_name": "Inspect Scene Hierarchy & Transform Scale Hygiene",
1181
+ "purpose": "Inspect parent-child relationships, collection organization, and non-uniform or negative scale anomalies.",
1182
+ "category": "inspection",
1183
+ "supported_runtime_paths": [
1184
+ "path-1-host-a",
1185
+ "path-1-host-b",
1186
+ "path-2-community"
1187
+ ],
1188
+ "runtime_tool_mappings": {
1189
+ "path-1-host-a": {
1190
+ "primary_tool": "get_objects_summary",
1191
+ "readback_tools": [
1192
+ "get_objects_summary"
1193
+ ],
1194
+ "parameter_adapter": "lab_mcp_hierarchy_summary",
1195
+ "mutation_transport_note": "Read-only Lab MCP hierarchy inspection.",
1196
+ "upstream_mcp_tool_name": "get_objects_summary",
1197
+ "tool_schema_fingerprint": "19105e512c7b198ac0a0cbf9f2b9f64d07258a4a97370a78c7b637379b33944f",
1198
+ "upstream_qualification_status": "qualified_read_only",
1199
+ "requires_bounded_governed_extension": false,
1200
+ "rollback_strategy": "none_read_only",
1201
+ "qualification_evidence": "Verified against real upstream Blender Lab MCP (blmcp) v1.0.2 tool get_objects_summary (https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_objects_summary.py)."
1202
+ },
1203
+ "path-1-host-b": {
1204
+ "primary_tool": "get_objects_summary",
1205
+ "readback_tools": [
1206
+ "get_objects_summary"
1207
+ ],
1208
+ "parameter_adapter": "lab_mcp_hierarchy_summary",
1209
+ "mutation_transport_note": "Read-only Lab MCP hierarchy inspection.",
1210
+ "upstream_mcp_tool_name": "get_objects_summary",
1211
+ "tool_schema_fingerprint": "19105e512c7b198ac0a0cbf9f2b9f64d07258a4a97370a78c7b637379b33944f",
1212
+ "upstream_qualification_status": "qualified_read_only",
1213
+ "requires_bounded_governed_extension": false,
1214
+ "rollback_strategy": "none_read_only",
1215
+ "qualification_evidence": "Verified against real upstream Blender Lab MCP (blmcp) v1.0.2 tool get_objects_summary (https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_objects_summary.py)."
1216
+ },
1217
+ "path-2-community": {
1218
+ "primary_tool": "get_scene_info",
1219
+ "readback_tools": [
1220
+ "get_scene_info"
1221
+ ],
1222
+ "parameter_adapter": "community_mcp_hierarchy_summary",
1223
+ "mutation_transport_note": "Read-only community scene hierarchy inspection.",
1224
+ "upstream_mcp_tool_name": "get_scene_info",
1225
+ "tool_schema_fingerprint": "caa384b8584c6d54ebfd6194ab612e0eaa3e6a54fa8bacdc5134b03cf7963566",
1226
+ "upstream_qualification_status": "qualified_read_only",
1227
+ "requires_bounded_governed_extension": false,
1228
+ "rollback_strategy": "none_read_only",
1229
+ "qualification_evidence": "Verified against real upstream MCP for Blender (ahujasid/mcp-for-blender) v2.2.7 tool get_scene_info (https://github.com/ahujasid/blender-mcp/blob/main/src/blender_mcp/server.py#L607)."
1230
+ }
1231
+ },
1232
+ "input_schema": {
1233
+ "type": "object",
1234
+ "additionalProperties": false,
1235
+ "required": [],
1236
+ "properties": {
1237
+ "check_unapplied_scale": {
1238
+ "type": "boolean"
1239
+ }
1240
+ }
1241
+ },
1242
+ "output_schema": {
1243
+ "type": "object",
1244
+ "required": [
1245
+ "root_objects",
1246
+ "negative_scale_objects",
1247
+ "unapplied_scale_objects"
1248
+ ],
1249
+ "properties": {
1250
+ "root_objects": {
1251
+ "type": "array"
1252
+ },
1253
+ "negative_scale_objects": {
1254
+ "type": "array"
1255
+ },
1256
+ "unapplied_scale_objects": {
1257
+ "type": "array"
1258
+ }
1259
+ }
1260
+ },
1261
+ "required_capability_tier": "L0",
1262
+ "required_governed_runtime_ceiling": "L0",
1263
+ "governing_skills": [
1264
+ "scene-readiness",
1265
+ "pre-handoff-verification"
1266
+ ],
1267
+ "side_effect_classification": "none",
1268
+ "behavior": "read_only",
1269
+ "idempotency": "idempotent_read",
1270
+ "required_preconditions": [
1271
+ {
1272
+ "check_id": "pre.runtime_connected",
1273
+ "description": "External MCP runtime session must be connected.",
1274
+ "blocking": true
1275
+ }
1276
+ ],
1277
+ "required_postconditions": [
1278
+ {
1279
+ "check_id": "post.hierarchy_summary_returned",
1280
+ "description": "Root objects and scale hygiene lists are returned.",
1281
+ "verification_method": "read_only_response_schema"
1282
+ }
1283
+ ],
1284
+ "backup_requirement": "none",
1285
+ "approval_requirement": "none",
1286
+ "asset_license_requirement": "none",
1287
+ "version_constraints": {
1288
+ "path_1_min_blender": "5.1.0",
1289
+ "path_2_min_blender": "3.0.0"
1290
+ },
1291
+ "timeout_and_retry_policy": {
1292
+ "timeout_ms": 5000,
1293
+ "max_retries": 1,
1294
+ "retry_on_timeout": true,
1295
+ "ambiguous_timeout_behavior": "halt_and_inspect_no_blind_retry"
1296
+ },
1297
+ "evidence_requirements": {
1298
+ "required_packet_type": "preview-check",
1299
+ "requires_independent_readback": false,
1300
+ "requires_checkpoint_hash": false
1301
+ },
1302
+ "user_facing_python_allowed": false,
1303
+ "known_limitations": [
1304
+ "Does not automatically apply transforms; flags unapplied or negative scale for preflight."
1305
+ ]
1306
+ },
1307
+ {
1308
+ "operation_id": "op.inspect.animation-metadata",
1309
+ "display_name": "Inspect Animation Clips, NLA Tracks & Armature Metadata",
1310
+ "purpose": "Inspect action datablocks, NLA strips, frame range, and armature skinning presence prior to GLB animation handoff.",
1311
+ "category": "inspection",
1312
+ "supported_runtime_paths": [
1313
+ "path-1-host-a",
1314
+ "path-1-host-b",
1315
+ "path-2-community"
1316
+ ],
1317
+ "runtime_tool_mappings": {
1318
+ "path-1-host-a": {
1319
+ "primary_tool": "get_blendfile_summary_datablocks",
1320
+ "secondary_tools": [
1321
+ "get_objects_summary"
1322
+ ],
1323
+ "readback_tools": [
1324
+ "get_blendfile_summary_datablocks"
1325
+ ],
1326
+ "parameter_adapter": "lab_mcp_animation_metadata",
1327
+ "mutation_transport_note": "Read-only Lab MCP action/armature datablock inspection.",
1328
+ "upstream_mcp_tool_name": "get_blendfile_summary_datablocks",
1329
+ "tool_schema_fingerprint": "2b831a66bd41ba97d47055f4b5b51ce8b7387fbe7b2f2c294d251d4b8d658c73",
1330
+ "upstream_qualification_status": "qualified_read_only",
1331
+ "requires_bounded_governed_extension": false,
1332
+ "rollback_strategy": "none_read_only",
1333
+ "qualification_evidence": "Verified against real upstream Blender Lab MCP (blmcp) v1.0.2 tool get_blendfile_summary_datablocks (https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_blendfile_summary_datablocks.py)."
1334
+ },
1335
+ "path-1-host-b": {
1336
+ "primary_tool": "get_blendfile_summary_datablocks",
1337
+ "secondary_tools": [
1338
+ "get_objects_summary"
1339
+ ],
1340
+ "readback_tools": [
1341
+ "get_blendfile_summary_datablocks"
1342
+ ],
1343
+ "parameter_adapter": "lab_mcp_animation_metadata",
1344
+ "mutation_transport_note": "Read-only Lab MCP action/armature datablock inspection.",
1345
+ "upstream_mcp_tool_name": "get_blendfile_summary_datablocks",
1346
+ "tool_schema_fingerprint": "2b831a66bd41ba97d47055f4b5b51ce8b7387fbe7b2f2c294d251d4b8d658c73",
1347
+ "upstream_qualification_status": "qualified_read_only",
1348
+ "requires_bounded_governed_extension": false,
1349
+ "rollback_strategy": "none_read_only",
1350
+ "qualification_evidence": "Verified against real upstream Blender Lab MCP (blmcp) v1.0.2 tool get_blendfile_summary_datablocks (https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_blendfile_summary_datablocks.py)."
1351
+ },
1352
+ "path-2-community": {
1353
+ "primary_tool": "get_scene_info",
1354
+ "readback_tools": [
1355
+ "get_scene_info"
1356
+ ],
1357
+ "parameter_adapter": "community_mcp_animation_metadata",
1358
+ "mutation_transport_note": "Read-only community animation metadata inspection.",
1359
+ "upstream_mcp_tool_name": "get_scene_info",
1360
+ "tool_schema_fingerprint": "caa384b8584c6d54ebfd6194ab612e0eaa3e6a54fa8bacdc5134b03cf7963566",
1361
+ "upstream_qualification_status": "qualified_read_only",
1362
+ "requires_bounded_governed_extension": false,
1363
+ "rollback_strategy": "none_read_only",
1364
+ "qualification_evidence": "Verified against real upstream MCP for Blender (ahujasid/mcp-for-blender) v2.2.7 tool get_scene_info (https://github.com/ahujasid/blender-mcp/blob/main/src/blender_mcp/server.py#L607)."
1365
+ }
1366
+ },
1367
+ "input_schema": {
1368
+ "type": "object",
1369
+ "additionalProperties": false,
1370
+ "required": [],
1371
+ "properties": {
1372
+ "armature_name": {
1373
+ "type": "string"
1374
+ }
1375
+ }
1376
+ },
1377
+ "output_schema": {
1378
+ "type": "object",
1379
+ "required": [
1380
+ "action_count",
1381
+ "armature_count",
1382
+ "frame_start",
1383
+ "frame_end"
1384
+ ],
1385
+ "properties": {
1386
+ "action_count": {
1387
+ "type": "integer",
1388
+ "minimum": 0
1389
+ },
1390
+ "armature_count": {
1391
+ "type": "integer",
1392
+ "minimum": 0
1393
+ },
1394
+ "frame_start": {
1395
+ "type": "integer"
1396
+ },
1397
+ "frame_end": {
1398
+ "type": "integer"
1399
+ }
1400
+ }
1401
+ },
1402
+ "required_capability_tier": "L0",
1403
+ "required_governed_runtime_ceiling": "L0",
1404
+ "governing_skills": [
1405
+ "glb-animation-handoff",
1406
+ "scene-readiness"
1407
+ ],
1408
+ "side_effect_classification": "none",
1409
+ "behavior": "read_only",
1410
+ "idempotency": "idempotent_read",
1411
+ "required_preconditions": [
1412
+ {
1413
+ "check_id": "pre.runtime_connected",
1414
+ "description": "External MCP runtime session must be connected.",
1415
+ "blocking": true
1416
+ }
1417
+ ],
1418
+ "required_postconditions": [
1419
+ {
1420
+ "check_id": "post.animation_metadata_returned",
1421
+ "description": "Action count, armature count, and frame range are returned.",
1422
+ "verification_method": "read_only_response_schema"
1423
+ }
1424
+ ],
1425
+ "backup_requirement": "none",
1426
+ "approval_requirement": "none",
1427
+ "asset_license_requirement": "none",
1428
+ "version_constraints": {
1429
+ "path_1_min_blender": "5.1.0",
1430
+ "path_2_min_blender": "3.0.0"
1431
+ },
1432
+ "timeout_and_retry_policy": {
1433
+ "timeout_ms": 5000,
1434
+ "max_retries": 1,
1435
+ "retry_on_timeout": true,
1436
+ "ambiguous_timeout_behavior": "halt_and_inspect_no_blind_retry"
1437
+ },
1438
+ "evidence_requirements": {
1439
+ "required_packet_type": "preview-check",
1440
+ "requires_independent_readback": false,
1441
+ "requires_checkpoint_hash": false
1442
+ },
1443
+ "user_facing_python_allowed": false,
1444
+ "known_limitations": [
1445
+ "Does not bake constraints or NLA strips during L0 inspection."
1446
+ ]
1447
+ },
1448
+ {
1449
+ "operation_id": "op.inspect.glb-export-readiness",
1450
+ "display_name": "Inspect GLB Export Readiness (Zero File Write)",
1451
+ "purpose": "Verify missing external textures, linked libraries, scale hygiene, and PBR compatibility before any GLB export is attempted.",
1452
+ "category": "inspection",
1453
+ "supported_runtime_paths": [
1454
+ "path-1-host-a",
1455
+ "path-1-host-b",
1456
+ "path-2-community"
1457
+ ],
1458
+ "runtime_tool_mappings": {
1459
+ "path-1-host-a": {
1460
+ "primary_tool": "get_blendfile_summary_missing_files",
1461
+ "secondary_tools": [
1462
+ "get_blendfile_summary_of_linked_libraries",
1463
+ "get_objects_summary"
1464
+ ],
1465
+ "readback_tools": [
1466
+ "get_blendfile_summary_missing_files"
1467
+ ],
1468
+ "parameter_adapter": "lab_mcp_glb_readiness",
1469
+ "mutation_transport_note": "Read-only Lab MCP missing-files and linked-library check.",
1470
+ "upstream_mcp_tool_name": "get_blendfile_summary_missing_files",
1471
+ "tool_schema_fingerprint": "51ac3be903d237d241ef285e86d899963306807b86b760d35fdb8089ea7d4c08",
1472
+ "upstream_qualification_status": "qualified_read_only",
1473
+ "requires_bounded_governed_extension": false,
1474
+ "rollback_strategy": "none_read_only",
1475
+ "qualification_evidence": "Verified against real upstream Blender Lab MCP (blmcp) v1.0.2 tool get_blendfile_summary_missing_files (https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_blendfile_summary_missing_files.py)."
1476
+ },
1477
+ "path-1-host-b": {
1478
+ "primary_tool": "get_blendfile_summary_missing_files",
1479
+ "secondary_tools": [
1480
+ "get_blendfile_summary_of_linked_libraries",
1481
+ "get_objects_summary"
1482
+ ],
1483
+ "readback_tools": [
1484
+ "get_blendfile_summary_missing_files"
1485
+ ],
1486
+ "parameter_adapter": "lab_mcp_glb_readiness",
1487
+ "mutation_transport_note": "Read-only Lab MCP missing-files and linked-library check.",
1488
+ "upstream_mcp_tool_name": "get_blendfile_summary_missing_files",
1489
+ "tool_schema_fingerprint": "51ac3be903d237d241ef285e86d899963306807b86b760d35fdb8089ea7d4c08",
1490
+ "upstream_qualification_status": "qualified_read_only",
1491
+ "requires_bounded_governed_extension": false,
1492
+ "rollback_strategy": "none_read_only",
1493
+ "qualification_evidence": "Verified against real upstream Blender Lab MCP (blmcp) v1.0.2 tool get_blendfile_summary_missing_files (https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_blendfile_summary_missing_files.py)."
1494
+ },
1495
+ "path-2-community": {
1496
+ "primary_tool": "get_scene_info",
1497
+ "secondary_tools": [
1498
+ "get_object_info"
1499
+ ],
1500
+ "readback_tools": [
1501
+ "get_scene_info"
1502
+ ],
1503
+ "parameter_adapter": "community_mcp_glb_readiness",
1504
+ "mutation_transport_note": "Read-only community scene and object GLB readiness check.",
1505
+ "upstream_mcp_tool_name": "get_scene_info",
1506
+ "tool_schema_fingerprint": "caa384b8584c6d54ebfd6194ab612e0eaa3e6a54fa8bacdc5134b03cf7963566",
1507
+ "upstream_qualification_status": "qualified_read_only",
1508
+ "requires_bounded_governed_extension": false,
1509
+ "rollback_strategy": "none_read_only",
1510
+ "qualification_evidence": "Verified against real upstream MCP for Blender (ahujasid/mcp-for-blender) v2.2.7 tool get_scene_info (https://github.com/ahujasid/blender-mcp/blob/main/src/blender_mcp/server.py#L607)."
1511
+ }
1512
+ },
1513
+ "input_schema": {
1514
+ "type": "object",
1515
+ "additionalProperties": false,
1516
+ "required": [],
1517
+ "properties": {
1518
+ "target_profile": {
1519
+ "type": "string",
1520
+ "enum": [
1521
+ "desktop_web",
1522
+ "mobile_web",
1523
+ "hybrid_render_and_web"
1524
+ ]
1525
+ }
1526
+ }
1527
+ },
1528
+ "output_schema": {
1529
+ "type": "object",
1530
+ "required": [
1531
+ "export_ready",
1532
+ "missing_files_count",
1533
+ "linked_libraries_count",
1534
+ "blockers"
1535
+ ],
1536
+ "properties": {
1537
+ "export_ready": {
1538
+ "type": "boolean"
1539
+ },
1540
+ "missing_files_count": {
1541
+ "type": "integer",
1542
+ "minimum": 0
1543
+ },
1544
+ "linked_libraries_count": {
1545
+ "type": "integer",
1546
+ "minimum": 0
1547
+ },
1548
+ "blockers": {
1549
+ "type": "array",
1550
+ "items": {
1551
+ "type": "string"
1552
+ }
1553
+ }
1554
+ }
1555
+ },
1556
+ "required_capability_tier": "L0",
1557
+ "required_governed_runtime_ceiling": "L0",
1558
+ "governing_skills": [
1559
+ "pre-handoff-verification",
1560
+ "glb-web-handoff",
1561
+ "mobile-glb-budget"
1562
+ ],
1563
+ "side_effect_classification": "none",
1564
+ "behavior": "read_only",
1565
+ "idempotency": "idempotent_read",
1566
+ "required_preconditions": [
1567
+ {
1568
+ "check_id": "pre.runtime_connected",
1569
+ "description": "External MCP runtime session must be connected.",
1570
+ "blocking": true
1571
+ }
1572
+ ],
1573
+ "required_postconditions": [
1574
+ {
1575
+ "check_id": "post.glb_readiness_evaluated",
1576
+ "description": "Readiness report is returned with zero files written to disk.",
1577
+ "verification_method": "read_only_response_schema"
1578
+ }
1579
+ ],
1580
+ "backup_requirement": "none",
1581
+ "approval_requirement": "none",
1582
+ "asset_license_requirement": "none",
1583
+ "version_constraints": {
1584
+ "path_1_min_blender": "5.1.0",
1585
+ "path_2_min_blender": "3.0.0"
1586
+ },
1587
+ "timeout_and_retry_policy": {
1588
+ "timeout_ms": 5000,
1589
+ "max_retries": 1,
1590
+ "retry_on_timeout": true,
1591
+ "ambiguous_timeout_behavior": "halt_and_inspect_no_blind_retry"
1592
+ },
1593
+ "evidence_requirements": {
1594
+ "required_packet_type": "preview-check",
1595
+ "requires_independent_readback": false,
1596
+ "requires_checkpoint_hash": false
1597
+ },
1598
+ "user_facing_python_allowed": false,
1599
+ "known_limitations": [
1600
+ "Does not perform a .glb file export; evaluates scene readiness only."
1601
+ ]
1602
+ },
1603
+ {
1604
+ "operation_id": "op.mutate.camera-transform-and-lens",
1605
+ "display_name": "Update Existing Camera Transform & Lens Settings",
1606
+ "purpose": "Apply bounded, reversible location, Euler rotation, focal length (mm), and DOF focus distance updates to an existing camera after a verified .blend checkpoint.",
1607
+ "category": "mutation",
1608
+ "supported_runtime_paths": [
1609
+ "path-1-host-a",
1610
+ "path-1-host-b",
1611
+ "path-2-community"
1612
+ ],
1613
+ "runtime_tool_mappings": {
1614
+ "path-1-host-a": {
1615
+ "primary_tool": "set_camera_properties_governed",
1616
+ "readback_tools": [
1617
+ "get_objects_summary"
1618
+ ],
1619
+ "parameter_adapter": "lab_mcp_camera_mutation",
1620
+ "mutation_transport_note": "Constrained camera property update on Path 1 after verified .blend checkpoint; never exposes raw Python to the user.",
1621
+ "upstream_mcp_tool_name": null,
1622
+ "tool_schema_fingerprint": "827d69856b08267683e41117cdab6879afb5eb56b7b954312b95f0d3adc0c542",
1623
+ "upstream_qualification_status": "blocked_missing_bounded_upstream_tool",
1624
+ "requires_bounded_governed_extension": true,
1625
+ "rollback_strategy": "restore_verified_pre_mutation_blend_checkpoint_and_independent_l0_readback",
1626
+ "qualification_evidence": "Upstream Blender Lab MCP v1.0.2 does not expose bounded tool set_camera_properties_governed and relies on execute_blender_code (unsafe_raw_code); blocked fail-closed on real upstream runtimes and never translated to generated Python."
1627
+ },
1628
+ "path-1-host-b": {
1629
+ "primary_tool": "set_camera_properties_governed",
1630
+ "readback_tools": [
1631
+ "get_objects_summary"
1632
+ ],
1633
+ "parameter_adapter": "lab_mcp_camera_mutation",
1634
+ "mutation_transport_note": "Constrained camera property update on Path 1 after verified .blend checkpoint; never exposes raw Python to the user.",
1635
+ "upstream_mcp_tool_name": null,
1636
+ "tool_schema_fingerprint": "827d69856b08267683e41117cdab6879afb5eb56b7b954312b95f0d3adc0c542",
1637
+ "upstream_qualification_status": "blocked_missing_bounded_upstream_tool",
1638
+ "requires_bounded_governed_extension": true,
1639
+ "rollback_strategy": "restore_verified_pre_mutation_blend_checkpoint_and_independent_l0_readback",
1640
+ "qualification_evidence": "Upstream Blender Lab MCP v1.0.2 does not expose bounded tool set_camera_properties_governed and relies on execute_blender_code (unsafe_raw_code); blocked fail-closed on real upstream runtimes and never translated to generated Python."
1641
+ },
1642
+ "path-2-community": {
1643
+ "primary_tool": "set_camera_properties_governed",
1644
+ "readback_tools": [
1645
+ "get_scene_info",
1646
+ "get_object_info"
1647
+ ],
1648
+ "parameter_adapter": "community_mcp_camera_mutation",
1649
+ "mutation_transport_note": "Constrained camera property update on Path 2 after verified .blend checkpoint; never exposes raw Python to the user.",
1650
+ "upstream_mcp_tool_name": null,
1651
+ "tool_schema_fingerprint": "827d69856b08267683e41117cdab6879afb5eb56b7b954312b95f0d3adc0c542",
1652
+ "upstream_qualification_status": "blocked_missing_bounded_upstream_tool",
1653
+ "requires_bounded_governed_extension": true,
1654
+ "rollback_strategy": "restore_verified_pre_mutation_blend_checkpoint_and_independent_l0_readback",
1655
+ "qualification_evidence": "Upstream mcp-for-blender v2.2.7 does not expose bounded tool set_camera_properties_governed and relies on execute_blender_code (unsafe_raw_code); blocked fail-closed on real upstream runtimes and never translated to generated Python."
1656
+ }
1657
+ },
1658
+ "input_schema": {
1659
+ "type": "object",
1660
+ "additionalProperties": false,
1661
+ "required": [
1662
+ "camera_name",
1663
+ "location",
1664
+ "rotation_euler_deg",
1665
+ "focal_length_mm"
1666
+ ],
1667
+ "properties": {
1668
+ "camera_name": {
1669
+ "type": "string",
1670
+ "minLength": 1,
1671
+ "maxLength": 128
1672
+ },
1673
+ "location": {
1674
+ "type": "array",
1675
+ "minItems": 3,
1676
+ "maxItems": 3,
1677
+ "items": {
1678
+ "type": "number",
1679
+ "minimum": -1000,
1680
+ "maximum": 1000
1681
+ }
1682
+ },
1683
+ "rotation_euler_deg": {
1684
+ "type": "array",
1685
+ "minItems": 3,
1686
+ "maxItems": 3,
1687
+ "items": {
1688
+ "type": "number",
1689
+ "minimum": -360,
1690
+ "maximum": 360
1691
+ }
1692
+ },
1693
+ "focal_length_mm": {
1694
+ "type": "number",
1695
+ "minimum": 12,
1696
+ "maximum": 300
1697
+ },
1698
+ "dof_enabled": {
1699
+ "type": "boolean"
1700
+ },
1701
+ "f_stop": {
1702
+ "type": "number",
1703
+ "minimum": 0.5,
1704
+ "maximum": 64
1705
+ }
1706
+ }
1707
+ },
1708
+ "output_schema": {
1709
+ "type": "object",
1710
+ "required": [
1711
+ "camera_name",
1712
+ "updated",
1713
+ "location",
1714
+ "rotation_euler_deg",
1715
+ "focal_length_mm"
1716
+ ],
1717
+ "properties": {
1718
+ "camera_name": {
1719
+ "type": "string"
1720
+ },
1721
+ "updated": {
1722
+ "type": "boolean"
1723
+ },
1724
+ "location": {
1725
+ "type": "array"
1726
+ },
1727
+ "rotation_euler_deg": {
1728
+ "type": "array"
1729
+ },
1730
+ "focal_length_mm": {
1731
+ "type": "number"
1732
+ }
1733
+ }
1734
+ },
1735
+ "required_capability_tier": "L1",
1736
+ "required_governed_runtime_ceiling": "L1",
1737
+ "governing_skills": [
1738
+ "camera-composition",
1739
+ "product-hero-scene-planner",
1740
+ "character-portrait"
1741
+ ],
1742
+ "side_effect_classification": "reversible_scene_mutation",
1743
+ "behavior": "mutating",
1744
+ "idempotency": "idempotent_set_state",
1745
+ "required_preconditions": [
1746
+ {
1747
+ "check_id": "pre.verified_blend_checkpoint",
1748
+ "description": "Pre-mutation .blend checkpoint must exist on disk with verified byteSize > 0 and SHA-256.",
1749
+ "blocking": true
1750
+ },
1751
+ {
1752
+ "check_id": "pre.camera_object_exists",
1753
+ "description": "Target camera_name must already exist in the scene as a CAMERA object.",
1754
+ "blocking": true
1755
+ }
1756
+ ],
1757
+ "required_postconditions": [
1758
+ {
1759
+ "check_id": "post.camera_state_matches_readback",
1760
+ "description": "Independent readback confirms camera location, rotation_euler_deg, and focal_length_mm match requested values within tolerance (0.001).",
1761
+ "verification_method": "independent_scene_readback"
1762
+ }
1763
+ ],
1764
+ "backup_requirement": "verified_pre_mutation_blend_checkpoint",
1765
+ "approval_requirement": "none",
1766
+ "asset_license_requirement": "none",
1767
+ "version_constraints": {
1768
+ "path_1_min_blender": "5.1.0",
1769
+ "path_2_min_blender": "3.0.0"
1770
+ },
1771
+ "timeout_and_retry_policy": {
1772
+ "timeout_ms": 8000,
1773
+ "max_retries": 0,
1774
+ "retry_on_timeout": false,
1775
+ "ambiguous_timeout_behavior": "halt_and_inspect_no_blind_retry"
1776
+ },
1777
+ "evidence_requirements": {
1778
+ "required_packet_type": "preview-check",
1779
+ "requires_independent_readback": true,
1780
+ "requires_checkpoint_hash": true
1781
+ },
1782
+ "user_facing_python_allowed": false,
1783
+ "known_limitations": [
1784
+ "Only updates an existing camera datablock; never creates or deletes cameras."
1785
+ ]
1786
+ },
1787
+ {
1788
+ "operation_id": "op.mutate.light-parameters",
1789
+ "display_name": "Update Existing Light Energy, Color & Transform",
1790
+ "purpose": "Apply bounded, reversible energy (Watts), RGB color, size, and transform updates to an existing light object after a verified .blend checkpoint.",
1791
+ "category": "mutation",
1792
+ "supported_runtime_paths": [
1793
+ "path-1-host-a",
1794
+ "path-1-host-b",
1795
+ "path-2-community"
1796
+ ],
1797
+ "runtime_tool_mappings": {
1798
+ "path-1-host-a": {
1799
+ "primary_tool": "set_light_properties_governed",
1800
+ "readback_tools": [
1801
+ "get_objects_summary"
1802
+ ],
1803
+ "parameter_adapter": "lab_mcp_light_mutation",
1804
+ "mutation_transport_note": "Constrained light parameter update on Path 1 after verified .blend checkpoint.",
1805
+ "upstream_mcp_tool_name": null,
1806
+ "tool_schema_fingerprint": "7f64a3a4fe668c5337bcc858735b38dec1ee3893a769852cb7986cd99d7045a5",
1807
+ "upstream_qualification_status": "blocked_missing_bounded_upstream_tool",
1808
+ "requires_bounded_governed_extension": true,
1809
+ "rollback_strategy": "restore_verified_pre_mutation_blend_checkpoint_and_independent_l0_readback",
1810
+ "qualification_evidence": "Upstream Blender Lab MCP v1.0.2 does not expose bounded tool set_light_properties_governed and relies on execute_blender_code (unsafe_raw_code); blocked fail-closed on real upstream runtimes and never translated to generated Python."
1811
+ },
1812
+ "path-1-host-b": {
1813
+ "primary_tool": "set_light_properties_governed",
1814
+ "readback_tools": [
1815
+ "get_objects_summary"
1816
+ ],
1817
+ "parameter_adapter": "lab_mcp_light_mutation",
1818
+ "mutation_transport_note": "Constrained light parameter update on Path 1 after verified .blend checkpoint.",
1819
+ "upstream_mcp_tool_name": null,
1820
+ "tool_schema_fingerprint": "7f64a3a4fe668c5337bcc858735b38dec1ee3893a769852cb7986cd99d7045a5",
1821
+ "upstream_qualification_status": "blocked_missing_bounded_upstream_tool",
1822
+ "requires_bounded_governed_extension": true,
1823
+ "rollback_strategy": "restore_verified_pre_mutation_blend_checkpoint_and_independent_l0_readback",
1824
+ "qualification_evidence": "Upstream Blender Lab MCP v1.0.2 does not expose bounded tool set_light_properties_governed and relies on execute_blender_code (unsafe_raw_code); blocked fail-closed on real upstream runtimes and never translated to generated Python."
1825
+ },
1826
+ "path-2-community": {
1827
+ "primary_tool": "set_light_properties_governed",
1828
+ "readback_tools": [
1829
+ "get_scene_info",
1830
+ "get_object_info"
1831
+ ],
1832
+ "parameter_adapter": "community_mcp_light_mutation",
1833
+ "mutation_transport_note": "Constrained light parameter update on Path 2 after verified .blend checkpoint.",
1834
+ "upstream_mcp_tool_name": null,
1835
+ "tool_schema_fingerprint": "7f64a3a4fe668c5337bcc858735b38dec1ee3893a769852cb7986cd99d7045a5",
1836
+ "upstream_qualification_status": "blocked_missing_bounded_upstream_tool",
1837
+ "requires_bounded_governed_extension": true,
1838
+ "rollback_strategy": "restore_verified_pre_mutation_blend_checkpoint_and_independent_l0_readback",
1839
+ "qualification_evidence": "Upstream mcp-for-blender v2.2.7 does not expose bounded tool set_light_properties_governed and relies on execute_blender_code (unsafe_raw_code); blocked fail-closed on real upstream runtimes and never translated to generated Python."
1840
+ }
1841
+ },
1842
+ "input_schema": {
1843
+ "type": "object",
1844
+ "additionalProperties": false,
1845
+ "required": [
1846
+ "light_name",
1847
+ "energy_watts",
1848
+ "color_rgb"
1849
+ ],
1850
+ "properties": {
1851
+ "light_name": {
1852
+ "type": "string",
1853
+ "minLength": 1,
1854
+ "maxLength": 128
1855
+ },
1856
+ "energy_watts": {
1857
+ "type": "number",
1858
+ "minimum": 0,
1859
+ "maximum": 100000
1860
+ },
1861
+ "color_rgb": {
1862
+ "type": "array",
1863
+ "minItems": 3,
1864
+ "maxItems": 3,
1865
+ "items": {
1866
+ "type": "number",
1867
+ "minimum": 0,
1868
+ "maximum": 1
1869
+ }
1870
+ },
1871
+ "location": {
1872
+ "type": "array",
1873
+ "minItems": 3,
1874
+ "maxItems": 3,
1875
+ "items": {
1876
+ "type": "number",
1877
+ "minimum": -1000,
1878
+ "maximum": 1000
1879
+ }
1880
+ },
1881
+ "rotation_euler_deg": {
1882
+ "type": "array",
1883
+ "minItems": 3,
1884
+ "maxItems": 3,
1885
+ "items": {
1886
+ "type": "number",
1887
+ "minimum": -360,
1888
+ "maximum": 360
1889
+ }
1890
+ },
1891
+ "area_size": {
1892
+ "type": "number",
1893
+ "minimum": 0.01,
1894
+ "maximum": 100
1895
+ }
1896
+ }
1897
+ },
1898
+ "output_schema": {
1899
+ "type": "object",
1900
+ "required": [
1901
+ "light_name",
1902
+ "updated",
1903
+ "energy_watts",
1904
+ "color_rgb"
1905
+ ],
1906
+ "properties": {
1907
+ "light_name": {
1908
+ "type": "string"
1909
+ },
1910
+ "updated": {
1911
+ "type": "boolean"
1912
+ },
1913
+ "energy_watts": {
1914
+ "type": "number"
1915
+ },
1916
+ "color_rgb": {
1917
+ "type": "array"
1918
+ },
1919
+ "location": {
1920
+ "type": "array"
1921
+ }
1922
+ }
1923
+ },
1924
+ "required_capability_tier": "L1",
1925
+ "required_governed_runtime_ceiling": "L1",
1926
+ "governing_skills": [
1927
+ "lighting-material-plan",
1928
+ "product-hero-scene-planner",
1929
+ "interior-scene"
1930
+ ],
1931
+ "side_effect_classification": "reversible_scene_mutation",
1932
+ "behavior": "mutating",
1933
+ "idempotency": "idempotent_set_state",
1934
+ "required_preconditions": [
1935
+ {
1936
+ "check_id": "pre.verified_blend_checkpoint",
1937
+ "description": "Pre-mutation .blend checkpoint must exist on disk with verified byteSize > 0 and SHA-256.",
1938
+ "blocking": true
1939
+ },
1940
+ {
1941
+ "check_id": "pre.light_object_exists",
1942
+ "description": "Target light_name must already exist in the scene as a LIGHT object.",
1943
+ "blocking": true
1944
+ }
1945
+ ],
1946
+ "required_postconditions": [
1947
+ {
1948
+ "check_id": "post.light_state_matches_readback",
1949
+ "description": "Independent readback confirms light energy_watts and color_rgb match requested values within tolerance (0.001).",
1950
+ "verification_method": "independent_scene_readback"
1951
+ }
1952
+ ],
1953
+ "backup_requirement": "verified_pre_mutation_blend_checkpoint",
1954
+ "approval_requirement": "none",
1955
+ "asset_license_requirement": "none",
1956
+ "version_constraints": {
1957
+ "path_1_min_blender": "5.1.0",
1958
+ "path_2_min_blender": "3.0.0"
1959
+ },
1960
+ "timeout_and_retry_policy": {
1961
+ "timeout_ms": 8000,
1962
+ "max_retries": 0,
1963
+ "retry_on_timeout": false,
1964
+ "ambiguous_timeout_behavior": "halt_and_inspect_no_blind_retry"
1965
+ },
1966
+ "evidence_requirements": {
1967
+ "required_packet_type": "preview-check",
1968
+ "requires_independent_readback": true,
1969
+ "requires_checkpoint_hash": true
1970
+ },
1971
+ "user_facing_python_allowed": false,
1972
+ "known_limitations": [
1973
+ "Only updates an existing LIGHT object; never creates duplicate lights."
1974
+ ]
1975
+ },
1976
+ {
1977
+ "operation_id": "op.mutate.material-pbr-properties",
1978
+ "display_name": "Update Existing Material Principled BSDF Properties",
1979
+ "purpose": "Apply bounded updates to allowlisted Principled BSDF inputs (base_color_rgba, metallic, roughness, ior) on an existing material.",
1980
+ "category": "mutation",
1981
+ "supported_runtime_paths": [
1982
+ "path-1-host-a",
1983
+ "path-1-host-b",
1984
+ "path-2-community"
1985
+ ],
1986
+ "runtime_tool_mappings": {
1987
+ "path-1-host-a": {
1988
+ "primary_tool": "set_material_pbr_governed",
1989
+ "readback_tools": [
1990
+ "get_blendfile_summary_datablocks",
1991
+ "get_objects_summary"
1992
+ ],
1993
+ "parameter_adapter": "lab_mcp_material_mutation",
1994
+ "mutation_transport_note": "Constrained Principled BSDF parameter update on Path 1 after verified .blend checkpoint.",
1995
+ "upstream_mcp_tool_name": null,
1996
+ "tool_schema_fingerprint": "0a7ea104353369d20883fd54dfa7542c592a1a931fe945e8cab07141a51637e1",
1997
+ "upstream_qualification_status": "blocked_missing_bounded_upstream_tool",
1998
+ "requires_bounded_governed_extension": true,
1999
+ "rollback_strategy": "restore_verified_pre_mutation_blend_checkpoint_and_independent_l0_readback",
2000
+ "qualification_evidence": "Upstream Blender Lab MCP v1.0.2 does not expose bounded tool set_material_pbr_governed and relies on execute_blender_code (unsafe_raw_code); blocked fail-closed on real upstream runtimes and never translated to generated Python."
2001
+ },
2002
+ "path-1-host-b": {
2003
+ "primary_tool": "set_material_pbr_governed",
2004
+ "readback_tools": [
2005
+ "get_blendfile_summary_datablocks",
2006
+ "get_objects_summary"
2007
+ ],
2008
+ "parameter_adapter": "lab_mcp_material_mutation",
2009
+ "mutation_transport_note": "Constrained Principled BSDF parameter update on Path 1 after verified .blend checkpoint.",
2010
+ "upstream_mcp_tool_name": null,
2011
+ "tool_schema_fingerprint": "0a7ea104353369d20883fd54dfa7542c592a1a931fe945e8cab07141a51637e1",
2012
+ "upstream_qualification_status": "blocked_missing_bounded_upstream_tool",
2013
+ "requires_bounded_governed_extension": true,
2014
+ "rollback_strategy": "restore_verified_pre_mutation_blend_checkpoint_and_independent_l0_readback",
2015
+ "qualification_evidence": "Upstream Blender Lab MCP v1.0.2 does not expose bounded tool set_material_pbr_governed and relies on execute_blender_code (unsafe_raw_code); blocked fail-closed on real upstream runtimes and never translated to generated Python."
2016
+ },
2017
+ "path-2-community": {
2018
+ "primary_tool": "set_material_pbr_governed",
2019
+ "readback_tools": [
2020
+ "get_object_info"
2021
+ ],
2022
+ "parameter_adapter": "community_mcp_material_mutation",
2023
+ "mutation_transport_note": "Constrained Principled BSDF parameter update on Path 2 after verified .blend checkpoint.",
2024
+ "upstream_mcp_tool_name": null,
2025
+ "tool_schema_fingerprint": "0a7ea104353369d20883fd54dfa7542c592a1a931fe945e8cab07141a51637e1",
2026
+ "upstream_qualification_status": "blocked_missing_bounded_upstream_tool",
2027
+ "requires_bounded_governed_extension": true,
2028
+ "rollback_strategy": "restore_verified_pre_mutation_blend_checkpoint_and_independent_l0_readback",
2029
+ "qualification_evidence": "Upstream mcp-for-blender v2.2.7 does not expose bounded tool set_material_pbr_governed and relies on execute_blender_code (unsafe_raw_code); blocked fail-closed on real upstream runtimes and never translated to generated Python."
2030
+ }
2031
+ },
2032
+ "input_schema": {
2033
+ "type": "object",
2034
+ "additionalProperties": false,
2035
+ "required": [
2036
+ "object_name",
2037
+ "material_name",
2038
+ "roughness",
2039
+ "metallic"
2040
+ ],
2041
+ "properties": {
2042
+ "object_name": {
2043
+ "type": "string",
2044
+ "minLength": 1,
2045
+ "maxLength": 128
2046
+ },
2047
+ "material_name": {
2048
+ "type": "string",
2049
+ "minLength": 1,
2050
+ "maxLength": 128
2051
+ },
2052
+ "base_color_rgba": {
2053
+ "type": "array",
2054
+ "minItems": 4,
2055
+ "maxItems": 4,
2056
+ "items": {
2057
+ "type": "number",
2058
+ "minimum": 0,
2059
+ "maximum": 1
2060
+ }
2061
+ },
2062
+ "metallic": {
2063
+ "type": "number",
2064
+ "minimum": 0,
2065
+ "maximum": 1
2066
+ },
2067
+ "roughness": {
2068
+ "type": "number",
2069
+ "minimum": 0,
2070
+ "maximum": 1
2071
+ },
2072
+ "ior": {
2073
+ "type": "number",
2074
+ "minimum": 1,
2075
+ "maximum": 3
2076
+ }
2077
+ }
2078
+ },
2079
+ "output_schema": {
2080
+ "type": "object",
2081
+ "required": [
2082
+ "material_name",
2083
+ "updated",
2084
+ "roughness",
2085
+ "metallic"
2086
+ ],
2087
+ "properties": {
2088
+ "material_name": {
2089
+ "type": "string"
2090
+ },
2091
+ "updated": {
2092
+ "type": "boolean"
2093
+ },
2094
+ "roughness": {
2095
+ "type": "number"
2096
+ },
2097
+ "metallic": {
2098
+ "type": "number"
2099
+ }
2100
+ }
2101
+ },
2102
+ "required_capability_tier": "L1",
2103
+ "required_governed_runtime_ceiling": "L1",
2104
+ "governing_skills": [
2105
+ "lighting-material-plan",
2106
+ "product-hero-scene-planner"
2107
+ ],
2108
+ "side_effect_classification": "reversible_scene_mutation",
2109
+ "behavior": "mutating",
2110
+ "idempotency": "idempotent_set_state",
2111
+ "required_preconditions": [
2112
+ {
2113
+ "check_id": "pre.verified_blend_checkpoint",
2114
+ "description": "Pre-mutation .blend checkpoint must exist on disk with verified byteSize > 0 and SHA-256.",
2115
+ "blocking": true
2116
+ },
2117
+ {
2118
+ "check_id": "pre.material_slot_exists",
2119
+ "description": "Target object and material slot must exist in the scene.",
2120
+ "blocking": true
2121
+ }
2122
+ ],
2123
+ "required_postconditions": [
2124
+ {
2125
+ "check_id": "post.material_pbr_matches_readback",
2126
+ "description": "Independent readback confirms roughness and metallic values match requested inputs.",
2127
+ "verification_method": "independent_scene_readback"
2128
+ }
2129
+ ],
2130
+ "backup_requirement": "verified_pre_mutation_blend_checkpoint",
2131
+ "approval_requirement": "none",
2132
+ "asset_license_requirement": "none",
2133
+ "version_constraints": {
2134
+ "path_1_min_blender": "5.1.0",
2135
+ "path_2_min_blender": "3.0.0"
2136
+ },
2137
+ "timeout_and_retry_policy": {
2138
+ "timeout_ms": 8000,
2139
+ "max_retries": 0,
2140
+ "retry_on_timeout": false,
2141
+ "ambiguous_timeout_behavior": "halt_and_inspect_no_blind_retry"
2142
+ },
2143
+ "evidence_requirements": {
2144
+ "required_packet_type": "preview-check",
2145
+ "requires_independent_readback": true,
2146
+ "requires_checkpoint_hash": true
2147
+ },
2148
+ "user_facing_python_allowed": false,
2149
+ "known_limitations": [
2150
+ "Only updates scalar/color inputs on an existing Principled BSDF material; does not rewire arbitrary shader graphs."
2151
+ ]
2152
+ },
2153
+ {
2154
+ "operation_id": "op.mutate.object-transform",
2155
+ "display_name": "Update Existing Object Transform (Positive Scale Guarded)",
2156
+ "purpose": "Apply bounded location, Euler rotation, and positive scale updates to an existing scene object after a verified .blend checkpoint.",
2157
+ "category": "mutation",
2158
+ "supported_runtime_paths": [
2159
+ "path-1-host-a",
2160
+ "path-1-host-b",
2161
+ "path-2-community"
2162
+ ],
2163
+ "runtime_tool_mappings": {
2164
+ "path-1-host-a": {
2165
+ "primary_tool": "set_object_transform_governed",
2166
+ "readback_tools": [
2167
+ "get_objects_summary"
2168
+ ],
2169
+ "parameter_adapter": "lab_mcp_object_transform",
2170
+ "mutation_transport_note": "Constrained object transform update on Path 1 after verified .blend checkpoint.",
2171
+ "upstream_mcp_tool_name": null,
2172
+ "tool_schema_fingerprint": "ee1e006ed63b39ec9c1c2cbfb6befb304374d4be504773f1558041ee1795f421",
2173
+ "upstream_qualification_status": "blocked_missing_bounded_upstream_tool",
2174
+ "requires_bounded_governed_extension": true,
2175
+ "rollback_strategy": "restore_verified_pre_mutation_blend_checkpoint_and_independent_l0_readback",
2176
+ "qualification_evidence": "Upstream Blender Lab MCP v1.0.2 does not expose bounded tool set_object_transform_governed and relies on execute_blender_code (unsafe_raw_code); blocked fail-closed on real upstream runtimes and never translated to generated Python."
2177
+ },
2178
+ "path-1-host-b": {
2179
+ "primary_tool": "set_object_transform_governed",
2180
+ "readback_tools": [
2181
+ "get_objects_summary"
2182
+ ],
2183
+ "parameter_adapter": "lab_mcp_object_transform",
2184
+ "mutation_transport_note": "Constrained object transform update on Path 1 after verified .blend checkpoint.",
2185
+ "upstream_mcp_tool_name": null,
2186
+ "tool_schema_fingerprint": "ee1e006ed63b39ec9c1c2cbfb6befb304374d4be504773f1558041ee1795f421",
2187
+ "upstream_qualification_status": "blocked_missing_bounded_upstream_tool",
2188
+ "requires_bounded_governed_extension": true,
2189
+ "rollback_strategy": "restore_verified_pre_mutation_blend_checkpoint_and_independent_l0_readback",
2190
+ "qualification_evidence": "Upstream Blender Lab MCP v1.0.2 does not expose bounded tool set_object_transform_governed and relies on execute_blender_code (unsafe_raw_code); blocked fail-closed on real upstream runtimes and never translated to generated Python."
2191
+ },
2192
+ "path-2-community": {
2193
+ "primary_tool": "set_object_transform_governed",
2194
+ "readback_tools": [
2195
+ "get_scene_info",
2196
+ "get_object_info"
2197
+ ],
2198
+ "parameter_adapter": "community_mcp_object_transform",
2199
+ "mutation_transport_note": "Constrained object transform update on Path 2 after verified .blend checkpoint.",
2200
+ "upstream_mcp_tool_name": null,
2201
+ "tool_schema_fingerprint": "ee1e006ed63b39ec9c1c2cbfb6befb304374d4be504773f1558041ee1795f421",
2202
+ "upstream_qualification_status": "blocked_missing_bounded_upstream_tool",
2203
+ "requires_bounded_governed_extension": true,
2204
+ "rollback_strategy": "restore_verified_pre_mutation_blend_checkpoint_and_independent_l0_readback",
2205
+ "qualification_evidence": "Upstream mcp-for-blender v2.2.7 does not expose bounded tool set_object_transform_governed and relies on execute_blender_code (unsafe_raw_code); blocked fail-closed on real upstream runtimes and never translated to generated Python."
2206
+ }
2207
+ },
2208
+ "input_schema": {
2209
+ "type": "object",
2210
+ "additionalProperties": false,
2211
+ "required": [
2212
+ "object_name",
2213
+ "location",
2214
+ "rotation_euler_deg",
2215
+ "scale"
2216
+ ],
2217
+ "properties": {
2218
+ "object_name": {
2219
+ "type": "string",
2220
+ "minLength": 1,
2221
+ "maxLength": 128
2222
+ },
2223
+ "location": {
2224
+ "type": "array",
2225
+ "minItems": 3,
2226
+ "maxItems": 3,
2227
+ "items": {
2228
+ "type": "number",
2229
+ "minimum": -1000,
2230
+ "maximum": 1000
2231
+ }
2232
+ },
2233
+ "rotation_euler_deg": {
2234
+ "type": "array",
2235
+ "minItems": 3,
2236
+ "maxItems": 3,
2237
+ "items": {
2238
+ "type": "number",
2239
+ "minimum": -360,
2240
+ "maximum": 360
2241
+ }
2242
+ },
2243
+ "scale": {
2244
+ "type": "array",
2245
+ "minItems": 3,
2246
+ "maxItems": 3,
2247
+ "items": {
2248
+ "type": "number",
2249
+ "exclusiveMinimum": 0,
2250
+ "maximum": 100
2251
+ }
2252
+ }
2253
+ }
2254
+ },
2255
+ "output_schema": {
2256
+ "type": "object",
2257
+ "required": [
2258
+ "object_name",
2259
+ "updated",
2260
+ "location",
2261
+ "rotation_euler_deg",
2262
+ "scale"
2263
+ ],
2264
+ "properties": {
2265
+ "object_name": {
2266
+ "type": "string"
2267
+ },
2268
+ "updated": {
2269
+ "type": "boolean"
2270
+ },
2271
+ "location": {
2272
+ "type": "array"
2273
+ },
2274
+ "rotation_euler_deg": {
2275
+ "type": "array"
2276
+ },
2277
+ "scale": {
2278
+ "type": "array"
2279
+ }
2280
+ }
2281
+ },
2282
+ "required_capability_tier": "L1",
2283
+ "required_governed_runtime_ceiling": "L1",
2284
+ "governing_skills": [
2285
+ "product-hero-scene-planner",
2286
+ "product-grid-scene-planner",
2287
+ "environment-shot"
2288
+ ],
2289
+ "side_effect_classification": "reversible_scene_mutation",
2290
+ "behavior": "mutating",
2291
+ "idempotency": "idempotent_set_state",
2292
+ "required_preconditions": [
2293
+ {
2294
+ "check_id": "pre.verified_blend_checkpoint",
2295
+ "description": "Pre-mutation .blend checkpoint must exist on disk with verified byteSize > 0 and SHA-256.",
2296
+ "blocking": true
2297
+ },
2298
+ {
2299
+ "check_id": "pre.target_object_exists",
2300
+ "description": "Target object_name must already exist in the scene.",
2301
+ "blocking": true
2302
+ }
2303
+ ],
2304
+ "required_postconditions": [
2305
+ {
2306
+ "check_id": "post.object_transform_matches_readback",
2307
+ "description": "Independent readback confirms object location, rotation, and positive scale match requested values.",
2308
+ "verification_method": "independent_scene_readback"
2309
+ }
2310
+ ],
2311
+ "backup_requirement": "verified_pre_mutation_blend_checkpoint",
2312
+ "approval_requirement": "none",
2313
+ "asset_license_requirement": "none",
2314
+ "version_constraints": {
2315
+ "path_1_min_blender": "5.1.0",
2316
+ "path_2_min_blender": "3.0.0"
2317
+ },
2318
+ "timeout_and_retry_policy": {
2319
+ "timeout_ms": 8000,
2320
+ "max_retries": 0,
2321
+ "retry_on_timeout": false,
2322
+ "ambiguous_timeout_behavior": "halt_and_inspect_no_blind_retry"
2323
+ },
2324
+ "evidence_requirements": {
2325
+ "required_packet_type": "preview-check",
2326
+ "requires_independent_readback": true,
2327
+ "requires_checkpoint_hash": true
2328
+ },
2329
+ "user_facing_python_allowed": false,
2330
+ "known_limitations": [
2331
+ "Rejects negative scale components to prevent inverted mesh normals in downstream GLB exports."
2332
+ ]
2333
+ },
2334
+ {
2335
+ "operation_id": "op.export.render-still",
2336
+ "display_name": "Render Still Image to Governed Output Directory",
2337
+ "purpose": "Render a still frame to an allowlisted output path and verify the produced file byteSize and SHA-256 on disk.",
2338
+ "category": "export_or_import",
2339
+ "supported_runtime_paths": [
2340
+ "path-1-host-a",
2341
+ "path-1-host-b",
2342
+ "path-2-community",
2343
+ "cli-appendix"
2344
+ ],
2345
+ "runtime_tool_mappings": {
2346
+ "path-1-host-a": {
2347
+ "primary_tool": "render_viewport_to_path",
2348
+ "secondary_tools": [
2349
+ "render_thumbnail_to_path"
2350
+ ],
2351
+ "readback_tools": [
2352
+ "get_blendfile_summary_path_info",
2353
+ "get_blendfile_summary_datablocks"
2354
+ ],
2355
+ "parameter_adapter": "lab_mcp_render_to_path",
2356
+ "mutation_transport_note": "Conditionally gated L2 render via Lab MCP render_viewport_to_path; blocked in unguarded live mode due to upstream issues #12 and #70.",
2357
+ "upstream_mcp_tool_name": "render_viewport_to_path",
2358
+ "tool_schema_fingerprint": "288057920fe2cda5733db02228a417c98da75f4648a4524113ea78e0d75e4b25",
2359
+ "upstream_qualification_status": "conditional_upstream_known_issues",
2360
+ "requires_bounded_governed_extension": false,
2361
+ "rollback_strategy": "delete_unverified_export_and_restore_pre_mutation_blend_checkpoint",
2362
+ "qualification_evidence": "Audited against upstream Blender Lab MCP (blmcp) v1.0.2 commit dbbf836ad4b1025f14a2b3b504c43903f39e0b04. Reclassified from safe_direct to conditional due to open upstream issues #12 (mutates scene.render.filepath directly on user scene until deferred callback) and #70 (render_thumbnail_to_path INVOKE_DEFAULT restores temporary settings before async render begins); blocked in live mode unless disposableSceneConfirmed + verified .blend checkpoint + isolated staging dir + pre/post render settings readback restoration check pass."
2363
+ },
2364
+ "path-1-host-b": {
2365
+ "primary_tool": "render_viewport_to_path",
2366
+ "secondary_tools": [
2367
+ "render_thumbnail_to_path"
2368
+ ],
2369
+ "readback_tools": [
2370
+ "get_blendfile_summary_path_info",
2371
+ "get_blendfile_summary_datablocks"
2372
+ ],
2373
+ "parameter_adapter": "lab_mcp_render_to_path",
2374
+ "mutation_transport_note": "Conditionally gated L2 render via Lab MCP render_viewport_to_path; blocked in unguarded live mode due to upstream issues #12 and #70.",
2375
+ "upstream_mcp_tool_name": "render_viewport_to_path",
2376
+ "tool_schema_fingerprint": "288057920fe2cda5733db02228a417c98da75f4648a4524113ea78e0d75e4b25",
2377
+ "upstream_qualification_status": "conditional_upstream_known_issues",
2378
+ "requires_bounded_governed_extension": false,
2379
+ "rollback_strategy": "delete_unverified_export_and_restore_pre_mutation_blend_checkpoint",
2380
+ "qualification_evidence": "Audited against upstream Blender Lab MCP (blmcp) v1.0.2 commit dbbf836ad4b1025f14a2b3b504c43903f39e0b04. Reclassified from safe_direct to conditional due to open upstream issues #12 (mutates scene.render.filepath directly on user scene until deferred callback) and #70 (render_thumbnail_to_path INVOKE_DEFAULT restores temporary settings before async render begins); blocked in live mode unless disposableSceneConfirmed + verified .blend checkpoint + isolated staging dir + pre/post render settings readback restoration check pass."
2381
+ },
2382
+ "path-2-community": {
2383
+ "primary_tool": "render_still_governed",
2384
+ "readback_tools": [
2385
+ "get_scene_info"
2386
+ ],
2387
+ "parameter_adapter": "community_mcp_render_still",
2388
+ "mutation_transport_note": "Governed still render to allowlisted output directory on Path 2.",
2389
+ "upstream_mcp_tool_name": null,
2390
+ "tool_schema_fingerprint": "46b38af59a88b08c00378cb65d966111d767e2b73355b32e16861b107ca39801",
2391
+ "upstream_qualification_status": "blocked_missing_bounded_upstream_tool",
2392
+ "requires_bounded_governed_extension": true,
2393
+ "rollback_strategy": "delete_unverified_export_and_restore_pre_mutation_blend_checkpoint",
2394
+ "qualification_evidence": "Upstream mcp-for-blender v2.2.7 does not expose bounded tool render_still_governed and relies on execute_blender_code (unsafe_raw_code); blocked fail-closed on real upstream runtimes and never translated to generated Python."
2395
+ },
2396
+ "cli-appendix": {
2397
+ "primary_tool": "blender_cli_render_still",
2398
+ "readback_tools": [
2399
+ "filesystem_stat_and_sha256"
2400
+ ],
2401
+ "parameter_adapter": "cli_appendix_render_flags",
2402
+ "mutation_transport_note": "Headless CLI appendix render (-b <file> -o <path> -F PNG -f 1).",
2403
+ "upstream_mcp_tool_name": null,
2404
+ "tool_schema_fingerprint": "9cd25869377025e58de3809e2075679ac1dbacfb4a0539191e1f8cadbe206bb9",
2405
+ "upstream_qualification_status": "contract_only_appendix",
2406
+ "requires_bounded_governed_extension": true,
2407
+ "rollback_strategy": "delete_unverified_export_and_restore_pre_mutation_blend_checkpoint",
2408
+ "qualification_evidence": "Headless Blender CLI appendix surface (--background --render-output / glTF export); not an MCP server tool."
2409
+ }
2410
+ },
2411
+ "input_schema": {
2412
+ "type": "object",
2413
+ "additionalProperties": false,
2414
+ "required": [
2415
+ "target_output_path",
2416
+ "output_directory_allowlist",
2417
+ "format"
2418
+ ],
2419
+ "properties": {
2420
+ "target_output_path": {
2421
+ "type": "string",
2422
+ "minLength": 5
2423
+ },
2424
+ "output_directory_allowlist": {
2425
+ "type": "array",
2426
+ "minItems": 1,
2427
+ "items": {
2428
+ "type": "string",
2429
+ "minLength": 2
2430
+ }
2431
+ },
2432
+ "format": {
2433
+ "type": "string",
2434
+ "enum": [
2435
+ "PNG",
2436
+ "OPEN_EXR",
2437
+ "JPEG",
2438
+ "WEBP"
2439
+ ]
2440
+ }
2441
+ }
2442
+ },
2443
+ "output_schema": {
2444
+ "type": "object",
2445
+ "required": [
2446
+ "artifact_path",
2447
+ "byte_size",
2448
+ "sha256"
2449
+ ],
2450
+ "properties": {
2451
+ "artifact_path": {
2452
+ "type": "string"
2453
+ },
2454
+ "byte_size": {
2455
+ "type": "integer",
2456
+ "minimum": 1
2457
+ },
2458
+ "sha256": {
2459
+ "type": "string",
2460
+ "pattern": "^[a-f0-9]{64}$"
2461
+ }
2462
+ }
2463
+ },
2464
+ "required_capability_tier": "L2",
2465
+ "required_governed_runtime_ceiling": "L2",
2466
+ "governing_skills": [
2467
+ "render-export-evidence",
2468
+ "output-format-decision"
2469
+ ],
2470
+ "side_effect_classification": "file_write_export",
2471
+ "behavior": "export",
2472
+ "idempotency": "non_idempotent_append_or_export",
2473
+ "required_preconditions": [
2474
+ {
2475
+ "check_id": "pre.output_path_in_allowlist",
2476
+ "description": "target_output_path must resolve inside output_directory_allowlist without path traversal.",
2477
+ "blocking": true
2478
+ },
2479
+ {
2480
+ "check_id": "pre.verified_blend_checkpoint",
2481
+ "description": "Pre-export .blend checkpoint must be verified before invoking L2 export.",
2482
+ "blocking": true
2483
+ }
2484
+ ],
2485
+ "required_postconditions": [
2486
+ {
2487
+ "check_id": "post.render_file_verified_on_disk",
2488
+ "description": "Rendered image file exists on disk with byte_size > 0 and 64-hex SHA-256.",
2489
+ "verification_method": "disk_file_and_sha256_verification"
2490
+ }
2491
+ ],
2492
+ "backup_requirement": "verified_pre_mutation_blend_checkpoint",
2493
+ "approval_requirement": "operator_confirmation_if_escalated",
2494
+ "asset_license_requirement": "none",
2495
+ "version_constraints": {
2496
+ "path_1_min_blender": "5.1.0",
2497
+ "path_2_min_blender": "3.0.0",
2498
+ "cli_appendix_min_blender": "4.2.0"
2499
+ },
2500
+ "timeout_and_retry_policy": {
2501
+ "timeout_ms": 60000,
2502
+ "max_retries": 0,
2503
+ "retry_on_timeout": false,
2504
+ "ambiguous_timeout_behavior": "halt_and_inspect_no_blind_retry"
2505
+ },
2506
+ "evidence_requirements": {
2507
+ "required_packet_type": "render-export",
2508
+ "requires_independent_readback": true,
2509
+ "requires_checkpoint_hash": true
2510
+ },
2511
+ "user_facing_python_allowed": false,
2512
+ "known_limitations": [
2513
+ "Separately gated at L2; deferred from the initial L0/L1 vertical slice unless L2 is explicitly granted."
2514
+ ]
2515
+ },
2516
+ {
2517
+ "operation_id": "op.export.glb-container",
2518
+ "display_name": "Export GLB 2.0 Container to Governed Output Directory",
2519
+ "purpose": "Export a binary .glb file to an allowlisted directory and validate its binary GLB 2.0 container and glTF semantics.",
2520
+ "category": "export_or_import",
2521
+ "supported_runtime_paths": [
2522
+ "path-1-host-a",
2523
+ "path-1-host-b",
2524
+ "path-2-community",
2525
+ "cli-appendix"
2526
+ ],
2527
+ "runtime_tool_mappings": {
2528
+ "path-1-host-a": {
2529
+ "primary_tool": "export_glb_governed",
2530
+ "readback_tools": [
2531
+ "get_blendfile_summary_path_info"
2532
+ ],
2533
+ "parameter_adapter": "lab_mcp_glb_export",
2534
+ "mutation_transport_note": "Governed GLB 2.0 export to allowlisted directory followed by binary GLB inspection.",
2535
+ "upstream_mcp_tool_name": null,
2536
+ "tool_schema_fingerprint": "7846bdb2b47c426a7f1b79f967ae90463303934c0d1c370cd2a567232d6b418e",
2537
+ "upstream_qualification_status": "blocked_missing_bounded_upstream_tool",
2538
+ "requires_bounded_governed_extension": true,
2539
+ "rollback_strategy": "delete_unverified_export_and_restore_pre_mutation_blend_checkpoint",
2540
+ "qualification_evidence": "Upstream Blender Lab MCP v1.0.2 does not expose bounded tool export_glb_governed and relies on execute_blender_code (unsafe_raw_code); blocked fail-closed on real upstream runtimes and never translated to generated Python."
2541
+ },
2542
+ "path-1-host-b": {
2543
+ "primary_tool": "export_glb_governed",
2544
+ "readback_tools": [
2545
+ "get_blendfile_summary_path_info"
2546
+ ],
2547
+ "parameter_adapter": "lab_mcp_glb_export",
2548
+ "mutation_transport_note": "Governed GLB 2.0 export to allowlisted directory followed by binary GLB inspection.",
2549
+ "upstream_mcp_tool_name": null,
2550
+ "tool_schema_fingerprint": "7846bdb2b47c426a7f1b79f967ae90463303934c0d1c370cd2a567232d6b418e",
2551
+ "upstream_qualification_status": "blocked_missing_bounded_upstream_tool",
2552
+ "requires_bounded_governed_extension": true,
2553
+ "rollback_strategy": "delete_unverified_export_and_restore_pre_mutation_blend_checkpoint",
2554
+ "qualification_evidence": "Upstream Blender Lab MCP v1.0.2 does not expose bounded tool export_glb_governed and relies on execute_blender_code (unsafe_raw_code); blocked fail-closed on real upstream runtimes and never translated to generated Python."
2555
+ },
2556
+ "path-2-community": {
2557
+ "primary_tool": "export_glb_governed",
2558
+ "readback_tools": [
2559
+ "get_scene_info"
2560
+ ],
2561
+ "parameter_adapter": "community_mcp_glb_export",
2562
+ "mutation_transport_note": "Governed GLB 2.0 export on Path 2 followed by binary GLB inspection.",
2563
+ "upstream_mcp_tool_name": null,
2564
+ "tool_schema_fingerprint": "7846bdb2b47c426a7f1b79f967ae90463303934c0d1c370cd2a567232d6b418e",
2565
+ "upstream_qualification_status": "blocked_missing_bounded_upstream_tool",
2566
+ "requires_bounded_governed_extension": true,
2567
+ "rollback_strategy": "delete_unverified_export_and_restore_pre_mutation_blend_checkpoint",
2568
+ "qualification_evidence": "Upstream mcp-for-blender v2.2.7 does not expose bounded tool export_glb_governed and relies on execute_blender_code (unsafe_raw_code); blocked fail-closed on real upstream runtimes and never translated to generated Python."
2569
+ },
2570
+ "cli-appendix": {
2571
+ "primary_tool": "blender_cli_export_glb",
2572
+ "readback_tools": [
2573
+ "inspect_glb_binary_container"
2574
+ ],
2575
+ "parameter_adapter": "cli_appendix_gltf_export",
2576
+ "mutation_transport_note": "Headless CLI appendix GLB export on Blender 4.5+.",
2577
+ "upstream_mcp_tool_name": null,
2578
+ "tool_schema_fingerprint": "4d709b1382711ec4a0f143f412a2a8af4d77b02ab905329185a489906e627263",
2579
+ "upstream_qualification_status": "contract_only_appendix",
2580
+ "requires_bounded_governed_extension": true,
2581
+ "rollback_strategy": "delete_unverified_export_and_restore_pre_mutation_blend_checkpoint",
2582
+ "qualification_evidence": "Headless Blender CLI appendix surface (--background --render-output / glTF export); not an MCP server tool."
2583
+ }
2584
+ },
2585
+ "input_schema": {
2586
+ "type": "object",
2587
+ "additionalProperties": false,
2588
+ "required": [
2589
+ "target_output_path",
2590
+ "output_directory_allowlist"
2591
+ ],
2592
+ "properties": {
2593
+ "target_output_path": {
2594
+ "type": "string",
2595
+ "pattern": "\\.glb$"
2596
+ },
2597
+ "output_directory_allowlist": {
2598
+ "type": "array",
2599
+ "minItems": 1,
2600
+ "items": {
2601
+ "type": "string",
2602
+ "minLength": 2
2603
+ }
2604
+ },
2605
+ "apply_modifiers": {
2606
+ "type": "boolean"
2607
+ },
2608
+ "export_yup": {
2609
+ "type": "boolean"
2610
+ }
2611
+ }
2612
+ },
2613
+ "output_schema": {
2614
+ "type": "object",
2615
+ "required": [
2616
+ "artifact_path",
2617
+ "byte_size",
2618
+ "sha256",
2619
+ "glb_inspection"
2620
+ ],
2621
+ "properties": {
2622
+ "artifact_path": {
2623
+ "type": "string"
2624
+ },
2625
+ "byte_size": {
2626
+ "type": "integer",
2627
+ "minimum": 12
2628
+ },
2629
+ "sha256": {
2630
+ "type": "string",
2631
+ "pattern": "^[a-f0-9]{64}$"
2632
+ },
2633
+ "glb_inspection": {
2634
+ "type": "object"
2635
+ }
2636
+ }
2637
+ },
2638
+ "required_capability_tier": "L2",
2639
+ "required_governed_runtime_ceiling": "L2",
2640
+ "governing_skills": [
2641
+ "glb-web-handoff",
2642
+ "mobile-glb-budget",
2643
+ "render-export-evidence"
2644
+ ],
2645
+ "side_effect_classification": "file_write_export",
2646
+ "behavior": "export",
2647
+ "idempotency": "non_idempotent_append_or_export",
2648
+ "required_preconditions": [
2649
+ {
2650
+ "check_id": "pre.output_path_in_allowlist",
2651
+ "description": "target_output_path must end with .glb and resolve inside output_directory_allowlist.",
2652
+ "blocking": true
2653
+ },
2654
+ {
2655
+ "check_id": "pre.verified_blend_checkpoint",
2656
+ "description": "Pre-export .blend checkpoint must be verified on disk.",
2657
+ "blocking": true
2658
+ }
2659
+ ],
2660
+ "required_postconditions": [
2661
+ {
2662
+ "check_id": "post.glb_binary_container_valid",
2663
+ "description": "Exported .glb passes binary container and semantic inspection (magic glTF, version 2).",
2664
+ "verification_method": "glb_binary_semantic_inspection"
2665
+ }
2666
+ ],
2667
+ "backup_requirement": "verified_pre_mutation_blend_checkpoint",
2668
+ "approval_requirement": "operator_confirmation_if_escalated",
2669
+ "asset_license_requirement": "cleared_spdx_or_category",
2670
+ "version_constraints": {
2671
+ "path_1_min_blender": "5.1.0",
2672
+ "path_2_min_blender": "3.0.0",
2673
+ "cli_appendix_min_blender": "4.5.0"
2674
+ },
2675
+ "timeout_and_retry_policy": {
2676
+ "timeout_ms": 60000,
2677
+ "max_retries": 0,
2678
+ "retry_on_timeout": false,
2679
+ "ambiguous_timeout_behavior": "halt_and_inspect_no_blind_retry"
2680
+ },
2681
+ "evidence_requirements": {
2682
+ "required_packet_type": "glb-handoff",
2683
+ "requires_independent_readback": true,
2684
+ "requires_checkpoint_hash": true
2685
+ },
2686
+ "user_facing_python_allowed": false,
2687
+ "known_limitations": [
2688
+ "Separately gated at L2; requires binary GLB 2.0 inspection before claiming Produced/Verified."
2689
+ ]
2690
+ },
2691
+ {
2692
+ "operation_id": "op.export.import-cleared-asset",
2693
+ "display_name": "Import License-Cleared External 3D / Material Asset",
2694
+ "purpose": "Import an external asset only after asset-license-checker clearance and a verified pre-mutation .blend checkpoint.",
2695
+ "category": "export_or_import",
2696
+ "supported_runtime_paths": [
2697
+ "path-2-community"
2698
+ ],
2699
+ "runtime_tool_mappings": {
2700
+ "path-2-community": {
2701
+ "primary_tool": "import_asset",
2702
+ "secondary_tools": [
2703
+ "search_assets"
2704
+ ],
2705
+ "readback_tools": [
2706
+ "get_scene_info",
2707
+ "get_object_info"
2708
+ ],
2709
+ "parameter_adapter": "community_mcp_import_asset",
2710
+ "mutation_transport_note": "Uses Path 2 import_asset only after SPDX/category license clearance and .blend backup.",
2711
+ "upstream_mcp_tool_name": "import_asset",
2712
+ "tool_schema_fingerprint": "6732f0bb197417522e69d4e65810306da377a2545bf93b7eaac033b10866d949",
2713
+ "upstream_qualification_status": "blocked_unbounded_upstream_side_effects",
2714
+ "requires_bounded_governed_extension": true,
2715
+ "rollback_strategy": "restore_verified_pre_mutation_blend_checkpoint_and_independent_l0_readback",
2716
+ "qualification_evidence": "Upstream tool import_asset exists in MCP for Blender (ahujasid/mcp-for-blender) v2.2.7 (https://github.com/ahujasid/blender-mcp/blob/main/src/blender_mcp/server.py#L1951) but performs unbounded external network download and scene mutation without local SHA-256/license enforcement; blocked on real upstream unless governed contract extension is active."
2717
+ }
2718
+ },
2719
+ "input_schema": {
2720
+ "type": "object",
2721
+ "additionalProperties": false,
2722
+ "required": [
2723
+ "asset_id",
2724
+ "asset_source",
2725
+ "license_clearance"
2726
+ ],
2727
+ "properties": {
2728
+ "asset_id": {
2729
+ "type": "string",
2730
+ "minLength": 1,
2731
+ "maxLength": 128
2732
+ },
2733
+ "asset_source": {
2734
+ "type": "string",
2735
+ "enum": [
2736
+ "polyhaven",
2737
+ "local_allowlisted_library"
2738
+ ]
2739
+ },
2740
+ "license_clearance": {
2741
+ "type": "object",
2742
+ "additionalProperties": false,
2743
+ "required": [
2744
+ "status",
2745
+ "spdxOrCategory",
2746
+ "verifiedBySkill"
2747
+ ],
2748
+ "properties": {
2749
+ "status": {
2750
+ "const": "Cleared"
2751
+ },
2752
+ "spdxOrCategory": {
2753
+ "type": "string",
2754
+ "enum": [
2755
+ "CC0-1.0",
2756
+ "CC-BY-4.0",
2757
+ "Royalty-Free-Commercial",
2758
+ "Proprietary-First-Party"
2759
+ ]
2760
+ },
2761
+ "verifiedBySkill": {
2762
+ "const": "asset-license-checker"
2763
+ }
2764
+ }
2765
+ }
2766
+ }
2767
+ },
2768
+ "output_schema": {
2769
+ "type": "object",
2770
+ "required": [
2771
+ "imported_asset_id",
2772
+ "imported_objects"
2773
+ ],
2774
+ "properties": {
2775
+ "imported_asset_id": {
2776
+ "type": "string"
2777
+ },
2778
+ "imported_objects": {
2779
+ "type": "array",
2780
+ "items": {
2781
+ "type": "string"
2782
+ }
2783
+ }
2784
+ }
2785
+ },
2786
+ "required_capability_tier": "L2",
2787
+ "required_governed_runtime_ceiling": "L2",
2788
+ "governing_skills": [
2789
+ "asset-license-checker",
2790
+ "asset-discovery",
2791
+ "asset-style-check"
2792
+ ],
2793
+ "side_effect_classification": "external_asset_import",
2794
+ "behavior": "mutating",
2795
+ "idempotency": "non_idempotent_append_or_export",
2796
+ "required_preconditions": [
2797
+ {
2798
+ "check_id": "pre.asset_license_cleared",
2799
+ "description": "Asset must carry Cleared license status from asset-license-checker.",
2800
+ "blocking": true
2801
+ },
2802
+ {
2803
+ "check_id": "pre.verified_blend_checkpoint",
2804
+ "description": "Pre-mutation .blend checkpoint must exist and be SHA-256 verified on disk.",
2805
+ "blocking": true
2806
+ }
2807
+ ],
2808
+ "required_postconditions": [
2809
+ {
2810
+ "check_id": "post.imported_object_present_in_readback",
2811
+ "description": "Independent scene readback confirms the imported asset datablock exists in the scene.",
2812
+ "verification_method": "independent_scene_readback"
2813
+ }
2814
+ ],
2815
+ "backup_requirement": "verified_pre_mutation_blend_checkpoint",
2816
+ "approval_requirement": "operator_confirmation_if_escalated",
2817
+ "asset_license_requirement": "cleared_spdx_or_category",
2818
+ "version_constraints": {
2819
+ "path_1_min_blender": "5.1.0",
2820
+ "path_2_min_blender": "3.0.0"
2821
+ },
2822
+ "timeout_and_retry_policy": {
2823
+ "timeout_ms": 30000,
2824
+ "max_retries": 0,
2825
+ "retry_on_timeout": false,
2826
+ "ambiguous_timeout_behavior": "halt_and_inspect_no_blind_retry"
2827
+ },
2828
+ "evidence_requirements": {
2829
+ "required_packet_type": "preview-check",
2830
+ "requires_independent_readback": true,
2831
+ "requires_checkpoint_hash": true
2832
+ },
2833
+ "user_facing_python_allowed": false,
2834
+ "known_limitations": [
2835
+ "External asset import tool (import_asset) is only exposed on Path 2 community mcp-for-blender and remains gated at L2."
2836
+ ]
2837
+ }
2838
+ ],
2839
+ "upstream_runtime_compatibility_matrix": {
2840
+ "audited_at": "2026-11-08T00:00:00Z",
2841
+ "mcp_protocol_versions_supported": [
2842
+ "2024-11-05",
2843
+ "2025-03-26",
2844
+ "2025-06-18"
2845
+ ],
2846
+ "transports_supported": [
2847
+ "stdio",
2848
+ "sse",
2849
+ "streamable-http"
2850
+ ],
2851
+ "runtimes": {
2852
+ "path-1-official-blender-lab-mcp": {
2853
+ "runtime_paths": [
2854
+ "path-1-host-a",
2855
+ "path-1-host-b"
2856
+ ],
2857
+ "official_docs_url": "https://www.blender.org/lab/mcp-server/",
2858
+ "source_repository_url": "https://projects.blender.org/lab/blender_mcp",
2859
+ "audited_commit_sha": "dbbf836ad4b1025f14a2b3b504c43903f39e0b04",
2860
+ "audited_commit_date": "2026-09-29",
2861
+ "server_package_name": "blender-mcp",
2862
+ "server_entry_point": "blmcp:main",
2863
+ "server_version": "1.0.2",
2864
+ "addon_id": "mcp",
2865
+ "addon_name": "MCP",
2866
+ "addon_version": "1.0.0",
2867
+ "blender_version_min": "5.1.0",
2868
+ "mcp_sdk_dependency": "mcp[cli]>=1.2.0,<2",
2869
+ "known_upstream_issues": [
2870
+ "https://projects.blender.org/lab/blender_mcp/issues/12",
2871
+ "https://projects.blender.org/lab/blender_mcp/issues/70"
2872
+ ],
2873
+ "upstream_security_warning": "Official Blender Lab MCP documentation explicitly warns that execute_blender_code and execute_blender_code_for_cli execute LLM-generated Python inside Blender without built-in guards protecting user data.",
2874
+ "real_upstream_qualification_summary": {
2875
+ "advertised_tool_count": 26,
2876
+ "read_only_only_count": 18,
2877
+ "safe_direct_count": 0,
2878
+ "conditional_count": 2,
2879
+ "unsafe_raw_code_count": 2,
2880
+ "unsupported_count": 4,
2881
+ "read_only_qualified": true,
2882
+ "mutation_qualified": false,
2883
+ "export_import_qualified": false,
2884
+ "qualification_verdict": "read_only_qualified",
2885
+ "mutation_blocking_reason": "Upstream blender-mcp v1.0.2 (commit dbbf836ad4b1025f14a2b3b504c43903f39e0b04) provides zero dedicated bounded L1 scene-mutation tools; all scene mutations upstream rely on execute_blender_code (unsafe_raw_code), and render_viewport_to_path / render_thumbnail_to_path are classified as conditional due to open upstream issues #12 and #70."
2886
+ }
2887
+ },
2888
+ "path-2-community-mcp-for-blender": {
2889
+ "runtime_paths": [
2890
+ "path-2-community"
2891
+ ],
2892
+ "source_repository_url": "https://github.com/ahujasid/mcp-for-blender",
2893
+ "canonical_github_mirror": "https://github.com/ahujasid/blender-mcp",
2894
+ "audited_commit_sha": "2e4b0bc294694b1570d76ed01be657c22e6d02a0",
2895
+ "audited_commit_date": "2026-10-15",
2896
+ "server_package_name": "mcp-for-blender",
2897
+ "server_entry_point": "blender_mcp.server:main",
2898
+ "server_version": "2.2.7",
2899
+ "addon_name": "MCP for Blender",
2900
+ "addon_version": "1.8.0",
2901
+ "addon_protocol_version": 15,
2902
+ "blender_version_min": "3.0.0",
2903
+ "mcp_sdk_dependency": "mcp>=1.26.0,<2",
2904
+ "upstream_security_warning": "Third-party community integration (not affiliated with Blender Foundation). Exposes execute_blender_code which runs arbitrary Python via exec() in Blender without sandboxing, plus cloud asset/3D generation tools.",
2905
+ "real_upstream_qualification_summary": {
2906
+ "advertised_tool_count": 16,
2907
+ "read_only_only_count": 10,
2908
+ "safe_direct_count": 0,
2909
+ "conditional_count": 0,
2910
+ "unsafe_raw_code_count": 1,
2911
+ "unsupported_count": 5,
2912
+ "read_only_qualified": true,
2913
+ "mutation_qualified": false,
2914
+ "export_import_qualified": false,
2915
+ "qualification_verdict": "read_only_qualified",
2916
+ "mutation_blocking_reason": "Upstream mcp-for-blender v2.2.7 (commit 2e4b0bc294694b1570d76ed01be657c22e6d02a0) provides zero dedicated bounded L1 scene-mutation tools or local L2 GLB/render export tools; mutations rely on execute_blender_code (unsafe_raw_code) and import_asset downloads unverified remote assets."
2917
+ }
2918
+ }
2919
+ }
2920
+ },
2921
+ "upstream_tool_qualification_matrix": [
2922
+ {
2923
+ "tool_name": "execute_blender_code",
2924
+ "description": "Execute Python code in the connected Blender instance.",
2925
+ "input_schema": {
2926
+ "type": "object",
2927
+ "additionalProperties": false,
2928
+ "required": [
2929
+ "code"
2930
+ ],
2931
+ "properties": {
2932
+ "code": {
2933
+ "type": "string"
2934
+ }
2935
+ }
2936
+ },
2937
+ "output_shape_summary": "dict[str, object] from arbitrary user/LLM Python result variable",
2938
+ "side_effects": "arbitrary_code_execution",
2939
+ "required_capability_tier": "L3",
2940
+ "executes_arbitrary_code": true,
2941
+ "modifies_scene_state": true,
2942
+ "reads_files": true,
2943
+ "writes_files": true,
2944
+ "accesses_external_services": true,
2945
+ "bounded_and_independently_verifiable": false,
2946
+ "classification": "unsafe_raw_code",
2947
+ "qualification_rationale": "Executes unrestricted LLM-generated Python inside Blender with full bpy/os/sys access and destructiveHint=True; permanently blocked per laws/no-arbitrary-python-interface.md.",
2948
+ "evidence_source": "https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/execute_blender_code.py",
2949
+ "runtime_paths": [
2950
+ "path-1-host-a",
2951
+ "path-1-host-b"
2952
+ ],
2953
+ "server_identity": "Blender Lab MCP (blmcp)",
2954
+ "server_version": "1.0.2",
2955
+ "tool_schema_fingerprint": "f7899e40e5884eb06aa99019527ec36aa9fe7c2b25f269cc8cc40dbec978e65b"
2956
+ },
2957
+ {
2958
+ "tool_name": "execute_blender_code_for_cli",
2959
+ "description": "Execute Python code in a background Blender process.",
2960
+ "input_schema": {
2961
+ "type": "object",
2962
+ "additionalProperties": false,
2963
+ "required": [
2964
+ "blend_file",
2965
+ "code"
2966
+ ],
2967
+ "properties": {
2968
+ "blend_file": {
2969
+ "type": "string"
2970
+ },
2971
+ "code": {
2972
+ "type": "string"
2973
+ }
2974
+ }
2975
+ },
2976
+ "output_shape_summary": "dict[str, object] from background Blender CLI Python execution",
2977
+ "side_effects": "arbitrary_code_execution",
2978
+ "required_capability_tier": "L3",
2979
+ "executes_arbitrary_code": true,
2980
+ "modifies_scene_state": true,
2981
+ "reads_files": true,
2982
+ "writes_files": true,
2983
+ "accesses_external_services": true,
2984
+ "bounded_and_independently_verifiable": false,
2985
+ "classification": "unsafe_raw_code",
2986
+ "qualification_rationale": "Spawns background Blender CLI and executes arbitrary Python code without sandboxing; permanently blocked per laws/no-arbitrary-python-interface.md.",
2987
+ "evidence_source": "https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/execute_blender_code.py",
2988
+ "runtime_paths": [
2989
+ "path-1-host-a",
2990
+ "path-1-host-b"
2991
+ ],
2992
+ "server_identity": "Blender Lab MCP (blmcp)",
2993
+ "server_version": "1.0.2",
2994
+ "tool_schema_fingerprint": "1b5412044152b8dc1f9d33ec95008b6b39bc85771e9cecf376501dae228c2145"
2995
+ },
2996
+ {
2997
+ "tool_name": "get_blendfile_summary_datablocks",
2998
+ "description": "Return a summary of the blend file: data-block counts, active workspace, and render engine.",
2999
+ "input_schema": {
3000
+ "type": "object",
3001
+ "additionalProperties": false,
3002
+ "required": [],
3003
+ "properties": {}
3004
+ },
3005
+ "output_shape_summary": "dict with datablock counts, active_workspace, and render_engine",
3006
+ "side_effects": "none",
3007
+ "required_capability_tier": "L0",
3008
+ "executes_arbitrary_code": false,
3009
+ "modifies_scene_state": false,
3010
+ "reads_files": false,
3011
+ "writes_files": false,
3012
+ "accesses_external_services": false,
3013
+ "bounded_and_independently_verifiable": true,
3014
+ "classification": "read_only_only",
3015
+ "qualification_rationale": "Fixed read-only toolcode template inspecting bpy.data counts and active scene render engine without scene mutation.",
3016
+ "evidence_source": "https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_blendfile_summary_datablocks.py",
3017
+ "runtime_paths": [
3018
+ "path-1-host-a",
3019
+ "path-1-host-b"
3020
+ ],
3021
+ "server_identity": "Blender Lab MCP (blmcp)",
3022
+ "server_version": "1.0.2",
3023
+ "tool_schema_fingerprint": "2b831a66bd41ba97d47055f4b5b51ce8b7387fbe7b2f2c294d251d4b8d658c73"
3024
+ },
3025
+ {
3026
+ "tool_name": "get_blendfile_summary_datablocks_for_cli",
3027
+ "description": "Return a data-block summary by opening blend_file in background Blender.",
3028
+ "input_schema": {
3029
+ "type": "object",
3030
+ "additionalProperties": false,
3031
+ "required": [
3032
+ "blend_file"
3033
+ ],
3034
+ "properties": {
3035
+ "blend_file": {
3036
+ "type": "string",
3037
+ "minLength": 1
3038
+ }
3039
+ }
3040
+ },
3041
+ "output_shape_summary": "dict with datablock counts for specified blend_file",
3042
+ "side_effects": "none",
3043
+ "required_capability_tier": "L0",
3044
+ "executes_arbitrary_code": false,
3045
+ "modifies_scene_state": false,
3046
+ "reads_files": true,
3047
+ "writes_files": false,
3048
+ "accesses_external_services": false,
3049
+ "bounded_and_independently_verifiable": true,
3050
+ "classification": "read_only_only",
3051
+ "qualification_rationale": "Read-only inspection of a .blend file in background CLI mode using fixed datablock summary toolcode.",
3052
+ "evidence_source": "https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_blendfile_summary_datablocks.py",
3053
+ "runtime_paths": [
3054
+ "path-1-host-a",
3055
+ "path-1-host-b"
3056
+ ],
3057
+ "server_identity": "Blender Lab MCP (blmcp)",
3058
+ "server_version": "1.0.2",
3059
+ "tool_schema_fingerprint": "ca69341ef4a1b166f6698394cdee4986badeab74c0632616709c86d5549a0581"
3060
+ },
3061
+ {
3062
+ "tool_name": "get_blendfile_summary_missing_files",
3063
+ "description": "Report external file references that are missing from disk (images, libraries, fonts, sounds, movie clips, caches, sequences).",
3064
+ "input_schema": {
3065
+ "type": "object",
3066
+ "additionalProperties": false,
3067
+ "required": [],
3068
+ "properties": {}
3069
+ },
3070
+ "output_shape_summary": "dict listing missing external file paths by datablock category",
3071
+ "side_effects": "none",
3072
+ "required_capability_tier": "L0",
3073
+ "executes_arbitrary_code": false,
3074
+ "modifies_scene_state": false,
3075
+ "reads_files": true,
3076
+ "writes_files": false,
3077
+ "accesses_external_services": false,
3078
+ "bounded_and_independently_verifiable": true,
3079
+ "classification": "read_only_only",
3080
+ "qualification_rationale": "Read-only check of external file references in the open .blend session.",
3081
+ "evidence_source": "https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_blendfile_summary_missing_files.py",
3082
+ "runtime_paths": [
3083
+ "path-1-host-a",
3084
+ "path-1-host-b"
3085
+ ],
3086
+ "server_identity": "Blender Lab MCP (blmcp)",
3087
+ "server_version": "1.0.2",
3088
+ "tool_schema_fingerprint": "51ac3be903d237d241ef285e86d899963306807b86b760d35fdb8089ea7d4c08"
3089
+ },
3090
+ {
3091
+ "tool_name": "get_blendfile_summary_missing_files_for_cli",
3092
+ "description": "Report missing file references by opening blend_file in background Blender.",
3093
+ "input_schema": {
3094
+ "type": "object",
3095
+ "additionalProperties": false,
3096
+ "required": [
3097
+ "blend_file"
3098
+ ],
3099
+ "properties": {
3100
+ "blend_file": {
3101
+ "type": "string",
3102
+ "minLength": 1
3103
+ }
3104
+ }
3105
+ },
3106
+ "output_shape_summary": "dict listing missing external file paths for blend_file",
3107
+ "side_effects": "none",
3108
+ "required_capability_tier": "L0",
3109
+ "executes_arbitrary_code": false,
3110
+ "modifies_scene_state": false,
3111
+ "reads_files": true,
3112
+ "writes_files": false,
3113
+ "accesses_external_services": false,
3114
+ "bounded_and_independently_verifiable": true,
3115
+ "classification": "read_only_only",
3116
+ "qualification_rationale": "Read-only CLI inspection of missing external references.",
3117
+ "evidence_source": "https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_blendfile_summary_missing_files.py",
3118
+ "runtime_paths": [
3119
+ "path-1-host-a",
3120
+ "path-1-host-b"
3121
+ ],
3122
+ "server_identity": "Blender Lab MCP (blmcp)",
3123
+ "server_version": "1.0.2",
3124
+ "tool_schema_fingerprint": "d7e81c8daac75807f5bb9765ebb8103b18dcd39e78c3356da8fefe3fd9ffc3ec"
3125
+ },
3126
+ {
3127
+ "tool_name": "get_blendfile_summary_of_linked_libraries",
3128
+ "description": "Return a tree of directly and indirectly linked library files.",
3129
+ "input_schema": {
3130
+ "type": "object",
3131
+ "additionalProperties": false,
3132
+ "required": [],
3133
+ "properties": {}
3134
+ },
3135
+ "output_shape_summary": "dict with linked library hierarchy",
3136
+ "side_effects": "none",
3137
+ "required_capability_tier": "L0",
3138
+ "executes_arbitrary_code": false,
3139
+ "modifies_scene_state": false,
3140
+ "reads_files": true,
3141
+ "writes_files": false,
3142
+ "accesses_external_services": false,
3143
+ "bounded_and_independently_verifiable": true,
3144
+ "classification": "read_only_only",
3145
+ "qualification_rationale": "Read-only inspection of bpy.data.libraries dependency tree.",
3146
+ "evidence_source": "https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_blendfile_summary_of_linked_libraries.py",
3147
+ "runtime_paths": [
3148
+ "path-1-host-a",
3149
+ "path-1-host-b"
3150
+ ],
3151
+ "server_identity": "Blender Lab MCP (blmcp)",
3152
+ "server_version": "1.0.2",
3153
+ "tool_schema_fingerprint": "bea4e96dd50b6a8cab3f5b02b0d40e45f0b9b761a211a6dd1550c25affb2d823"
3154
+ },
3155
+ {
3156
+ "tool_name": "get_blendfile_summary_of_linked_libraries_for_cli",
3157
+ "description": "Return linked-library info by opening blend_file in background Blender.",
3158
+ "input_schema": {
3159
+ "type": "object",
3160
+ "additionalProperties": false,
3161
+ "required": [
3162
+ "blend_file"
3163
+ ],
3164
+ "properties": {
3165
+ "blend_file": {
3166
+ "type": "string",
3167
+ "minLength": 1
3168
+ }
3169
+ }
3170
+ },
3171
+ "output_shape_summary": "dict with linked library hierarchy for blend_file",
3172
+ "side_effects": "none",
3173
+ "required_capability_tier": "L0",
3174
+ "executes_arbitrary_code": false,
3175
+ "modifies_scene_state": false,
3176
+ "reads_files": true,
3177
+ "writes_files": false,
3178
+ "accesses_external_services": false,
3179
+ "bounded_and_independently_verifiable": true,
3180
+ "classification": "read_only_only",
3181
+ "qualification_rationale": "Read-only CLI inspection of linked libraries.",
3182
+ "evidence_source": "https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_blendfile_summary_of_linked_libraries.py",
3183
+ "runtime_paths": [
3184
+ "path-1-host-a",
3185
+ "path-1-host-b"
3186
+ ],
3187
+ "server_identity": "Blender Lab MCP (blmcp)",
3188
+ "server_version": "1.0.2",
3189
+ "tool_schema_fingerprint": "c02f11b39d066dec26b428c34cd93fde4d13f68d1803f65060b046c5f8ad6ede"
3190
+ },
3191
+ {
3192
+ "tool_name": "get_blendfile_summary_path_info",
3193
+ "description": "Simple/fast access to the blend file path, save status, age, and backups.",
3194
+ "input_schema": {
3195
+ "type": "object",
3196
+ "additionalProperties": false,
3197
+ "required": [],
3198
+ "properties": {}
3199
+ },
3200
+ "output_shape_summary": "dict with filepath, is_saved, is_dirty, and backup file metadata",
3201
+ "side_effects": "none",
3202
+ "required_capability_tier": "L0",
3203
+ "executes_arbitrary_code": false,
3204
+ "modifies_scene_state": false,
3205
+ "reads_files": true,
3206
+ "writes_files": false,
3207
+ "accesses_external_services": false,
3208
+ "bounded_and_independently_verifiable": true,
3209
+ "classification": "read_only_only",
3210
+ "qualification_rationale": "Read-only inspection of bpy.data.filepath, is_saved, and is_dirty flags.",
3211
+ "evidence_source": "https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_blendfile_summary_path_info.py",
3212
+ "runtime_paths": [
3213
+ "path-1-host-a",
3214
+ "path-1-host-b"
3215
+ ],
3216
+ "server_identity": "Blender Lab MCP (blmcp)",
3217
+ "server_version": "1.0.2",
3218
+ "tool_schema_fingerprint": "c5083618ec6414ddb0ecc190f759a06330fbfe81f7b95e9ffc04fa169040b60b"
3219
+ },
3220
+ {
3221
+ "tool_name": "get_blendfile_summary_path_info_for_cli",
3222
+ "description": "Return path info by opening blend_file in background Blender.",
3223
+ "input_schema": {
3224
+ "type": "object",
3225
+ "additionalProperties": false,
3226
+ "required": [
3227
+ "blend_file"
3228
+ ],
3229
+ "properties": {
3230
+ "blend_file": {
3231
+ "type": "string",
3232
+ "minLength": 1
3233
+ }
3234
+ }
3235
+ },
3236
+ "output_shape_summary": "dict with filepath and save status for blend_file",
3237
+ "side_effects": "none",
3238
+ "required_capability_tier": "L0",
3239
+ "executes_arbitrary_code": false,
3240
+ "modifies_scene_state": false,
3241
+ "reads_files": true,
3242
+ "writes_files": false,
3243
+ "accesses_external_services": false,
3244
+ "bounded_and_independently_verifiable": true,
3245
+ "classification": "read_only_only",
3246
+ "qualification_rationale": "Read-only CLI path metadata check.",
3247
+ "evidence_source": "https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_blendfile_summary_path_info.py",
3248
+ "runtime_paths": [
3249
+ "path-1-host-a",
3250
+ "path-1-host-b"
3251
+ ],
3252
+ "server_identity": "Blender Lab MCP (blmcp)",
3253
+ "server_version": "1.0.2",
3254
+ "tool_schema_fingerprint": "d507a7356c42189349da95fe56452e423e6a30f13016e7e814644b23cc6c3a6e"
3255
+ },
3256
+ {
3257
+ "tool_name": "get_blendfile_summary_usage_guess",
3258
+ "description": "Guess the primary use-cases of the current blend file (scored 0-100 with certainty).",
3259
+ "input_schema": {
3260
+ "type": "object",
3261
+ "additionalProperties": false,
3262
+ "required": [],
3263
+ "properties": {}
3264
+ },
3265
+ "output_shape_summary": "dict with heuristic usage scores",
3266
+ "side_effects": "none",
3267
+ "required_capability_tier": "L0",
3268
+ "executes_arbitrary_code": false,
3269
+ "modifies_scene_state": false,
3270
+ "reads_files": false,
3271
+ "writes_files": false,
3272
+ "accesses_external_services": false,
3273
+ "bounded_and_independently_verifiable": true,
3274
+ "classification": "read_only_only",
3275
+ "qualification_rationale": "Read-only heuristic classification of scene datablocks.",
3276
+ "evidence_source": "https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_blendfile_summary_usage_guess.py",
3277
+ "runtime_paths": [
3278
+ "path-1-host-a",
3279
+ "path-1-host-b"
3280
+ ],
3281
+ "server_identity": "Blender Lab MCP (blmcp)",
3282
+ "server_version": "1.0.2",
3283
+ "tool_schema_fingerprint": "dfb1b381d46f7205df1a5bd1dc47a737231a7828501187720cf4e5b12bf1ab4c"
3284
+ },
3285
+ {
3286
+ "tool_name": "get_blendfile_summary_usage_guess_for_cli",
3287
+ "description": "Guess use-cases by opening blend_file in background Blender.",
3288
+ "input_schema": {
3289
+ "type": "object",
3290
+ "additionalProperties": false,
3291
+ "required": [
3292
+ "blend_file"
3293
+ ],
3294
+ "properties": {
3295
+ "blend_file": {
3296
+ "type": "string",
3297
+ "minLength": 1
3298
+ }
3299
+ }
3300
+ },
3301
+ "output_shape_summary": "dict with heuristic usage scores for blend_file",
3302
+ "side_effects": "none",
3303
+ "required_capability_tier": "L0",
3304
+ "executes_arbitrary_code": false,
3305
+ "modifies_scene_state": false,
3306
+ "reads_files": true,
3307
+ "writes_files": false,
3308
+ "accesses_external_services": false,
3309
+ "bounded_and_independently_verifiable": true,
3310
+ "classification": "read_only_only",
3311
+ "qualification_rationale": "Read-only CLI heuristic classification of scene datablocks.",
3312
+ "evidence_source": "https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_blendfile_summary_usage_guess.py",
3313
+ "runtime_paths": [
3314
+ "path-1-host-a",
3315
+ "path-1-host-b"
3316
+ ],
3317
+ "server_identity": "Blender Lab MCP (blmcp)",
3318
+ "server_version": "1.0.2",
3319
+ "tool_schema_fingerprint": "a1a1cbeb2145664522fc001a942cb376a43f249086302122dfbe32907945d776"
3320
+ },
3321
+ {
3322
+ "tool_name": "get_object_detail_summary",
3323
+ "description": "Return a structured summary of the object identified by name.",
3324
+ "input_schema": {
3325
+ "type": "object",
3326
+ "additionalProperties": false,
3327
+ "required": [
3328
+ "name"
3329
+ ],
3330
+ "properties": {
3331
+ "name": {
3332
+ "type": "string",
3333
+ "minLength": 1
3334
+ }
3335
+ }
3336
+ },
3337
+ "output_shape_summary": "dict with object type, transforms, modifiers, constraints, materials, visibility, and collections",
3338
+ "side_effects": "none",
3339
+ "required_capability_tier": "L0",
3340
+ "executes_arbitrary_code": false,
3341
+ "modifies_scene_state": false,
3342
+ "reads_files": false,
3343
+ "writes_files": false,
3344
+ "accesses_external_services": false,
3345
+ "bounded_and_independently_verifiable": true,
3346
+ "classification": "read_only_only",
3347
+ "qualification_rationale": "Read-only fixed toolcode inspecting single object transforms, modifiers, and materials by name.",
3348
+ "evidence_source": "https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_object_detail_summary.py",
3349
+ "runtime_paths": [
3350
+ "path-1-host-a",
3351
+ "path-1-host-b"
3352
+ ],
3353
+ "server_identity": "Blender Lab MCP (blmcp)",
3354
+ "server_version": "1.0.2",
3355
+ "tool_schema_fingerprint": "8db3448bbdb791de024f7f0687148f6d60258a974ce70adfc122fac9a74bb16e"
3356
+ },
3357
+ {
3358
+ "tool_name": "get_objects_summary",
3359
+ "description": "Return the scene collection hierarchy and their objects.",
3360
+ "input_schema": {
3361
+ "type": "object",
3362
+ "additionalProperties": false,
3363
+ "required": [],
3364
+ "properties": {}
3365
+ },
3366
+ "output_shape_summary": "dict with collection hierarchy and object descriptors",
3367
+ "side_effects": "none",
3368
+ "required_capability_tier": "L0",
3369
+ "executes_arbitrary_code": false,
3370
+ "modifies_scene_state": false,
3371
+ "reads_files": false,
3372
+ "writes_files": false,
3373
+ "accesses_external_services": false,
3374
+ "bounded_and_independently_verifiable": true,
3375
+ "classification": "read_only_only",
3376
+ "qualification_rationale": "Read-only fixed toolcode returning scene collection tree and object transforms/visibility.",
3377
+ "evidence_source": "https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_objects_summary.py",
3378
+ "runtime_paths": [
3379
+ "path-1-host-a",
3380
+ "path-1-host-b"
3381
+ ],
3382
+ "server_identity": "Blender Lab MCP (blmcp)",
3383
+ "server_version": "1.0.2",
3384
+ "tool_schema_fingerprint": "19105e512c7b198ac0a0cbf9f2b9f64d07258a4a97370a78c7b637379b33944f"
3385
+ },
3386
+ {
3387
+ "tool_name": "get_python_api_docs",
3388
+ "description": "Return the Blender Python API docs for identifier, or list modules matching a trailing-* discovery pattern.",
3389
+ "input_schema": {
3390
+ "type": "object",
3391
+ "additionalProperties": false,
3392
+ "required": [
3393
+ "identifier"
3394
+ ],
3395
+ "properties": {
3396
+ "identifier": {
3397
+ "type": "string",
3398
+ "minLength": 1
3399
+ }
3400
+ }
3401
+ },
3402
+ "output_shape_summary": "dict with bundled RST documentation text for identifier",
3403
+ "side_effects": "none",
3404
+ "required_capability_tier": "L0",
3405
+ "executes_arbitrary_code": false,
3406
+ "modifies_scene_state": false,
3407
+ "reads_files": true,
3408
+ "writes_files": false,
3409
+ "accesses_external_services": false,
3410
+ "bounded_and_independently_verifiable": true,
3411
+ "classification": "read_only_only",
3412
+ "qualification_rationale": "Queries static bundled Blender Python API RST files without touching the Blender scene.",
3413
+ "evidence_source": "https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_python_api_docs.py",
3414
+ "runtime_paths": [
3415
+ "path-1-host-a",
3416
+ "path-1-host-b"
3417
+ ],
3418
+ "server_identity": "Blender Lab MCP (blmcp)",
3419
+ "server_version": "1.0.2",
3420
+ "tool_schema_fingerprint": "10391a824fd3f783cec2ef55ac9c46bf51a1c8f162cd3a26fd6fd1b6e070d687"
3421
+ },
3422
+ {
3423
+ "tool_name": "get_screenshot_of_area_as_image",
3424
+ "description": "Take a screenshot of a single Blender area and return it as a PNG image.",
3425
+ "input_schema": {
3426
+ "type": "object",
3427
+ "additionalProperties": false,
3428
+ "required": [
3429
+ "area_index"
3430
+ ],
3431
+ "properties": {
3432
+ "area_index": {
3433
+ "type": "integer",
3434
+ "minimum": 0
3435
+ }
3436
+ }
3437
+ },
3438
+ "output_shape_summary": "MCP ImageContent (PNG bytes)",
3439
+ "side_effects": "none",
3440
+ "required_capability_tier": "L0",
3441
+ "executes_arbitrary_code": false,
3442
+ "modifies_scene_state": false,
3443
+ "reads_files": false,
3444
+ "writes_files": false,
3445
+ "accesses_external_services": false,
3446
+ "bounded_and_independently_verifiable": true,
3447
+ "classification": "read_only_only",
3448
+ "qualification_rationale": "Read-only UI area screenshot returned in-memory as MCP image content.",
3449
+ "evidence_source": "https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_screenshot_of_area_as_image.py",
3450
+ "runtime_paths": [
3451
+ "path-1-host-a",
3452
+ "path-1-host-b"
3453
+ ],
3454
+ "server_identity": "Blender Lab MCP (blmcp)",
3455
+ "server_version": "1.0.2",
3456
+ "tool_schema_fingerprint": "57bd80e58b7ee59d1d6c222518f025988beb81874fb07db3df24c2f2ad42e66f"
3457
+ },
3458
+ {
3459
+ "tool_name": "get_screenshot_of_window_as_image",
3460
+ "description": "Take a screenshot of the entire Blender window and return it as a PNG image.",
3461
+ "input_schema": {
3462
+ "type": "object",
3463
+ "additionalProperties": false,
3464
+ "required": [],
3465
+ "properties": {}
3466
+ },
3467
+ "output_shape_summary": "MCP ImageContent (PNG bytes)",
3468
+ "side_effects": "none",
3469
+ "required_capability_tier": "L0",
3470
+ "executes_arbitrary_code": false,
3471
+ "modifies_scene_state": false,
3472
+ "reads_files": false,
3473
+ "writes_files": false,
3474
+ "accesses_external_services": false,
3475
+ "bounded_and_independently_verifiable": true,
3476
+ "classification": "read_only_only",
3477
+ "qualification_rationale": "Read-only full window screenshot returned in-memory as MCP image content.",
3478
+ "evidence_source": "https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_screenshot_of_window_as_image.py",
3479
+ "runtime_paths": [
3480
+ "path-1-host-a",
3481
+ "path-1-host-b"
3482
+ ],
3483
+ "server_identity": "Blender Lab MCP (blmcp)",
3484
+ "server_version": "1.0.2",
3485
+ "tool_schema_fingerprint": "33787ee15f1e224ebc495e6de06ebfba0b4dd9fa61c6d4174db192ea8ba47f4c"
3486
+ },
3487
+ {
3488
+ "tool_name": "get_screenshot_of_window_as_json",
3489
+ "description": "Return a JSON description of the Blender window layout, areas, active object, and selection.",
3490
+ "input_schema": {
3491
+ "type": "object",
3492
+ "additionalProperties": false,
3493
+ "required": [],
3494
+ "properties": {}
3495
+ },
3496
+ "output_shape_summary": "dict describing window layout, areas, active object, and selection",
3497
+ "side_effects": "none",
3498
+ "required_capability_tier": "L0",
3499
+ "executes_arbitrary_code": false,
3500
+ "modifies_scene_state": false,
3501
+ "reads_files": false,
3502
+ "writes_files": false,
3503
+ "accesses_external_services": false,
3504
+ "bounded_and_independently_verifiable": true,
3505
+ "classification": "read_only_only",
3506
+ "qualification_rationale": "Read-only inspection of window layout and active selection.",
3507
+ "evidence_source": "https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/get_screenshot_of_window_as_json.py",
3508
+ "runtime_paths": [
3509
+ "path-1-host-a",
3510
+ "path-1-host-b"
3511
+ ],
3512
+ "server_identity": "Blender Lab MCP (blmcp)",
3513
+ "server_version": "1.0.2",
3514
+ "tool_schema_fingerprint": "0848f4ac37a2b70605b84a77f5735784b76528b3abeb9808a3f04c9016a2fd1c"
3515
+ },
3516
+ {
3517
+ "tool_name": "jump_to_tab_by_name",
3518
+ "description": "Switch the active workspace tab to name.",
3519
+ "input_schema": {
3520
+ "type": "object",
3521
+ "additionalProperties": false,
3522
+ "required": [
3523
+ "name"
3524
+ ],
3525
+ "properties": {
3526
+ "name": {
3527
+ "type": "string",
3528
+ "minLength": 1
3529
+ }
3530
+ }
3531
+ },
3532
+ "output_shape_summary": "dict confirming workspace switch",
3533
+ "side_effects": "ui_state_mutation",
3534
+ "required_capability_tier": "L1",
3535
+ "executes_arbitrary_code": false,
3536
+ "modifies_scene_state": false,
3537
+ "reads_files": false,
3538
+ "writes_files": false,
3539
+ "accesses_external_services": false,
3540
+ "bounded_and_independently_verifiable": false,
3541
+ "classification": "unsupported",
3542
+ "qualification_rationale": "Mutates interactive Blender UI workspace tab state rather than governed scene datablocks; not mapped to any BlendOps canonical operation.",
3543
+ "evidence_source": "https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/jump_to_tab_by_name.py",
3544
+ "runtime_paths": [
3545
+ "path-1-host-a",
3546
+ "path-1-host-b"
3547
+ ],
3548
+ "server_identity": "Blender Lab MCP (blmcp)",
3549
+ "server_version": "1.0.2",
3550
+ "tool_schema_fingerprint": "210ca95b2b6ce7189ea75f4ed0f04770397504615c6ad6a9b54c44ad4e41682c"
3551
+ },
3552
+ {
3553
+ "tool_name": "jump_to_tab_by_space_type",
3554
+ "description": "Switch to a workspace whose main area matches space_type.",
3555
+ "input_schema": {
3556
+ "type": "object",
3557
+ "additionalProperties": false,
3558
+ "required": [
3559
+ "space_type"
3560
+ ],
3561
+ "properties": {
3562
+ "space_type": {
3563
+ "type": "string",
3564
+ "minLength": 1
3565
+ }
3566
+ }
3567
+ },
3568
+ "output_shape_summary": "dict confirming workspace switch by space_type",
3569
+ "side_effects": "ui_state_mutation",
3570
+ "required_capability_tier": "L1",
3571
+ "executes_arbitrary_code": false,
3572
+ "modifies_scene_state": false,
3573
+ "reads_files": false,
3574
+ "writes_files": false,
3575
+ "accesses_external_services": false,
3576
+ "bounded_and_independently_verifiable": false,
3577
+ "classification": "unsupported",
3578
+ "qualification_rationale": "Mutates interactive Blender UI workspace state; not mapped to any BlendOps canonical operation.",
3579
+ "evidence_source": "https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/jump_to_tab_by_space_type.py",
3580
+ "runtime_paths": [
3581
+ "path-1-host-a",
3582
+ "path-1-host-b"
3583
+ ],
3584
+ "server_identity": "Blender Lab MCP (blmcp)",
3585
+ "server_version": "1.0.2",
3586
+ "tool_schema_fingerprint": "2fa6ee4c0ed693600630b9fcb69d46c64e23d52ff1e55251f489ff2bb247183e"
3587
+ },
3588
+ {
3589
+ "tool_name": "jump_to_view3d_object_by_name",
3590
+ "description": "Move the 3D viewport to focus on an object by name.",
3591
+ "input_schema": {
3592
+ "type": "object",
3593
+ "additionalProperties": false,
3594
+ "required": [
3595
+ "name"
3596
+ ],
3597
+ "properties": {
3598
+ "name": {
3599
+ "type": "string",
3600
+ "minLength": 1
3601
+ }
3602
+ }
3603
+ },
3604
+ "output_shape_summary": "dict confirming viewport focus change",
3605
+ "side_effects": "ui_state_mutation",
3606
+ "required_capability_tier": "L1",
3607
+ "executes_arbitrary_code": false,
3608
+ "modifies_scene_state": false,
3609
+ "reads_files": false,
3610
+ "writes_files": false,
3611
+ "accesses_external_services": false,
3612
+ "bounded_and_independently_verifiable": false,
3613
+ "classification": "unsupported",
3614
+ "qualification_rationale": "Mutates 3D viewport navigation camera rather than governed scene camera datablock.",
3615
+ "evidence_source": "https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/jump_to_view3d_object_by_name.py",
3616
+ "runtime_paths": [
3617
+ "path-1-host-a",
3618
+ "path-1-host-b"
3619
+ ],
3620
+ "server_identity": "Blender Lab MCP (blmcp)",
3621
+ "server_version": "1.0.2",
3622
+ "tool_schema_fingerprint": "460ef4d4d396a4d19f72eb65fb5ee025f213d093cc7111723ebbaeb8fe49602e"
3623
+ },
3624
+ {
3625
+ "tool_name": "jump_to_view3d_object_data_by_name",
3626
+ "description": "Move the 3D viewport to the object whose data block matches name.",
3627
+ "input_schema": {
3628
+ "type": "object",
3629
+ "additionalProperties": false,
3630
+ "required": [
3631
+ "name"
3632
+ ],
3633
+ "properties": {
3634
+ "name": {
3635
+ "type": "string",
3636
+ "minLength": 1
3637
+ }
3638
+ }
3639
+ },
3640
+ "output_shape_summary": "dict confirming viewport focus change by data-block name",
3641
+ "side_effects": "ui_state_mutation",
3642
+ "required_capability_tier": "L1",
3643
+ "executes_arbitrary_code": false,
3644
+ "modifies_scene_state": false,
3645
+ "reads_files": false,
3646
+ "writes_files": false,
3647
+ "accesses_external_services": false,
3648
+ "bounded_and_independently_verifiable": false,
3649
+ "classification": "unsupported",
3650
+ "qualification_rationale": "Mutates 3D viewport navigation state rather than governed scene datablocks.",
3651
+ "evidence_source": "https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/jump_to_view3d_object_data_by_name.py",
3652
+ "runtime_paths": [
3653
+ "path-1-host-a",
3654
+ "path-1-host-b"
3655
+ ],
3656
+ "server_identity": "Blender Lab MCP (blmcp)",
3657
+ "server_version": "1.0.2",
3658
+ "tool_schema_fingerprint": "fc8bdf71b1808716a3c993fe8a9472dd922bedb301158d3800b31234135a3a0d"
3659
+ },
3660
+ {
3661
+ "tool_name": "render_thumbnail_to_path",
3662
+ "description": "Render a small, low-quality thumbnail to output_path (temporarily overrides settings).",
3663
+ "input_schema": {
3664
+ "type": "object",
3665
+ "additionalProperties": false,
3666
+ "required": [
3667
+ "output_path"
3668
+ ],
3669
+ "properties": {
3670
+ "output_path": {
3671
+ "type": "string",
3672
+ "minLength": 1
3673
+ }
3674
+ }
3675
+ },
3676
+ "output_shape_summary": "dict confirming thumbnail file written to output_path",
3677
+ "side_effects": "file_write",
3678
+ "required_capability_tier": "L2",
3679
+ "executes_arbitrary_code": false,
3680
+ "modifies_scene_state": true,
3681
+ "reads_files": false,
3682
+ "writes_files": true,
3683
+ "accesses_external_services": false,
3684
+ "bounded_and_independently_verifiable": false,
3685
+ "classification": "conditional",
3686
+ "qualification_rationale": "Upstream sets readOnlyHint=True, but open upstream issue #70 shows INVOKE_DEFAULT restores temporary resolution/simplify/sample overrides before interactive rendering starts, and issue #12 shows scene.render.filepath is mutated directly on the user scene until the deferred callback finishes while forcing output into os.path.join(bpy.app.tempdir, 'blender_mcp', basename). Reclassified as conditional: blocked in unguarded live mode unless disposableSceneConfirmed + verified .blend checkpoint + isolated governed staging directory + pre/post render settings readback restoration check pass.",
3687
+ "evidence_source": "https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/render_thumbnail_to_path.py",
3688
+ "source_commit_sha": "dbbf836ad4b1025f14a2b3b504c43903f39e0b04",
3689
+ "known_upstream_issues": [
3690
+ "https://projects.blender.org/lab/blender_mcp/issues/12",
3691
+ "https://projects.blender.org/lab/blender_mcp/issues/70"
3692
+ ],
3693
+ "conditional_execution_requirements": [
3694
+ "disposable_scene_or_verified_blend_checkpoint",
3695
+ "isolated_governed_staging_directory",
3696
+ "pre_and_post_render_settings_readback_restoration_verified",
3697
+ "on_disk_file_and_sha256_verified_before_promotion"
3698
+ ],
3699
+ "runtime_paths": [
3700
+ "path-1-host-a",
3701
+ "path-1-host-b"
3702
+ ],
3703
+ "server_identity": "Blender Lab MCP (blmcp)",
3704
+ "server_version": "1.0.2",
3705
+ "tool_schema_fingerprint": "6b00317058217c0111d990cd62d2016c8dec87ee2f1abb38182bc8cbc06297aa"
3706
+ },
3707
+ {
3708
+ "tool_name": "render_viewport_to_path",
3709
+ "description": "Render the current scene to output_path using current render settings.",
3710
+ "input_schema": {
3711
+ "type": "object",
3712
+ "additionalProperties": false,
3713
+ "required": [
3714
+ "output_path"
3715
+ ],
3716
+ "properties": {
3717
+ "output_path": {
3718
+ "type": "string",
3719
+ "minLength": 1
3720
+ }
3721
+ }
3722
+ },
3723
+ "output_shape_summary": "dict confirming rendered image written to output_path",
3724
+ "side_effects": "file_write",
3725
+ "required_capability_tier": "L2",
3726
+ "executes_arbitrary_code": false,
3727
+ "modifies_scene_state": true,
3728
+ "reads_files": false,
3729
+ "writes_files": true,
3730
+ "accesses_external_services": false,
3731
+ "bounded_and_independently_verifiable": false,
3732
+ "classification": "conditional",
3733
+ "qualification_rationale": "Upstream sets readOnlyHint=True, but open upstream issue #12 shows render_viewport_to_path mutates scene.render.filepath directly on the user scene until the deferred callback finishes and forces output into os.path.join(bpy.app.tempdir, 'blender_mcp', basename). Reclassified as conditional: blocked in unguarded live mode unless disposableSceneConfirmed + verified .blend checkpoint + isolated governed staging directory + pre/post render settings readback restoration check pass.",
3734
+ "evidence_source": "https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/render_viewport_to_path.py",
3735
+ "source_commit_sha": "dbbf836ad4b1025f14a2b3b504c43903f39e0b04",
3736
+ "known_upstream_issues": [
3737
+ "https://projects.blender.org/lab/blender_mcp/issues/12",
3738
+ "https://projects.blender.org/lab/blender_mcp/issues/70"
3739
+ ],
3740
+ "conditional_execution_requirements": [
3741
+ "disposable_scene_or_verified_blend_checkpoint",
3742
+ "isolated_governed_staging_directory",
3743
+ "pre_and_post_render_settings_readback_restoration_verified",
3744
+ "on_disk_file_and_sha256_verified_before_promotion"
3745
+ ],
3746
+ "runtime_paths": [
3747
+ "path-1-host-a",
3748
+ "path-1-host-b"
3749
+ ],
3750
+ "server_identity": "Blender Lab MCP (blmcp)",
3751
+ "server_version": "1.0.2",
3752
+ "tool_schema_fingerprint": "288057920fe2cda5733db02228a417c98da75f4648a4524113ea78e0d75e4b25"
3753
+ },
3754
+ {
3755
+ "tool_name": "search_api_docs",
3756
+ "description": "Full-text search over the bundled Blender Python API reference.",
3757
+ "input_schema": {
3758
+ "type": "object",
3759
+ "additionalProperties": false,
3760
+ "required": [
3761
+ "query"
3762
+ ],
3763
+ "properties": {
3764
+ "query": {
3765
+ "type": "string",
3766
+ "minLength": 1
3767
+ }
3768
+ }
3769
+ },
3770
+ "output_shape_summary": "dict with matching API documentation snippets",
3771
+ "side_effects": "none",
3772
+ "required_capability_tier": "L0",
3773
+ "executes_arbitrary_code": false,
3774
+ "modifies_scene_state": false,
3775
+ "reads_files": true,
3776
+ "writes_files": false,
3777
+ "accesses_external_services": false,
3778
+ "bounded_and_independently_verifiable": true,
3779
+ "classification": "read_only_only",
3780
+ "qualification_rationale": "Read-only full-text search over static bundled API documentation.",
3781
+ "evidence_source": "https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/search_api_docs.py",
3782
+ "runtime_paths": [
3783
+ "path-1-host-a",
3784
+ "path-1-host-b"
3785
+ ],
3786
+ "server_identity": "Blender Lab MCP (blmcp)",
3787
+ "server_version": "1.0.2",
3788
+ "tool_schema_fingerprint": "02f06eeacde972ff7c654a5da292ebc96d7f6228aba9fe748590e1ef87877ca4"
3789
+ },
3790
+ {
3791
+ "tool_name": "search_manual_docs",
3792
+ "description": "Full-text search over the bundled Blender user manual.",
3793
+ "input_schema": {
3794
+ "type": "object",
3795
+ "additionalProperties": false,
3796
+ "required": [
3797
+ "query"
3798
+ ],
3799
+ "properties": {
3800
+ "query": {
3801
+ "type": "string",
3802
+ "minLength": 1
3803
+ }
3804
+ }
3805
+ },
3806
+ "output_shape_summary": "dict with matching Blender Manual snippets",
3807
+ "side_effects": "none",
3808
+ "required_capability_tier": "L0",
3809
+ "executes_arbitrary_code": false,
3810
+ "modifies_scene_state": false,
3811
+ "reads_files": true,
3812
+ "writes_files": false,
3813
+ "accesses_external_services": false,
3814
+ "bounded_and_independently_verifiable": true,
3815
+ "classification": "read_only_only",
3816
+ "qualification_rationale": "Read-only full-text search over static bundled Blender Manual RST files.",
3817
+ "evidence_source": "https://projects.blender.org/lab/blender_mcp/src/branch/main/mcp/blmcp/tools/search_manual_docs.py",
3818
+ "runtime_paths": [
3819
+ "path-1-host-a",
3820
+ "path-1-host-b"
3821
+ ],
3822
+ "server_identity": "Blender Lab MCP (blmcp)",
3823
+ "server_version": "1.0.2",
3824
+ "tool_schema_fingerprint": "ec0814996111a0694b64dac848d55abbada9556b81ef63fbcfac47b48e45ac01"
3825
+ },
3826
+ {
3827
+ "tool_name": "get_addon_status",
3828
+ "description": "Check the connected Blender: its version, whether the addon matches this server, and which asset libraries and 3D generators are switched on.",
3829
+ "input_schema": {
3830
+ "type": "object",
3831
+ "additionalProperties": false,
3832
+ "required": [],
3833
+ "properties": {
3834
+ "user_prompt": {
3835
+ "type": "string"
3836
+ }
3837
+ }
3838
+ },
3839
+ "output_shape_summary": "string or JSON summary of Blender version, addon v1.8 match, and enabled integrations",
3840
+ "side_effects": "none",
3841
+ "required_capability_tier": "L0",
3842
+ "executes_arbitrary_code": false,
3843
+ "modifies_scene_state": false,
3844
+ "reads_files": false,
3845
+ "writes_files": false,
3846
+ "accesses_external_services": false,
3847
+ "bounded_and_independently_verifiable": true,
3848
+ "classification": "read_only_only",
3849
+ "qualification_rationale": "Read-only handshake inspection verifying Blender version and addon compatibility.",
3850
+ "evidence_source": "https://github.com/ahujasid/blender-mcp/blob/main/src/blender_mcp/server.py#L451",
3851
+ "runtime_paths": [
3852
+ "path-2-community"
3853
+ ],
3854
+ "server_identity": "MCP for Blender (ahujasid/mcp-for-blender)",
3855
+ "server_version": "2.2.7",
3856
+ "tool_schema_fingerprint": "e0a491a9f51fc8126dc51beb503a6bb12b2145811f9e2ec8e870eaa4926f9489"
3857
+ },
3858
+ {
3859
+ "tool_name": "disable_telemetry",
3860
+ "description": "Turn OFF collection of prompts, code, screenshots and scene data.",
3861
+ "input_schema": {
3862
+ "type": "object",
3863
+ "additionalProperties": false,
3864
+ "required": [],
3865
+ "properties": {
3866
+ "user_prompt": {
3867
+ "type": "string"
3868
+ }
3869
+ }
3870
+ },
3871
+ "output_shape_summary": "string confirmation of telemetry opt-out",
3872
+ "side_effects": "telemetry_or_config_mutation",
3873
+ "required_capability_tier": "L1",
3874
+ "executes_arbitrary_code": false,
3875
+ "modifies_scene_state": false,
3876
+ "reads_files": false,
3877
+ "writes_files": true,
3878
+ "accesses_external_services": false,
3879
+ "bounded_and_independently_verifiable": false,
3880
+ "classification": "unsupported",
3881
+ "qualification_rationale": "Mutates third-party add-on telemetry preferences rather than governed 3D scene state.",
3882
+ "evidence_source": "https://github.com/ahujasid/blender-mcp/blob/main/src/blender_mcp/server.py#L501",
3883
+ "runtime_paths": [
3884
+ "path-2-community"
3885
+ ],
3886
+ "server_identity": "MCP for Blender (ahujasid/mcp-for-blender)",
3887
+ "server_version": "2.2.7",
3888
+ "tool_schema_fingerprint": "1513ad3e444c9963c6dc265cab89544b449c7eee5a72b9e4b9c484336758d43c"
3889
+ },
3890
+ {
3891
+ "tool_name": "get_scene_info",
3892
+ "description": "Facts about the scene as text/JSON: what is there, where, how big, and how healthy meshes and rigs are.",
3893
+ "input_schema": {
3894
+ "type": "object",
3895
+ "additionalProperties": false,
3896
+ "required": [],
3897
+ "properties": {
3898
+ "user_prompt": {
3899
+ "type": "string"
3900
+ },
3901
+ "query": {
3902
+ "type": [
3903
+ "string",
3904
+ "null"
3905
+ ]
3906
+ },
3907
+ "root": {
3908
+ "type": [
3909
+ "string",
3910
+ "null"
3911
+ ]
3912
+ },
3913
+ "fields": {
3914
+ "type": [
3915
+ "array",
3916
+ "null"
3917
+ ],
3918
+ "items": {
3919
+ "type": "string"
3920
+ }
3921
+ },
3922
+ "limit": {
3923
+ "type": "integer"
3924
+ }
3925
+ }
3926
+ },
3927
+ "output_shape_summary": "structured scene object, hierarchy, camera, light, and render summary",
3928
+ "side_effects": "none",
3929
+ "required_capability_tier": "L0",
3930
+ "executes_arbitrary_code": false,
3931
+ "modifies_scene_state": false,
3932
+ "reads_files": false,
3933
+ "writes_files": false,
3934
+ "accesses_external_services": false,
3935
+ "bounded_and_independently_verifiable": true,
3936
+ "classification": "read_only_only",
3937
+ "qualification_rationale": "Read-only inspection of active scene objects, transforms, cameras, lights, and hierarchy.",
3938
+ "evidence_source": "https://github.com/ahujasid/blender-mcp/blob/main/src/blender_mcp/server.py#L607",
3939
+ "runtime_paths": [
3940
+ "path-2-community"
3941
+ ],
3942
+ "server_identity": "MCP for Blender (ahujasid/mcp-for-blender)",
3943
+ "server_version": "2.2.7",
3944
+ "tool_schema_fingerprint": "caa384b8584c6d54ebfd6194ab612e0eaa3e6a54fa8bacdc5134b03cf7963566"
3945
+ },
3946
+ {
3947
+ "tool_name": "execute_blender_code",
3948
+ "description": "Run Python in the user live Blender (bpy, bmesh, mathutils). Whatever it prints is returned.",
3949
+ "input_schema": {
3950
+ "type": "object",
3951
+ "additionalProperties": false,
3952
+ "required": [
3953
+ "code"
3954
+ ],
3955
+ "properties": {
3956
+ "code": {
3957
+ "type": "string"
3958
+ },
3959
+ "user_prompt": {
3960
+ "type": "string"
3961
+ }
3962
+ }
3963
+ },
3964
+ "output_shape_summary": "stdout string from arbitrary exec() in Blender",
3965
+ "side_effects": "arbitrary_code_execution",
3966
+ "required_capability_tier": "L3",
3967
+ "executes_arbitrary_code": true,
3968
+ "modifies_scene_state": true,
3969
+ "reads_files": true,
3970
+ "writes_files": true,
3971
+ "accesses_external_services": true,
3972
+ "bounded_and_independently_verifiable": false,
3973
+ "classification": "unsafe_raw_code",
3974
+ "qualification_rationale": "Executes arbitrary Python via exec() inside Blender main thread without sandboxing; permanently blocked per laws/no-arbitrary-python-interface.md.",
3975
+ "evidence_source": "https://github.com/ahujasid/blender-mcp/blob/main/src/blender_mcp/server.py#L791",
3976
+ "runtime_paths": [
3977
+ "path-2-community"
3978
+ ],
3979
+ "server_identity": "MCP for Blender (ahujasid/mcp-for-blender)",
3980
+ "server_version": "2.2.7",
3981
+ "tool_schema_fingerprint": "23ad5f7c9b3dce9b57112ae26d823a1f4b6315214c4d88ee7330443485d071b5"
3982
+ },
3983
+ {
3984
+ "tool_name": "record_trajectory_feedback",
3985
+ "description": "Record evaluation feedback for a captured trajectory step.",
3986
+ "input_schema": {
3987
+ "type": "object",
3988
+ "additionalProperties": false,
3989
+ "required": [
3990
+ "feedback"
3991
+ ],
3992
+ "properties": {
3993
+ "feedback": {
3994
+ "type": "string"
3995
+ },
3996
+ "correction_text": {
3997
+ "type": [
3998
+ "string",
3999
+ "null"
4000
+ ]
4001
+ },
4002
+ "step_index": {
4003
+ "type": [
4004
+ "integer",
4005
+ "null"
4006
+ ]
4007
+ },
4008
+ "user_prompt": {
4009
+ "type": "string"
4010
+ }
4011
+ }
4012
+ },
4013
+ "output_shape_summary": "string telemetry recording status",
4014
+ "side_effects": "telemetry_or_config_mutation",
4015
+ "required_capability_tier": "L1",
4016
+ "executes_arbitrary_code": false,
4017
+ "modifies_scene_state": false,
4018
+ "reads_files": false,
4019
+ "writes_files": true,
4020
+ "accesses_external_services": true,
4021
+ "bounded_and_independently_verifiable": false,
4022
+ "classification": "unsupported",
4023
+ "qualification_rationale": "Records third-party trajectory telemetry; not a governed Blender scene operation.",
4024
+ "evidence_source": "https://github.com/ahujasid/blender-mcp/blob/main/src/blender_mcp/server.py#L1484",
4025
+ "runtime_paths": [
4026
+ "path-2-community"
4027
+ ],
4028
+ "server_identity": "MCP for Blender (ahujasid/mcp-for-blender)",
4029
+ "server_version": "2.2.7",
4030
+ "tool_schema_fingerprint": "98a1b88827b1f5aac33e27de245031b28b5680e24553ad5524d9f092f7b41863"
4031
+ },
4032
+ {
4033
+ "tool_name": "look",
4034
+ "description": "Inspect viewport or camera views of the scene or specific target objects.",
4035
+ "input_schema": {
4036
+ "type": "object",
4037
+ "additionalProperties": false,
4038
+ "required": [],
4039
+ "properties": {
4040
+ "mode": {
4041
+ "type": [
4042
+ "string",
4043
+ "null"
4044
+ ]
4045
+ },
4046
+ "target": {
4047
+ "type": [
4048
+ "array",
4049
+ "null"
4050
+ ],
4051
+ "items": {
4052
+ "type": "string"
4053
+ }
4054
+ },
4055
+ "max_size": {
4056
+ "type": "integer"
4057
+ },
4058
+ "user_prompt": {
4059
+ "type": "string"
4060
+ }
4061
+ }
4062
+ },
4063
+ "output_shape_summary": "viewport capture image content and view metadata",
4064
+ "side_effects": "none",
4065
+ "required_capability_tier": "L0",
4066
+ "executes_arbitrary_code": false,
4067
+ "modifies_scene_state": false,
4068
+ "reads_files": false,
4069
+ "writes_files": false,
4070
+ "accesses_external_services": false,
4071
+ "bounded_and_independently_verifiable": true,
4072
+ "classification": "read_only_only",
4073
+ "qualification_rationale": "Read-only viewport visual inspection tool.",
4074
+ "evidence_source": "https://github.com/ahujasid/blender-mcp/blob/main/src/blender_mcp/server.py#L1562",
4075
+ "runtime_paths": [
4076
+ "path-2-community"
4077
+ ],
4078
+ "server_identity": "MCP for Blender (ahujasid/mcp-for-blender)",
4079
+ "server_version": "2.2.7",
4080
+ "tool_schema_fingerprint": "179cbb5fa704032e95430b287bb2c570c34877b5fdd97bbe2cf1215f6b4d30a2"
4081
+ },
4082
+ {
4083
+ "tool_name": "generate_3d",
4084
+ "description": "Generate a 3D model from text or image via external cloud providers (Rodin, Tripo, Hunyuan3D) and import into Blender.",
4085
+ "input_schema": {
4086
+ "type": "object",
4087
+ "additionalProperties": false,
4088
+ "required": [],
4089
+ "properties": {
4090
+ "prompt": {
4091
+ "type": [
4092
+ "string",
4093
+ "null"
4094
+ ]
4095
+ },
4096
+ "image": {
4097
+ "type": [
4098
+ "string",
4099
+ "null"
4100
+ ]
4101
+ },
4102
+ "name": {
4103
+ "type": [
4104
+ "string",
4105
+ "null"
4106
+ ]
4107
+ },
4108
+ "provider": {
4109
+ "type": "string"
4110
+ },
4111
+ "user_prompt": {
4112
+ "type": "string"
4113
+ }
4114
+ }
4115
+ },
4116
+ "output_shape_summary": "cloud generation job status and imported mesh summary",
4117
+ "side_effects": "external_network_and_scene_mutation",
4118
+ "required_capability_tier": "L3",
4119
+ "executes_arbitrary_code": false,
4120
+ "modifies_scene_state": true,
4121
+ "reads_files": true,
4122
+ "writes_files": true,
4123
+ "accesses_external_services": true,
4124
+ "bounded_and_independently_verifiable": false,
4125
+ "classification": "unsupported",
4126
+ "qualification_rationale": "Calls external third-party cloud AI generation APIs and mutates the live scene without deterministic mesh/license/checkpoint guarantees.",
4127
+ "evidence_source": "https://github.com/ahujasid/blender-mcp/blob/main/src/blender_mcp/server.py#L1757",
4128
+ "runtime_paths": [
4129
+ "path-2-community"
4130
+ ],
4131
+ "server_identity": "MCP for Blender (ahujasid/mcp-for-blender)",
4132
+ "server_version": "2.2.7",
4133
+ "tool_schema_fingerprint": "15195ee10da2d4979578c1d300d8cca89b039454057d30dedfa47c44c20e828f"
4134
+ },
4135
+ {
4136
+ "tool_name": "search_assets",
4137
+ "description": "Search external 3D/material/HDRI libraries (Poly Haven, Sketchfab, Poly Pizza, BlenderKit).",
4138
+ "input_schema": {
4139
+ "type": "object",
4140
+ "additionalProperties": false,
4141
+ "required": [
4142
+ "source"
4143
+ ],
4144
+ "properties": {
4145
+ "source": {
4146
+ "type": "string"
4147
+ },
4148
+ "query": {
4149
+ "type": "string"
4150
+ },
4151
+ "asset_type": {
4152
+ "type": "string"
4153
+ },
4154
+ "limit": {
4155
+ "type": "integer"
4156
+ },
4157
+ "user_prompt": {
4158
+ "type": "string"
4159
+ }
4160
+ }
4161
+ },
4162
+ "output_shape_summary": "external asset search results",
4163
+ "side_effects": "external_network_and_scene_mutation",
4164
+ "required_capability_tier": "L2",
4165
+ "executes_arbitrary_code": false,
4166
+ "modifies_scene_state": false,
4167
+ "reads_files": false,
4168
+ "writes_files": false,
4169
+ "accesses_external_services": true,
4170
+ "bounded_and_independently_verifiable": false,
4171
+ "classification": "unsupported",
4172
+ "qualification_rationale": "Queries external third-party network catalogs rather than local governed scene state.",
4173
+ "evidence_source": "https://github.com/ahujasid/blender-mcp/blob/main/src/blender_mcp/server.py#L1881",
4174
+ "runtime_paths": [
4175
+ "path-2-community"
4176
+ ],
4177
+ "server_identity": "MCP for Blender (ahujasid/mcp-for-blender)",
4178
+ "server_version": "2.2.7",
4179
+ "tool_schema_fingerprint": "753f2f24088a0772fbc681888f444ae6c0c860423375bd4c421072815dec9bfc"
4180
+ },
4181
+ {
4182
+ "tool_name": "import_asset",
4183
+ "description": "Download and import an asset from an external network source (Poly Haven, Sketchfab, Poly Pizza) into Blender.",
4184
+ "input_schema": {
4185
+ "type": "object",
4186
+ "additionalProperties": false,
4187
+ "required": [
4188
+ "source",
4189
+ "id"
4190
+ ],
4191
+ "properties": {
4192
+ "source": {
4193
+ "type": "string"
4194
+ },
4195
+ "id": {
4196
+ "type": "string"
4197
+ },
4198
+ "asset_type": {
4199
+ "type": [
4200
+ "string",
4201
+ "null"
4202
+ ]
4203
+ },
4204
+ "resolution": {
4205
+ "type": "string"
4206
+ },
4207
+ "user_prompt": {
4208
+ "type": "string"
4209
+ }
4210
+ }
4211
+ },
4212
+ "output_shape_summary": "string confirmation of downloaded and imported remote asset",
4213
+ "side_effects": "external_network_and_scene_mutation",
4214
+ "required_capability_tier": "L2",
4215
+ "executes_arbitrary_code": false,
4216
+ "modifies_scene_state": true,
4217
+ "reads_files": true,
4218
+ "writes_files": true,
4219
+ "accesses_external_services": true,
4220
+ "bounded_and_independently_verifiable": false,
4221
+ "classification": "unsupported",
4222
+ "qualification_rationale": "Upstream import_asset downloads arbitrary remote network files and mutates the live scene without enforcing BlendOps SPDX license preflight or pre-mutation .blend checkpoint.",
4223
+ "evidence_source": "https://github.com/ahujasid/blender-mcp/blob/main/src/blender_mcp/server.py#L1951",
4224
+ "runtime_paths": [
4225
+ "path-2-community"
4226
+ ],
4227
+ "server_identity": "MCP for Blender (ahujasid/mcp-for-blender)",
4228
+ "server_version": "2.2.7",
4229
+ "tool_schema_fingerprint": "6732f0bb197417522e69d4e65810306da377a2545bf93b7eaac033b10866d949"
4230
+ },
4231
+ {
4232
+ "tool_name": "search_mentions",
4233
+ "description": "Search scene objects, materials and collections to @-mention in the composer.",
4234
+ "input_schema": {
4235
+ "type": "object",
4236
+ "additionalProperties": false,
4237
+ "required": [],
4238
+ "properties": {
4239
+ "query": {
4240
+ "type": "string"
4241
+ }
4242
+ }
4243
+ },
4244
+ "output_shape_summary": "CallToolResult listing matching scene objects, materials, and collections",
4245
+ "side_effects": "none",
4246
+ "required_capability_tier": "L0",
4247
+ "executes_arbitrary_code": false,
4248
+ "modifies_scene_state": false,
4249
+ "reads_files": false,
4250
+ "writes_files": false,
4251
+ "accesses_external_services": false,
4252
+ "bounded_and_independently_verifiable": true,
4253
+ "classification": "read_only_only",
4254
+ "qualification_rationale": "Read-only search over scene objects, materials, and collections (_READ_ONLY annotation verified).",
4255
+ "evidence_source": "https://github.com/ahujasid/blender-mcp/blob/main/src/blender_mcp/server.py#L2056",
4256
+ "runtime_paths": [
4257
+ "path-2-community"
4258
+ ],
4259
+ "server_identity": "MCP for Blender (ahujasid/mcp-for-blender)",
4260
+ "server_version": "2.2.7",
4261
+ "tool_schema_fingerprint": "a0c620c18f12c994aaab7c3f13a8c7b4e4f065f2eb0f2a757fde3d61a0a5998a"
4262
+ },
4263
+ {
4264
+ "tool_name": "open_viewport",
4265
+ "description": "Show the latest Blender viewport screenshot beside the conversation.",
4266
+ "input_schema": {
4267
+ "type": "object",
4268
+ "additionalProperties": false,
4269
+ "required": [],
4270
+ "properties": {}
4271
+ },
4272
+ "output_shape_summary": "CallToolResult with cached viewport screenshot",
4273
+ "side_effects": "none",
4274
+ "required_capability_tier": "L0",
4275
+ "executes_arbitrary_code": false,
4276
+ "modifies_scene_state": false,
4277
+ "reads_files": false,
4278
+ "writes_files": false,
4279
+ "accesses_external_services": false,
4280
+ "bounded_and_independently_verifiable": true,
4281
+ "classification": "read_only_only",
4282
+ "qualification_rationale": "Read-only cached viewport display tool.",
4283
+ "evidence_source": "https://github.com/ahujasid/blender-mcp/blob/main/src/blender_mcp/server.py#L2146",
4284
+ "runtime_paths": [
4285
+ "path-2-community"
4286
+ ],
4287
+ "server_identity": "MCP for Blender (ahujasid/mcp-for-blender)",
4288
+ "server_version": "2.2.7",
4289
+ "tool_schema_fingerprint": "48168ec62605a643ba676d5d25a68097e15d0208ba29aafe288e210c9df4da89"
4290
+ },
4291
+ {
4292
+ "tool_name": "viewport_latest",
4293
+ "description": "The latest viewport screenshot, if newer than since. Never touches Blender.",
4294
+ "input_schema": {
4295
+ "type": "object",
4296
+ "additionalProperties": false,
4297
+ "required": [],
4298
+ "properties": {
4299
+ "since": {
4300
+ "type": "integer"
4301
+ }
4302
+ }
4303
+ },
4304
+ "output_shape_summary": "CallToolResult with cached viewport screenshot",
4305
+ "side_effects": "none",
4306
+ "required_capability_tier": "L0",
4307
+ "executes_arbitrary_code": false,
4308
+ "modifies_scene_state": false,
4309
+ "reads_files": false,
4310
+ "writes_files": false,
4311
+ "accesses_external_services": false,
4312
+ "bounded_and_independently_verifiable": true,
4313
+ "classification": "read_only_only",
4314
+ "qualification_rationale": "Read-only in-memory viewport cache lookup.",
4315
+ "evidence_source": "https://github.com/ahujasid/blender-mcp/blob/main/src/blender_mcp/server.py#L2160",
4316
+ "runtime_paths": [
4317
+ "path-2-community"
4318
+ ],
4319
+ "server_identity": "MCP for Blender (ahujasid/mcp-for-blender)",
4320
+ "server_version": "2.2.7",
4321
+ "tool_schema_fingerprint": "4fd6668719852e23dad7610abdc056be867f7c4c0a8a17c69d463db0bbe761fb"
4322
+ },
4323
+ {
4324
+ "tool_name": "viewport_capture",
4325
+ "description": "Capture a fresh viewport screenshot for the Viewport app.",
4326
+ "input_schema": {
4327
+ "type": "object",
4328
+ "additionalProperties": false,
4329
+ "required": [],
4330
+ "properties": {
4331
+ "max_size": {
4332
+ "type": "integer"
4333
+ },
4334
+ "auto": {
4335
+ "type": "boolean"
4336
+ }
4337
+ }
4338
+ },
4339
+ "output_shape_summary": "CallToolResult with fresh viewport screenshot",
4340
+ "side_effects": "none",
4341
+ "required_capability_tier": "L0",
4342
+ "executes_arbitrary_code": false,
4343
+ "modifies_scene_state": false,
4344
+ "reads_files": false,
4345
+ "writes_files": false,
4346
+ "accesses_external_services": false,
4347
+ "bounded_and_independently_verifiable": true,
4348
+ "classification": "read_only_only",
4349
+ "qualification_rationale": "Read-only viewport capture into memory store.",
4350
+ "evidence_source": "https://github.com/ahujasid/blender-mcp/blob/main/src/blender_mcp/server.py#L2166",
4351
+ "runtime_paths": [
4352
+ "path-2-community"
4353
+ ],
4354
+ "server_identity": "MCP for Blender (ahujasid/mcp-for-blender)",
4355
+ "server_version": "2.2.7",
4356
+ "tool_schema_fingerprint": "c438c0325426ec403d8aaff64785638d07902cfdf3e0c1c988811b29481554f7"
4357
+ },
4358
+ {
4359
+ "tool_name": "viewport_pick",
4360
+ "description": "The object under a click on viewport capture seq.",
4361
+ "input_schema": {
4362
+ "type": "object",
4363
+ "additionalProperties": false,
4364
+ "required": [
4365
+ "seq",
4366
+ "x",
4367
+ "y"
4368
+ ],
4369
+ "properties": {
4370
+ "seq": {
4371
+ "type": "integer"
4372
+ },
4373
+ "x": {
4374
+ "type": "number"
4375
+ },
4376
+ "y": {
4377
+ "type": "number"
4378
+ }
4379
+ }
4380
+ },
4381
+ "output_shape_summary": "CallToolResult identifying object hit by raycast",
4382
+ "side_effects": "none",
4383
+ "required_capability_tier": "L0",
4384
+ "executes_arbitrary_code": false,
4385
+ "modifies_scene_state": false,
4386
+ "reads_files": false,
4387
+ "writes_files": false,
4388
+ "accesses_external_services": false,
4389
+ "bounded_and_independently_verifiable": true,
4390
+ "classification": "read_only_only",
4391
+ "qualification_rationale": "Read-only scene raycast query against a recorded camera view.",
4392
+ "evidence_source": "https://github.com/ahujasid/blender-mcp/blob/main/src/blender_mcp/server.py#L2184",
4393
+ "runtime_paths": [
4394
+ "path-2-community"
4395
+ ],
4396
+ "server_identity": "MCP for Blender (ahujasid/mcp-for-blender)",
4397
+ "server_version": "2.2.7",
4398
+ "tool_schema_fingerprint": "d2e75a27dce793dbd02867ecee45f5c5ffff32118e46ddcb3dc2ca5825c3a791"
4399
+ },
4400
+ {
4401
+ "tool_name": "get_object_info",
4402
+ "description": "Return transform, material slots, and mesh topology statistics for a named Blender object (addon socket command / blender://object/{name} resource / legacy v1.x tool).",
4403
+ "input_schema": {
4404
+ "type": "object",
4405
+ "additionalProperties": false,
4406
+ "required": [
4407
+ "object_name"
4408
+ ],
4409
+ "properties": {
4410
+ "object_name": {
4411
+ "type": "string",
4412
+ "minLength": 1
4413
+ }
4414
+ }
4415
+ },
4416
+ "output_shape_summary": "dict with object transform, materials, and mesh vertex/triangle counts",
4417
+ "side_effects": "none",
4418
+ "required_capability_tier": "L0",
4419
+ "executes_arbitrary_code": false,
4420
+ "modifies_scene_state": false,
4421
+ "reads_files": false,
4422
+ "writes_files": false,
4423
+ "accesses_external_services": false,
4424
+ "bounded_and_independently_verifiable": true,
4425
+ "classification": "read_only_only",
4426
+ "qualification_rationale": "Read-only per-object inspection command implemented in addon.py get_object_info and exposed via resource blender://object/{name} in v2.2.7 and tool get_object_info in v1.x.",
4427
+ "evidence_source": "https://github.com/ahujasid/blender-mcp/blob/main/src/blender_mcp/server.py#L2083",
4428
+ "runtime_paths": [
4429
+ "path-2-community"
4430
+ ],
4431
+ "server_identity": "MCP for Blender (ahujasid/mcp-for-blender)",
4432
+ "server_version": "2.2.7",
4433
+ "tool_schema_fingerprint": "d0a91f92c0d4558c8eebc2f50a30d35363f6e9c480dc1635e1684492a3d6195f"
4434
+ },
4435
+ {
4436
+ "tool_name": "get_viewport_screenshot",
4437
+ "description": "Legacy v1.x read-only viewport screenshot capture tool (superseded by look / viewport_capture in v2.2.7).",
4438
+ "input_schema": {
4439
+ "type": "object",
4440
+ "additionalProperties": false,
4441
+ "required": [],
4442
+ "properties": {
4443
+ "max_size": {
4444
+ "type": "integer"
4445
+ }
4446
+ }
4447
+ },
4448
+ "output_shape_summary": "MCP ImageContent (PNG bytes)",
4449
+ "side_effects": "none",
4450
+ "required_capability_tier": "L0",
4451
+ "executes_arbitrary_code": false,
4452
+ "modifies_scene_state": false,
4453
+ "reads_files": false,
4454
+ "writes_files": false,
4455
+ "accesses_external_services": false,
4456
+ "bounded_and_independently_verifiable": true,
4457
+ "classification": "read_only_only",
4458
+ "qualification_rationale": "Read-only viewport capture in mcp-for-blender v1.x.",
4459
+ "evidence_source": "https://github.com/ahujasid/blender-mcp/blob/main/addon.py",
4460
+ "runtime_paths": [
4461
+ "path-2-community"
4462
+ ],
4463
+ "server_identity": "MCP for Blender (ahujasid/mcp-for-blender)",
4464
+ "server_version": "2.2.7",
4465
+ "tool_schema_fingerprint": "c42722e11da8fd43b9befa9daf7ea6d7fdf9f1c40b921d523b4aa7ca4d126ede"
4466
+ }
4467
+ ]
4468
+ }