discord-mcp

List channel threads

discord_list_channel_threads

Read-only

Toolset
Messages messages
Discord permissions
View Channel and Read Message History
Context cost
627 tokens, estimated2,508 bytes of definition, divided by 4

List the threads in a text or announcement channel. Returns { threads: [...], hasMore, nextBefore }. The first call includes active threads plus the first page of archived ones; while hasMore is true pass nextBefore back as `before`. hasMore means that page came back full, so the last call can return nothing. messageCount excludes the starter message and deleted messages, and is inaccurate above 50 for threads created before July 1, 2022. Requires the View Channel and Read Message History permissions. Read-only. Use discord_list_forum_threads for a forum's posts.

Risk and annotations

Read-onlyreadOnlyHintyesDoes not modify your server.
DestructivedestructiveHintn/aNot declared: it only applies to tools that write.
IdempotentidempotentHintn/aNot declared.
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 text or announcement channel to list threads from.
limitoptionalinteger
2 to 100default 100
Max archived threads per page (2–100). Default 100.
typeoptionalstring
one of "public""private"default "public"
Which archived threads to page through. Private requires the Manage Threads permission. Active threads are returned either way. Default public.
beforeoptionalstring
format date-time
pattern (288 characters)^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
Pagination cursor: an ISO timestamp compared against when a thread was archived. Pass the previous response's nextBefore to fetch older archived threads. When set, active threads are omitted.

Output

Declared by outputSchema: clients receive this shape as structuredContent.

FieldType
threadsrequiredarray of objects
id (nested, level 1)requiredstring
name (nested, level 1)requiredstring
private (nested, level 1)requiredboolean
archived (nested, level 1)requiredboolean or null
locked (nested, level 1)requiredboolean or null
messageCount (nested, level 1)requirednumber or null
createdAt (nested, level 1)requiredstring or null
hasMorerequiredboolean
nextBeforerequiredstring or null

Related tools

Named in its description

Also in Messages

Raw definition (2,508 bytes)
{
  "name": "discord_list_channel_threads",
  "description": "List the threads in a text or announcement channel. Returns { threads: [...], hasMore, nextBefore }. The first call includes active threads plus the first page of archived ones; while hasMore is true pass nextBefore back as `before`. hasMore means that page came back full, so the last call can return nothing. messageCount excludes the starter message and deleted messages, and is inaccurate above 50 for threads created before July 1, 2022. Requires the View Channel and Read Message History permissions. Read-only. Use discord_list_forum_threads for a forum's posts.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "channel_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "ID (snowflake) of the text or announcement channel to list threads from."
      },
      "limit": {
        "default": 100,
        "description": "Max archived threads per page (2–100). Default 100.",
        "type": "integer",
        "minimum": 2,
        "maximum": 100
      },
      "type": {
        "default": "public",
        "description": "Which archived threads to page through. Private requires the Manage Threads permission. Active threads are returned either way. Default public.",
        "type": "string",
        "enum": [
          "public",
          "private"
        ]
      },
      "before": {
        "description": "Pagination cursor: an ISO timestamp compared against when a thread was archived. Pass the previous response's nextBefore to fetch older archived threads. When set, active threads are omitted.",
        "type": "string",
        "format": "date-time",
        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
      }
    },
    "required": [
      "channel_id"
    ],
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "threads": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "name": {
              "type": "string"
            },
            "private": {
              "type": "boolean"
            },
            "archived": {
              "type": [
                "boolean",
                "null"
              ]
            },
            "locked": {
              "type": [
                "boolean",
                "null"
              ]
            },
            "messageCount": {
              "type": [
                "number",
                "null"
              ]
            },
            "createdAt": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "id",
            "name",
            "private",
            "archived",
            "locked",
            "messageCount",
            "createdAt"
          ],
          "additionalProperties": false
        }
      },
      "hasMore": {
        "type": "boolean"
      },
      "nextBefore": {
        "type": [
          "string",
          "null"
        ]
      }
    },
    "required": [
      "threads",
      "hasMore",
      "nextBefore"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "List channel threads",
    "readOnlyHint": true,
    "openWorldHint": true
  }
}