delete_object

Delete an object in FreeCAD.

Server FreeCAD MCP lzy-hhhh/freecad
Category Destructive
Risk class Critical
Parameters 00 required

What delete_object does on FreeCAD MCP

AI agents call delete_object to permanently remove resources in FreeCAD MCP — typically in cleanup and lifecycle workflows. It does its job in a single call, and there is no undo.

Why delete_object needs a policy

Deletion of objects in CAD designs cannot be undone through normal tool operations and constitutes irreversible data loss. While the scope is limited to individual objects within a document (not the entire document), the destructive nature and potential to corrupt designs warrants high severity classification.

From the tool's definition Tool name 'delete_object' combined with description 'Delete an object in FreeCAD' clearly indicates irreversible deletion of 3D objects or design elements.

Questions about delete_object

What does the delete_object tool do? +

Delete an object in FreeCAD. It is categorised as a Destructive tool in the FreeCAD MCP MCP Server, which means it can permanently delete or destroy data. Block by default and require explicit approval.

How do I enforce a policy on delete_object? +

Register the FreeCAD MCP server in PolicyLayer and add a rule for delete_object: 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 FreeCAD MCP. Nothing to install.

What risk level is delete_object? +

delete_object is a Destructive tool with critical risk. Critical-risk tools should be blocked by default and only enabled with explicit human approval.

Can I rate-limit delete_object? +

Yes. Add a rate_limit block to the delete_object 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.

How do I block delete_object completely? +

Set action: deny in the PolicyLayer policy for delete_object. 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.

What MCP server provides delete_object? +

delete_object is provided by the FreeCAD MCP server (lzy-hhhh/freecad). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

// THE FULL RECORD

delete_object is one line of FreeCAD's registry record.

The record carries the whole server: verified identity, auth posture, risk grade, every tool classified, recommended policy — re-checked continuously.

Teams ship this data inside their own products. See what a licence covers →

// GET IN TOUCH

Have a question or want to learn more? Send us a message.

Message sent.

We'll get back to you soon.