discord-mcp

Audit permissions

discord_audit_permissions

Read-only

Toolset
Permissions permissions
Context cost
390 tokens, estimated1,561 bytes of definition, divided by 4

Generate a server-wide permission report: for every channel that has overwrites, lists each role/member and their allowed/denied permissions (entity names resolved). Read-only. Returns { channels: [...], hiddenChannels } with channel, channelId, overwrites. Channels that Discord hides from the bot behind the placeholder name ___hidden___ are left out and counted in hiddenChannels: Discord shows a placeholder in place of their real overwrites. Use discord_get_channel_permissions for a single channel.

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
guild_idrequiredstring
pattern ^\d{17,20}$
Discord server (guild) ID (snowflake).

Output

Declared by outputSchema: clients receive this shape as structuredContent.

FieldType
channelsrequiredarray of objects
channel (nested, level 1)requiredstring
channelId (nested, level 1)requiredstring
overwrites (nested, level 1)requiredarray of objects
entity (nested, level 2)requiredstring
type (nested, level 2)requiredstring
allow (nested, level 2)requiredarray of strings
deny (nested, level 2)requiredarray of strings
hiddenChannelsrequiredinteger

Related tools

Named in its description

Also in Permissions

Raw definition (1,561 bytes)
{
  "name": "discord_audit_permissions",
  "description": "Generate a server-wide permission report: for every channel that has overwrites, lists each role/member and their allowed/denied permissions (entity names resolved). Read-only. Returns { channels: [...], hiddenChannels } with channel, channelId, overwrites. Channels that Discord hides from the bot behind the placeholder name ___hidden___ are left out and counted in hiddenChannels: Discord shows a placeholder in place of their real overwrites. Use discord_get_channel_permissions for a single channel.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "guild_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "Discord server (guild) ID (snowflake)."
      }
    },
    "required": [
      "guild_id"
    ],
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "channels": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "channel": {
              "type": "string"
            },
            "channelId": {
              "type": "string"
            },
            "overwrites": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "entity": {
                    "type": "string"
                  },
                  "type": {
                    "type": "string"
                  },
                  "allow": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "deny": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  }
                },
                "required": [
                  "entity",
                  "type",
                  "allow",
                  "deny"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "channel",
            "channelId",
            "overwrites"
          ],
          "additionalProperties": false
        }
      },
      "hiddenChannels": {
        "type": "integer",
        "minimum": -9007199254740991,
        "maximum": 9007199254740991
      }
    },
    "required": [
      "channels",
      "hiddenChannels"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Audit permissions",
    "readOnlyHint": true,
    "openWorldHint": true
  }
}