discord-mcp

Create forum channel

discord_create_forum_channel

Write

Toolset
Forums forums
Discord permission
Manage Channels
Context cost
242 tokens, estimated968 bytes of definition, divided by 4

Create a new forum channel in a server. A forum holds posts (threads) rather than a linear message feed. Requires the Manage Channels permission. Use discord_create_channel for text/voice channels 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).
namerequiredstring
none
Name of the new forum channel (max 100 characters).
topicoptionalstring
none
Guidelines/topic text shown at the top of the forum.
category_idoptionalstring
pattern ^\d{17,20}$
Optional category (snowflake) to nest the forum 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 Forums

Raw definition (968 bytes)
{
  "name": "discord_create_forum_channel",
  "description": "Create a new forum channel in a server. A forum holds posts (threads) rather than a linear message feed. Requires the Manage Channels permission. Use discord_create_channel for text/voice channels 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)."
      },
      "name": {
        "type": "string",
        "description": "Name of the new forum channel (max 100 characters)."
      },
      "topic": {
        "description": "Guidelines/topic text shown at the top of the forum.",
        "type": "string"
      },
      "category_id": {
        "description": "Optional category (snowflake) to nest the forum under.",
        "type": "string",
        "pattern": "^\\d{17,20}$"
      }
    },
    "required": [
      "guild_id",
      "name"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Create forum channel",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": false,
    "openWorldHint": true
  }
}