commands_edit_command_permissions
commands_edit_command_permissions
Section titled “commands_edit_command_permissions”Category: commands
Set per-command permission overrides for one command in a guild.
When to use
Section titled “When to use”When NOT to use
Section titled “When NOT to use”| Field | Type | Required | Description |
|---|---|---|---|
application_id | string | yes | Bot/app application ID |
guild_id | string | yes | Guild scope |
command_id | string | yes | Command ID to edit permissions for |
permissions | array | yes | Permission overrides — max 100 per command |
bearer_token | string | no | User OAuth2 access token (NOT bot token). Required by Discord; tool throws if missing. Treated as a credential — do not log. |
Returns
Section titled “Returns”updated \{id, application_id, guild_id, permissions\}.
Output schema
Section titled “Output schema”| Field | Type | Required | Description |
|---|---|---|---|
id | string | yes | |
application_id | string | yes | |
guild_id | string | yes | |
permissions | array | yes |
Annotations
Section titled “Annotations”| Property | Value |
|---|---|
| Read-only | no |
| Destructive | no |
| Idempotent | yes |
| Open-world | yes |
| Confirmation required | no |
Source
Section titled “Source”packages/mcp-core/src/tools/commands/edit_command_permissions.ts