Low Risk

inspect_object

Get detailed information about a FreeCAD object. Args: object_name: Name of the object to inspect. doc_name: Document containing the object. Uses active document if None. include_properties: Whether to include property values. include_shape: Whether to include shape geometry details. Returns: Dic...

How to control inspect_object ↓

AI agents call inspect_object to retrieve information from FreeCAD Robust MCP Server without modifying anything — typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.

Low Risk

inspect_object is a purely informational tool that queries and retrieves data about existing FreeCAD objects. It has no parameters that suggest modification, deletion, or external execution. The return values are read-only property and geometry information. This represents a straightforward Read operation with minimal risk potential.

From the tool's definition Tool description states 'Get detailed information about a FreeCAD object' with parameters like 'include_properties' and 'include_shape' that return object information, properties, and geometry details without modifying state.

Documented attack patterns abuse exactly the kind of access inspect_object gives an agent:

PolicyLayer is an MCP gateway — it sits between your AI agents and FreeCAD Robust MCP Server, and nothing reaches the server without passing your rules. This is the rule we recommend for inspect_object:

policy.json
{
  "version": "1",
  "default": "deny",
  "tools": {
    "inspect_object": {}
  }
}

inspect_object is read-only, so it stays allowed — but everything else on the server is denied unless you say otherwise.

  1. Create a free account and register FreeCAD Robust MCP Server — nothing to install.
  2. Add this policy — paste it, or build it visually.
  3. Point your MCP client (Claude, Cursor, anything) at your gateway URL.
CAP THIS TOOL →

Free to start. No card required.

Go deeper

What does the inspect_object tool do? +

Get detailed information about a FreeCAD object. Args: object_name: Name of the object to inspect. doc_name: Document containing the object. Uses active document if None. include_properties: Whether to include property values. include_shape: Whether to include shape geometry details. Returns: Dictionary containing comprehensive object information: - name: Object name - label: Object label - type_id: FreeCAD type identifier - properties: Dictionary of property names and values (if requested) - shape_info: Shape details (if requested and object has shape) - children: List of child object names - parents: List of parent object names - visibility: Whether object is visible. It is categorised as a Read tool in the FreeCAD Robust MCP Server MCP Server, which means it retrieves data without modifying state.

How do I enforce a policy on inspect_object? +

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

What risk level is inspect_object? +

inspect_object is a Read tool with low risk. Read-only tools are generally safe to allow by default.

Can I rate-limit inspect_object? +

Yes. Add a rate_limit block to the inspect_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 inspect_object completely? +

Set action: deny in the PolicyLayer policy for inspect_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 inspect_object? +

inspect_object is provided by the FreeCAD Robust MCP Server MCP server (spkane/freecad-addon-robust-mcp-server). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

Enforce policy on every FreeCAD Robust MCP Server tool call.

Deterministic rules across all 152 FreeCAD Robust MCP Server tools. Per-identity grants. Full audit log. Live in minutes. Nothing to install.

Free to start. No card required.

152 FreeCAD Robust MCP Server tools catalogued and risk-classified — across an index of 42,500+ MCP servers.

// GET IN TOUCH

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

Message sent.

We'll get back to you soon.