Skip to main content
Glama

Decline Action

swiftly_decline_action

Decline a pending destructive action.

Input Schema

NameRequiredDescriptionDefault
approval_idYesThe approval ID to decline

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

B3.2/5.0
Behavior3/5

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

Annotations declare destructiveHint=false and readOnlyHint=false, which is consistent with declining (a state mutation that prevents rather than performs destruction). The description adds the useful qualifier that the target is a 'pending destructive action', clarifying eligibility, but says nothing about reversibility, whether the approval record is deleted, or error behavior on a stale ID. With annotations covering the safety profile, this is adequate but thin.

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?

One short, front-loaded sentence with zero padding — appropriate for a single-parameter tool. It is efficient, though the terseness borders on under-specification rather than economy.

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

Completeness3/5

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

For a one-parameter mutation with no output schema, the description gives the minimum needed to call it, but omits what happens after a decline (does the action become permanently rejected, can it be re-requested?) and how it relates to the approval family of tools. Slightly incomplete for a workflow tool.

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 description coverage is 100% with a single parameter whose meaning ('The approval ID to decline') is fully self-documenting. The description adds no syntax, format, or sourcing detail beyond the schema, so the baseline 3 applies.

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 (decline) and resource (a pending destructive action), and the word 'pending' correctly scopes it to actions awaiting approval. It does not distinguish itself from siblings like swiftly_execute_approved beyond the opposite verb, but an agent can still infer the intent.

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?

There is no explicit guidance on when to use this versus the sibling swiftly_execute_approved, nor any statement of prerequisites (e.g., that the approval must still be pending, or that an approval_id must come from swiftly_request_approval). The agent must infer the workflow entirely from the sibling names.

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