channels_create_guild_channel
channels_create_guild_channel
Section titled “channels_create_guild_channel”Category: channels
Create a new channel in a guild (text, voice, category, announcement, forum, etc.).
When to use
Section titled “When to use”- Programmatic guild bootstrap; tier-based channel provisioning.
When NOT to use
Section titled “When NOT to use”- Threads — use
messages_create_thread,channels_forum_create_thread, or thread-specific tools.
Type values (from Discord API): 0 GUILD_TEXT, 2 GUILD_VOICE, 4 GUILD_CATEGORY, 5 GUILD_ANNOUNCEMENT, 13 GUILD_STAGE_VOICE, 14 GUILD_DIRECTORY, 15 GUILD_FORUM, 16 GUILD_MEDIA. Pick fields that match the type — extra fields are ignored by Discord.
| Field | Type | Required | Description |
|---|---|---|---|
guild_id | string | yes | Target guild |
name | string | yes | Channel name (1-100 chars) |
type | integer | no | Discord channel type (omit for default GUILD_TEXT=0) |
topic | string | no | Channel topic (text/forum/announcement only) |
bitrate | integer | no | Voice bitrate in bps (voice/stage) |
user_limit | integer | no | Voice user cap (0 = no limit) |
rate_limit_per_user | integer | no | Slowmode in seconds (0-21600) |
position | integer | no | Sort position |
permission_overwrites | array | no | Permission overwrites to seed at creation |
parent_id | string | no | Category to nest under |
nsfw | boolean | no | Mark as NSFW |
rtc_region | string | no | Voice region override (voice/stage) |
video_quality_mode | unknown | no | 1 AUTO, 2 FULL (voice/stage) |
default_auto_archive_duration | unknown | no | Default thread auto-archive (60/1440/4320/10080 minutes) |
default_reaction_emoji | object | no | Forum default reaction (emoji_id OR emoji_name) |
available_tags | array | no | Forum tag set |
default_sort_order | unknown | no | Forum sort order (0 LATEST_ACTIVITY, 1 CREATION_DATE) |
default_forum_layout | unknown | no | Forum layout (0 NOT_SET, 1 LIST_VIEW, 2 GALLERY_VIEW) |
audit_reason | string | no | Reason recorded in audit log (X-Audit-Log-Reason header) |
Returns
Section titled “Returns”\{id, name, type, parent_id\}.
Output schema
Section titled “Output schema”| Field | Type | Required | Description |
|---|---|---|---|
id | string | yes | Discord channel ID (snowflake) |
name | string | yes | |
type | integer | yes | |
parent_id | 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/channels/create_guild_channel.ts