soundboard_create_guild_sound
soundboard_create_guild_sound
Section titled “soundboard_create_guild_sound”Category: soundboard
Upload a new soundboard sound to a guild.
sound must be a base64 data URI (audio/mpeg|ogg|wav), max 512 KB raw.
When to use
Section titled “When to use”When NOT to use
Section titled “When NOT to use”| Field | Type | Required | Description |
|---|---|---|---|
guild_id | string | yes | Target guild |
name | string | yes | Sound name (2..32 chars) |
sound | string | yes | Base64-encoded audio data URI (mp3/ogg/wav) |
volume | number | no | Playback volume 0..1 (default 1) |
emoji_id | string | no | Custom emoji to display |
emoji_name | string | no | Unicode emoji to display |
audit_reason | string | no | Reason recorded in audit log (X-Audit-Log-Reason header) |
Returns
Section titled “Returns”\{sound_id, name, volume, emoji_id, emoji_name\}.
Output schema
Section titled “Output schema”| Field | Type | Required | Description |
|---|---|---|---|
sound_id | string | yes | Discord soundboard sound ID |
name | string | yes | |
volume | number | yes | |
emoji_id | unknown | yes | |
emoji_name | unknown | yes |
Annotations
Section titled “Annotations”| Property | Value |
|---|---|
| Read-only | no |
| Destructive | no |
| Idempotent | no |
| Open-world | yes |
| Confirmation required | no |
Source
Section titled “Source”packages/mcp-core/src/tools/soundboard/create_guild_sound.ts