discord-mcp

Set channel position

discord_set_channel_position

Write

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

Set a channel's display order among the channels of its kind in its category. Text, announcement, forum and media channels sort together, voice and stage channels together, and categories among categories. A position equal to or above the number of channels in that group leaves the order unchanged. Use discord_move_channel to change which category it belongs to. 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 reposition.
positionrequiredinteger
at least 0
Zero-based position among the channels of its kind in the category (0 = top).

Output

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

Related tools

Named in its description

Also in Channels

Raw definition (1,013 bytes)
{
  "name": "discord_set_channel_position",
  "description": "Set a channel's display order among the channels of its kind in its category. Text, announcement, forum and media channels sort together, voice and stage channels together, and categories among categories. A position equal to or above the number of channels in that group leaves the order unchanged. Use discord_move_channel to change which category it belongs to. 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 reposition."
      },
      "position": {
        "type": "integer",
        "minimum": 0,
        "maximum": 9007199254740991,
        "description": "Zero-based position among the channels of its kind in the category (0 = top)."
      }
    },
    "required": [
      "channel_id",
      "position"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Set channel position",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true
  }
}