viewport_set_shading
Set viewport shading mode.
This record as markdown: /tools/dwgx-blender-copilot/viewport-set-shading.md
What viewport_set_shading does on Blender Copilot MCP Server
AI agents invoke viewport_set_shading to trigger actions in Blender Copilot MCP Server. What it does depends on the arguments the agent supplies, and its effects often reach beyond the immediate call: builds kicked off, notifications sent, workflows started.
Why viewport_set_shading is rated High
This tool modifies the active viewport's shading mode in Blender (e.g., Solid, Material, Rendered, Wireframe). It is not a data read, nor does it create/modify scene data or delete anything. It executes an application-level state change in an external tool (Blender), making Execute the most appropriate category. Misuse has minimal blast radius as it only affects display, hence low severity.
From the tool's definition 'Set viewport shading mode' — triggers a change in the Blender viewport rendering state, an external operation affecting the application UI.
Attacks that exploit this kind of access
The rule that runs viewport_set_shading safely
PolicyLayer is an MCP gateway: it sits between your AI agents and Blender Copilot MCP Server, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For viewport_set_shading, this is the rule to start with:
viewport_set_shading stays usable, but rate-capped: a runaway agent can't fire it dozens of times a minute. Everything else on the server is denied unless you say otherwise.
The button opens the PolicyLayer dashboard: create your workspace, connect Blender Copilot MCP Server, apply this rule, and every viewport_set_shading call is checked against it from then on.
Questions about viewport_set_shading
Set viewport shading mode. It is categorised as a Execute tool in the Blender Copilot MCP Server MCP Server, which means it can trigger actions or run processes. Use rate limits and argument validation.
Register the Blender Copilot MCP Server MCP server in PolicyLayer and add a rule for viewport_set_shading: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Blender Copilot MCP Server. Nothing to install.
viewport_set_shading is a Execute tool with high risk. Execute tools should be rate-limited and have argument validation enabled.
Yes. Add a rate_limit block to the viewport_set_shading rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for viewport_set_shading. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
viewport_set_shading is provided by the Blender Copilot MCP Server MCP server (dwgx/blender-copilot). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on Blender Copilot MCP Server, and thousands of servers like it.
Across the catalogue