Skip to main content
Glama

Destroy a channel

destroy_channel
DestructiveIdempotent

Destroy a channel and its routes. This cannot be undone, so confirm with the user first. Without name, it destroys an organization channel found with list_channels; an organization channel that any agent still holds is refused, and the answer names each holder: free each with detach_channel, then destroy it. With name, it destroys a channel that agent owns, such as one create_channel made; a channel the agent only holds from the organization is detached with detach_channel instead. A channel found only in the other scope is refused with the call to make. A channel on an app is destroyed the same way, naming the app in name. Destroying a channel that is already gone changes nothing. The organization's Slack integration removes every agent's Slack app, so for it this gives the step to take and destroys nothing. Returns the channel's name and already_gone when it was gone before the call, or for the Slack integration the step and its url. Requires connecting a Valet account.

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": {
      "channel": "<channel>"
    },
    "name": "destroy_channel"
  }
}

Input Schema

NameRequiredDescriptionDefault
nameNoThe owning agent's or app's name, for a channel it owns. Omit to destroy an organization channel.
channelYesThe channel's name, from list_channels.
org_nameNoThe Valet organization the channel belongs to. Omit to use the organization the account joined first.

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "already_gone": {
      -        "description": "True when the thing was already gone before the call, so nothing was destroyed. Absent when this call destroyed it.",
      -        "type": "boolean"
      -      },
      -      "kind": {
      -        "description": "What the thing was, such as channel, connector, or resource.",
      -        "type": "string"
      -      },
      -      "name": {
      -        "description": "Name of the thing the call destroyed, as the caller gave it.",
      -        "type": "string"
      -      },
      -      "org": {
      -        "description": "Name of the Valet organization the call acted in.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "org",
      -      "name",
      -      "kind"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "org": {
      -        "description": "Name of the Valet organization the call acted in.",
      -        "type": "string"
      -      },
      -      "step": {
      -        "description": "What the person does in a browser, such as authorizing a service. Nothing has changed until they do it.",
      -        "type": "string"
      -      },
      -      "url": {
      -        "description": "Address of the page where the person finishes the step. Absent when the page has no address to give.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "org",
      -      "step"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "already_gone": {
      +        "description": "True when the channel was already gone before the call, so nothing was destroyed. Absent when this call destroyed it.",
      +        "type": "boolean"
      +      },
      +      "kind": {
      +        "description": "Always channel: the kind of thing this tool destroys.",
      +        "enum": [
      +          "channel"
      +        ],
      +        "type": "string"
      +      },
      +      "name": {
      +        "description": "Name of the channel destroyed, as passed in channel.",
      +        "type": "string"
      +      },
      +      "org": {
      +        "description": "Name of the Valet organization the call acted in.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "org",
      +      "name",
      +      "kind"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "org": {
      +        "description": "Name of the Valet organization the call acted in.",
      +        "type": "string"
      +      },
      +      "step": {
      +        "description": "What the person does in a browser, such as authorizing a service. Nothing has changed until they do it.",
      +        "type": "string"
      +      },
      +      "url": {
      +        "description": "Address of the page where the person finishes the step. Absent when the page has no address to give.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "org",
      +      "step"
      +    ],
      +    "type": "object"
      +  }
      +]
  2. Changed2 schema fields changed
    • changedInput schema / properties / channel / description
      Previous value: -"Required. The channel's name, from list_channels."New value: +"The channel's name, from list_channels."
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": false,
      +      "properties": {
      +        "already_gone": {
      +          "description": "True when the thing was already gone before the call, so nothing was destroyed. Absent when this call destroyed it.",
      +          "type": "boolean"
      +        },
      +        "kind": {
      +          "description": "What the thing was, such as channel, connector, or resource.",
      +          "type": "string"
      +        },
      +        "name": {
      +          "description": "Name of the thing the call destroyed, as the caller gave it.",
      +          "type": "string"
      +        },
      +        "org": {
      +          "description": "Name of the Valet organization the call acted in.",
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "org",
      +        "name",
      +        "kind"
      +      ],
      +      "type": "object"
      +    },
      +    {
      +      "additionalProperties": false,
      +      "properties": {
      +        "org": {
      +          "description": "Name of the Valet organization the call acted in.",
      +          "type": "string"
      +        },
      +        "step": {
      +          "description": "What the person does in a browser, such as authorizing a service. Nothing has changed until they do it.",
      +          "type": "string"
      +        },
      +        "url": {
      +          "description": "Address of the page where the person finishes the step. Absent when the page has no address to give.",
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "org",
      +        "step"
      +      ],
      +      "type": "object"
      +    }
      +  ],
      +  "type": "object"
      +}
  3. Changed1 schema field changed
    • changedInput schema / properties / name / description
      Previous value: -"The owning agent's name, for a channel that agent owns. Omit to destroy an organization channel."New value: +"The owning agent's or app's name, for a channel it owns. Omit to destroy an organization channel."
  4. Added

TDQS

A4.8/5.0
Behavior5/5

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

Annotations already declare destructiveHint=true and idempotentHint=true, but the description adds critical context beyond them: irreversibility with an instruction to confirm with the user, refusal when any agent holds the channel, the named-holder error payload, the already_gone no-op, and the Valet account auth requirement.

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?

Front-loads the destructive warning and the scope rule, which is the right structure for a dangerous tool. Some clauses are dense and repetitive, e.g. the 'other scope is refused with the call to make' sentence, but nearly every sentence carries operational information.

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

Completeness5/5

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

An output schema exists, yet the description still sketches the return shape (name, already_gone, or step and url for Slack) without redundancy. Combined with auth, refusal, and idempotency behavior, nothing an agent needs to call this safely is missing.

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 100%, so the baseline is 3, but the description adds real meaning: name switches scope between organization channels and agent/app-owned channels (including app channels), and org_name's omission default is behaviorally significant. Slight overlap with the schema's own parameter descriptions keeps it from a 5.

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?

Opens with a specific verb+resource ('Destroy a channel and its routes') and immediately distinguishes itself from sibling operations by naming detach_channel, create_channel, and list_channels as the other paths. An agent knows exactly what this tool does and what it does not do.

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

Usage Guidelines5/5

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

Gives explicit routing rules: omit name for organization channels found via list_channels, supply name for agent- or app-owned channels, use detach_channel when the agent merely holds a channel, and 'the call to make' when the channel lives in the other scope. The Slack-integration case is also called out as a non-destructive path.

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