guild_modify_user_voice_state
guild_modify_user_voice_state
Section titled “guild_modify_user_voice_state”Category: guild
Update another user’s voice state in a stage channel (suppress = mute on stage).
When to use
Section titled “When to use”- Move audience users between stage and audience without giving them speak permission.
When NOT to use
Section titled “When NOT to use”- Modify the bot’s own state → use
guild_modify_current_voice_state.
| Field | Type | Required | Description |
|---|---|---|---|
guild_id | string | yes | Guild containing the stage channel |
user_id | string | yes | Target user |
channel_id | string | yes | Stage channel the user is currently in |
suppress | boolean | no | Whether the user is suppressed (true = audience, false = speaker) |
audit_reason | string | no | Reason recorded in audit log (X-Audit-Log-Reason header) |
Returns
Section titled “Returns”\{ok, user_id, channel_id\}. Discord returns 204 (no body).
Output schema
Section titled “Output schema”| Field | Type | Required | Description |
|---|---|---|---|
ok | boolean | yes | |
user_id | string | yes | Discord user ID |
channel_id | string | yes | Discord channel ID (snowflake) |
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/guild/modify_user_voice_state.ts