Delete a file from the Baasix backend by supplying its unique file ID. Removes the specified file permanently from your project.
Delete a file
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | File ID |
Changes observed during successful MCP inspections.
v0.1.7Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. 'Delete' implies destructiveness, but the description does not state whether deletion is permanent, reversible, or what happens to related data or references.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is three words with no wasted content. Every word contributes to the meaning, and the essential operation is front-loaded.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool is very simple with one well-documented parameter and no output schema, so the minimal description may be adequate for basic invocation. However, without annotations or mention of return behavior, reversibility, or failure modes, it lacks full operational context for an agent.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema fully documents the only parameter 'id' as 'File ID', and the description adds no additional parameter semantics. Since schema coverage is 100%, the baseline of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description 'Delete a file' states a specific verb and resource, making the core operation unmistakable. It is clear but does not explicitly differentiate itself from sibling file-related tools like baasix_get_file_info or baasix_list_files, though the delete verb already implies the distinction.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no guidance on when to use this tool versus alternatives, such as baasix_delete_schema or baasix_delete_item, nor any mention of prerequisites or side effects. The usage context is left entirely to the agent's inference from the tool name.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.