guild_modify_current_voice_state
guild_modify_current_voice_state
Section titled “guild_modify_current_voice_state”Category: guild
Update the bot’s own voice state in a stage channel (request to speak, toggle suppress).
When to use
Section titled “When to use”- Bot wants to raise its hand (
request_to_speak_timestamp = now) or step down (suppress = true).
When NOT to use
Section titled “When NOT to use”| Field | Type | Required | Description |
|---|---|---|---|
guild_id | string | yes | Guild containing the stage channel |
channel_id | string | no | Stage channel the bot is currently in |
suppress | boolean | no | |
request_to_speak_timestamp | unknown | no | ISO8601 timestamp; null clears, future requests to speak |
Returns
Section titled “Returns”\{ok, guild_id\}. Discord returns 204 (no body).
Output schema
Section titled “Output schema”| Field | Type | Required | Description |
|---|---|---|---|
ok | boolean | yes | |
guild_id | string | yes | Discord guild (server) ID |
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_current_voice_state.ts