Audit permissions
discord_
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_ for a single channel.
Risk and annotations
Read-onlyreadOnlyHint | yes | Does not modify your server. |
|---|---|---|
DestructivedestructiveHint | n/a | Not declared: it only applies to tools that write. |
IdempotentidempotentHint | n/a | Not declared. |
Open worldopenWorldHint | yes | Interacts with an external system: Discord. |
Annotations are hints the server declares. Clients use them to decide when to ask you before a call.
Parameters
| Parameter | Type | Rules | Description |
|---|---|---|---|
| guild_ | string | pattern ^\d{17,20}$ | Discord server (guild) ID (snowflake). |
Output
Declared by outputSchema: clients receive this shape as structuredContent.
| Field | Type |
|---|---|
| channelsrequired | array of objects |
| channel (nested, level 1)required | string |
| channelId (nested, level 1)required | string |
| overwrites (nested, level 1)required | array of objects |
| entity (nested, level 2)required | string |
| type (nested, level 2)required | string |
| allow (nested, level 2)required | array of strings |
| deny (nested, level 2)required | array of strings |
| hiddenChannelsrequired | integer |
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
}
}