discord-mcp

Create thread

discord_create_thread

Write

Toolset
Messages messages
Discord permission
Create Public Threads
Context cost
321 tokens, estimated1,285 bytes of definition, divided by 4

Create a thread, either branching from an existing message (pass message_id) or as a standalone thread in a text channel (omit message_id). Standalone creation requires a parent text channel and fails if channel_id is itself a thread. Requires the Create Public Threads permission, plus Read Message History when message_id is set. Returns the new thread's 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
channel_idrequiredstring
pattern ^\d{17,20}$
ID (snowflake) of the parent text channel. For a message-based thread, the channel containing message_id.
namerequiredstring
none
Name of the thread to create (max 100 characters).
message_idoptionalstring
pattern ^\d{17,20}$
Optional. Message to branch the thread from. If omitted, a standalone thread is created in the channel.
auto_archive_durationoptionalnumber
one of 601440432010080default 1440
Minutes of inactivity before auto-archiving: 60, 1440, 4320, or 10080. Default 1440 (24h).

Output

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

Related tools

Also in Messages

Raw definition (1,285 bytes)
{
  "name": "discord_create_thread",
  "description": "Create a thread, either branching from an existing message (pass message_id) or as a standalone thread in a text channel (omit message_id). Standalone creation requires a parent text channel and fails if channel_id is itself a thread. Requires the Create Public Threads permission, plus Read Message History when message_id is set. Returns the new thread's ID.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "channel_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "ID (snowflake) of the parent text channel. For a message-based thread, the channel containing message_id."
      },
      "name": {
        "type": "string",
        "description": "Name of the thread to create (max 100 characters)."
      },
      "message_id": {
        "description": "Optional. Message to branch the thread from. If omitted, a standalone thread is created in the channel.",
        "type": "string",
        "pattern": "^\\d{17,20}$"
      },
      "auto_archive_duration": {
        "default": 1440,
        "description": "Minutes of inactivity before auto-archiving: 60, 1440, 4320, or 10080. Default 1440 (24h).",
        "type": "number",
        "enum": [
          60,
          1440,
          4320,
          10080
        ]
      }
    },
    "required": [
      "channel_id",
      "name"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Create thread",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": false,
    "openWorldHint": true
  }
}