discord-mcp

Get channel permissions

discord_get_channel_permissions

Read-only

Toolset
Permissions permissions
Context cost
292 tokens, estimated1,166 bytes of definition, divided by 4

List every permission overwrite on a channel, per role and per member, with the allowed and denied permission flags for each. Read-only. Refuses a channel that Discord hides from the bot behind the placeholder name ___hidden___: Discord shows a placeholder in place of its real overwrites, so grant the bot View Channel on it first. Use discord_audit_permissions for a server-wide report across all channels.

Risk and annotations

Read-onlyreadOnlyHintyesDoes not modify your server.
DestructivedestructiveHintn/aNot declared: it only applies to tools that write.
IdempotentidempotentHintn/aNot declared.
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 inspect.

Output

Declared by outputSchema: clients receive this shape as structuredContent.

FieldType
overwritesrequiredarray of objects
id (nested, level 1)requiredstring
type (nested, level 1)requiredstring
allow (nested, level 1)requiredarray of strings
deny (nested, level 1)requiredarray of strings

Related tools

Named in its description

Also in Permissions

Raw definition (1,166 bytes)
{
  "name": "discord_get_channel_permissions",
  "description": "List every permission overwrite on a channel, per role and per member, with the allowed and denied permission flags for each. Read-only. Refuses a channel that Discord hides from the bot behind the placeholder name ___hidden___: Discord shows a placeholder in place of its real overwrites, so grant the bot View Channel on it first. Use discord_audit_permissions for a server-wide report across all channels.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "channel_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "ID (snowflake) of the channel to inspect."
      }
    },
    "required": [
      "channel_id"
    ],
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "overwrites": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "type": {
              "type": "string"
            },
            "allow": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "deny": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          "required": [
            "id",
            "type",
            "allow",
            "deny"
          ],
          "additionalProperties": false
        }
      }
    },
    "required": [
      "overwrites"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Get channel permissions",
    "readOnlyHint": true,
    "openWorldHint": true
  }
}