discord-mcp

Edit channel

discord_edit_channel

Write

Toolset
Channels channels
Discord permission
Manage Channels
Context cost
292 tokens, estimated1,166 bytes of definition, divided by 4

Update a channel's name, topic, slowmode, or NSFW flag. Only provided fields change. This tool sends topic and slowmode for plain text channels only; on every other type, announcement channels included, it ignores them without an error. Requires the Manage Channels permission. Returns a confirmation.

Risk and annotations

Read-onlyreadOnlyHintnoCan modify your server.
DestructivedestructiveHintnoDeclared non-destructive.
IdempotentidempotentHintyesRepeating the call with the same arguments has no additional effect.
Open worldopenWorldHintyesInteracts with an external system: Discord.

Annotations are hints the server declares. Clients use them to decide when to ask you before a call.

Parameters

ParameterTypeRulesDescription
channel_idrequiredstring
pattern ^\d{17,20}$
ID (snowflake) of the channel to edit.
nameoptionalstring
none
New channel name (max 100 characters).
topicoptionalstring
none
New topic/description (text channels only, not announcement).
slowmodeoptionalinteger
0 to 21600
Per-user message cooldown in seconds, 0–21600. 0 disables slowmode (text channels only, not announcement).
nsfwoptionalboolean
none
Mark (true) or unmark (false) the channel as age-restricted (NSFW).

Output

This tool declares no output schema. Its description says what it returns; this page shows no example rather than invent one.

Related tools

Also in Channels

Raw definition (1,166 bytes)
{
  "name": "discord_edit_channel",
  "description": "Update a channel's name, topic, slowmode, or NSFW flag. Only provided fields change. This tool sends topic and slowmode for plain text channels only; on every other type, announcement channels included, it ignores them without an error. Requires the Manage Channels permission. Returns a confirmation.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "channel_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "ID (snowflake) of the channel to edit."
      },
      "name": {
        "description": "New channel name (max 100 characters).",
        "type": "string"
      },
      "topic": {
        "description": "New topic/description (text channels only, not announcement).",
        "type": "string"
      },
      "slowmode": {
        "description": "Per-user message cooldown in seconds, 0–21600. 0 disables slowmode (text channels only, not announcement).",
        "type": "integer",
        "minimum": 0,
        "maximum": 21600
      },
      "nsfw": {
        "description": "Mark (true) or unmark (false) the channel as age-restricted (NSFW).",
        "type": "boolean"
      }
    },
    "required": [
      "channel_id"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Edit channel",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true
  }
}