Skip to main content
Glama

Delete print profile

delete_print_profile
Destructive

Requires items.delete. Delete a print profile in this organization. Two-step confirm_token: the first call without confirm_token only returns confirmation_required, a summary, and confirm_token. That call does not write, delete, cancel, or send. The second call must repeat the same arguments plus that confirm_token; that is the write. A confirm boolean is ignored. The token expires in 5 minutes and works once.

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": {
      "profile_id": "<profile_id>"
    },
    "name": "delete_print_profile"
  }
}

Input Schema

NameRequiredDescriptionDefault
profile_idYes
confirm_tokenNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.5/5.0
Behavior5/5

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

Far beyond what the annotations declare: the description explains that the first call is a guaranteed no-op ("does not write, delete, cancel, or send"), that only the second call mutates, that the token is single-use and expires in 5 minutes, and that a confirm boolean is ignored. This is consistent with destructiveHint=true and idempotentHint=false and materially de-risks a destructive operation.

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?

The safety-critical two-step rule is front-loaded and every sentence carries operational weight. It is slightly redundant — "does not write, delete, cancel, or send" restates "only returns confirmation_required" — costing a little tightness.

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

Completeness4/5

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

For a destructive two-step tool with no output schema and undocumented parameters, the description covers the flow, the first call's return shape (confirmation_required, summary, confirm_token), and token lifetime. It omits what the second call returns and what happens when a token has expired or is reused.

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

Parameters4/5

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

Schema coverage is 0%, so the description must carry the parameter burden, and confirm_token is fully specified: single-use, 5-minute expiry, must be paired with a repeat of the same arguments. profile_id is left implicit and the mention of an ignored "confirm boolean" refers to a parameter that additionalProperties=false would reject, a small inconsistency.

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

Purpose5/5

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

The description states a specific verb and resource ("Delete a print profile in this organization") and scopes it to the organization. It is unmistakable against siblings such as list_print_profiles, copy_print_profile, and rebind_print_profile, which read or modify rather than remove a profile.

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

Usage Guidelines4/5

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

It gives the required permission ("Requires items.delete") and spells out the exact call sequence: first call without a token, second call repeating the same arguments plus the token. It doesn't name alternatives or say when a profile should be deleted versus unbound, so it stops short of full when/when-not guidance.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources