discord-mcp

Create channel

discord_create_channel

Write

Toolset
Channels channels
Discord permission
Manage Channels
Context cost
269 tokens, estimated1,074 bytes of definition, divided by 4

Create a text channel, voice channel, or category in a server. Requires the Manage Channels permission. For forum channels use discord_create_forum_channel instead. Returns the new channel's name and ID.

Risk and annotations

Read-onlyreadOnlyHintnoCan modify your server.
DestructivedestructiveHintnoDeclared non-destructive.
IdempotentidempotentHintnoRepeating the call can have an additional effect.
Open worldopenWorldHintyesInteracts with an external system: Discord.

Annotations are hints the server declares. Clients use them to decide when to ask you before a call.

Parameters

ParameterTypeRulesDescription
guild_idrequiredstring
pattern ^\d{17,20}$
Discord server (guild) ID (snowflake) to create the channel in.
namerequiredstring
none
Name of the new channel (max 100 characters).
typeoptionalstring
one of "text""voice""category"
Channel type to create. Defaults to 'text'.
topicoptionalstring
none
Optional channel topic/description. Applies to text channels only.
category_idoptionalstring
pattern ^\d{17,20}$
Optional category (snowflake) to nest the new channel under.

Output

This tool declares no output schema. Its description says what it returns; this page shows no example rather than invent one.

Related tools

Named in its description

Also in Channels

Raw definition (1,074 bytes)
{
  "name": "discord_create_channel",
  "description": "Create a text channel, voice channel, or category in a server. Requires the Manage Channels permission. For forum channels use discord_create_forum_channel instead. Returns the new channel's name and ID.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "guild_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "Discord server (guild) ID (snowflake) to create the channel in."
      },
      "name": {
        "type": "string",
        "description": "Name of the new channel (max 100 characters)."
      },
      "type": {
        "description": "Channel type to create. Defaults to 'text'.",
        "type": "string",
        "enum": [
          "text",
          "voice",
          "category"
        ]
      },
      "topic": {
        "description": "Optional channel topic/description. Applies to text channels only.",
        "type": "string"
      },
      "category_id": {
        "description": "Optional category (snowflake) to nest the new channel under.",
        "type": "string",
        "pattern": "^\\d{17,20}$"
      }
    },
    "required": [
      "guild_id",
      "name"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Create channel",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": false,
    "openWorldHint": true
  }
}