Skip to main content
Glama

delete_workout_section_template

Destructive

Delete a saved workout section. Plans that already used it keep their exercises. (confirm-gated: previews until confirm: true)

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": {
      "id": "<id>"
    },
    "name": "delete_workout_section_template"
  }
}

Input Schema

NameRequiredDescriptionDefault
idYes
confirmNoMust be true to actually execute. If false/omitted, returns a preview only.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

A3.5/5.0
Behavior3/5

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

Annotations already declare destructiveHint=true and readOnlyHint=false, so the safety profile is structured data. The description adds genuinely new behavior: existing plans retain their exercises (scoped, non-cascading delete) and the confirm-gating flow. That is real value, but it omits whether the deletion is reversible or what the preview contains.

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?

Two short sentences with the core action front-loaded and the consequence immediately after; nothing is wasted. The trailing parenthetical is slightly telegraphic but still readable.

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-parameter mutation with no output schema, the essential facts are present: what gets deleted, what survives, and that a preview is returned until confirm is true. Missing only secondary detail (irreversibility, error behavior when the id is unknown).

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?

Schema coverage is only 50%: the `confirm` parameter is fully documented in the schema, while `id` has no description anywhere, and the description does not compensate by saying what the id refers to. The confirm-gating sentence restates what the schema already says rather than adding new meaning.

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?

Names a specific verb and resource ("Delete a saved workout section") that clearly separates it from the create/update/list siblings in the same family. It does not explicitly distinguish itself from other delete_* templates (plan, diet plan), but the resource noun is unambiguous enough to pick the right tool.

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

Usage Guidelines3/5

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

Usage is implied by the name and the caveat that existing plans keep their exercises hints at when this is safe to do. It never states prerequisites (ownership, permissions) nor contrasts against siblings such as update_workout_section_template or delete_workout_plan_template when the agent may actually want the latter.

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.