discord-mcp

Copy channel permissions

discord_copy_permissions

Destructive

Toolset
Permissions permissions
Discord permissions
Manage Channels and Manage Roles
Context cost
301 tokens, estimated1,205 bytes of definition, divided by 4

Replace the target channel's permission overwrites with a copy of the source channel's. The target's existing overwrites are overwritten. Requires the Manage Channels and Manage Roles permissions, and View Channel on the source: the tool refuses a source the bot cannot view, whose overwrites Discord may replace with a single @everyone View Channel deny. Returns a confirmation. To create a new channel with the same overwrites, use discord_clone_channel; to remove them all, use discord_reset_channel_permissions.

Risk and annotations

Read-onlyreadOnlyHintnoCan modify your server.
DestructivedestructiveHintyesMay perform destructive updates, so clients can ask before running it.
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
source_channel_idrequiredstring
pattern ^\d{17,20}$
ID (snowflake) of the channel to copy overwrites from.
target_channel_idrequiredstring
pattern ^\d{17,20}$
ID (snowflake) of the channel whose overwrites will be replaced.
reasonoptionalstring
none
Optional reason recorded in the server audit log.

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 Permissions

Raw definition (1,205 bytes)
{
  "name": "discord_copy_permissions",
  "description": "Replace the target channel's permission overwrites with a copy of the source channel's. The target's existing overwrites are overwritten. Requires the Manage Channels and Manage Roles permissions, and View Channel on the source: the tool refuses a source the bot cannot view, whose overwrites Discord may replace with a single @everyone View Channel deny. Returns a confirmation. To create a new channel with the same overwrites, use discord_clone_channel; to remove them all, use discord_reset_channel_permissions.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "source_channel_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "ID (snowflake) of the channel to copy overwrites from."
      },
      "target_channel_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "ID (snowflake) of the channel whose overwrites will be replaced."
      },
      "reason": {
        "description": "Optional reason recorded in the server audit log.",
        "type": "string"
      }
    },
    "required": [
      "source_channel_id",
      "target_channel_id"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Copy channel permissions",
    "readOnlyHint": false,
    "destructiveHint": true,
    "idempotentHint": true,
    "openWorldHint": true
  }
}