Get channel permissions
discord_
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_ for a server-wide report across all channels.
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 |
|---|---|---|---|
| channel_ | string | pattern ^\d{17,20}$ | ID (snowflake) of the channel to inspect. |
Output
Declared by outputSchema: clients receive this shape as structuredContent.
| Field | Type |
|---|---|
| overwritesrequired | array of objects |
| id (nested, level 1)required | string |
| type (nested, level 1)required | string |
| allow (nested, level 1)required | array of strings |
| deny (nested, level 1)required | array 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
}
}