Skip to main content
Glama

ai_modeling_canvas_delete

Destructive

Deletes an explicitly selected Canvas project by project ID to remove it from the user's Studio account during cleanup or project management.

Instructions

Delete an explicitly selected Canvas project.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "projectId": "<projectId>"
    },
    "name": "ai_modeling_canvas_delete"
  }
}

Input Schema

NameRequiredDescriptionDefault
projectIdYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observedv0.1.4

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare destructiveHint=true, readOnlyHint=false, and openWorldHint=true, so the safety profile is covered elsewhere. Beyond that, the description adds nothing: it says nothing about permanence, whether canvas assets or templates cascade, or whether permissions are required. "Explicitly selected" is the only behavioral nuance, and it is undefined.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single short sentence with the verb front-loaded and no filler. The brevity is appropriate in form but leaves no room for the disambiguation or safety caveats a destructive tool warrants.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

This is a destructive, open-world mutation that returns no output schema and has an undocumented parameter. For that complexity, the description should address irreversibility, scope of deletion, and confirmation expectations, and it addresses none of them.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

There is one parameter, projectId, and the schema gives it a pattern and length bounds but 0% description coverage. The description says only that the project must be explicitly selected; it does not explain the expected ID format or where to obtain it. The parameter name is largely self-explanatory, which keeps this at the baseline rather than lower.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource: "Delete" plus "Canvas project". The verb distinguishes it from the many read/create siblings like ai_modeling_canvas_get or ai_modeling_canvas_create. However, it never differentiates itself from the close variants ai_modeling_project_delete or ai_modeling_canvas_template_delete, which an agent could plausibly confuse it with.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

"Explicitly selected" hints that a project must already be chosen but gives no when/when-not guidance, no alternative tools, and no prerequisites. There is nothing about how an agent should confirm the projectId or what to do instead when the target is ambiguous or shared.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server

Other Tools